PingDirectory

Configuring server affinity

About this task

The PingDirectoryProxy server supports the ability to forward a sequence of requests to the same external server if specific conditions are met. This feature, called server affinity, is applied by the load balancing algorithms. The following server affinity methods are available in the PingDirectoryProxy server:

  • Client Connection. Requests from the same PingDirectoryProxy server client connection are consistently routed to the same external server.

  • Client IP. PingDirectoryProxy server client requests coming from the same client IP address are routed to the same external server.

  • Bind DN. Requests from all client connections authenticated as the same bind DN are routed to the same external server.

For each algorithm, you can specify the set of operations for which an affinity will be established, as well as the set of operations for which affinity will be used. Affinity assignments have a time-out value so that they are in effect for some period of time after the last operation that might cause the affinity to be set or updated.

In this example, we create a bind DN server affinity provider for any client requesting write operations to have subsequent requests, whether read or write, forwarded to the same external server. The affinity period will last for 30 seconds after the last write request.

Steps

  1. Use the dsconfig tool to configure server affinity. Specify the host name, connection method, port number, and bind DN as described in previous procedures.

    Example:

    $ bin/dsconfig
  2. In the PingDirectoryProxy server main menu, enter the number associated with server affinity provider configuration

  3. On the Server Affinity menu, enter the number corresponding to creating a new server affinity provider.

  4. Enter a name for your new server affinity provider.

    Example:

    >>>> Enter a name for the Bind DN Server Affinity Provider
    that you want to create: Affinity for Writing Applications
  5. Indicate whether you want the server affinity provider to be enabled for use by the Directory Proxy Server. In this example, enter 1 to enable to the server affinity provider.

  6. Next, configure the properties of the server affinity provider. For example, you can customize the types of operations for which affinity can be set and the types of operations for which affinity can be used, as well as the length of time for which the affinity should persist. This example illustrates the properties of the bind DN server affinity provider.

    Example:

    >>>> >>>> Configure the properties of the Bind DN Server Affinity Provider
    
            Property                  Value(s)
            ----------------------------------------------------------
        1)  description               -
        2)  enable                    true
        3)  affinity-duration         30 s
        4)  set-affinity-operation    add, delete, modify, modify-dn
        5)  use-affinity-operation    add, bind, compare, delete, modify,
                                      modify-dn, search
    
        ?)  help
        f)  finish - create the new Bind DN Server Affinity Provider
        d)  display the equivalent dsconfig arguments to create this object
        b)  back
        q)  quit
    
    Enter choice [b]:
  7. Review the properties of the server affinity provider. If you are satisfied, enter f to finish. After it has been defined, the affinity provider can now be assigned to a load balancing algorithm.