# Server Upgrade

Enable Application Initialization in Internet Information Services (IIS) first before upgrading the CLIMS Server.

# Without Ingress Setup (Standalone CLIMS)

Use this guide if the CLIMS Server will be standalone and no connection to Ingress will be made. Choose among the upgrade methods:

Double-click the new installer file.
In the setup wizard, click Next.

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

End-User License Agreement
The installer automatically detects the previous installation directories.

Click Change to specify new directories; otherwise, click Next.

Destination Folder

Changing the Installation Directories
Specify a valid Open iT license file, then click Next.

Open iT License File

You may skip this step and upload a valid license file through the CLIMS Server web interface afterward.
Click Next to skip the prompt for specifying the Open iT Ingress URI.

Ingress URI Details

Click Yes to proceed with the installation.

Warning for Inaccessible Ingress URI
Click Install to start the upgrade 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

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] <LICENSEFILE> <INSTALLDIR> <DATADIR> <SERVERPORT>

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
`<LICENSEFILE>`	Use this optional property to specify the location and name of a valid Open iT license file
`<INSTALLDIR>`	Use this optional property to specify the path where the Open iT files will be installed; the default path is `C:\Program Files\OpeniT\Zero`
`<DATADIR>`	Use this optional property to specify the path where the database will be stored; the default path is `C:\Program Files\OpeniT\Zero\RavenDB\RavenData`
`<SERVERPORT>`	Use this optional property to specify the port number of the website; the default value is 8888

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 install openit_10_2_0_clims_server_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 license file, C:\Users\OpeniT\Documents\openit_license, and the default directories and port number:

Example 1
msiexec /i "C:\Installers\openit_10_2_0_clims_server_x64.msi" /l*v "C:\install.log" /passive LICENSEFILE="C:\Users\OpeniT\Documents\openit_license"

To install openit_10_2_0_clims_server_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 and data directories and default port number:

Example 2
msiexec /i "C:\Installers\openit_10_2_0_clims_server_x64.msi" /l*v "C:\install.log" /quiet INSTALLDIR="C:\CLIMSServer" DATADIR="C:\CLIMSData"

To install openit_10_2_0_clims_server_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 directories and 8889 as the port number:

Example 3
msiexec /i "C:\Installers\openit_10_2_0_clims_server_x64.msi" /l*v "C:\install.log" /passive SERVERPORT="8889"

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.

# With Ingress Setup

Use this guide if the CLIMS Server will connect to Ingress (local or remote).

# Local Ingress Setup

Install Open iT Ingress first before upgrading to CLIMS Server version 10.

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

Double-click the new installer file.
In the setup wizard, click Next.

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

End-User License Agreement
The installer automatically detects the previous installation directories.

Click Change to specify new directories; otherwise, click Next.

Destination Folder

Changing the Installation Directories
Specify a valid Open iT license file, then click Next.

Open iT License File

You may skip this step and upload a valid license file through the CLIMS Server web interface afterward.
Click Install to start the upgrade 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

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] <INGRESSURI> <LICENSEFILE> <INSTALLDIR> <DATADIR> <SERVERPORT>

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
`<INGRESSURI>`	Use this optional property to specify the Open iT Ingress URI where the CLIMS Server will connect to; follow the `http(s)://<ingress_hostname>:<ingress_port_number>` format
`<LICENSEFILE>`	Use this optional property to specify the location and name of a valid Open iT license file
`<INSTALLDIR>`	Use this optional property to specify the path where the Open iT files will be installed; the default path is `C:\Program Files\OpeniT\Zero`
`<DATADIR>`	Use this optional property to specify the path where the database will be stored; the default path is `C:\Program Files\OpeniT\Zero\RavenDB\RavenData`
`<SERVERPORT>`	Use this optional property to specify the port number of the website; the default value is 8888

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 install openit_10_2_0_clims_server_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 license file, C:\Users\OpeniT\Documents\openit_license, default directories and port number, and https://customer.openit.com as the Ingress URI:

Example 1
msiexec /i "C:\Installers\openit_10_2_0_clims_server_x64.msi" /l*v "C:\install.log" /passive LICENSEFILE="C:\Users\OpeniT\Documents\openit_license" INGRESSURI=https://customer.openit.com

Example 2
msiexec /i "C:\Installers\openit_10_2_0_clims_server_x64.msi" /l*v "C:\install.log" /quiet INSTALLDIR="C:\CLIMSServer" DATADIR="C:\CLIMSData"

Example 3
msiexec /i "C:\Installers\openit_10_2_0_clims_server_x64.msi" /l*v "C:\install.log" /passive SERVERPORT="8889"

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.

# Remote Ingress Setup

Install Open iT Ingress first before upgrading to CLIMS Server version 10.

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

Double-click the new installer file.
In the setup wizard, click Next.

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

End-User License Agreement
The installer automatically detects the previous installation directories.

Click Change to specify new directories; otherwise, click Next.

Destination Folder

Changing the Installation Directories
Specify a valid Open iT license file, then click Next.

Open iT License File

You may skip this step and upload a valid license file through the CLIMS Server web interface afterward.
Specify the Open iT Ingress URI where the CLIMS Server will connect to, then click Next.

Ingress URI Details

A warning prompt will appear if the Open iT Ingress is inaccessible. This may also occur if Open iT Ingress is not yet installed.

Click Yes to proceed with the installation.

Warning for Inaccessible Ingress URI
Click Install to start the upgrade 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

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] <INGRESSURI> <LICENSEFILE> <INSTALLDIR> <DATADIR> <SERVERPORT>

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
`<INGRESSURI>`	Use this optional property to specify the Open iT Ingress URI where the CLIMS Server will connect to; follow the `http(s)://<ingress_hostname>:<ingress_port_number>` format
`<LICENSEFILE>`	Use this optional property to specify the location and name of a valid Open iT license file
`<INSTALLDIR>`	Use this optional property to specify the path where the Open iT files will be installed; the default path is `C:\Program Files\OpeniT\Zero`
`<DATADIR>`	Use this optional property to specify the path where the database will be stored; the default path is `C:\Program Files\OpeniT\Zero\RavenDB\RavenData`
`<SERVERPORT>`	Use this optional property to specify the port number of the website; the default value is 8888

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 install openit_10_2_0_clims_server_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 license file, C:\Users\OpeniT\Documents\openit_license, default directories and port number, and https://customer.openit.com as the Ingress URI:

Example 1
msiexec /i "C:\Installers\openit_10_2_0_clims_server_x64.msi" /l*v "C:\install.log" /passive LICENSEFILE="C:\Users\OpeniT\Documents\openit_license" INGRESSURI=https://customer.openit.com

Example 2
msiexec /i "C:\Installers\openit_10_2_0_clims_server_x64.msi" /l*v "C:\install.log" /quiet INSTALLDIR="C:\CLIMSServer" DATADIR="C:\CLIMSData"

Example 3
msiexec /i "C:\Installers\openit_10_2_0_clims_server_x64.msi" /l*v "C:\install.log" /passive SERVERPORT="8889"

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.

# Next Steps?

After upgrading, proceed with verifying the upgrade.

Verifying CLIMS Server Installation

If you upgraded to CLIMS Server version 10 first and then installed Ingress later, proceed with manually configuring the CLIMS Server connection to Ingress.