ltm rule command clone

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

clone
       Causes the system to clone traffic to the specified pool, pool member or vlan regardless of monitor status.

SYNOPSIS
       clone pool POOL_OBJ (member IP_ADDR (PORT)?)?

       clone nexthop VLAN_OBJ

DESCRIPTION
       Causes the system to clone traffic to the specified pool, pool member or vlan regardless of monitor status. (Pool member
       status may be determined by the use of the LB::status command. Failure to select a server because none are available may be
       prevented by using the active_members command to test the number of active members in the target pool before choosing it.)
       Any responses to cloned traffic from pool members will be ignored. "Clone" is meant to be used to allow traffic to be sent
       to devices such as IDS, Sniffers, etc and is not meant to try load balancing a single request to multiple systems at the
       same time.

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

       Nexthop  will be used to send cloned traffic to physical interface(s) mapped to the vlan.

RETURN VALUE
       clone pool 
	   Specifies the pool to which you want to send the cloned traffic.

       clone pool  [member  []]
	   Specifies a pool member to which you want to directly send the cloned traffic.

       clone nexthop 
	   Specifies a vlan to which you want to send the cloned traffic.

VALID DURING
       ANY_EVENT

EXAMPLES
	# Clone traffic based on the requested HTTP URI
	when HTTP_REQUEST {
	  if { [HTTP::uri] starts_with "/clone_me" } {
	    pool real_pool
	    clone pool clone_pool
	  } else {
	    pool real_pool
	  }
	}

	# Clone only traffic destined for one VS pool member
	when LB_SELECTED {
	  if { [IP::addr [LB::server addr] equals 10.1.1.1] } {
	    clone pool member1_clone_pool
	  }
	}

	when CLIENT_ACCEPTED {
	   clone nexthop tap_vlan
	}

HINTS
SEE ALSO
CHANGE LOG
       @BIGIP-9.0.0 --First introduced @BIGIP-13.0.0 --Added "nexthop" option

BIG-IP							    2022-04-12							  iRule(1)