Server

warning

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

With Ingress Setup

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

warning

Install Open iT Ingress first before installing App Launcher Server version 10.

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

Upgrading through the Windows Installer Interface

1. Double-click the new installer.

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 directory. Click Change to specify new directories; otherwise, click Next.

   

   Destination Folder

   
   

   

   Changing the Destination Folder

   
   

5. Use the configured port number or specify the desired value.

   Click Next.

   

   Specifying the Port Number

   
   

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> <INSTALLDIR> <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 App Launcher Server will connect to; follow the http(s)://<ingress_hostname>:<ingress_port_number> format
   <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\Launcher
   <SERVERPORT>	Use this optional property to specify the port number of the website; the default value is 81

   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 OpeniTLauncherServer_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 directory and https://customer.openit.com as the Ingress URI:

Example 1

msiexec /i "C:\Installers\OpeniTLauncherServer_x64.msi" /l*v "C:\install.log" /passive INGRESSURI=https://customer.openit.com

To install OpeniTLauncherServer_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 port number:

Example 2

msiexec /i "C:\Installers\OpeniTLauncherServer_x64.msi" /l*v "C:\install.log" /quiet INSTALLDIR="C:\AppLauncherServer"

To install OpeniTLauncherServer_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 directory and 82 as the port number:

Example 3

msiexec /i "C:\Installers\OpeniTLauncherServer_x64.msi /l*v "C:\install.log" /passive SERVERPORT="82"

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 App Launcher Server.

Use this guide if Ingress is installed remotely or on a separate machine than the App Launcher 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.

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 directory. Click Change to specify new directories; otherwise, click Next.

   

   Destination Folder

   
   

   

   Changing the Destination Folder

   
   

5. Use the configured port number or specify the desired value.

   Click Next.

   

   Specifying the Port Number

   
   

6. Specify the Open iT Ingress URI where the App Launcher 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 Continue 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> <INSTALLDIR> <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 App Launcher Server will connect to; follow the http(s)://<ingress_hostname>:<ingress_port_number> format
   <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\Launcher
   <SERVERPORT>	Use this optional property to specify the port number of the website; the default value is 81

   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 OpeniTLauncherServer_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 directory and https://customer.openit.com as the Ingress URI:

Example 1

msiexec /i "C:\Installers\OpeniTLauncherServer_x64.msi" /l*v "C:\install.log" /passive INGRESSURI=https://customer.openit.com

To install OpeniTLauncherServer_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 port number:

Example 2

msiexec /i "C:\Installers\OpeniTLauncherServer_x64.msi" /l*v "C:\install.log" /quiet INSTALLDIR="C:\AppLauncherServer"

To install OpeniTLauncherServer_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 directory and 82 as the port number:

Example 3

msiexec /i "C:\Installers\OpeniTLauncherServer_x64.msi /l*v "C:\install.log" /passive SERVERPORT="82"

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 App Launcher 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.

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 directory. Click Change to specify new directories; otherwise, click Next.

   

   Destination Folder

   
   

   

   Changing the Destination Folder

   
   

5. Use the configured port number or specify the desired value.

   Click Next.

   

   Specifying the Port Number

   
   

6. Click Next to skip the prompt for specifying the Open iT Ingress URI.

   

   Ingress URI Details

   
   

   Click Continue 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] <INSTALLDIR> <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
   <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\Launcher
   <SERVERPORT>	Use this optional property to specify the port number of the website; the default value is 81

   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 OpeniTLauncherServer_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 directory and port number:

Example 1

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

To install OpeniTLauncherServer_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 port number:

Example 2

msiexec /i "C:\Installers\OpeniTLauncherServer_x64.msi" /l*v "C:\install.log" /quiet INSTALLDIR="C:\AppLauncherServer"

To install OpeniTLauncherServer_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 directory and 82 as the port number:

Example 3

msiexec /i "C:\Installers\OpeniTLauncherServer_x64.msi /l*v "C:\install.log" /passive SERVERPORT="82"

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 Application Launcher Server Installation

warning

If you upgraded the App Launcher Server first and then installed Ingress later, proceed with manually configuring the Application Launcher connection to Ingress.