# Software Upgrade

# Upgrading through the Windows Installer Interface

Double-click the installer file.
The installer will notify that there is an older version already installed on the machine. Click Yes to continue or No to cancel.

Ingress Upgrade Prompt
In the setup wizard, click Next.

Welcome Screen
Read and accept the License Agreement, then click Next.

End-User License Agreement
Specify the installation directory. Click Change to set a different directory or click Next to use the default folder.

Destination Folder

Changing the Destination Folder
Click Install to start the installation process.

Alternatively, click Back to review any installation setting.

Ready to Install
The installer will set up all necessary files on the computer. Click Finish.

Complete Installation

# Upgrading through the Command Line

Open a command prompt with Administrator level privileges.

Run the following command:

Command Syntax
msiexec /i <path_to_installer> /l*v <path_to_logfile> [/quiet] [/passive] <INSTALLDIR> <ENABLEHTTPS> <PORT> <SSLPORT> <CERTSTOREHOST> <CERTOPTION> <CERTCONFIG1> <CERTCONFIG2> <ACTIVATE_EVENTD> <START_EVENTD>

Parameter	Description
`/i`	Use this parameter for a normal installation
`<path_to_installer>`	Use this parameter to specify the path to the installer file
`/l*v`	Use this parameter to turn on logging of all information, including verbose output
`<path_to_logfile>`	Use this parameter to specify the path to the output log file
`/quiet`	Use this optional parameter to run the installation in silent mode, meaning no user interaction required
`/passive`	Use this optional parameter to run the installation in unattended mode, showing only a progress bar
`<INSTALLDIR>`	Use this optional property to specify the location where the Open iT files will be installed; the default path is `C:\Program Files\OpeniT\Ingress`
`<ENABLEHTTPS>`	Use this optional property to enable HTTPS; set the value to 1
`<PORT>`	Use this optional property to specify the port number when using HTTP; the default value is 8080
`<SSLPORT>`	Use this optional property to specify the port number when using HTTPS; the default value is 443
`<CERTSTOREHOST>`	Use this optional property to specify the hostname of the machine where the certificate is located
`<CERTOPTION>`	Use this optional property to specify the HTTPS configuration; the default value is 1 which configures HTTPS with an SSL certificate and key; set the value to 2 to configure HTTPS with Windows Certificate Store
`<CERTCONFIG1>`	Use this optional property to specify the path to the SSL certificate (if you opt for `CERTOPTION="1"`) or the Certificate Store where your SSL certificate is stored (if you opt for `CERTOPTION="2"`)
`<CERTCONFIG2>`	Use this optional property to specify the path to the SSL key (if you opt for `CERTOPTION="1"`) or the store location (if you opt for `CERTOPTION="2"`)
`<ACTIVATE_EVENTD>`	Use this optional property to enable (but not start) the websocket service for real-time events (OpeniTEventd); set the value to 1
`<START_EVENTD>`	Use this optional property to start the websocket service for real-time events (OpeniTEventd); set the value to 1 Note: `<ACTIVATE_EVENTD>` is required when using this property.

Command Parameters

The installation will use the default directories and port number if these properties are unspecified.

Also, the installer will use the Windows Installer Interface if the process mode (/quiet or /passive) is unspecified.

# Examples

To upgrade to openit_ingress_1_0_1_x64.msi from C:\Installers in unattended mode with all logging information stored in an output log file at C:\install.log, and using the default installation directory and SSL port number (HTTPS):

Example 1
msiexec /i "C:\Installers\openit_ingress_1_0_18_x64.msi" /l*v "C:\install.log" /passive

To upgrade to openit_ingress_1_0_18_x64.msi from C:\Installers in silent mode with all logging information stored in an output log file at C:\install.log, and using a preferred installation directory and default SSL port number (HTTPS):

Example 2
msiexec /i "C:\Installers\openit_ingress_1_0_18_x64.msi" /l*v "C:\install.log" /quiet INSTALLDIR="C:\OpeniTIngress"

Example 3
msiexec /i "C:\Installers\openit_ingress_1_0_18_x64.msi" /l*v "C:\install.log" /passive PORT="8081"

To upgrade to openit_ingress_1_0_18_x64.msi from C:\Installers, in unattended mode with all logging information stored in an output log file at C:\install.log, and using the default installation directory and default HTTPS settings using Windows Certificate Store:

Example 4
msiexec /i "C:\Installers\openit_ingress_1_0_18_x64.msi" /l*v "C:\install.log" /passive ENABLEHTTPS="1" CERTOPTION="2"

To upgrade to openit_ingress_1_0_18_x64.msi from C:\Installers, in unattended mode with all logging information stored in an output log file at C:\install.log, and using the default installation directory, customized HTTPS settings using an SSL certificate and key, 4435 as the SSL port, and desktop_123win as the machine hostname where the certificate is located:

Example 5
msiexec /i "C:\Installers\openit_ingress_1_0_18_x64.msi" /l*v "C:\install.log" /passive ENABLEHTTPS="1" SSLPORT="4435" CERTSTOREHOST="desktop_123win" CERTOPTION="1" CERTCONFIG1="C:\OpeniT\certificate\sample.cert" CERTCONFIG2="C:\OpeniT\certificate\sample.key"

To upgrade to openit_ingress_1_0_18_x64.msi from C:\Installers in unattended mode with all logging information stored in an output log file at C:\install.log, and using the default installation directory and SSL port number (HTTPS) with a running websocket service for real-time events (OpeniTEventd):

Example 6
msiexec /i "C:\Installers\openit_ingress_1_0_18_x64.msi" /l*v "C:\install.log" /passive ACTIVATE_EVENTD="1" START_EVENTD="1"

When using the passive mode, wait until the process bar dialog disappears.
When using the quiet mode, verify that the installation is complete by opening the Task Manager and checking in the Details tab if the msiexec process is still running.

# Upgrading through the Terminal

Open a terminal with root user privileges.

Run the following command:

Command Syntax
rpm -Uvh "<path_to_installer>"

Parameter	Description
`-Uvh`	Use this parameter to upgrade with verbose output and hash marks to show the upgrade progress
`<path_to_installer>`	Use this parameter to specify the path to the installer file

Command Parameters

# Example

To upgrade to openit-ingress-1.0.18-0.x86_64.rpm from /root/Installers/:

Example
rpm -Uvh "/root/Installers/openit-ingress-1.0.18-0.x86_64.rpm"