PingDirectory

Configuring server locations

About this task

PingDataSync supports endpoint failover, which is configurable using the location property on the external servers. By default, the server prefers to connect to, and failover to, endpoints in the same location as itself. If there are no location settings configured, PingDataSync will iterate through the configured list of external servers on the Sync Source and Sync Destination when failing over.

Location-based failover is only applicable for LDAP endpoint servers.

Steps

  1. On PingDataSync, run the dsconfig command to set the location for each external server in the Sync Source and Sync Destination. For example, the following command sets the location for six servers in two data centers, austin and dallas.

    $ bin/dsconfig set-external-server-prop \
      --server-name example.com:1389 \
      --set location:austin
    $ bin/dsconfig set-external-server-prop \
      --server-name example.com:2389 \
      --set location:austin
    $ bin/dsconfig set-external-server-prop \
      --server-name example.com:3389 \
      --set location:austin
    $ bin/dsconfig set-external-server-prop \
      --server-name example.com:4389 \
      --set location:dallas
    $ bin/dsconfig set-external-server-prop \
      --server-name example.com:5389 \
      --set location:dallas
    $ bin/dsconfig set-external-server-prop \
      --server-name example.com:6389 \
      --set location:dallas
  2. Run dsconfig to set the location on the Global Configuration. This is the location of PingDataSync itself. In this example, set the location to austin.

    $ bin/dsconfig set-global-configuration-prop \
      --set location:austin