Health-Based Routing (HBR) Session Agent

Health-Based Routing (HBR) is a pipeline agent that monitors the health of the downstream canisters and can dynamically route sessions to those canisters based upon their health. HBR works even with a single processing server and can monitor up to a maximum of 20 processing servers. HBR is supported from version 12.1.0.3 onwards.

Note: For some deployments of the Processing Server, this session agent is included in the default pipeline and is required.

HBR determines the processing server health by communicating with the processing server SearchServer and gets the Governor/Canister status (i.e., http://processingserver:19000/GovernorStatusEx); Processing server health is determined if the processing server is spooling, if it is not spooling HBR assumes that it can continue to take traffic for existing sessions and new sessions. If HBR determines that the processing server is spooling, then it will continue to send traffic for existing sessions (HBR tries to maintain session fidelity per canister) but will not start any new sessions for that processing server till it has recovered from its spool condition.

This section describes how to add and configure the Health-Based Routing session agent.

Note: If you selected to install HBR during through the Discover installer, HBR is automatically configured for you. This section is useful if you are adding HBR or modifying an existing HBR after installation is complete.

Prerequisites

Note: A local instance of Search Server must be started before HBR is initialized. HBR uses Search Server to perform a Governor Status assessment on the local machine. Both services are available through the Canister Services utility (CanSvcs.exe), which should be used to start and stop these services.

Adding the Session Agent

Session agents can be added through the Pipeline Editor in Manage Services. See Discover Administration Manual.

  • For more information on the Pipeline Editor and Manage Services, see "Discover Management System" in the Discover Administration Manual.

The remainder of this page describes configuration options and how to change them through the DiscoverCaptureSocket.cfg file stored on the server. These settings are also available through the Pipeline Editor, which is the recommended method for configuring session agents.