ltm rule command ONECONNECT detach

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



ONECONNECT::detach
       Detaches server-side OneConnect connections.

SYNOPSIS
       ONECONNECT::detach BOOL_VALUE

DESCRIPTION
       Controls the behavior of a server-side connection when a OneConnect
       profile is on the virtual server. The default behavior is that the
       server-side connection detaches after each response is completed, and a
       new load balancing decision and persistence look-up are performed for
       every request.  Disabling detaching prevents this behavior.  Note: the
       use of the terms "request" and "response" imply the presence of a
       supported layer 7 profile (e.g. the HTTP profile) on the virtual
       server. An iRule can also detaching the server-side connection using
       the LB::detach command.	Note that this command has no impact on
       whether or not the server-side connection will return to the idle
       connection pool when the client connection closes. The
       ONECONNECT::reuse command controls this behavior.

       Syntax

       ONECONNECT::detach [enable | disable ]

	    * When disabled, the server-side connection will not detach.
	    * When enabled, the server-side connection detaches after each layer
	      7 transaction.

RETURN VALUE
VALID DURING
EXAMPLES
	when HTTP_REQUEST {
	    set headreq 0
	    if { [HTTP::method] == "HEAD" } {
		# We are a head request. Set the flag for checking in the response.
		set headreq 1
	    }
	}

	when HTTP_RESPONSE {
	    if { $headreq } {
		# Response to HEAD request. Detach after done.
		ONECONNECT::detach enable
		ONECONNECT::reuse enable
	    }
	}

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



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