Installation

Windows

This guide will walk you through the Core Client installation process based on your setup. There are two main categories to make the navigation simple:

• Installing through the Windows Interface
• Installing through the Command Line

---

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

   
   

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

   

   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

   
   

4. Specify the Open iT Server URL. By default, the configured SRV (service) record in the Domain Name System (DNS) is displayed.

   The installer will automatically retrieve the server name and ports from the URL 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 URL

   
   

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

   

   Inaccessible Server URL

   
   

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

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

   

   Blank Server URL 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

   
   
   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

   
   

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=<server_url>

   Required:

   Parameter	Description
   /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:

   Parameter	Description
   INSTALLDIR=$ROOT_DIR	The path where the Open iT files will be installed. This value is set to C:\Program Files\OpeniT\Core by default.
   SERVERURI	The Open iT Server URL.

   Properties for Core Client Installation
   
   

   Options:

   Parameter	Description
   /quiet	Run the command in silent mode.
   /passive	Run 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.

Unix

This guide will walk you through the Core Client installation process based on your setup. There are two main categories to make the navigation simple:

• Root Software Installation
• Non-root Software Installation

---

Root Software Installation

1. Extract the archive contents of the installer using the following command:

   Command Syntax

   tar -xvpf openit_<version>_client_<platform>_<architecture>.tar
   Example

   tar -xvpf openit_10_2_500_client_linux_x86_64.tar

   A dist directory will appear in the current directory.

2. Go to the dist directory.

3. Execute the following command:

   Command Syntax

   ./install.sh <key1=value1> <key2=value2>...

   A help command is available for displaying the usage of these key-value pairs. Type --help or -h after the install command.

   Example

   ./install.sh --help

   The following key-value pairs may be written in any order:

   Required:

   Parameter	Description
   user	Use this to specify the service account name.
   group	Use this to specify the service account group name.
   server-uri	Use this to specify the Open iT Server URL. If the server-uri is not provided, the installer checks the DNS SRV (service) record. If a record is found, the installer will use this and proceed with the installation. If there's no record found, the installation will fail.

   Required Key-Value Pairs for Core Client Installation
   
   
   note

   Use an existing user and group with root privilege to ensure proper collection.

   Optional:

   Parameter	Description
   install-dir	Use this parameter to specify where the Open iT static data, binaries, and libraries will be. If not specified, the libraries will be in /opt/openit by default. If the default directory doesn't fit the system, use another, and the installer will create a link pointing to this directory. If a link exists from /opt/openit, the link's destination will be suggested as the install destination. Do not set this to / or /var.
   temp-dir	Use this parameter to specify the directory where the data collected by the Core Clients from the sources will be before transferring them to the server. If not specified, the data will be in /var/opt/openit.

   Optional Key-Value Pairs for Core Client Installation
   
   
   Example

    ./install.sh user=openit group=openit server-uri=https://openit.customer.com
   note

   Using openit as user and group is optional.

   Once started, the install.sh script will display the following:

   Example Output

   Version: 10.2.500
   Platform: x86_64-unknown-linux
   Installer package directory: /home/openit/dist
   Host Type: client
   
   Getting information from the given Server URI...
   
   Installation Directory: /opt/openit
   Root Temporary Directory: /var/opt/openit
   Service Account Name: openit
   Service Account Group: openit
   Checking minimum OS requirement...
   Minimum OS requirement met.
   
   
   Verifying the directories that will be used by Open iT...
   
   Installing Open iT Client files...
   Installing crontab jobs, startup scripts, and boot runlevel links...
   
   Setting the service account as the owner of the installation files...
   File ownership setup complete.
   
   Setting up configuration files...
   Configuration file setup complete.
   Installation successful.
   

Non-root Software Installation

warning

Non-root software installation is not supported in Solaris.

1. Extract the archive contents of the installer using the following command:

   Command Syntax

   tar -xvpf openit_<version>_client_<platform>_<architecture>.tar
   Example

   tar -xvpf openit_10_2_500_client_linux_x86_64.tar

   A dist directory will appear.

2. Go to the dist directory.

3. Execute the following command to prepare the required directories needed by the service account before installation:

   Command Syntax

   su root -c "./prepare_dirs_and_links.sh <platform> <install_dir> <root_temp_dir> <user> <group>"
   Example

   su root -c "./prepare_dirs_and_links.sh x86_64-unknown-linux /opt/openit /var/opt/openit openit openit"

