ltm persistence persist-recordsΒΆ

ltm persistence persist-records(1)		  BIG-IP TMSH Manual		   ltm persistence persist-records(1)

NAME
       persist-records - Displays or deletes persistence records.

MODULE
       ltm persistence

SYNTAX
       Configure the persist-records component within the ltm persistence module using the syntax in the following
       sections.

   DISPLAY
	show persist-records
	  options:
	    client-addr [ip address]
	    key [string]
	    mode [cookie | destination-address | hash | msrdp | sip |
	      source-address | ssl-session-id | universal]
	    node-addr [ip address]
	    node-port [integer]
	    pool [string]
	    save-to-file [ filename ]
	    virtual [string]

   DELETE
	delete persist-records
	  options:
	    client-addr [ip address]
	    key [string]
	    mode [cookie | destination-address | hash | msrdp | sip |
	      source-address | ssl-session-id | universal]
	    node-addr [ip address]
	    node-port [integer]
	    pool [string]
	    virtual [string]

DESCRIPTION
       You can use the persist-records component to either display or delete records of persistent connections.

EXAMPLES
       show persist-records

       Displays all persistent connections on the BIG-IP(r) system.

       delete persist-records client-addr 172.19.255.1

       Deletes all persistent connections that originate from the client IP address, 172.19.255.1.

OPTIONS
       client-addr
	    Specifies the IP address of the client from which the persistent connections you want to view or delete
	    persist.

       key  Specifies a string that the system is using to persist the connections you want to view or delete.

       mode Specifies the type of persistence of the connections you want to view or delete. The options are:

	    cookie
		 Cookie persistence uses an HTTP cookie stored on a client's computer to allow the client to connect
		 to the same server previously visited at a web site.

	    destination-address
		 Also known as sticky persistence, destination address affinity persistence supports TCP and UDP
		 protocols, and directs session requests to the same server based solely on the destination IP
		 address of a packet.

	    hash Hash persistence is based on an existing iRule.

	    msrdp
		 MSRDP persistence provides an efficient way of load balancing traffic and maintaining persistent
		 sessions between Windows(r) clients and servers that are running the Microsoft(r) Terminal Services
		 service. The recommended scenario for enabling the MSRDP persistence feature is to create a load
		 balancing pool that consists of members running Windows .NET Server 2003, Enterprise Edition, or
		 later, where all members belong to a Windows cluster and participate in a Windows session directory.

	    sip  Session Initiation Protocol (SIP) persistence is a type of persistence available for server pools.
		 You can configure SIP persistence for proxy servers that receive SIP messages sent through UDP. The
		 BIG-IP system currently supports persistence for SIP messages sent through UDP, TCP, or SCTP.

	    source-address
		 Also known as simple persistence, source address affinity persistence supports TCP and UDP
		 protocols, and directs session requests to the same server based solely on the source IP address of
		 a packet. When you specify a source address as the mode of persistence, you must specify an IP
		 address using the client-addr option.

	    ssl-session-id
		 SSL persistence is a type of persistence that tracks non-terminated SSL sessions, using the SSL
		 session ID. Even when the client's IP address changes, the system still recognizes the connection as
		 being persistent based on the session ID. Note that the term, non-terminated SSL sessions, refers to
		 sessions in which the system does not perform the tasks of SSL certificate authentication and
		 encryption/re-encryption.

	    universal
		 Universal persistence allows you to write an expression that defines what to persist on in a packet.
		 The expression, written using the same expression syntax that you use in iRules(r), defines some
		 sequence of bytes to use as a session identifier.

       node-addr
	    Specifies the IP address of the node with which the client sessions that you want to view or delete
	    remain persistent.

       node-port
	    Specifies the port number of the node with which the client sessions that you want to view or delete
	    remain persistent.

       pool Specifies the pool member with which the client sessions that you want to view or delete remain
	    persistent.

       save-to-file
	    Specifies the file which persist-records information can be save to. With this option, it can write a
	    file larger than 2GB.

       virtual
	    Specifies the virtual server with which the client sessions that you want to view or delete remain
	    persistent.

SEE ALSO
       delete, show, tmsh

COPYRIGHT
       No part of this program may be reproduced or transmitted in any form or by any means, electronic or
       mechanical, including photocopying, recording, or information storage and retrieval systems, for any purpose
       other than the purchaser's personal use, without the express written permission of F5 Networks, Inc.

       F5 Networks and BIG-IP (c) Copyright 2009-2010, 2012-2013. All rights reserved.

BIG-IP						      2013-04-10		   ltm persistence persist-records(1)