Load-balance Endpoint

The Load-balanced Endpoint distributes the messages (load) arriving at it among a set of listed endpoints or static members by evaluating the load balancing policy and any other relevant parameters.

XML Configuration

<session type="http|simpleClientSession"/>?
<loadBalance [policy="roundRobin"] [algorithm="impl of org.apache.synapse.endpoints.algorithms.LoadbalanceAlgorithm"]
        [failover="true|false"]>
    <endpoint .../>+
    <member hostName="host" [httpPort="port"] [httpsPort="port2"]>+
</loadBalance>

The Load-balance attributes and elements:

• The policy attribute of the load balance element specifies the load balance policy (algorithm) to be used for selecting the target endpoint or static member.

• The failover attribute determines if the next endpoint or static member should be selected once the currently selected endpoint or static member has failed, and defaults to true.

• The loadBalance element allows to list the set of endpoints or static members among which the load has to be distributed. These endpoints can belong to any endpoint type (see Address Endpoint, WSDL Endpoint, Default Endpoint,Failover Endpoint). For example, Failover Endpoints can be listed inside the Load-balance endpoint to load balance between failover groups etc.

• The optional session element makes the endpoint a session affinity based load balancing endpoint. If it is specified, sessions are bound to endpoints in the first message and all successive messages for those sessions are directed to their associated endpoints.

• The failover attribute mentioned above is not applicable for session affinity based endpoints and it is always considered as set to false. If it is required to have failover behavior in session affinity based load balance endpoints, list failover endpoints as the target endpoints.

  ---

UI Configuration

1. In the "Add Endpoint" list, click "Load Balance Group Endpoint" (See Adding an Endpoint). The "Load Balance Group Endpoint" page appears.

The following fields are specific to the Load Balance Group Endpoint:

• Endpoint Name - A unique name of the endpoint.
• Algorithm - Either a default "Round-robin" or custom loaded algorithm of the group. See more information about this algorithm in the article.
• Session Management - A session management method from the load balancing group. The possible values are:
  • None - Session management is not used.
  • Transport - Session management is done on the transport level using HTTP cookies.
  • SOAP - Session management is done using SOAP sessions.
  • Client ID - Session management is done using an ID sent by the client.
• Session Timeout(ms) - Session timeout in milliseconds.
• Load Balance Endpoint Properties - See Adding an Endpoint.

2. Click "Add Endpoint."

3. A shortcut menu with the available endpoints appears.

4. Click on the endpoint you want to add as a Load Balance Group Endpoint. A tab with the fields relevant to the selected endpoint appears.

See the details of child endpoints in Address Endpoint, WSDL Endpoint, Failover Endpoint.