persist¶

persist simple [<mask>] [<timeout>]
persist source_addr [<mask>] [<timeout>]
persist sticky [<mask>] [<timeout>]
persist dest_addr [<mask>] [<timeout>]
persist ssl [<timeout>]
persist msrdp [<timeout>]
persist cookie [insert [<cookie_name>] [<expiration>] |
                rewrite [<cookie_name>] [<expiration>] |
                passive [<cookie_name>] |
                hash <cookie_name> [ {<offset> [<length>]} [<timeout>]] ]
persist uie <string> [<timeout>]
persist hash <string> [<timeout>]
persist carp <string>
persist none

  <timeout> = The timeout in seconds.

persist add <mode> <key> [<timeout>]
   <key> = <mode specific value> | { <value> [any virtual|service|pool] [pool <name>] }
     the latter key specification is used to add persistence entries that can be used across virtuals, services, or pools.

persist lookup <mode> <key> [all|node|port|pool]
  "all" or no specification returns a list containing the node, port and pool name.
  Specifying any of the other return types will return the specified item only.
   <key> = <mode specific value> | { <value> [any virtual|service|pool] [pool <name>] }
     the latter key specification is used to access persistence entries across virtuals, services, or pools.

persist delete <mode> <key>
   <mode> = simple | source_addr | sticky | dest_addr | ssl | uie | hash
   <key> = <mode specific value> | { <value> [any virtual|service|pool] [pool <name>] }
     the latter key specification is used to delete persistence entries regardless of virtual, service, or pool association.

persist lookup cookie

when HTTP_REQUEST {
    persist hash [HTTP::uri]
}
when HTTP_REQUEST_SEND {
    persist add hash [clientside {HTTP::uri}] 180
}

when CLIENTSSL_HANDSHAKE {
   # Persist the client connection based on the SSL session ID
    persist ssl
}

when HTTP_REQUEST {
   # Look up the UIE persistence record for 11111111
   persist lookup uie {11111111 pool pool_1}
}

when HTTP_REQUEST {

   # Look up the client IP in UIE persistence records for any virtual server
   set lookup_key [list [IP::client_addr] any virtual]
   set value [persist lookup uie $lookup_key]
}

when HTTP_REQUEST {
   # Save the value of the UIE persistence record for this client for any pool
   set value [persist lookup uie [IP::client_addr] any pool]
}

when HTTP_REQUEST {
   # Save the value of the UIE persistence record for a generic token for any virtual server
   set value [persist lookup uie [list $myVar any virtual]]
}

# Select different persistence methods by HTTP URI

when HTTP_REQUEST {

   # Check the requested URI
   switch -glob [HTTP::uri] {
      "/path1/*" -
      "/path2/*" {
         # Request was for an IIS URI so select the pool and set a pool-specific cookie
         pool iis_pool
         persist cookie insert iis_persist 0
      }
      default {
         # Request was for an iPlanet URI so select the pool and source address persistence with a /24 source mask
         pool iplanet_pool
         persist source_addr 255.255.255.0 0
      }
   }
}

when CLIENT_ACCEPTED {
    # Persist on the client and destination IP addresses
    # Use lsort to order them the same regardless of which host is originating the connection
    # Replace the space with an underscore so the persist command is given a single string
    persist carp [string map {" " "_"} [lsort "[IP::client_addr] [IP::local_addr]"]]
}

when HTTP_REQUEST {
            log local0. "The persist is: [persist lookup source_addr [IP::client_addr]]"
}