Configuring session affinity for slow drain

Session affinity is configured with the load balancer. It 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. Configure cookies for high availability session affinity for slow drain quiesce by using the following settings.

session/ha/quiesce/customSessionInvalidationMethod

Note: This setting is applicable only when using slow drain for quiesce.
  • 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

Note: This setting is applicable only when using slow drain for quiesce.
  • Value – Name of the cookie to invalidate
  • Functionality – Name of the cookie to invalidate when using the configurable-cookie-invalidator customSessionInvalidationMethod