Skip to main content
Version: 10.3

Installation

This guide provides instructions for installing the Open iT Core Server. Choose one of the available installation methods:

Installing through the Windows Interface​

Follow these steps to install the Open iT Core Server using the Windows graphical installer. This installation includes steps for configuring required and optional components such as PostgreSQL (required) and Open iT Ingress (recommended).

Step 1: Mount the Installation Image​

  1. Right-click the openit_<version>_server_windows ISO image.

  2. Select Mount.

    A new File Explorer window will appear containing:

    • openit_<version>_server_windows_<architecture>.msi
    • compressed Git files (Git.zip)
    • compressed LicensePredictor files (openit_forecast.zip)
    • compressed PostgreSQL files (pgsql.zip)
    • a clients directory containing client installers

Step 2. Launch the Installer​

  1. Double-click the openit_<version>_server_windows_<architecture>.msi file. The Open iT Core Server Setup Wizard will appear.

  2. Click Next to continue.

    Setup Wizard Welcome Screen

    Setup Wizard Welcome Screen

Step 3: Review the License Agreement​

  1. Read the End-User License Agreement carefully.

  2. Accept the license terms.

  3. Click Next to continue.

    End-User License Agreement

    End-User License Agreement

Step 4: Select the Installation Directory​

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

  2. Click Change to select a different location.

    Destination Folder Configuration

    Destination Folder Configuration

  3. Click Next to continue.

    Destination Folder

    Destination Folder

Step 5: Configure Active Directory Service Account​

Specify the account that will run the Open iT Core Server services.

  1. If your organization uses a dedicated Active Directory service account:

    • Select Use Service Account.
    • Enter the User Name in the <DOMAIN\username> format.
    • Enter the corresponding Password.

    Active Directory Service Account Configuration

    Active Directory Service Account Configuration

    note

    Make sure that the service account has the necessary permissions required to run the Open iT services.

  2. If a dedicated service account is not available:

    • Leave Use Service Account unchecked.
    • The installer will configure the services to run using the LocalSystem account.

    Use LocalSystem Account

    Use LocalSystem Account

  3. Click Next to continue.

Step 6: Configure the Open iT Ingress URI​

Specify the Open iT Ingress URI that the Open iT Core Server will use to connect to the Open iT web application using the following format: http(s)://<ingress_hostname>:<port_number>.

note

You will only see this dialog box if Ingress is not installed on the machine where you are installing the Open iT Core Server. If it is already installed, this step is skipped and the existing Ingress details are used.

