PAGE CONTENTS
- Prerequisites for the Dynamic IP Agent Installation
- Downloading and Installing the Dynamic IP Agent
- Uninstalling the Dynamic IP Agent
If you add a Dynamic IP location to WebTitan, you must also install the Dynamic IP Agent on a server or PC on your network so that as the dynamic IP changes, the new IP is automatically updated in WebTitan.
The Dynamic IP Agent installs a task locally in the Windows Scheduler that runs every minute and checks the current external IP. If the IP has changed, the agent contacts WebTitan with the new IP. Each time the IP changes, WebTitan also generates a new location key. The task runs whether or not the user is logged in.
Prerequisites for the Dynamic IP Agent Installation
Below are the prerequisites that must be met or considered before installing WebTitan Dynamic IP Agent. Please read through this information carefully before installation.
The Dynamic IP Agent can be installed on a Windows server or PC on your network. However, it should not be installed on the same machine as the WebTitan OTG agent.
You must have administrative privileges for the machine on which you are installing WebTitan Dynamic IP Agent.
The most recent version of WebTitan Dynamic IP Agent (version 1.3.6) is supported and tested for the following Windows releases:
Supported Deployments
Version Tested with Dynamic IP Agent
Windows Server 2012
Standard Edition, 6.3.9600
Windows Server 2016
Standard Edition, 10.0.14393
Windows Server 2019
Standard Edition, 10.0.17763
Windows Server 2022
Standard Edition, 10.0.20348
Windows 10
Version 20H2 and Version 22H2
Windows 11
Version 22H2
Not prerequisites, but these two items are important to know for after Dynamic IP Agent is installed:
If this installation is on a laptop, you must restart it to complete the installation.
The machine running the Dynamic IP Agent must have AC power plugged in for the agent to work. By default, the scheduled task does not run on battery power.
Downloading and Installing the Dynamic IP Agent
The Dynamic IP Agent can be installed on a Windows server or PC on your network. Before installing, please read the Prerequisites for Dynamic IP Agent installation.
Follow the steps below to download and install the Dynamic IP Agent.
Step 1: Generate or Retrieve a Location Key from WebTitan
When a Dynamic IP location is added to WebTitan a location key is generated. This key is necessary to complete the steps below and install the Dynamic IP Agent.
If you have not already done so, add a Dynamic IP location in WebTitan to generate a location key. Follow the steps in Adding a Dynamic IP Location.
If you have already added the Dynamic IP location, go to Settings > Location > Dynamic IP and retrieve the key from the Location Key column:
Step 2: Download and Install the Dynamic IP Agent
Click here to download the Dynamic IP Agent install file (ipagent.msi). The current version of the Dynamic IP Agent is 1.3.6.
Double click on the install file to launch the installer. The Welcome to the Dynamic IP Agent Setup Wizard window displays - select Next.
The Configuration window displays. Enter your Location Key and WebTitan FQDN/IP (see below):
Location Key: Enter the location key for your Dynamic IP location. See Step 1: Generate or Retrieve a Location Key from WebTitan above.
WebTitan FQDN/IP: Enter either the FQDN or the IP of your WebTitan Cloud. For example, mycloud.webtitancloud.com or 203.0.113.0.
Select Next and the WTC Network Checks window displays. It is recommended to leave these checks enabled, as they catch any issues with communications between WebTitan Cloud and the local network:
Click Next and the Select Installation Folder window displays. It is recommended you install to the default folder. Select Next.
The Confirm Installation window displays. Select Next to start the installation:
Once successfully installed, the Installation Complete window displays. Select Close to exit the installation wizard.
Step 3: After Installation
After completing Steps 1 & 2 above, please ensure the following:
If this installation is on a laptop, you must restart it to complete the installation.
The machine running the Dynamic IP Agent must have AC power plugged in for the agent to work. By default, the scheduled task does not run on battery power.
Uninstalling the Dynamic IP Agent
Follow these steps to uninstall the Dynamic IP Agent:
Open the Add or Remove Programs.
Locate and select Dynamic IP Agent:
Select Uninstall.