Install the Web Tunneling Gateway

The Web Tunneling Gateway (WTG, or IndWebSvc) enables an Internet-connected computer — typically your web server — to route data between a project runtime server that is not connected to the Internet and remote thin clients. This section describes how to install WTG.

Before you begin this task, you should first set up Microsoft Internet Information Services (IIS) as a web server to host your project pages. WTG can run only on IIS.

Also, your web server must be connected to the Internet and have a static IP address, rather than a dynamically assigned IP address. Consult your IT department or Internet service provider about how to get a static IP address.

Finally, your web server and project runtime server both must be on the same internal TCP/IP network, even if only your web server is connected to the Internet.

In order for thin clients to access your project, they must be able to communicate with both the web server that is hosting your project pages and the project runtime server that is actually running your AVEVA Edge project. This is not a problem if your servers and clients are all on the same internal network, nor if you connect both of your servers to the Internet so that remote thin clients can communicate with them.

However, if you choose not to connect your project runtime server to the Internet (for network security or topology reasons), you must route the project data through another computer that is connected.

WTG provides these routing capabilities. It is an ISAPI extension for Microsoft IIS, and it is typically installed on the same web server that is hosting your project pages. It encapsulates the packets sent between the project runtime server and the thin clients, thereby ensuring project security, and it can route data for multiple servers at the same time.

Please note that these instructions apply only to the following versions of IIS:

To install the Web Tunneling Gateway:

1. On your web server (or whichever Internet-connected computer that will act as the gateway), make sure Microsoft IIS is running and ISAPI Extensions are enabled.

   For more information, see Configuring a web server to host your project pages.

2. Locate the Web Tunneling Gateway software installer in your program folder.

   The default location on your computer of the Web Tunneling Gateway software installer is: C:\Program Files (x86)\AVEVA\AVEVA Edge 2026\Redist\WebAddOn\IIS\WebTunnelingGatewaySetup.exe

3. Copy the Web Tunneling Gateway software installer to the "root" directory of your website (such as C:\inetpub\wwwroot\).

   Assuming your web server has a network connection — which it should, if you plan to use it as a web server — you can simply copy the installer across the network. Otherwise, copy the installer to a USB flash drive and then carry it to the web server.

4. Run the installer, and then proceed through the installation wizard.

   There are no options to select.

   The installer will create a new directory in the website's "root" directory and install the WTG extension files there. It will also create a new application pool.

5. Open the Administrative Tools control panel in Windows (Control Panel > System and Security > Administrative Tools), and then double-click Internet Information Services (IIS) Manager.

   The Internet Information Services (IIS) Manager window is displayed.

6. Make sure the application pool was created by the installer.

   1. In the Connections pane, expand the server node and click Application Pools.

   2. On the Application Pools page, in the list of pools, look for IndWebSvcPool.

   If IndWebSvcPool is not in the list, the WTG installer did not finish correctly. Return to the beginning of this task.

7. Add an ISAPI restriction for IndWebSvc.

   1. In the Connections pane, click the server node.

   2. On the server node's Home page, double-click ISAPI and CGI Restrictions.

   3. On the ISAPI and CGI Restrictions page, in the Actions pane, click Add.

      The Add ISAPI or CGI Restriction dialog is displayed.

   4. In the ISAPI or CGI path box, type the path to the file IndWebSvc.dll (such as C:\inetpub\wwwroot\indwebsvc\IndWebSvc.dll), or click the browse button (…) and navigate to the file.

   5. In the Description box, type IndWebSvc.

   6. Select Allow extension path to execute.

   7. Click OK.

8. Configure the website's handler mappings to make ISAPI extension files executable.

   1. In the Connections pane, expand Sites, and then click the website that is acting as the gateway (that is, typically Default Web Site, or whichever site is hosting your AVEVA Edge project pages).

   2. On the website's Home page, double-click Handler Mappings.

   3. On the Handler Mappings page, in the list of mappings, select ISAPI-dll.

      This item is disabled by default.

   4. In the Actions pane, click Edit Feature Permissions.

      The Edit Feature Permissions dialog is displayed.

   5. Select Execute.

   6. Click OK.

9. Make sure the website and the gateway extension are running — on the server, start Internet Explorer, and then go to: http://127.0.0.1/indwebsvc/indwebsvc.dll

   127.0.0.1 is the "localhost" or "loopback" address, so the browser is looking at the website that is running on the same computer.

   The resulting webpage should look like this:

   Studio Web Gateway

   Status: Ok

   Version: 1.3

   Active Connections: 0

   If you do not see this, either the website is not running or the gateway extension was not correctly configured. Return to the beginning of this task.

10. Close IIS Manager.

11. Configure your project to include the address of the gateway.

    For more information, see Configure project settings for Web Thin Client.