LB::select

Description

This command forces the system to make a load balancing selection based on current conditions, and returns a string in the form of a pool command that can be eval’d to activate that selection.
This enables an iRule to make LB decision early, and use that information to manage the connection.
Two of the most common scenarios are:
1. To compare the selection that would be made using the load balancing criteria to the actual server that should be picked, and force the alternative selection before the serverside flow is established with the “wrong” server. If you wait to evaluate the load balancing selection until after the serverside flow is established (in SERVER_CONNECTED or later), then use LB::detach / LB::reselect, client data that has already entered the abandoned serverside flow may be lost.
2. To use information about the selected server to influence the characteristics of the serverside flow (ie. specific SNAT based on selected server, insertion of custom header based on selected server, etc. for other conditions or actions - see 2nd example below.)
Note: The LB::select command will currently only function correctly on connections which use a TCP profile. It will not function correctly on connections using a UDP, nor on connections which use a FastL4 profile. This issue is tracked by ID421708.
Note: The LB::select command is no longer officially supported, as it doesn’t work on CMP systems when an asynchronous persistence lookup is required. If this is attempted, the client connection will stall indefinitely.

Syntax

LB::select
LB::select transparent_port

LB::select

  • Forces the system to make a load balancing selection based on load balancing criteria and current conditions. Returns a string in the form of a pool command that can be evaluated to activate that selection:

pool <poolname> member <ip_addr> <port>

  • This is the same string that would be returned by the LB__server command when invoked with no parameters. This string can in turn be eval’d to actually make the indicated load balancing selection. (You can use the Tcl eval command to evaluate the return value and actually make the pick, then parse the output from LB__select or use LB__server to get pool name, IP, or port - see examples below.)

LB::select transparent_port

  • Same as LB__select but port translation will be disabled for this pick.

Examples

To evaluate the selection early, then use it:
when HTTP_REQUEST {
   pool fargo
   set mypick [LB::select]
   log local0. "The LB choice is: $mypick"
   # Execute the pick
   eval $mypick
}

To force an early load balancing selection so the details may be used to modify the serverside request attributes:
when HTTP_REQUEST {
  log local0. "lbserveraddr: [LB::server addr]"
  # check if serverside connection had previously been established
  if { [LB::server addr] eq "" }{
    # if no serverside connection had previously been established, force one
    # so the iRule has the info required to insert a destination-specific header
    eval [LB::select]
  }
  switch [LB::server addr] {
    "172.16.5.80" { HTTP::header replace Host www1.customer.com }
    "172.16.5.81" { HTTP::header replace Host www2.customer.com }
    "172.16.5.82" { HTTP::header replace Host www3.customer.com }
  }
}