ltm rule command pool

iRule(1)		      BIG-IP TMSH Manual		      iRule(1)



pool
       Sets the pool or pool member regardless of monitor status.

SYNOPSIS
       pool POOL_OBJ  (member  (IP_TUPLE | (IP_ADDR (PORT)?)))?

DESCRIPTION
       Causes the system to load balance traffic to the specified pool or pool
       member . In case only pool member is specified ,the system will load
       balance traffic to the specified pool member regardless of pool member
       monitor status. Pool member status may be determined by the use of the
       LB::status command. Server failure to respond may be caught in the
       LB_FAILED event. Failure to select a server because none are available
       may be caught in the LB_FAILED event or prevented by using the
       active_members command to test the number of active servers in the pool
       before sending traffic.)

       Pool member may be selected conditionally. If multiple conditions
       match, the last match will determine the pool/member to which this
       traffic is load balanced.

	   Syntax

	   pool 

		* Specifies the pool to which you want to send the traffic.

	   pool  [member  []]

		* Specifies a pool member to which you want to directly send the
		  traffic.

RETURN VALUE
VALID DURING
       CLIENT_ACCEPTED, CLIENT_DATA, CLIENT_LINE, CLIENTSSL_CLIENTCERT,
       CLIENTSSL_HANDSHAKE, DNS_REQUEST, GLOBAL_GTM, HTTP_CLASS_SELECTED,
       HTTP_PROXY_REQUEST, HTTP_REQUEST, HTTP_REQUEST_DATA, LB_FAILED,
       NAME_RESOLVED, RTSP_REQUEST, USER_REQUEST, USER_RESPONSE,
       XML_BEGIN_DOCUMENT, XML_BEGIN_ELEMENT, XML_CDATA, XML_END_DOCUMENT,
       XML_END_ELEMENT, XML_EVENT

EXAMPLES
	To select a pool conditionally:
	when CLIENT_ACCEPTED {
	  if { [IP::addr [IP::client_addr] equals 10.10.10.10] } {
	     pool my_pool
	  }
	}

	To check pool member status before sending traffic:

	when HTTP_REQUEST {
	   if { [HTTP::uri] ends_with ".gif" } {
	      if { [LB::status pool my_Pool member 10.1.2.200 80] eq "down" } {
		 log "Server $ip $port down!"
		 pool fallback_Pool
	      } else {
		 pool my_Pool member 10.1.2.200 80
	      }
	   }
	}

	To catch failure of selected pool member to respond:

	when HTTP_REQUEST {
	  if { [HTTP::uri] ends_with ".gif" } {
	    pool my_Pool member 10.1.2.200 80
	  }
	}
	when LB_FAILED {
	  pool my_Pool
	  LB::reselect
	  log "Selected server [LB::server] did not respond. Re-selecting node from myPool"
	}

HINTS
       In order to make this functionality work, one must precede the pool
       command with an LB::reselect command if a pool member has already been
       selected.

       For UDP, the load-balancing decision cannot be changed in the
       CLIENT_DATA event. This command will not have an effect. Instead the
       CLIENT_ACCEPTED event is recommended.

SEE ALSO
CHANGE LOG
       @BIGIP-9.0.0 --First introduced the command.



BIG-IP				  2017-01-31			      iRule(1)