Specify the connection preference for PI SDK clients

Most PI SDK clients can connect to any server in a collective. However, some of these clients write configuration data to Data Archive. These clients must connect to a primary server. (In a collective, you make configuration changes to the primary server, which sends those changes to all secondary servers.) When you configure a client, you can specify server-type connection preferences:

• Require Primary

  Client must connect to primary server. With this setting, PI SDK returns an error if the primary server is unavailable when trying to connect.

• Prefer Primary

  Client prefers to connect to primary server; if connected to a secondary server, some features may not be available. With this setting, PI SDK always attempts to connect to a primary server first, but will connect to a secondary server if the primary server is unavailable.

• Any

  Client can connect to any server.

  Note: Client-specific connection preferences to require or prefer the primary server override default connection preferences specified in PI Connection Manager. See the client documentation for information about specifying a client-specific connection preference.