Skip to main content
Version: 10.3

Installation

warning

For fresh installation, install Open iT Ingress first before installing other Open iT applications.

Installing through the Windows Installer Interface​

Step 1: Launch the Installer​

  1. Double-click the installer file.

  2. In the setup wizard, click Next.

    Welcome Screen

    Welcome Screen


Step 2: Review the License Agreement​

  1. Read the End-User License Agreement carefully.

  2. Accept the license terms.

    End-User License Agreement

    End-User License Agreement


  3. Click Next to proceed.

Step 3: Select the Installation Directory​

  1. Choose where the Open iT software will be installed.

  2. Click Change to select a different location.

Changing the Destination Folder

Changing the Destination Folder


  1. Click Next to continue.

Destination Folder

Destination Folder


Step 4: Specify the Web Server Port​

  1. Specify the web server port number or use the default values.

    • 443 for HTTPS
    • 8080 for HTTP

    This option enables access to the Open iT web application using the address http(s)://<ingress_hostname>:<port_number>.

  2. Choose the protocol. Tick the checkbox to use HTTPS.

  3. Choose your SSL configuration.

    • Using the SSL certificate and key, choose the HTTPS setup option that you prefer:

      • Clear the values of the SSL Cert and SSL Key fields. Ingress will automatically create the certificate and key using Let's Encrypt for the setup
      • Use the default values of the SSL Cert and SSL Key fields. After installation, you need to Configure HTTPS using Let's Encrypt
      • Provide your own values for the SSL Cert and SSL Key fields

      Default Installation Options

      Default Installation Options


    • Using Certificate store - specify the Certificate Store and Location.


    HTTPS Option: Certificate Store

    HTTPS Option: Certificate Store


    • Using HTTP - allows you to browse the Open iT web application without encryption.

    HTTP Option

    HTTP Option


  4. Click Next to proceed with the installation.

Step 5: Start the Installation​

  1. Click Install to start the installation process.

    Alternatively, click Back to review any installation setting.

    Ready to Install

    Ready to Install


  2. If prompted by Windows User Account Control (UAC), click Yes to allow the installer to proceed.

    The installer will set up all necessary files on the computer.

Step 6: Complete the Installation​

  1. Click Finish to exit the installer.

    Complete Installation

    Complete Installation


Installing through the Command Line​

Step 1: Open Command Prompt​

  1. Open a command prompt with Administrator level privileges.

Step 2: Execute the Installation Command​

  1. Execute the following command:

    Command Syntax
    msiexec /i <path_to_installer> /l*v <path_to_logfile> [/quiet] [/passive] <INSTALLDIR> <ENABLEHTTPS> <PORT> <SSLPORT> <CERTSTOREHOST> <CERTOPTION> <CERTCONFIG1> <CERTCONFIG2>
    ParameterDescription
    /iUse this parameter for a normal installation
    <path_to_installer>Use this parameter to specify the path to the installer file
    /l*vUse this parameter to turn on logging of all information, including verbose output
    <path_to_logfile>Use this parameter to specify the path to the output log file
    /quietUse this optional parameter to run the installation in silent mode, meaning no user interaction required
    /passiveUse this optional parameter to run the installation in unattended mode, showing only a progress bar
    <INSTALLDIR>Use this optional property to specify the location where the Open iT files will be installed; the default path is C:\Program Files\OpeniT\Ingress
    <ENABLEHTTPS>Use this optional property to specify whether the installation uses HTTPS or HTTP. The default value is 1, which enables HTTPS. Set the value to 0 to use HTTP.
    <PORT>Use this optional property to specify a custom HTTP port when ENABLEHTTPS=0. If ENABLEHTTPS=0 is specified without PORT, the default HTTP port 8080 is used.
    <SSLPORT>Use this optional property to specify the port number when using HTTPS; the default value is 443
    <CERTSTOREHOST>Use this optional property to specify the hostname of the machine where the certificate is located
    <CERTOPTION>Use this optional property to specify the HTTPS configuration; the default value is 1 which configures HTTPS with an SSL certificate and key; set the value to 2 to configure HTTPS with Windows Certificate Store
    <CERTCONFIG1>Use this optional property to specify the path to the SSL certificate (if you opt for CERTOPTION="1") or the Certificate Store where your SSL certificate is stored (if you opt for CERTOPTION="2")
    <CERTCONFIG2>Use this optional property to specify the path to the SSL key (if you opt for CERTOPTION="1") or the store location (if you opt for CERTOPTION="2")
    Command Parameters

    note

    The installation will use the default directories and port number if these properties are unspecified.

    Also, the installer will use the Windows Installer Interface if the process mode (/quiet or /passive) is unspecified.

