Configure the server settings for Distributed – Client

If you select Distributed – Client as the security mode for your project, you also need to configure the server settings for that mode.

Before you begin this procedure, you need to have another project that has been (or will be) configured to use Distributed – Server as its security mode. That project will provide the security system configuration for this project. Note the IP address and port number of that project running on its target station.

You are prompted to configure the server settings when you use the Security System Configuration Wizard to configure your project's security for the first time. You can also change the server settings later, in the Security System dialog box.

To configure the server settings:

1. In either the Security System Configuration Wizard or the Security System dialog box, click Server Settings.

   The Server Settings dialog box is displayed.

   

2. In the Server IP and Server Port boxes, enter the IP address and port number of the project that is configured as Distributed – Server.

3. If the Encrypted Channel feature has been enabled in that server's communication settings, you can select the Encrypted Channel option here to force the client to connect to the server using encrypted communication instead of standard, unencrypted communication.

   Selecting this option will automatically change the port number (in the Server Port box) to the default port number for the Encrypted Channel feature, so if that is not the correct port number for that server, correct it now. For more information about the Encrypted Channel feature, see Communication tab.

4. If you want the client (that is, your project) to automatically trust and store the certificate presented by the server, select the Automatically trust server certificate option.

   For more information, see Managing your project's certificate store.

5. Review the advanced settings.

   Connection timeout

   The duration (in seconds) after which the client will stop trying to connect to the server. The default is 3 seconds. A connection can time out if the server is slow to respond or not available at the specified address.

   Synchronization Period

   The period (in seconds) at which the client will try to synchronize with the server and update the local cache. The default is 10 seconds.

   Force Cache Reload

   If you want to force the local cache to reload, enter the name of a project tag (Integer or Boolean type) in this box. When the tag value is TRUE (non-zero), the client will reload the local cache with the server's current information regardless of whether the server cache is outdated (that is, the timestamp on the server cache is older than the timestamp on the local cache).

   Status Tag

   If you want to monitor the status of the security system during project run time, enter the name of a project tag (Integer type) in this box. The specified tag will receive continuously updated values that indicate the status of the client's connection to the server. The possible values are:

   Value	Description
   0	No cache
   1	Updated cache
   2	Outdated local cache
   3	Outdated server cache
   4	Disconnected from server

   For more information, see GetSecuritySystemStatus.

6. In the User Name and Password boxes, enter the credentials for the user account that will be used to log on to the server.

   That user account must be created in the server's project, and it must belong to a group that has the Enable Remote Security System and Remote Debugging Tools option selected. For more information, see Creating and configuring groups.

7. Click OK.