Configuring session affinity

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

Production load balancers offer a range of options for configuring session affinity. Pega Platform supports cookie-based affinity. Configure cookies for high availability session affinity using the following variables.

session/ha/quiesce/customSessionInvalidationMethod

Note: Session affinity configuration is only applicable 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: Session affinity configuration is only applicable 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