Realms
A realm in VTS has two aspects:
• It is a name given to configuration options including protocol (HTTP or WAP) and port (usually 80). Without a realm there will be no port for internet communications.
• It is a group of applications that are logically associated with one another for the purpose of authenticated access from a web browser using a VIC. Without a group of applications, there will be nothing to connect to on the configured port.
These two aspects are illustrated in the realm configuration dialog, as shown:
Realms are required and used by:
• VTS/IS / VIC operations
• ODBC Interface to VTS History
• Web services via SOAP
Any number of realms can be created, and any application can be placed into one or more realms. The name given to the realm is specified as part of the URL used to access the VTS/IS from your web browser. For example, if a realm called "myrealm" was configured on server "myserver.trihedral.com", then the following URL could be used to request authenticated access to the applications in that realm:
http://myserver.trihedral.com/myrealm
If the realm contains one or more standard applications, each attempt to access it will be met with a prompt for the operator’s user name and password. Each application in the realm should have an account which has been granted Internet Client Access.
Note: only one instance of a script application can run at a time – it if is running on the server, it cannot also run on the VIC.
An ActiveX component will be downloaded to the operator’s computer and a session to the VTS application will be established.
Note: The order of the applications in a realm is significant. The first application listed should be running in order for the VIC to make a connection. While it is possible to connect to the application list by using the GUID from a previously successful connection, the length of the GUID makes this inconvenient.
When more than one application is part of a realm, it is good practice to use the same username and password combinations in each. If you do not want an operator who is connecting via a VIC to have access to all the applications, create a separate realm for each application. There is no limit to the number of realms you may configure or to the combination of applications available to a realm
Realms, and the names of the VTS applications belonging to them, are stored within a database file named "Realms.db". This database file exists within the VTS installation directory, and it cannot be manually edited. VTS provides a series of easily configurable dialogs that enable you to establish realms and assign VTS applications to them.
The Realms Dialog