Skip to main content
Version: 10.3

Upgrade

warning

Direct upgrades between major versions are not supported.

Starting with Open iT Core Server 10.3, a PostgreSQL database is required. You can use an existing PostgreSQL instance or install the PostgreSQL database bundled with the installer. Before proceeding with the upgrade, review the PostgreSQL requirements.

Choose one of the available upgrade methods:

Upgrading through the Windows Interface​

Follow these steps to upgrade the Open iT Core Server using the Windows graphical installer. This includes steps for configuring the required PostgreSQL component.

note

Make sure that there are no open files and directories in the Windows Explorer or 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. Launch the Installer​

  1. Double-click the openit_<version>_server_windows_<architecture>.msi file.

  2. Click Yes on the upgrade confirmation prompt.

    Confirm Upgrade

    Confirm Upgrade


  3. The setup wizard will be displayed. Click Next.

    Welcome Screen

    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: Configure Active Directory Service Account​

note

You can opt to skip this step if the settings from the previous installation will be used.

  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 5: Configure SSAD Access (Optional)​

note

You can opt to skip this step if the settings from the previous installation will be used.

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.


SSAD Access Configuration

SSAD Access Configuration

Step 6. 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 7. Specify the License File​

note

You can opt to skip this step if the settings from the previous installation will be used.

  1. Browse to the directory containing a valid Open iT license file.

  2. Click Next.

    Software License File

    Software License File

Step 8: Start the Installation​

  1. (Optional) Select Create a shortcut to the Core Server GUI on the Desktop. to create a shortcut to the Open iT Core Reporter on the desktop after installation.

  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 9: Complete the Installation​

When the installation finishes:

  1. (Optional) View release notes.

  2. Click Finish to exit the installer.

    Installation Complete

    Installation Complete

Upgrading through the Command Line​

Follow these steps to upgrade 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.
    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 Upgrade Properties

    Optional MSI Properties:

    You can opt not to use the installation parameters for the upgrade if the settings from the previous installation will be used.

    PropertyDescription
    INSTALLDIRUse this to specify the path where the Open iT files will be installed.
    DATADIRUse this to specify the path where the Open iT data files will be stored.
    UPGRADECONFIGDIR=<path_to_dir>Use this to specify the path where the UpgradeAssistant will store the installation upgrade files and changelogs. If not specified, the default value is C:\ProgramData\OpeniT\Data\UpgradeConfigFiles.
    CONFIGDIR=<path_to_dir>Use this to specify the path where the UpgradeAssistant will store the configuration files to be modified. If not specified, the default value is C:\Program Files\OpeniT\Core\Configuration.
    INGRESSURIUse 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_IDUse 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_SECRETUse 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.
    OPENITGRPCPORTUse this to specify the gRPC port that will be used by the Core Server.
    POSTGRESHOSTNAMEUse this to specify the hostname of the PostgreSQL server.
    POSTGRESDBNAMEUse this to specify the PostgreSQL database name.
    POSTGRESPORTUse this to specify the port used to connect to PostgreSQL.
    LICENSEFILEUse 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.
    RUNAUTODETECTORSSpecifying any value using this property executes the autoconfigurators after installation.
    INSTALLSHORTCUTSpecifying any value using this property creates a desktop shortcut to the Core Reporter after installation.
    Optional Core Server Upgrade Properties
note

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

  • Set PGINSTANCEOPT=embedded 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