Installation

warning

Learn about and install Open iT Ingress before installing Core Server version 10.

Windows

This guide provides instructions for scenarios where Ingress is installed on the same machine as the Core Server. It assumes that Ingress is properly installed and accessible. Choose one of the available installation methods below:

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

---

Installing through the Windows Interface

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.

   A setup wizard will be displayed. Click Next.

   

   Welcome Screen

   
   

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

   

   End-User License Agreement

   
   

4. Specify where the Open iT software will be installed. Click Change to specify a different directory or click Next to use the default folder.

   

   Destination Folder

   
   

   

   Changing the Installation Directories

   
   

5. (Optional) Enter the Open iT Shared Software Assets Directory (SSAD) Client ID and Secret provided by the Open iT Account Manager or 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

   
   

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

   note

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

   

   Software License File

   
   

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

   

   Ready to Install

   
   

   The installer will set up all necessary files on the computer.

8. Click Finish to complete the installation.

   

   Installation Complete

   
   

Installing 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 Administrator level privileges.

3. Execute the following command:

   Command Syntax

   msiexec /i <msi_file> /l*v <log_file> <options> INSTALLDIR=$ROOT_DIR ingress-uri=$INGRESS_URI

   Required:

   Name	Description
   /i <msi_file>	The path of the Windows installer file, openit_<version>_server_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:

   Name	Description
   /quiet	Use this to run the command in silent mode.
   /passive	Use this to run 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:

   Name	Description
   INSTALLDIR=$ROOT_DIR	Use this to specify the path where the Open iT files will be installed. This value is set to C:\Program Files\OpeniT\Core by default.
   SSAD_ID=<client_id>	Use this to input the SSAD Client ID during installation. Coordinate with the Open iT Account Manager or 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 Support Team regarding the SSAD Access Credentials.

   Core Server Installation Properties
   
   

   The SSAD_ID and SSAD_SECRET credentials will be utilized by the Open iT Share Software Assets Directory (SSAD) component of the ServiceNow Integration.

   Example

   msiexec /i openit_10_2_500_server_windows_x64 /l*v install_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.

Unix

This guide provides instructions for scenarios where Ingress is installed on the same machine as the Core Server. It assumes that Ingress is properly installed and accessible.

---

Installing through the Terminal

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

   Command Syntax

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

   tar -xvpf openit_10_2_540_server_linux_x86_64.tar

2. After extracting the archive, the directory dist will appear in the current directory. Go to the dist directory.

   Command Syntax

   cd dist

3. Execute the following command:

   Command Syntax

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

   Execute the help command to display the usage of these key-value pairs. Type --help or -h after the install command.

   Example

   ./install.sh --help

   You can write the following key-value pairs in any order.

   Required:

   Name	Description
   user	Use this to specify a service account name. Use a service account other than root.
   group	Use this to specify a service account group name. Use a service account group other than root.
   data-dir	Use this to specify a path to where you want the Open iT database to be.

   Required Key-Value Pairs for Core Server Installation
   
   

   Optional:

   Name	Description
   html-dir	Use this to specify the path to where you want the report data to be.
   httpd-log-dir	Use this to specify the path to where you want the web daemon activity logging (access and error) to be. If not specified, the default value is temp-dir/log/httpd.
   install-dir	Use this to specify the location for Open iT static data, binaries, and libraries. If not specified, the default value is /opt/openit. If this default directory is not suitable for your system, you can specify another location, and a link will be created pointing to this directory. If a link already exists from /opt/openit, the destination of the link will be suggested as the installation destination. Do not set the install-dir value to / and avoid using /var.
   temp-dir	Use this to specify where you want to keep the Open iT Core Client collected data from the original data sources before converting and transferring them to the Core Server. Default value is /var/opt/openit.
   SSAD_ID=<client_id>	Use this to input the SSAD Client ID during installation. Coordinate with the Open iT Account Manager or 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 Support Team regarding the SSAD Access Credentials.

   Optional Key-Value Pairs for Core Server Installation
   
   

   The SSAD_ID and SSAD_SECRET credentials will be utilized by the Open iT Share Software Assets Directory (SSAD) component of the ServiceNow Integration.

   Example

   ./install.sh user=openit group=openit data-dir=/opt/openit_data

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

   Example Output

   Version: 10.2.540
   Platform: x86_64-unknown-linux
   Installer package directory: /root/installer/dist_10.2
   Host Type: server
   
   Data directory: /opt/openit-data
   Installation Directory: /opt/openit
   Root Temporary Directory: /var/opt/openit
   Service Account Name: openit
   Service Account Group: openit
   
   Checking for Open iT Ingress accessibility ...
   Open iT Ingress installation found on this host.
   
   Checking minimum OS requirement...
   Minimum OS requirement met.
   
   Verifying the directories that will be used by Open iT...
   
   Using ROOT_DATA_DIR for ROOT_HTML_DIR
   
   Installing Open iT Server 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 complete. The URL for the Open iT web interface is:
   
       https://host123lin/
   
   Log in as: admin
   Password:  admin
   
   Setting up git and bare repositories of configuration files.
   Installation successful.
   warning

   If you encounter the warning Warning: Git Not Found., follow this troubleshooting guide.

Unix machines have a file descriptor limit of 1024. If you are expecting a lot of distinct Core Server simultaneous users, workstation collector hosts, and license manager collector hosts, make sure that the global limit file is significantly high in the limits.conf file in /etc/security/. If you deem that the configured value is enough, you may keep it as is.

If it is not yet configured or the existing value is not enough:

1. Add the following line in the limits.conf file:

   limits.conf

   <user>  hard    nofile  <new_limit>
   limits.conf Example

   openit  hard    nofile  50000

   This example will increase the maximum open file limit to 50,000 for the openit user.

   warning

   The value of the new limit must be greater than the sum of the distinct number of Core Server simultaneous users, workstation collector hosts, and license manager collector hosts.

2. Change the actual limit in the current environment, run the following command:

   Command Syntax

   ulimit -n 50000

3. Restart the Open iT Services.

   Command Syntax

   /opt/openit/bin/openit-all restart

note

Recommended reading: If Ingress is installed remotely or on a separate machine than the Core Server, follow the instructions on Installation with Remote Ingress Setup