Skip to main content

WebTitan

OTG 2 Installation Parameters

Abstract

A detailed description, with examples, of the required and optional parameters needed when creating a command line script to install WebTitan OTG 2.

When creating your command line script for OTG 2 installation, as well as the required parameters there are also several optional parameters that you can use.

Required Parameter

Description

Example

RPC_URL

The URL and (optional) port number of your WebTitan Cloud instance. You can get the FQDN by opening a command prompt in windows and typing nslookup followed by the IP of your WebTitan Cloud. For example, nslookup 1.2.3.4.

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

wtc1.webtitancloud.com

wtc1.webtitancloud.com:7771

https://wtc1.webtitancloud.com

https://wtc1.webtitancloud.com:7771

https://wtc1.webtitancloud.com:7771/

INSTALL_KEY

This is the OTG install key used to register an OTG 2 device on WebTitan Cloud. You can get this in your WebTitan Cloud from Settings > Account 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 in WebTitan.

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.

Optional Parameter

Description

Example

DEVICE_NAME_PREFIX

This is an optional prefix that can be used to help with device identification in WebTitan. For example, if DEVICE_NAME_PREFIX is specified as 'sales' for a group installation, all devices are given the prefix 'sales', e.g. sales-example1.comp, sales-example2.comp.

DEVICE_NAME_PREFIX=sales

DEVICE_NAME

If a DEVICE_NAME is not provided, the installer uses the machine name, e.g. example_laptop.comp.

If a DEVICE_NAME is provided, this is the name used when registering a device on WebTitan during installation, e.g. training_laptop.

If a device name is specified, but already in use in WebTitan, a randomized number is appended to make the device name unique, e.g. example.comp#12345123451234.

DEVICE_NAME=training_laptop

LOCATION_NAME

When OTG 2 is installed, a virtual location is automatically created for a device on WebTitan and given a default name. However, you can specify a location name to use with the LOCATION_NAME parameter on install.

A virtual location can either be created on WebTitan before installation and then the name can be used in this parameter, or, if not already created, the virtual location is created and assigned the name given in this parameter on install.

LOCATION_NAME=Training-PC

DEVICE_KEY

To locate an individual device key WebTitan Cloud, go to Settings > Devices and click the edit ST-701-edit-button.jpg icon for a device. The device key is listed on the Status tab.

The DEVICE_KEY is used to identify a single device and is typically used during re-installation. It can be added manually, or from the RPC call with the INSTALL_KEY parameter.

DEVICE_KEY is not used in multiple-user rollouts.

DEVICE_KEY and INSTALL_KEY are mutually exclusive, so can not be used together.

0a0a000a-0aa0-0a00-aa00-00a0aaaa0000

HIDE_TRAY_ICON

Note

HIDE_TRAY_ICON works with WebTitan OTG 2 for Windows version 2.0.3 or later.

Use this parameter on installation to hide the OTG 2 OTG-W2-tray-icon.jpg icon from the system tray on a user machine.

HIDE_TRAY_ICON=hide

FULL_CLEAN

This parameter removes configuration and log files from previous installations and can be used if you want a clean install. A new virtual location and device is created on install. The following folders are removed:

  • c:\program files (x86)\Webtitan Cloud OTG

  • c:\programdata\webtitan cloud otg

FULL_CLEAN=True