This task shows how to define two backend LDAP servers and a failover load-balancing algorithm. Also, it shows how to connect the load-balancing algorithm to an existing LDAP store adapter named UserStoreAdapter.

Note: The example is simplified and does not discuss SSL connection management. When using SSL to connect to an LDAP external server, you must configure PingAuthorize Server to trust the server certificate presented by the LDAP external server using a trust manager provider.
  1. Run prepare-external-store for each backend LDAP server. This tool creates a service account with the access rights needed by PingAuthorize Server.
    For example:
    prepare-external-store \
      --hostname ds1.example.com \
      --port 636 \
      --useSSL \
      --trustAll \
      --bindDN "cn=directory manager" \
      --bindPassword password \
      --governanceBindDN 'cn=Authorize User,cn=Root DNs,cn=config' \
      --governanceBindPassword password \
      --userStoreBaseDN 'ou=People,dc=example,dc=com'
  2. Create an LDAP external server entry for each backend LDAP server. This configures how PingAuthorize Server connects to each LDAP server.
    For example:
    dsconfig create-external-server \
      --server-name DS1 \
      --type ping-identity-ds \
      --set server-host-name:ds1.example.com \
      --set server-port:636 \
      --set location:Minneapolis \
      --set 'bind-dn:cn=Authorize User, cn=Root DNs,cn=config' \
      --set password:password \
      --set connection-security:ssl \
      --set key-manager-provider:Null \
      --set trust-manager-provider:JKS
    
    dsconfig create-external-server \
      --server-name DS2 \
      --type ping-identity-ds \
      --set server-host-name:ds2.example.com \
      --set server-port:636 \
      --set location:Minneapolis \
      --set 'bind-dn:cn=Authorize User, cn=Root DNs,cn=config' \
      --set password:password \
      --set connection-security:ssl \
      --set key-manager-provider:Null \
      --set trust-manager-provider:JKS
  3. Create a failover load-balancing algorithm that uses the two LDAP external servers.
    For example:
    dsconfig create-load-balancing-algorithm \
      --algorithm-name 'User Store LBA' \
      --type failover \
      --set enabled:true \
      --set backend-server:DS1 \
      --set backend-server:DS2
  4. Assign the load-balancing algorithm to an LDAP store adapter. This example assumes that the store adapter UserStoreAdapter already exists.
    For example:
    dsconfig set-store-adapter-prop \
      --adapter-name UserStoreAdapter \
      --set 'load-balancing-algorithm:User Store LBA'