Server

warning

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

With Ingress Setup

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

warning

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

This assumes that Ingress is properly installed on the same machine where the CLIMS Server will be installed and is accessible. Choose among the upgrade methods:

Upgrading through the Windows Installer Interface

1. Double-click the new installer file.

2. In the setup wizard, click Next.

   

   Welcome Screen

   
   

3. Read and accept the License Agreement, then click Next.

   

   End-User License Agreement

   
   

4. The installer automatically detects the previous installation directories.

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

   

   Destination Folder

   
   

   

   Changing the Installation Directories

   
   

5. Specify a valid Open iT license file, then click Next.

   

   Open iT License File

   
   
   note

   You may skip this step and upload a valid license file through the CLIMS Server web interface afterward.

6. Click Install to start the upgrade process.

   Alternatively, click Back to review any installation setting.

   

   Ready to Install

   
   

7. The installer will set up all necessary files on the computer. Click Finish.

   

   Complete Installation

   
   

Upgrading through the Command Line

1. Open a command prompt with Administrator level privileges.

2. 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>:<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
   
   
   note

   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_5_clims_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_5_clims_x64.msi" /l*v "C:\install.log" /passive LICENSEFILE="C:\Users\OpeniT\Documents\openit_license" INGRESSURI=https://customer.openit.com

To install openit_10_2_5_clims_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_5_clims_x64.msi" /l*v "C:\install.log" /quiet INSTALLDIR="C:\CLIMSServer" DATADIR="C:\CLIMSData"

To install openit_10_2_5_clims_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_5_clims_x64.msi" /l*v "C:\install.log" /passive SERVERPORT="8889"

note

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

warning

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:

Upgrading through the Windows Installer Interface

1. Double-click the new installer file.

2. In the setup wizard, click Next.

   

   Welcome Screen

   
   

3. Read and accept the License Agreement, then click Next.

   

   End-User License Agreement

   
   

4. The installer automatically detects the previous installation directories.

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

   

   Destination Folder

   
   

   

   Changing the Installation Directories

   
   

5. Specify a valid Open iT license file, then click Next.

   

   Open iT License File

   
   
   note

   You may skip this step and upload a valid license file through the CLIMS Server web interface afterward.

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

   
   

7. Click Install to start the upgrade process.

   Alternatively, click Back to review any installation setting.

   

   Ready to Install

   
   

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

   

   Complete Installation

   
   

Upgrading through the Command Line

1. Open a command prompt with Administrator level privileges.

2. 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>:<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
   
   
   note

   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_5_clims_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_5_clims_x64.msi" /l*v "C:\install.log" /passive LICENSEFILE="C:\Users\OpeniT\Documents\openit_license" INGRESSURI=https://customer.openit.com

To install openit_10_2_5_clims_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_5_clims_x64.msi" /l*v "C:\install.log" /quiet INSTALLDIR="C:\CLIMSServer" DATADIR="C:\CLIMSData"

To install openit_10_2_5_clims_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_5_clims_x64.msi" /l*v "C:\install.log" /passive SERVERPORT="8889"

note

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.

Without Ingress Setup

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

Upgrading through the Windows Installer Interface

1. Double-click the new installer file.

2. In the setup wizard, click Next.

   

   Welcome Screen

   
   

3. Read and accept the License Agreement, then click Next.

   

   End-User License Agreement

   
   

4. The installer automatically detects the previous installation directories.

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

   

   Destination Folder

   
   

   

   Changing the Installation Directories

   
   

5. Specify a valid Open iT license file, then click Next.

   

   Open iT License File

   
   
   note

   You may skip this step and upload a valid license file through the CLIMS Server web interface afterward.

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

   
   

7. Click Install to start the upgrade process.

   Alternatively, click Back to review any installation setting.

   

   Ready to Install

   
   

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

   

   Complete Installation

   
   

Upgrading through the Command Line

1. Open a command prompt with Administrator level privileges.

2. 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
   
   
   note

   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_5_clims_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_5_clims_x64.msi" /l*v "C:\install.log" /passive LICENSEFILE="C:\Users\OpeniT\Documents\openit_license"
   
   

   To install openit_10_2_5_clims_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_5_clims_x64.msi" /l*v "C:\install.log" /quiet INSTALLDIR="C:\CLIMSServer" DATADIR="C:\CLIMSData"
   
   

   To install openit_10_2_5_clims_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_5_clims_x64.msi" /l*v "C:\install.log" /passive SERVERPORT="8889"
   note

   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

warning

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