"<persistence-policy_name>"

Enter the name of the persistence policy. The maximum length is 63 characters.

To display the list of existing persistence policies, enter:

edit ?

type { source-ip | persistent-cookie | asp-sessionid | php-sessionid | jsp-sessionid | insert-cookie | HTTP-header | url-parameter | rewrite-cookie | embedded-cookie | ssl-session-id }

• source-ip—Forwards subsequent requests with the same client IP address and subnet as the initial request to the same pool member. To define how FortiWeb derives the appropriate subnet from the IP address, configure ipv4-netmask "<v4mask>" and ipv6-mask-length "<v6mask>".
• persistent-cookie—If an initial request contains a cookie whose name matches the cookie-name "<cookie-name_str>" value, FortiWeb forwards subsequent requests that contain the same cookie value to the same pool member as the initial request.
• asp-sessionid—If a cookie in the initial request contains an ASP .NET session ID value, FortiWeb forwards subsequent requests with the same session ID value to the same pool member as the initial request. FortiWeb preserves the original cookie name.
• php-sessionid—If a cookie in the initial request contains a PHP session ID value, FortiWeb forwards subsequent requests with the same session ID value to the same pool member as the initial request. FortiWeb preserves the original cookie name.
• jsp_sessionid—FortiWeb forwards subsequent requests with the same JSP session ID as the inital request to the same pool member. FortiWeb preserves the original cookie name.
• insert-cookie—FortiWeb inserts a cookie with the name specified by cookie-name "<cookie-name_str>" to the initial request and forwards all subsequent requests with this cookie to the same pool member. FortiWeb uses this cookie for persistence only and does not forward it to the pool member. Also specify cookie-path "<cookie-path_str>" and cookie-domain "<cookie-domain_str>".
• HTTP-header—Forwards subsequent requests with the same value for an HTTP header as the initial request to the same pool member. Also configure HTTP-header.

• url-parameter—Forwards subsequent requests with the same value for a URL parameter as the initial request to the same pool member. Also configure url-parameter.
• rewrite-cookie—If the HTTP response has a Set-Cookie: value that matches the value specified by cookie-name "<cookie-name_str>", FortiWeb replaces the value with a randomly generated cookie value. FortiWeb forwards all subsequent requests with this generated cookie value to the same pool member.
• embedded-cookie—If the HTTP response contains a cookie with the name specified by cookie-name "<cookie-name_str>", FortiWeb preserves the original cookie value and adds a randomly generated cookie value and a ~ (tilde) as a prefix. FortiWeb forwards all subsequent requests with this cookie and prefix to the same pool member.
• ssl-session-id—If a cookie in the initial request contains an SSL session ID value, FortiWeb forwards subsequent requests with the same session ID value to the same pool member as the initial request. FortiWeb preserves the original cookie name.

For persistence types that use cookies, you can use the sessioncookie-enforce setting to maintain persistence for transactions within a session. For details, see server-policy policy.

cookie-name "<cookie-name_str>"

Enter a value to match or the name of the cookie that FortiWeb inserts.

Available only when the persistence type uses a cookie.

timeout "<timeout_int>"

Enter the maximum amount of time between requests that FortiWeb maintains persistence, in seconds.

FortiWeb stops forwarding requests according to the established persistence after this amount of time has elapsed since it last received a request from the client with the associated property (for example, an IP address or cookie). Instead, it again selects a pool member using the load balancing method specified in the server pool configuration.

ipv4-netmask "<v4mask>"

Enter the IPv4 subnet used for session persistence.

For example, if IPv4 Netmask is 256.256.256.256, FortiWeb can forward requests from IP addresses 192.0.2.1 and 192.0.2.2 to different server pool members.

If IPv4 Netmask is 256.256.256.0, FortiWeb forwards requests from IP addresses 192.0.2.1 and 192.0.2.2 to the same pool member.

ipv6-mask-length "<v6mask>"

HTTP-header "<HTTP-header_str>"

url-parameter "<url-parameter_str>"

cookie-path "<cookie-path_str>"

cookie-domain "<cookie-domain_str>"