4. Execute the following command to begin installation:

   Command Syntax

   ./install.sh <key1=value1> <key2=value2>...

   A help command is available for displaying the usage of these key-value pairs. Type --help or -h after the install command.

   Example

   ./install.sh --help

   The following key-value pairs may be written in any order:

   Required:

   Parameter	Description
   user	Use this to specify the service account name.
   group	Use this to specify the service account group name.
   server-uri	Use this to specify the Open iT Server URL. If the server-uri is not provided, the installer checks the DNS SRV (service) record. If a record is found, the installer will use this and proceed with the installation. If there's no record found, the installation will fail.

   Required Key-Value Pairs for Core Client Installation
   
   

   Optional:

   Parameter	Description
   install-dir	Use this parameter to specify where the Open iT static data, binaries, and libraries will be. If not specified, the libraries will be in /opt/openit by default. If the default directory doesn't fit the system, use another, and the installer will create a link pointing to this directory. If a link exists from /opt/openit, the link's destination will be suggested as the install destination. Do not set this to / or /var.
   temp-dir	Use this parameter to specify the directory where the data collected by the Core Clients from the sources will be before transferring them to the server. If not specified, the data will be in /var/opt/openit.

   Optional Key-Value Pairs for Core Client Installation
   
   
   Example

   ./install.sh user=openit group=openit server-uri=https://openit.customer.com
   note

   Using openit as user and group is optional.

   Once started, the install.sh script will display the following:

   Example Output

   Version: 10.2.500
   Platform: x86_64-unknown-linux
   Installer package directory: /home/openit/dist
   Host Type: client
   
   
   Getting information from the given Server URI...
   
   Installation Directory: /opt/openit
   Root Temporary Directory: /var/opt/openit
   Service Account Name: openit
   Service Account Group: openit
   Checking minimum OS requirement...
   Minimum OS requirement met.
   
   
   Verifying the directories that will be used by Open iT...
   
   Installing Open iT Client files...
   Installing crontab jobs, startup scripts, and boot runlevel links...
   
       The startup scripts and boot scripts have to be installed by root.
           An administrator should install the startup scripts and the boot
           script links.
   
       ############ IMPORTANT #############
       Do not forget to inform the Administrator to copy the scripts
       located at:
   
           /opt/openit/libexec/bin/openit-handlerd
   
           /opt/openit/libexec/bin/openit-scheduler
   
       into the system's startup script directory.
   
       /etc/rc.d/init.d
   
       then create a symlink to each current runlevel.
   
   Setting the service account as the owner of the installation files...
   File ownership setup complete.
   
   Setting up configuration files...
   Unable to create file: Permission denied
   Unable to start accounting on file /var/account/pacct: Operation not permitted
   Configuration file setup complete.
   runuser: may not be used by non-root users
   Installation successful.

macOS

This guide will walk you through the Core Client installation process based on your setup, whether installing using the installer interface or not. There are two main categories to make the navigation simple:

• Installing through the Installer Interface
• Installing through the Terminal

---

Installing through the Installer Interface

1. Double-click the openit_<version>_client_mac.pkg file. Click Continue to proceed with the installation.

   

   Welcome Screen

   
   

2. Read the License Agreement carefully. Click Continue to resume the installation.

   

   End-User License Agreement

   
   

   A pop-up will appear.

3. Agree to the terms of the software license agreement by clicking Agree.

   

   Agree End-User License Agreement

   
   

4. Click Install.

   warning

   You can only install Open iT in the root directory.

   

   Installation Type

   
   

   A pop-up will appear.

5. Key in the User Name and Password, then click Install Software.

   

   Install Software

   
   

6. The installer sets up all necessary files on the computer. Click Close after completing the installation.

   

   Installation Complete

   
   

Establishing Connection to the Server

On macOS, the Core Client requires additional steps to establish a secure connection to the server if you installed it using the installer interface.

1. Open a terminal.

2. Execute the following command:

   Command Syntax

   sudo /usr/local/openit/bin/ serverurl <server_url>

   where <server_url> is the Open iT Server URL.

note

Running this command outputs a warning message if the server URL is not available or accessible. Enter y to continue and provide the server URL at a later time or n to exit the setup.

Installing through the Terminal

1. Open a terminal.

2. Execute the following command:

   Command Syntax

   sudo installer -pkg <pkg_file> -target <tgt_vol> && sudo /usr/local/openit/bin/ serverurl <server_url>

   Required:

   Parameter	Description
   -pkg	Use this parameter to specify the full path to the mac installer file, openit_<version>_client_mac.pkg.
   -target	Use this parameter to specify the volume where the Core Client will be installed.
   serverurl <server_url>	Use this property to specify the Open iT Server URL.

   Required Key-Value Pairs for Core Client Installation
   
   
   warning

   You can only install Open iT in the root (/) directory.

   Example

   sudo installer -pkg openit_10_2_500_client_mac_x64.pkg -target / && sudo /usr/local/openit/bin/ serverurl https://openit.customer.com

   Once started, it will display the following:

   Example Output

   installer: Package name is OpeniT Client
   installer: Installing at base path /
   installer: The install was successful