# Installation

# Installation Requirements

Application Version
Core Server 10 and later
Analysis Server 10 and later
CLIMS 10 and later
Application Launcher 10 and later
Supported Open iT Applications and Versions

# Installing through the Windows Installer Interface

  1. Double-click the installer file.

  2. In the setup wizard, click Next.

    Welcome Screen

    Welcome Screen

  3. Read and accept the License Agreement, then click Next.

    End-User License Agreement

    End-User License Agreement

  4. Specify the installation directory. Click Change to set a different directory or click Next to use the default folder.

    Destination Folder

    Destination Folder

    Changing the Destination Folder

    Changing the Destination Folder

  5. Specify the web server port number or use the default values, 443 for HTTPS and 8080 for HTTP. This option enables access to the Open iT web application using the address http(s)://<ingress_hostname>:<ingress_port_number>.

    The default option is HTTPS using an SSL Certificate and Key. You can choose whether to use an SSL certificate and key or a Certificate store. Specify the necessary information as needed.

    Default Installation Options

    Default Installation Options

    HTTPS Option: Certificate Store

    HTTPS Option: Certificate Store

    Selecting HTTP will allow you to browse the Open iT web application without encryption. Click Next to proceed with the installation.

    HTTP Option

    HTTP Option

  6. Click Install to start the installation process.

    Alternatively, click Back to review any installation setting.

    Ready to Install

    Ready to Install

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

    Complete Installation

    Complete Installation

# Installing through the Command Line

  1. Open a command prompt with Administrator level privileges.

  2. Run 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> <ACTIVATE_EVENTD> <START_EVENTD>
    Parameter Description
    /i Use this parameter for a normal installation
    <path_to_installer> Use this parameter to specify the path to the installer file
    /l*v Use 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
    /quiet Use this optional parameter to run the installation in silent mode, meaning no user interaction required
    /passive Use 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 enable HTTPS; set the value to 1
    <PORT> Use this optional property to specify the port number when using HTTP; the default value is 8080
    <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")
    <ACTIVATE_EVENTD> Use this optional property to enable (but not start) the websocket service for real-time events (OpeniTEventd); set the value to 1
    <START_EVENTD> Use this optional property to start the websocket service for real-time events (OpeniTEventd); set the value to 1

    Note: <ACTIVATE_EVENTD> is required when using this property.
    Command Parameters

# Examples

To install openit_ingress_1_0_0_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_1_0_0_x64.msi" /l*v "C:\install.log" /passive

To install openit_ingress_1_0_0_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_1_0_0_x64.msi" /l*v "C:\install.log" /quiet INSTALLDIR="C:\OpeniTIngress"

To install openit_ingress_1_0_0_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 3
msiexec /i "C:\Installers\openit_ingress_1_0_0_x64.msi" /l*v "C:\install.log" /passive PORT="8081"

To install openit_ingress_1_0_0_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 4
msiexec /i "C:\Installers\openit_ingress_1_0_0_x64.msi" /l*v "C:\install.log" /passive ENABLEHTTPS="1" CERTOPTION="2"

To install openit_ingress_1_0_0_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 desktop_123win as the machine hostname where the certificate is located:

Example 5
msiexec /i "C:\Installers\openit_ingress_1_0_0_x64.msi" /l*v "C:\install.log" /passive ENABLEHTTPS="1" SSLPORT="4435" CERTSTOREHOST="desktop_123win" CERTOPTION="1" CERTCONFIG1="C:\OpeniT\certificate\sample.cert" CERTCONFIG2="C:\OpeniT\certificate\sample.key"

To install openit_ingress_1_0_0_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) with a running websocket service for real-time events (OpeniTEventd):

Example 6
msiexec /i "C:\Installers\openit_ingress_1_0_0_x64.msi" /l*v "C:\install.log" /passive ACTIVATE_EVENTD="1" START_EVENTD="1"

# Installing through the Terminal

  1. Open a terminal with root user privileges.

  2. Run the following command:

    Command Syntax
    rpm -ivh "<path_to_installer>"
    Parameter Description
    -ivh Use this parameter to install with verbose output and hash marks to show the installation progress
    <path_to_installer> Use this parameter to specify the path to the installer file
    Command Parameters

# Example

To install openit-ingress-1.0.0-0.x86_64.rpm from /root/Installers/:

Example
rpm -ivh "/root/Installers/openit-ingress-1.0.0-0.x86_64.rpm"

We value your feedback!

Please take a few minutes to complete our survey and share your thoughts on your recent experience with our documentation.

Take survey

Close