Installation

With Remote Ingress Setup

warning

Install Open iT Ingress first before installing the 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, then click Next.

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

   

   Destination Folder

   
   

   

   Changing the Installation Directories

   
   

5. 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://<ingress_hostname>:<port_number>. The default value of 27893 will be supplied if Ingress is not yet installed. Click Next.

   

   Ingress Instance

   
   
   note

   If you haven't installed Ingress yet, a pop-up warning will display. You can skip and continue with the installation by clicking Yes.

   

   Ingress Warning

   
   

6. (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

   
   

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

   note

   Click Next to skip this step without specifying the path to the license key. If you do, the installation will use the license key included in the Configuration folder.

   

   Software License File

   
   

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

9. 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.
   ingress-uri=$INGRESS_URI	Use this to specify the address where the Open iT web application is accessed. You can set this address to http://<ingress_hostname>:<port_number>. If ingress is not yet installed, the default port is 27893. If ingress is installed before the Open iT Core Server installation, the default port is 8080.
   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 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" ingress-uri="http://localhost:8080"

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_500_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.
   httpd-use-https=y	Use this to use secure communication.
   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 client collected data from the original data sources before converting and transferring them to the server. Default value is /var/opt/openit.
   ingress-uri=$INGRESS_URI	Use this to specify the address where the Open iT web application is accessed. You can set this address to http://<ingress_hostname>:<port_number>. If ingress is installed before the Open iT Core Server installation, the default port is 8080.
   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.

   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 ingress-uri="http://host123lin.svg.openit.local:8080"

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

   Example Output

   Version: 10.2.500
   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 ...
   Ingress URI is accessible. Proceeding to installation.
   
   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