Config.ini [RPCMANAGER-SERVERS] Section Variables
Note: As of VTS 7.5, the \RPCManager\Register subroutine features two new parameters: ServerList and Sticky. ServerList is an optional parameter that is an array of server names for the service. If used, it overrides any server list configuration that has been done in the .INI files. If not used, the usual method of determining the server list is used (see below).
The [RPCMANAGER-SERVERS] section of the Config.ini configuration file can be used to define the primary and backup RPC Manager/configuration servers for your application. As described in RPC Manager Service, the RPC Manager service is a VTS service that manages connections and the synchronization and transfer of data among the multiple workstations that are running your VTS application.
Typically, when you choose to create a new application using the functionality of the VTS Application Manager, you specify the primary server for the application using the Configuration Server Choices area of the New Application Properties dialog. Having done so, the Config.ini configuration file that is generated includes an [RPCMANAGER-SERVERS] section, under which the servers you specified in the New Application Properties dialog appear (in the exact order in which they appear in the New Application Properties dialog). (It should be noted here that the primary configuration server and the RPC Manager primary server are one in the same.)
The first workstation name or IP to appear in the [RPCMANAGER-SERVERS] section is the primary configuration server, or primary RPC Manager server; subsequent workstations in the list are the backup configuration servers or backup RPC Manager servers, and will assume the role of primary RPC Manager server in the event that the primary configuration server is unavailable.
It should be made known that once an application has been created, and the Config.ini configuration file has been generated, you cannot change the list of configuration servers by altering the Configuration Server Choices area of the Application Properties dialog along. If it is your intention to reconfigure the list of configuration servers, you must additionally alter the Config.ini configuration file's [RPCMANAGER-SERVERS] section to match the changes made in the Application Properties dialog.
Note: It is strongly recommended that you use workstation names other than IP addresses when you are specifying configuration servers or service servers, especially in networks where the workstations may be dual-homed, or where dynamic IPs are assigned. Since workstation names are unique, it is good practice to condition yourself to use workstation names, rather than the IP addresses, even if yours system configuration does not currently require the use of workstation names.
In many remote application configurations, you may wish to specify different servers as the primary and backup servers for different services, thereby helping to protect your application from experiencing major disruptions in the event the RPC Manager primary configuration server should fail. Instructions on doing so can be found in Configure Separate Servers for Separate Services.
Configure Separate Servers for Separate
Services