Performing a Silent Installation

You can install GENESIS in the background using a command prompt instead of the graphical user interface. Silent installation is generally used in scenarios where IT administrators and system integrators are deploying GENESIS to multiple machines, creating new virtual machines, or using GENESIS as a dependency of another installer.

The commands in the following procedure apply to Windows Command Prompt. If you are using a different utility such as PowerShell, change the syntax as needed.

To perform a silent installation:

  1. Locate and open the installation .iso file or insert the installation DVD.

  2. Open a Windows command prompt with administrator privileges.

  3. In the command prompt window, switch to the drive and directory with the GENESIS_Setup.exe file, which is the root of the installation folder.

    Example: cd /d E:\

  4. Select the desired installation parameters and set their values. Learn more Learn more

    Run GENESIS_Setup.exe /? or GENESIS_Setup.exe /h to view the list of available parameters, as displayed in the following image.

  5. To begin the silent installation, execute the start /wait GENESIS64_Setup.exe /s command, followed by the desired settings. For example:

    start /wait GENESIS_Setup.exe /s /SQLINSTANCE=SQLEXPRESS2022 Workloads=DataBroker,Client Components=SNMP,Triggers

    It runs the silent installation with a custom SQL Server instance name and installs the SNMP and Triggers components in addition to Data Broker and Client workloads.

  6. Execute the echo %errorlevel% command to display the installation process exit code. The following list explains the meaning of each code.

    • 0—The installation finished successfully.

    • 1641 or 3010—The installation requested a restart.

      If the command contains the NoReboot parameter and one of these codes is returned, you need to manually restart the machine. Make sure you select Update and restart if any Windows updates are pending a restart.

      The installation should automatically resume after restarting the machine. If it does not, you need to run the silent installation command again to restart the installation.

    • Any other number—The installation failed.

      If the installation fails, do one of the following:

      • Check the log files. The default location is:

        <SystemDrive>: \ProgramData\ICONICS\Logs\Installation\

        If you cannot identify the problem, pack the logs into a .zip file and send an email with the attached logs to ICONICS Customer Support.

      • Open GENESIS_Setup.exe and run the installation again in the graphical user interface (GUI).

  7. After a successful installation, proceed with the initial system configuration. The required type of configuration varies based on the installation type.

    • If any server components are installed, open the configuration wizard to set up the SQL Server connection, the project database, and server configurations. Learn more Learn more

    • After a GraphWorX-only installation, open the FrameWorX Location Utility. Learn more

    • If the Workbench client is installed, open Workbench.

    • A Data Broker-only installation does not require any configuration.