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)