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)