Modify service group


Change one or more existing service groups. If you select multiple configurations, you can modify all of the selected configurations at one time.

Access mode

config

Syntax

vSwitch-name loadBalance serviceGroup name text

Arguments

Field Name Description
loadBalanceType enumeration The algorithm by which the system makes load balancing decisions, which disperses traffic across the available real services.

Valid values:
  • roundRobin : System assigns requests to each active real service (server), one per service.
  • weightedRandom : System provides a pseudo-random distribution according to the weight.
  • weightedHash : System runs a hash algorithm across the source IP address and source TCP port.
  • leastConnections : System load balances based on the server with the fewest connections.
  • weightedLeastConnections : System load balances based on the server with the weighted fewest connections.
cfgRealServices text The list of real services (servers) that the system groups and makes load balancing decisions across.
standbyRealServices text Optional: The list of real services (servers) that will be used for load balancing if any of the cfgRealServices are unavailable.
standbyRSActivation enumeration Optional: The method of bringing Standby real services into service.

The default setting is "asNeeded".

Valid values:
  • asNeeded : Standby real services will be activated upon each cfgRealService failure.
  • allRSFailure : Standby real services only activated when all cfgRealServices detected down.
adminState enumeration Optional: The administrative state of the named service group, either enabled or disabled. Set a status of disabled if you want to preconfigure a services group before bringing it online or disable a running service group.

The default setting is "enabled".

Valid values: enabled, disabled
healthName text Optional: The name of the health check profile to use with the real services (servers) of this service group. Enter the profile you have configured, identified by the name argument of the healthCheckProfile command. If no profile is defined, be certain to set static weights for the real services (with the weight argument of the realServices command). There is no profile enabled until you specify one with this argument.

The default setting is "".
inlineHealthCheck enumeration Optional: Any failures detected in the fast path forwarding of traffic will be used in the determination of a server's health.

The default setting is "enabled".

Valid values: enabled, disabled
retryCount integer Optional: The number of tries the system should make to connect to a different real service (server) within the same service group before failover to the sorry server.

Valid values are from 0 to 2; the default setting is "1".
responsePolicyList text Optional: Specifies the list of response polices that will be applied to responses received from real services. A response policy defines an action to take if the response matches the object rule. This list may be empty, in which case the server response will be returned to the client.
responseTransformList text Optional: Specifies the list of response transforms that will be applied to responses received from real services. A response transform defines specific changes to make to the HTTP header in the response if the response matches the object rule. This list may be empty.
flashCrowdThreshold enumeration Optional: The limit of open connections that will bring in additional real services. When this limit is exceeded it indicates the ServiceGroup may be in a flash-crowd condition. Real services defined as standbyRealServices will be brought into service along with the cfgRealServices.

The default setting is "none".

Valid values:
  • 1..65535
  • none : No flash-crowd checks will be done on this service group.
sourceAddressHashMask ipAddress Optional: The mask to apply the source IP Address before using the address in the hashing algorithm used in weightedHash load balancing. A mask of 255.255.255.255 will hash on the entire source IP address. A mask of 0.0.0.0 will ignore the source IP address.

The default setting is "255.255.255.255".
sourcePortHash enumeration Optional: Defines whether or not the source port will be used in the hashing algorithm used in weightedHash load balancing.

The default setting is "enabled".

Valid values: enabled, disabled