# Installation

# With Local Ingress Setup

Install Open iT Ingress first before installing the Core Server version 10.

Use this guide if Ingress is installed locally or on the same machine as the Core Server. This assumes that Ingress is properly installed and accessible. Choose among the installation methods:

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.
Double-click the openit_[version]_server_windows_[architecture].msi installer file to begin.

A setup wizard will be displayed. Click Next.

WCS Installation: Welcome Screen

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

WCS Installation: End-user License Agreement

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.

WCS Installation: Destination Folder

Enter the Client ID and Client Secret credentials provided by the Open iT Account Manager or Delivery/Support Team.

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

WCS Installation: SSAD Access Configuration

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.

WCS Installation: Product License Key

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.

WCS Installation: Ready to Install

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.

WCS Installation: Installation Complete

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.
Open a command prompt with Administrator level privilege.

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

Example
msiexec /i openit_10_2_500_server_windows_x64 /l*v install_log.txt /passive INSTALLDIR="C:\Program Files"

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.

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

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

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

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:

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.
Change the actual limit in the current environment, run the following command:
Command
```
ulimit -n 50000
```
Restart the Open iT Services.
Command
```
/opt/openit/bin/openit-all restart
```

# With Remote Ingress Setup

Install Open iT Ingress first before installing the Core Server version 10.

Use this guide if Ingress is installed remotely or on a separate machine than the Core Server. This assumes that Ingress is properly installed, accessible, and the URI is ready. Choose among the installation methods:

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.
Double-click the openit_[version]_server_windows_[architecture].msi installer file to begin.

A setup wizard will be displayed. Click Next.

WCS Installation: Welcome Screen
Read the License Agreement before accepting the terms. Click Next.

WCS Installation: End-user License Agreement
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.

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

WCS Installation: Ingress Instance

If Ingress is not installed yet, a pop-up warning will display. Skip this by clicking Yes to continue with the installation.

WCS Installation: Ingress Warning
Enter the Client ID and Client Secret credentials provided by the Open iT Account Manager or Delivery/Support Team.

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

WCS Installation: SSAD Access Configuration
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.

WCS Installation: Product License Key
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.

WCS Installation: Ready to Install
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.

WCS Installation: Installation Complete

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.
Open a command prompt with Administrator level privilege.

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

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"

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.

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

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

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

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.

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

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.
Change the actual limit in the current environment, run the following command:
Command
```
ulimit -n 50000
```
Restart the Open iT Services.
Command
```
/opt/openit/bin/openit-all restart
```