Citrix ADC 13.0

Configure backup persistence

You can configure a virtual server to use source IP persistence type when the primary persistence type fails.

The following table describes the combinations of primary and secondary backup persistence types, and the conditions when the backup persistence is used.

Primary persistence Backup persistence When the primary persistence lookup fails…
Cookie Insert Source IP The appliance falls back to source-IP based persistence only when the client browser does not return any cookie in the request. However, if the browser returns a cookie (not necessarily the persistence cookie) it is assumed that the browser supports cookies and hence backup persistence is not triggered.
Rule Source IP The appliance uses source-IP based persistence when the parameter specified in the rule is missing in the incoming request.


  • If the primary persistence type is HTTP-Cookie based persistence, and the backup persistence type is Source IP-based, you can set a timeout value for backup persistence. For instructions, see Setting a Timeout Value for Idle Client Connections.
  • You cannot set a timeout value for backup persistence when the primary persistence is rule based, because in that case the timeout value for secondary persistence must be the same as for the primary persistence. Therefore, the primary and secondary expire at the same time.

To set backup persistence for a virtual server by using the command line interface

At the command prompt, type:

set lb vserver <name> -persistenceType <PersistenceType> -persistenceBackup <BackupPersistenceType>


set lb vserver Vserver-LB-1 -persistenceType CookieInsert -persistenceBackup SourceIP

set lb vserver Vserver-LB-1 -persistenceType sslsession -persistenceBackup SourceIP

set lb vserver Vserver-LB-1 –persistenceType RULE –rule http.req.header("User-Agent").value(0).contains("MyBrowser") –persistenceBackup SOURCEIP

set lb vserver Vserver-LB-1 -persistenceType sslsession -persistenceBackup SourceIP

To set backup persistence for a virtual server by using the configuration utility

  1. Navigate to Traffic Management > Load Balancing > Virtual Servers, and open the virtual server.
  2. In Advanced Settings, select Persistence, and specify a backup persistence type.

Note: The primary persistence must be set to COOKIEINSERT, RULE, or SSLSESSION.

Configure backup persistence