Choose one of the following:

  • Provide a URI (recommended if Ingress is already available). The installer will use the URI you entered and continue the installation.

    Ingress Instance Configuration

    Ingress Instance Configuration

  • Accept the default value (http://localhost:27893). Use this if Ingress is not yet installed on the machine.

    Default Ingress Instance

    Default Ingress Instance

If Ingress is not installed and you proceed with the default value, a warning dialog will appear saying the Ingress URI is inaccessible.

Ingress Warning

Ingress Warning

Decide whether to proceed:

  • Click Yes to continue. The installer assumes you will install Ingress on the same machine later, and it will use http://localhost:27893.

    note

    You may proceed with the installation and configure it later. See Installing Open iT Ingress for setup instructions.

  • Click No to go back and enter a reachable Ingress URI.


Step 7: Configure SSAD Access (Optional)​

Enter the Client ID and Client Secret for the Open iT Shared Software Assets Directory (SSAD). These credentials will be utilized to ensure SSAD-Core Server connection for the ServiceNow Integration.

note

You may skip this step by clicking Next and configure it post-install. See Configuring Access to the Open iT Shared Software Assets Directory (SSAD) for setup instructions.


SSAD Access Configuration

SSAD Access Configuration

Step 8. Configure the Orchestrator and PostgreSQL Instance​

Configure the gRPC port for the Open iT Orchestrator service and select the PostgreSQL instance that will be used by the Open iT Core Server.

  1. Enter the gRPC Port that will be used by the Open iT Orchestrator service. The default value is 4266.

  2. Select the PostgreSQL instance to use:

    • Use the bundled PostgreSQL
    • Use an existing PostgreSQL

    Open iT Orchestrator Configuration

    Open iT Orchestrator Configuration

  3. Click Next to continue.

  4. In the PostgreSQL Configuration window, provide the required connection details.

    If Use the bundled PostgreSQL is selected:

    • Hostname – Pre-filled with localhost
    • Port – Default is 5432
    • Username – Pre-filled with postgres
    • Password – Enter the password

    You only need to confirm defaults and provide the password (and optionally database name).

    Bundled PostgreSQL Configuration

    Bundled PostgreSQL Configuration

    If Use an existing PostgreSQL is selected:

    • Hostname – Enter the hostname or IP address of the PostgreSQL server
    • Port – Enter the PostgreSQL port (default: 5432)
    • Username – Enter the PostgreSQL user account
    • Password – Enter the password
    • Database Name – Enter the existing database name

    You must provide all required connection details.

    Existing PostgreSQL Configuration

    Existing PostgreSQL Configuration

    note

    When using the bundled PostgreSQL, all required configuration is handled automatically by the installer.

  5. Click Next to continue the installation.

Step 9. Specify the License File​

  1. Browse to the directory containing a valid Open iT license file.
  2. Click Next.
note

If you skip this step, the installation will use a temporary license file. Install a valid license before expiration to avoid service interruption.

Software License File

Software License File

Step 10: Start the Installation​

Choose optional actions before starting the installation.

  1. (Optional) Select any of the following options:

    • Create a shortcut to the Core Server GUI on the Desktop. – Creates a shortcut to the Open iT Core Reporter on the desktop after installation.
    • Run LicenseAnalyzer Auto Configurators – Automatically executes configuration tools after installation to detect and configure supported license managers and system settings.

  2. Click Install to begin the installation.

    Ready to Install

    Ready to Install

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

The installer will now copy and configure the required files on the system.

Step 11: Complete the Installation​

When the installation finishes:

  1. (Optional) View release notes.

  2. Click Finish to exit the installer.

    Installation Complete

    Installation Complete

Installing through the Command Line​

Follow these steps to install the Open iT Core Server using the command line.

Step 1: Mount the Installation Image​

  1. Right-click the openit_<version>_server_windows ISO image.

  2. Select Mount.

    A new File Explorer window will appear containing:

    • openit_<version>_server_windows_<architecture>.msi
    • compressed Git files (Git.zip)
    • compressed LicensePredictor files (openit_forecast.zip)
    • compressed PostgreSQL files (pgsql.zip)
    • a clients directory containing client installers

Step 2: Open Command Prompt​

  1. Open a command prompt with Administrator level privileges.

Step 3: Execute the Installation Command​

  1. Execute the following command:

    Command Syntax
    msiexec /i <msi_file> /l*v <log_file> <Installer Switches> <MSI Properties>

    The installation command contains two types of parameters:

    • Installer Switches - control how the installer runs
    • MSI Properties - configure the Open iT application during installation

    Installer Switches (MSIEXEC Options)​

    Controls installer behavior.

    Required Switches:

    SwitchDescription
    /i <msi_file>Use this to specify the path to the Windows installer file, openit_<version>_server_windows_<architecture>.msi. This should be the path to the mounted ISO image.
    /l*v <log_file>Use this to specify the path of the installation log file that will be created during installation.
    Required Switches for Core Server Installation

    Optional Switches:

    SwitchDescription
    /quietUse this to run the command in silent mode.
    /passiveUse this to run the command in unattended mode — progress bar only.
    Optional Switches for Core Server Installation
    note

    If no installation mode is specified, the installer will use the Windows Installer interface.

    MSI Properties (Application Configuration)​

    MSI properties configure the Open iT application during installation. Properties are passed in this format:

    Command Syntax
    PROPERTY=VALUE

    Required MSI Properties:

    PropertyDescription
    PGINSTANCEOPTUse this to specify the PostgreSQL instance to use during installation.
    • local - Specify this option to use an existing PostgreSQL instance, whether it is local or remote.
    • embedded - Specify this option to install and use the bundled PostgreSQL included with Open iT.

    The default value is embedded.
    POSTGRESUSERNAMEUse this to specify the super admin username used in your PostgreSQL setup.
    POSTGRESPASSWORDUse this to specify the password of the super admin used in your PostgreSQL setup.
    Required Core Server Installation Properties

    Optional MSI Properties:

    The following optional MSI properties are defined with default values. If you want to use a different value during installation, specify the corresponding property.

    PropertyDefault ValueDescription
    INSTALLDIRC:\Program Files\OpeniT\CoreUse this to specify the path where the Open iT files will be installed.
    DATADIRC:\ProgramData\OpeniT\DataUse this to specify the path where the Open iT data files will be stored.
    INGRESSURIhttp://localhost:27893Use this to specify the Ingress URL where the Core Server will register.

    Provide this if Ingress is installed on a different machine. Otherwise, the installer assumes that Ingress will be installed on the same machine later.
    SSAD_IDnoneUse this to specify the SSAD Client ID during installation for the Open iT Share Software Assets Directory (SSAD) component of the ServiceNow Integration. Coordinate with the Open iT Account Manager or Support Team regarding the SSAD Access Credentials.
    SSAD_SECRETnoneUse this to specify the SSAD Client Secret during installation for the Open iT Share Software Assets Directory (SSAD) component of the ServiceNow Integration. Coordinate with the Open iT Account Manager or Support Team regarding the SSAD Access Credentials.
    OPENITGRPCPORT4266Use this to specify the gRPC port that will be used by the Core Server.
    POSTGRESHOSTNAMElocalhostUse this to specify the hostname of the PostgreSQL server.
    POSTGRESDBNAMEopenitUse this to specify the PostgreSQL database name.
    POSTGRESPORT5432Use this to specify the port used to connect to PostgreSQL.
    LICENSEFILE0Use this to specify the path to the valid Open iT license file.

    The installation will use a temporary license file if this is not specified. Install a valid license before expiration to avoid service interruption.
    RUNAUTODETECTORS0Specifying any value using this property executes the autoconfigurators after installation.
    INSTALLSHORTCUTnoneSpecifying any value using this property creates a desktop shortcut to the Core Reporter after installation.
    Optional Core Server Installation Properties
note

You must specify the PostgreSQL instance to use during installation using the PGINSTANCEOPT property.

  • Set PGINSTANCEOPT=embedded or do not specify to install and use the bundled PostgreSQL included with Open iT. In this mode, all required PostgreSQL configuration is handled automatically by the installer.

  • Set PGINSTANCEOPT=local to use an existing PostgreSQL instance (local or remote). In this case, you must provide the required connection details:

    • POSTGRESHOSTNAME
    • POSTGRESDBNAME
    • POSTGRESPORT
    • POSTGRESUSERNAME
    • POSTGRESPASSWORD

In both cases, a database (openit) will be created using the provided PostgreSQL credentials.

Example
msiexec /i openit_10_3_500_server_windows_x64 /l*v install_log.txt /passive PGINSTANCEOPT=embedded POSTGRESUSERNAME="postgres" POSTGRESPASSWORD="Adm!n123"

Step 4: 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

Next Steps?​

After installing the Open iT Core Server, you may need to configure additional components:

For accessing the Open iT web interface

Open iT Ingress

Configure credentials for ServiceNow integration

Configure SSAD Access