Modify a request policy


Change one or more existing load balancer request policies. If you select multiple configurations, you can modify all of the selected configurations at one time.

Access mode

config

Syntax

vSwitch-name loadBalance requestPolicy name text

Arguments

Available fields depend on action selection:


The following fields are relevant for forward

Field Name Description
objectRule text The name of the object rule, used for Layer 5 through Layer 7 switching, associated with this policy. This is the name that was assigned with the name argument of the objectRule command.
serviceGroupName text The service group affected by this policy. This is the name that was assigned with the name argument of the serviceGroup command. This argument is required unless the request policy's action is sorry.
precedence integer Optional: The precedence of the request policy, that is, the order in which the system considers the actions configured within it. If multiple policies exist with the same precedence, they are evaluated in the order in which they were configured. A value of 1 is the highest precedence.

Valid values are from 1 to 4294967295; the default setting is "1".
sorryData text Optional: When action is sorry, this is the name of the SorryData entity that defines the sorry response.
persistType enumeration Optional: The algorithm by which the system makes client persistence decisions when forwarding HTTP requests to real services.

The default setting is "none".

Valid values:
  • none : No session persistence is maintained.
  • fieldHash : System runs a hash algorithm using the fieldPrefix string.
  • fieldMatchName : System runs a hash algorithm using the Real Service rsPersistName.
  • srcAddress : System runs a hash algorithm across client browser's source IP address.
  • switchCookie : Switch managed cookie persistence using cookiePersistence string.
cookiePersist text Optional: The name of the cookie to be inserted into forwarded packets, from the cookie persistence table. If you do not set this field, session persistence is disabled. You configure the parameters of the cookie with the cookiePersistence command.
fieldPrefix text Optional: When the persistType is set to fieldHash or fieldMatchName, this string is used to delineate the field in the HTTP request header. The string field to be hashed will be between this fieldPrefix and the HTTP URI protocol.
srcAddressMask ipAddress Optional: The mask to apply to the IP address retrieved with the srcAddress value of the persistType field.

The default setting is "255.255.255.255".
optimizeLastResponse enumeration Optional: The data path will be optimized when closing connection.

The default setting is "disabled".

Valid values: enabled, disabled
usePooledConnections enumeration Optional: When enabled, a pool of connections to Real Services will be maintained so that a new TCP session will not need to be established for each incoming client connection.

The default setting is "disabled".

Valid values: enabled, disabled
firstObjectSwitching enumeration Optional: The system's method of load balance processing of client requests in a single TCP session. When disabled, the system makes a load balancing decision on each client request. If the request results in a different service group assignment, the system initiates a new TCP session. When enabled, all requests in a single TCP session are sent to the same real service. This lessens the granularity of the load balancing function, but can speed processing by simplifying load balancing decisions.

The default setting is "disabled".

Valid values: enabled, disabled


The following fields are relevant for sorry

Field Name Description
objectRule text The name of the object rule, used for Layer 5 through Layer 7 switching, associated with this policy. This is the name that was assigned with the name argument of the objectRule command.
sorryData text When action is sorry, this is the name of the SorryData entity that defines the sorry response.
precedence integer Optional: The precedence of the request policy, that is, the order in which the system considers the actions configured within it. If multiple policies exist with the same precedence, they are evaluated in the order in which they were configured. A value of 1 is the highest precedence.

Valid values are from 1 to 4294967295; the default setting is "1".