Configuring session affinity for slow drain

Session affinity is configured with the load balancer. Session affinity ensures that all requests from a user are handled by the same Pega Platform server.

Session affinity is required in the load balancer for both slow drain and immediate drain quiesce. Immediate drain is the default quiesce method. Pega Platform settings related to cookie invalidation are applicable only for slow drain.

Production load balancers offer a range of options for configuring session affinity. Pega Platform supports cookie-based affinity for slow drain quiesce. For more information, see Slow drain quiesce. Configure cookies for high availability session affinity for slow drain quiesce by using the settings listed in the following table.

Setting Description
session/ha/quiesce/customSessionInvalidationMethod
  • Value – configurable-cookie-invalidator or fully qualified class name of a class implementing the SessionInvalidationMethod in prpublic
  • Functionality – Class name of the invalidation method in use
    • Set to configurable-cookie-invalidator to perform cookie-based invalidation using the value of session/ha/quiesce/cookieToInvalidate as the name of the cookie to invalidate
    • Set to the fully qualified name of a class implementing the interface SessionInvalidationMethod in prpublic
session/ha/quiesce/cookieToInvalidate
  • Value – Name of the cookie to invalidate
  • Functionality – Name of the cookie to invalidate when using the configurable-cookie-invalidator customSessionInvalidationMethod