Skip to main content
Version: 10.2

Installation

This guide will walk you through the Core Client installation process based on your setup, whether installing a stand-alone Core Client or activating a Core Client in a Core Server. There are two main categories to make the navigation simple:

Installing through the Windows Interface​

  1. Double-click the openit_<version>_client_windows_<architecture>.msi installer file to begin.

    A setup wizard will be displayed. Click Next.

    Welcome Screen

    Welcome Screen


  2. Read the License Agreement carefully before accepting the terms. Click Next.

    End-User License Agreement

    End-User License Agreement


  3. Specify where the Core Client will be installed. Click Change to specify a different directory, then click Next.

    Clicking Next without doing any changes will use the default installation path.

    Destination Folder

    Destination Folder


  4. Specify the Uniform Resource Identifier (URI) of the Open iT Ingress. By default, the configured SRV (service) record in the Domain Name System is displayed.

    The installer will automatically retrieve the server name and Open iT ports from the URI supplied, assuring that all of the clients are in sync with the same server name and ports used.

    Click Next.

    note

    A trusted server certificate is needed to establish a secure connection between the Open iT client and server.


    Server URI
    Server URI


    If the provided server URI is not available or accessible, a prompt will be displayed. Select Yes to continue or No to return to the server URI dialog.

    Inaccessible Server URI

    Inaccessible Server URI


    If there are no servers available, provide a server URI and choose to continue with the installation if prompted — the process will continue even if the server URI alias used is not available.

    Leaving the server URI text box blank will result in an error.

    Blank Server URI Warning

    Blank Server URI Warning


  5. On the Ready to Install screen, review the available options and select those that apply:

    • Run LicenseAnalyzer Auto Configurators - automatically configures supported license managers (i.e., Flexnet, DSLS, LM-X, LS-DYNA, RLM, and SlickEdit) after installation
    • Start Open iT Client Service - starts the Core Client service immediately after installation
    • Create a shortcut to the Core Reporter URI on the Desktop. (optional) - adds a convenient desktop shortcut to the server web interface

    note

    It is recommended to leave the default options checked for a smoother setup.

    If you need to review the entries, click Back.

    Click Install to begin the installation.

    Ready to Install

    Ready to Install


    warning

    Personal firewalls (such as ZoneAlarm) may cause problems during startup, and the Open iT service may log additional errors; this may not be critical, but it must be checked to ensure that there are no further errors logged.

  6. Click Finish to complete the installation.

    Finish Installation

    Finish Installation


Installing through the Command Line​

  1. Open a command prompt with Administrator level privilege.

  2. Execute the following command:

    Command Syntax
    msiexec /i <msi_file> /l*v <log_file> <options> INSTALLDIR=$ROOT_DIR SERVERURI=http(s)://<ingress_hostname>:<port_number>

    Required:

    ParameterDescription
    /i <msi_file>Use this to specify the path of the Windows installer file, openit_<version>_client_windows_<architecture>.msi.
    /l*v <log_file>Use this to specify the path of the installation log file that will be created during installation.
    Required Key-Value Pairs for Core Client Installation

    Properties:

    ParameterDescription
    INSTALLDIR=$ROOT_DIRThe path where the Open iT files will be installed. This value is set to C:\Program Files\OpeniT\Core by default.
    SERVERURIThe web URI (Uniform Resource Identifier) including the correct port number of the Open iT Ingress.
    Properties for Core Client Installation

    Options:

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

    note

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


  3. 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.

Activating Core Client in the Core Server (for coexistence)​

warning

Apply the configurations shown in the Open iT Core Server.

Open iT allows for a coexistent environment wherein both server and client is hosted on a single machine.

These are the required steps to activate server-client coexistence:

  1. Open a command prompt with Administrator level privileges.

  2. Go to the bin directory, which is by default in C:\Program Files\OpeniT\Core\bin, run the command:

    Command Syntax
    cd $BIN_DIR
    Example
    cd C:\Program Files\OpeniT\Core\bin

  3. Once in the directory, activate the Core Client, run the following commands:

    Command Syntax
    openit_oconfinit -u "core_config-client.root.scheduler.jobs.core_download_dist.general.active=true"
    Command Syntax
    openit_oconfinit -u "core_config-client.root.scheduler.jobs.core_moduleactivator.general.active=true"

  4. Open Task Manager and go to the Services tab.

  5. Restart the OpeniTServer service.

    This will activate the scheduler jobs of client modules set to true in the module-activation directory, which is by default in C:\Program Files\OpeniT\Core\Configuration\module-activation.

    Another option to configure coexistence in Windows is to run the openit_moduleactivator. Go to the bin directory, which is by default in C:\Program Files\OpeniT\Core\bin, and run the following in the command line:

    Command Syntax
    openit_moduleactivator --no-restart