ltm rule command nexthop

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



nexthop
       Sets the nexthop of an IP connection.

SYNOPSIS
       nexthop ((IP_ADDR) | ((VLAN_OBJ) (IP_ADDR | MAC_ADDR | transparent)?))

DESCRIPTION
       Sets the nexthop of an IP connection. The nexthop is the destination
       for packets going from the BIG-IP to the server. This is usually
       determined by the IP routing table. This command lets you specify the
       nexthop to use for a particular connection.

       Note: In 11.6, you can use the 'nexthop' command to direct traffic over
	   IPIP tunnels.  In 13.0, you can use the 'nexthop' command to make
	   connections L2 transparent (preserve source and destination MAC
       address).

       Syntax

       nexthop [] 

	    * Sets the nexthop to the ethernet address belonging to the specified
	      IP address, optionally on the specified vlan. The IP address must
	      be directly connected to the BIG-IP (no intermediate router).

       nexthop  

	    * Sets the nexthop to the specified ethernet address on the specified
	      vlan.

       nexthop  []

	    * Sets the nexthop to the specific tunnel interface 'tunnel-name'. If
	      the tunnel interface is a point-to-point tunnel, the IP address is
	      optional, in which the IP address has not effect. If the tunnel
	      interface is a wild-card IPIP tunnel, the IP address specifies the
	      remote IP address.

       nexthop  transparent

	    * Sets the transparent nexthop vlan to the specific vlan interface 'vlan'.
	      The flow will be marked as L2 transparent: auto lasthop will be enabled
	      and address translation will be disabled.

RETURN VALUE
VALID DURING
       AUTH_ERROR, AUTH_FAILURE, AUTH_RESULT, AUTH_SUCCESS,
       AUTH_WANTCREDENTIAL, CACHE_REQUEST, CACHE_RESPONSE, CACHE_UPDATE,
       CLIENT_ACCEPTED, CLIENT_CLOSED, CLIENT_DATA, CLIENT_LINE,
       CLIENTSSL_CLIENTCERT, CLIENTSSL_HANDSHAKE, HTTP_CLASS_FAILED,
       HTTP_CLASS_SELECTED, HTTP_REQUEST, HTTP_REQUEST_DATA,
       HTTP_REQUEST_SEND, HTTP_RESPONSE, HTTP_RESPONSE_CONTINUE,
       HTTP_RESPONSE_DATA, LB_FAILED, LB_SELECTED, NAME_RESOLVED,
       PERSIST_DOWN, RTSP_REQUEST, RTSP_REQUEST_DATA, RTSP_RESPONSE,
       RTSP_RESPONSE_DATA, SERVER_CLOSED, SERVER_CONNECTED, SERVER_DATA,
       SERVER_LINE, SERVERSSL_HANDSHAKE, SIP_REQUEST, SIP_REQUEST_SEND,
       SIP_RESPONSE, SIP_RESPONSE_SEND, STREAM_MATCHED, USER_REQUEST,
       USER_RESPONSE, XML_BEGIN_DOCUMENT, XML_BEGIN_ELEMENT, XML_CDATA,
       XML_END_DOCUMENT, XML_END_ELEMENT, XML_EVENT

EXAMPLES
	when CLIENT_ACCEPTED {
	  nexthop external 01:23:45:ab:cd:ef
	}


	net tunnels tunnel wildcard-ipip-tun {
	    local-address 10.5.0.21
	    profile ipip
	}
	when CLIENT_ACCEPTED {
	    nexthop wildcard-ipip-tun 10.4.0.21
	}

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



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