Skip to main content
Version: 10.2

Upgrade

note

Upgrade to Core Server version 10.2 before updating the clients to ensure proper Windows Inventory data processing for the updated data type 33.

This guide provides instructions for upgrading the Core Server, whether you are upgrading from version 9 or from version 10.2.x to the latest version. Choose one of the available installation methods below:

Upgrading through the Windows Interface​

note

Make sure that there are no open files and directories in the Windows Explorer or command line.

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

    A new file explorer will appear containing the openit_<version>_server_windows_<architecture>.msi and clients folder.

  2. Double-click the openit_<version>_server_windows_<architecture>.msi installer file to begin upgrade.

  3. Click Yes on the upgrade confirmation prompt.

    Confirm Upgrade

    Confirm Upgrade


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

    Welcome Screen

    Welcome Screen


  5. Read the License Agreement before accepting the terms. Click Next.

    End-User License Agreement

    End-User License Agreement


note

The next step is only required if you are upgrading from version 9 to version 10 and Ingress has not yet been installed. If this does not apply to your setup—such as when Ingress is already installed or you are not performing this specific upgrade path—you may skip this step.

  1. Specify the Open iT Ingress URI that the Open iT Server will use. This will trigger the Open iT Core Server to establish a connection with Ingress and to access the Open iT web application using the address http(s)://<ingress_hostname>:<port_number>. The default value of 27893 will be supplied if Ingress is not yet installed. Click Next.

    Ingress Instance

    Ingress Instance


    If Ingress is not installed yet, a pop-up warning will display. Skip this by clicking Yes to continue with the installation.

    Ingress Warning

    Ingress Warning


  2. (Optional) Enter the Open iT Shared Software Assets Directory (SSAD) Client ID and Secret provided by the Open iT Account Manager or Delivery/Support team. 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 in Configuring Access to the Open iT Shared Software Assets Directory (SSAD).

    SSAD Access Configuration

    SSAD Access Configuration


  3. Specify, or browse for, the directory containing a valid Open iT license key, then click Next.

    note

    If you skip this step, the installation will use the license key included in the Configuration folder.

    Software License File

    Software License File


  4. Click Install to start the installation process. Click Back to review any installation setting.

    Ready to Install

    Ready to Install


  5. Click Finish to complete the installation.

    Installation Complete

    Installation Complete


Upgrading through the Command Line​

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

    A new file explorer will appear containing the openit_<version>_server_windows_<architecture>.msi and clients folder.

  2. Open a command prompt with Administrative level privileges.

  3. Execute the following command:

    Command Syntax
    msiexec /i <msi_file> /l*v <log_file> <options> INSTALLDIR=$ROOT_DIR

    Required:

    NameDescription
    /i <msi_file>The path of the Windows installer file, openit_<version>_client_windows_<architecture>.msi. This should be the path to the mounted ISO image.
    /l*v <log_file>The path of the installation log file that will be created during installation.
    Required Key-Value Pairs for Core Server Installation

    Options:

    NameDescription
    /quietRun the command in silent mode.
    /passiveRun the command in unattended mode — progress bar only.
    Options for Core Server Installation

    note

    The installer will use the Windows Installer Interface process when the installation option is not specified.

    Properties:

    NameDescription
    INSTALLDIR=$ROOT_DIRUse this to specify the path where the Open iT files will be installed. If not specified, the default value is C:\Program Files\OpeniT\Core.
    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.
    INGRESS-URI=$ingress_uriUse this to specify the Ingress installation hostname and port http(s)://<ingress_hostname>:<port_number>.
    SSAD_ID=<client_id>Use this to input the SSAD client ID during installation. Coordinate with the Open iT Account Manager or Delivery/Support team regarding the SSAD access credentials.
    SSAD_SECRET=<client_secret>Use this to input the SSAD client secret during installation. Coordinate with the Open iT Account Manager or Delivery/Support team regarding the SSAD access credentials.
    Core Server Software Upgrade Properties

    Example
    msiexec /i openit_10_2_510_server_windows_x64 /l*v upgrade_log.txt  /passive INSTALLDIR="C:\Program Files"

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