Establishing a Realm

VTS facilitates the configuration of realms on the VTS/IS using the VTS Internet Client/Server Setup dialog that is launched at a click of the VAM's Internet Setup button. The instructions below will assist you in the configuration of realms.

 

1.   In the VTS Application Manager, click the Internet Setup button. The VTS Internet Client/Server Setup dialog opens.

2.   Click the Add button in the Authorization Realms section of the dialog. The Add Realm dialog opens.

3.   Enter a meaningful name for the realm in the Realm Name field. Realm names should not include spaces. You may wish to use the hyphen character (-) to separate characters (e.g. "TELRealm", or "TEL-Realm").

4.   Enable the HTTP protocol.  (A WAP protocol for wireless devices is also available.)

5.   Enter the port number you wish VTS/IS to use to enable transfers to VICs. The default port number is 80, the standard Hypertext Transfer Protocol (HTTP) port. If you are using SSL, you must first have obtained an SSL certificate (see SSL Certificates), and installed it. Supply the SSL standard port number of 443, in this case, and check the SSL checkbox. If this checkbox is disabled, you need to supply the host + domain name for the SSL certificate in VTS's Setup.ini configuration file (located in the installation directory). Add the following line to the [SYSTEM] section:

SSLCertName = <host+domain>

where <host+domain> is the host and domain name you specified when obtaining an X.509-compliant SSL certificate. (Do not include the angle brackets.) This must exactly match the "CN=" field of your SSL certificate. After modifying the Setup.ini configuration file, you must stop and restart VTS for your change to take effect.

Each realm configured under VTS must be associated with a TCP port number.  You can configure any port number you wish, however, if operating over a public network (e.g. the Internet), you will likely have to traverse firewalls and other security mechanisms. Configuring a realm or VTS/IS to operate on other than the standard ports (port 80 for plain text HTTP, or port 443 for SSL-secured HTTPS), will likely require special configuration of such interposing security mechanisms. It is therefore advisable to operate on the standard ports whenever possible.

6.   Click the OK button. The new realm is created, and you are returned to the VTS Internet Client/Server Setup dialog where the new realm appears in the Realm drop-down list. An example is displayed below.

7.   Click the Add button in the Applications Available On section of the VTS Internet Client/Server Setup dialog. The Add Application dialog opens as shown.

8.   Select the VTS application you wish to add to this realm from the Application drop-down list. Note: The first VTS application added to this realm is the default application for the realm. A connection is automatically attempted to the default application if a partially specified URL is provided to your web browser. For example:

http://myserver.trihedral.com/myrealm

is a partially specified URL, containing only the protocol (http), host (myserver), domain name (trihedral.com), and realm (myrealm). For more details about specifying URLs for use with VTS/IS, see Syntax of VIC Requests.

 

9.   Click the OK button. You are returned to the VTS Internet Client/Server Setup dialog where the selected application has been added to the realm.

10. Repeat steps 8 through 10 to add as many VTS applications (both standard and script applications) as you wish for this realm. The completed VTS Internet Client/Server Setup dialog will appear similar to the example below.

11. Click the OK button. VTS generates a Realms.db database file in the VTS installation directory, adds the realm configuration to it, and resets the configured port(s).