Downloading and Installing OTG for Windows
Read Before Installing OTG for Windows to understand some important prerequisites before following the steps below to download and install OTG.
Click here to download the Windows OTG install file (setup.msi). The current version of OTG for Windows is 1.6.15.
Ensure you are logged in with Administrator privileges.
Go to the command prompt. OTG is installed from the command prompt for both a single install or multiple installs across your network using your preferred deployment method, e.g. group policy.
Change directory so you are in the same directory as the setup.msi file downloaded in step 1.
Important
The installation requires you to provide your WebTitan Cloud login credentials as parameters. This allows for the automatic creation of your Roaming Locations in WebTitan Cloud. These parameters are used once and not stored.
During installation, an administrator must create a command script based on the sample shown below with parameters edited for your WebTitan Cloud. When passed to OTG, these details create the roaming location key for this device.
There are four required parameters described in the table below that must be edited. There are also several optional parameters described further down this page.
setup.msi /quiet /qb WTC_SERVER_URL=http://mycloud.webtitancloud.com:8080 DNS_RESOLVER=1.2.3.4 CUSTOMER_EMAIL=docs@titanhq.com CUSTOMER_PASSWORD=iXdrEPx32aThe command must be on a single line with no line breaks.
Required Parameters:
Parameter
Description
Example
WTC_SERVER_URL
The URL and 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 e.g.
nslookup 1.2.3.4http://wtc1.webtitancloud.com:8080DNS_RESOLVER
The IP address(es) of the WebTitan Cloud DNS resolver to send DNS requests to.
1.2.3.4CUSTOMER_EMAIL
The email address for the customer account under which the roaming location will be added.
docs@titanhq.comCUSTOMER_PASSWORD
The password previously created for the customer account under which the roaming location will be added.
iXdrEPx32aEnter your custom script at the command prompt and press Enter.
After Installing OTG for Windows
There are a number of things to note after OTG installation:
Assuming your current external IP address is not configured to be bypassed, OTG will connect to your WebTitan Cloud account and start filtering.
After installation, OTG connects to WebTitan Cloud and creates a new roaming location and a new user. The user will have a unique identifier made from the username@machine-name, e.g. docs@TRAINING-PC. If the PC is a member of a domain, then the user identifier will be the username appended with the domain name.
Users created via OTG are assigned the default customer policy, but this can be changed to a new or different policy as required - see Policies for more information.
OTG automatically downloads and installs the WebTitan Cloud SSL certificate to the Windows trusted certificates (also Firefox’s if installed). This allows the WebTitan Cloud block page for HTTPS sites to be shown without an error.
Optional OTG Installation Parameters
When creating your command line script for installing OTG, as well as the four required parameters there are also several optional parameters which you can use:
Parameter | Description |
|---|---|
LOCATION_NAME | When creating a roaming location, OTG assigns the Windows or Mac computer name by default. To change this you can specify a LOCATION_NAME value. LOCATION_NAME should not be used if installing multiple OTGs, as the roaming location names must be unique. Example: |
LOCATION_NAME_SUFFIX | If specified, a LOCATION_NAME_SUFFIX is appended to the LOCATION_NAME and separated using '@', e.g LOCATION_NAME@LOCATION_NAME_SUFFIX LOCATION_NAME and LOCATION_NAME_SUFFIX should not be used together if installing multiple OTGs, as the roaming location names must be unique. Example: |
BYPASS_IPS | A remote user may visit a location (e.g. main office) which is also using WebTitan Cloud or any other internal filtering solution for filtering. In this case, you may want OTG to be disabled while there. To do this, the office's public facing IP can be added to a list of bypass IP when OTG is installed. When the user leaves the office, OTG will detect the IP change and start filtering again. When OTG is in bypass mode, the OTG tray icon will show "status: ignored". To bypass multiple IPs (e.g. several locations) use a comma to separate them: Example: To bypass a range of IPs use a hyphen to separate the two addresses: Example: |
TRAY_TYPE | Controls the WebTitan Cloud OTG information, logo and popup notifications in the Windows system tray or macOS menu bar. Values can be:
Example: |
DYNAMIC_FORWARD | Used conditionally forward requests for particular domains to specific DNS servers, based on the current external IP address. This is useful if you want to treat domains differently depending on where the user is, e.g. if a company's internal domain is the same name as its external domain and where access to the local office resources are impacted if routed externally. The format is: DYNAMIC_FORWARD= [site]@[external IP]-[Resolvers, …]; Example: When external IP is and When external IP is |
FORWARD_DOMAIN | Unconditionally forward any requests for the local domain to a local DNS server (rather than to WebTitan Cloud). If enabled, on startup OTG will attempt to get the name of local domain and will store the DNS settings provided, for example by the DHCP server of that local domain. When OTG detects requests for the local domain (or subdomains), it doesn't send them to WebTitan Cloud, but to the stored IP of the local DNS server. Can be set either true or false, e.g. |
RPC_PORT | Allows OTG to specify a port for communication with WebTitan Cloud other than the default 7771. NoteIf this parameter is supplied, private cloud WebTitan Cloud servers must also be configured to listen on the port specified. Example: |