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						      2020-06-23					     iRule(1)