The steps below describe a command-line installation of WebTitan OTG for Windows on a single machine. As part of the installation, you need to create a command script. The installation instructions provide a sample script that you can edit with your own parameters.

You can also watch this video for an overview of the steps below:

  1. Click here to download the WebTitan OTG for Windows install file (setup.msi). The current version of OTG for Windows is 2.1.4. You need to know what folder this install file saves to in later steps (default: Downloads folder).

  2. Retrieve your OTG install key from WebTitan Cloud. Go to Settings > Device Configuration and note the OTG Install Key:

  3. Open a command prompt with administrator privileges:

    • Click into your taskbar search box and type cmd.

    • Right-click on Command Prompt and choose Run as Administrator.

    • Click Yes and the command prompt opens running with administrator privileges.

  4. From the command prompt, change directory to the same directory as the install file you downloaded to in Step 1. To change directory, type cd followed by the file path you want to change to. For example:

    cd c:\users\yourusername\downloads\

  5. Next, create the command script for installation. Base your script on the example shown below, but edited with your own parameters.

    msiexec /i setup.msi /qn /passive /L* installer_log.log PREFER_MASTER_CONFIG=true RPC_URL=https://your-otg-url.webtitancloud.com:7771 INSTALL_KEY=00000z0z-0zz0-0000-zz0z-0zz000z0zz0z

    • There are three required parameters described in the table below that must be edited when creating your own script. There are also additional optional parameters that you can use during installation - see OTG Installation Parameters.

    • It is recommended that you use the FULL_CLEAN optional parameter in your OTG 2 install script if you are moving from OTG 1 to OTG 2 to fully clear OTG 1 files.

    • The command must be on a single line with no line breaks.

    • /qn, /passive or /quiet are required msiexec options. See MSI Installation Options for more information on msiexec options.

    Required Parameter

    Description

    Example

    RPC_URL

    Your WebTitan OTG URL and (optional) port number. See WebTitan OTG URLs to determine your OTG URL.

    The RPC port is always port 7771 and is automatically added if not included in the RPC_URL parameter. The example(s) show the accepted formats.

    your-otg-url.webtitancloud.com

    your-otg-url.webtitancloud.com:7771

    https://your-otg-url.webtitancloud.com

    https://your-otg-url.webtitancloud.com:7771

    https://your-otg-url.webtitancloud.com:7771/

    INSTALL_KEY

    This is the OTG install key used to register an OTG device on WebTitan. You can get this in WebTitan from Settings > Device Configuration and noting the OTG Install Key.

    00000z0z-0zz0-0000-zz0z-0zz000z0zz0z

    PREFER_MASTER_CONFIG

    This parameter ensures that your device count is accurate and duplicates are not created.

    PREFER_MASTER_CONFIG looks for an existing config file on the device OTG is being installed to. If found, that configuration is used. Otherwise, a new device is created with the parameters provided.

    true

    Warning

    Value is case sensitive, so true is valid, but True is invalid.

  6. Copy and paste your install script into the command prompt window.

  7. Press Enter and an install progress window displays. Allow this to complete.

  8. When installation has successfully completed, a WebTitan icon displays in your taskbar showing Status: Connected.

  9. Restarting your machine is recommended after installation.

  10. Close the command prompt window.

Once the steps above are complete, the best way to verify the installation is to check that a device and the associated user and location have been added to your WebTitan in Environment > Devices.