ltm rule command LSN persistence-entry

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



LSN::persistence-entry
       LSN::persistence-entry

SYNOPSIS
       LSN::persistence-entry (delete|get) CLIENT_ADDR

       LSN::persistence-entry create  (-override)? LSN_POOL  CLIENT_ADDR
       TRANSLATION_ADDR (TIMEOUT)?

DESCRIPTION
       Create or lookup LSN translation address. Those commands are linked to
       CGNAT module introduced in 11.3. You need to license and provision this
       module to use this command.

       LSN::persistence-entry create [-override]
       [:]
       [[:]] LSN::persistence-entry get
       [:]

       v11.4+ LSN::persistence-entry create [-override] 
       [:] [:]]  [timeout]

       v11.5+ LSN::persistence-entry delete 

RETURN VALUE
       LSN::persistence-entry create

	   Create a specific translation entry. Normally, this is occurs when a client initiates outbound traffic.
	   If the translation address is not provided, then the address is allocated based on the method configured on the LSN pool.

       LSN::persistence-entry get
	   Retrieve an existing translation record for the identified client.
	   The Persistence Mode must be set to Address or Address and Port in
       the LSN Pool Configuration.

       LSN::persistence-entry delete 
	   Deletes a specific client's translation entry.

VALID DURING
       AUTH_RESULT, AUTH_WANTCREDENTIAL, CACHE_REQUEST, CACHE_UPDATE,
       CLIENT_ACCEPTED, CLIENT_DATA, CLIENTSSL_CLIENTCERT,
       CLIENTSSL_HANDSHAKE, HTTP_CLASS_FAILED, HTTP_CLASS_SELECTED,
       HTTP_REQUEST, HTTP_REQUEST_DATA, LB_SELECTED, RTSP_REQUEST,
       RTSP_REQUEST_DATA, SIP_REQUEST, STREAM_MATCHED

EXAMPLES
	when CLIENT_ACCEPTED {
	    set clientIP [IP::client_addr]
	}
	when SERVER_CONNECTED {
	    log local0. "Client IP: $clientIP - LSN Persistence: [LSN::persistence-entry get $clientIP]"
	}

	Log generated:
	Mar 20 13:36:35 bigip2 info tmm9506: Rule /Common/LSNiRule : Client IP: 10.100.30.252 - LSN Persistence: 10.100.30.136:36753

HINTS
SEE ALSO
CHANGE LOG
       @BIGIP-11.3.0
	   - Initial version where the command was introduced

	   @BIGIP-11.4.0
	   - LSN::persistence-entry create [-override]   [:] [:]]  [timeout]

	   @BIGIP-11.5.0
	   - LSN::persistence-entry delete 



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