Step 3: Verify Installation Completion​

  1. If using passive mode, wait until the progress bar disappears.

  2. If using quiet mode, verify installation by:

    • Opening Task Manager
    • Checking the Details tab
    • Ensuring the msiexec process is no longer running

Examples​

To install openit_ingress_10_3_500_0000_x64.msi from C:\Installers in unattended mode with all logging information stored in an output log file at C:\install.log, and using the default installation directory and SSL port number (HTTPS):

Example 1
msiexec /i "C:\Installers\openit_ingress_10_3_500_0000_x64.msi" /l*v "C:\install.log" /passive

To install openit_ingress_10_3_500_0000_x64.msi from C:\Installers in silent mode with all logging information stored in an output log file at C:\install.log, and using a preferred installation directory and default SSL port number (HTTPS):

Example 2
msiexec /i "C:\Installers\openit_ingress_10_3_500_0000_x64.msi" /l*v "C:\install.log" /quiet INSTALLDIR="C:\OpeniTIngress"

To install openit_ingress_10_3_500_0000_x64.msi from C:\Installers, in unattended mode with all logging information stored in an output log file at C:\install.log, and using the default installation directory and 8080 as the HTTP port number:

Example 3
msiexec /i "C:\Installers\openit_ingress_10_3_500_0000_x64.msi" /l*v "C:\install.log" /passive ENABLEHTTPS=0

To install openit_ingress_10_3_500_0000_x64.msi from C:\Installers, in unattended mode with all logging information stored in an output log file at C:\install.log, and using the default installation directory and 8081 as the port number (HTTP):

Example 4
msiexec /i "C:\Installers\openit_ingress_10_3_500_0000_x64.msi" /l*v "C:\install.log" /passive ENABLEHTTPS=0 PORT="8081"

To install openit_ingress_10_3_500_0000_x64.msi from C:\Installers, in unattended mode with all logging information stored in an output log file at C:\install.log, and using the default installation directory and default HTTPS settings using Windows Certificate Store:

Example 5
msiexec /i "C:\Installers\openit_ingress_10_3_500_0000_x64.msi" /l*v "C:\install.log" /passive ENABLEHTTPS="1" CERTOPTION="2"

To install openit_ingress_10_3_500_0000_x64.msi from C:\Installers, in unattended mode with all logging information stored in an output log file at C:\install.log, and using the default installation directory, customized HTTPS settings using an SSL certificate and key, 4435 as the SSL port, and WIN-HOST01 as the machine hostname where the certificate is located:

Example 6
msiexec /i "C:\Installers\openit_ingress_10_3_500_0000_x64.msi" /l*v "C:\install.log" /passive ENABLEHTTPS="1" SSLPORT="4435" CERTSTOREHOST="WIN-HOST01" CERTOPTION="1" CERTCONFIG1="C:\OpeniT\certificate\sample.cert" CERTCONFIG2="C:\OpeniT\certificate\sample.key"

note
  • When using the passive mode, wait until the process bar dialog disappears.
  • When using the quiet mode, verify that the installation is complete by opening the Task Manager and checking in the Details tab if the msiexec process is still running.