# Installation

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.

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

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.

5. Enter the Client ID and Client Secret credentials provided by the Open iT Account Manager or Delivery/Support Team. These credentials will be utilized by the Open iT Share Software Assets Directory (SSAD) component of the ServiceNow Integration.

   You can skip this step by clicking Next. However, if skipped, this can be configured in post-installation.

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

   Skip this step by clicking Next without specifying the path to the license key. If this step is skipped, the included license key in the Configuration folder will be used.

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

   To generate a desktop shortcut for the Core Reporter URI, select the Create a shortcut to the Core Reporter URI on the Desktop. The Run LicenseAnalyzer Auto Configurators option will be automatically selected. Deselect this option as needed.

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

   After the installation, the View Release Notes option will be automatically selected. This option will show a list of updates and fixes included on the installer through a web browser. Deselect this option as needed.

   Click Finish to complete the installation.

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

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
   
   
   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 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"

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.

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.

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

   The following key-value pairs may be written 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 client collected data from the original data sources before converting and transferring them to the 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 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 

   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 ...
   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://mnl896lin/
   
   Log in as: admin
   Password:  admin
   
   Setting up git and bare repositories of configuration files.
   Installation successful.

   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>

   Example

   openit          hard    nofile      50000

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

   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

   ulimit -n 50000

3. Restart the Open iT Services.

   Command

   /opt/openit/bin/openit-all restart

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.

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

   The following key-value pairs may be written 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>:<ingress_portnumber>. 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://mnl896lin.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://mnl896lin/
   
   Log in as: admin
   Password:  admin
   
   Setting up git and bare repositories of configuration files.
   Installation successful.

   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>

   Example

   openit          hard    nofile      50000

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

   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

   ulimit -n 50000

3. Restart the Open iT Services.

   Command

   /opt/openit/bin/openit-all restart