Product Documentation

Manage service groups

You can change the settings of the services in a service group, and you can perform tasks such as enabling, disabling, and removing service groups. You can also unbind members from a service group.

Modify a service group

You can modify attributes of service group members. You can set several attributes of the service group, such as maximum client, SureConnect, and compression. The attributes are set on the individual servers in the service group. You cannot set parameters on the service group such as transport information (IP address and port), weight, and server ID.

Note: A parameter you set for a service group is applied to the member servers in the group, not to individual services.

To modify a service group by using the command line interface

At the command prompt, type the following command with one or more of the optional parameters:

set servicegroup <serviceGroupName> [-type <type>] [-maxClient <maxClient>] [-maxReq <maxReq>] [-cacheable (YES|NO)] [-cip (ENABLED|DISABLED)] [-cipHeader <cipHeader>] [-usip (YES|NO)] [-sc (ON|OFF)] [-sp (ON|OFF)] [-cltTimeout <cltTimeout>] [-svrTimeout <svrTimeout>] [-cka (YES|NO)] [-TCPB (YES|NO)] [-CMP (**YES**|**NO**)] [-maxBandwidth <maxBandwidth>] [-maxThreshold <maxThreshold>] [-state (ENABLED|DISABLED)] [-downStateFlush (ENABLED|DISABLED)

Example:

set servicegroup Service-Group-1 -type TRANSPARENT

set servicegroup Service-Group-1 -maxClient 4096

set servicegroup Service-Group-1 -maxReq 16384

set servicegroup Service-Group-1 -cacheable YES

To modify a service group by using the configuration utility

Navigate to Traffic Management > Load Balancing > Service Groups, and open the service group to modify.

Remove a service group

When you remove a service group, the servers bound to the group retain their individual settings and continue to exist on the Citrix ADC appliance.

To remove a service group by using the command line interface

At the command prompt, type:

rm servicegroup <ServiceGroupName>

Example:

rm servicegroup Service-Group-1

To remove a service group by using the configuration utility

  1. Navigate to Traffic Management > Load Balancing > Service Groups.
  2. Select a service group, and click Delete.

Unbind a member from a service group

When you unbind a member from the service group, the attributes set on the service group will no longer apply to the member that you unbound. The member services retains its individual settings, however, and continues to exist on the Citrix ADC appliance.

To unbind members from a service group by using the command line interface

At the command prompt, type:

unbind servicegroup <serviceGroupName> <IP>@ [<port>]

Example:

unbind servicegroup Service-Group-1 10.102.29.30 80

To unbind members from a service group by using the configuration utility

  1. Navigate to Traffic Management > Load Balancing > Service Groups.
  2. Open a service group, and click in the Service Group Members section.
  3. Select a service group member, and click Unbind.

Unbind a service group from a virtual server

When you unbind a service group from a virtual server, the member services are unbound from the virtual server and continue to exist on the Citrix ADC appliance.

To unbind a service group from a virtual server by using the command line interface

At the command prompt, type:

unbind lb vserver <name>@ <ServiceGroupName>

Example:

unbind lb vserver Vserver-LB-1 Service-Group-1

To unbind a service group from a virtual server by using the configuration utility

  1. Navigate to Traffic Management > Load Balancing > Virtual Servers.
  2. Open the virtual server, and click in the Service Group section.
  3. Select the service group, and click Unbind.

Unbind monitors from service groups

When you unbind a monitor from a service group, the monitor that you unbound no longer monitors the individual services that constitute the group.

To unbind a monitor from a service group using the command line interface

At the command prompt, type:

unbind serviceGroup <serviceGroupName> -monitorName <string>

Example:

unbind serviceGroup Service-Group-1 -monitorName monitor-HTTP-1

To unbind a monitor from a service group by using the configuration utility

  1. Navigate to Traffic Management > Load Balancing > Service Groups.
  2. Open a service group, and click in the Monitors section.
  3. Select a monitor, and click Unbind.

Enable or Disable a service group

When you enable a service group and the servers, the services belonging to the service group are enabled. Similarly, when a service belonging to a service group is enabled, the service group and the service are enabled. By default, service groups are enabled.

After disabling an enabled service, you can view the service using the configuration utility or the command line to see the amount of time that remains before the service goes DOWN.

To disable a service group by using the command line interface

At the command prompt, type:

disable servicegroup <ServiceGroupName>

Example:

disable servicegroup Service-Group-1

To disable a service group by using the configuration utility

  1. Navigate to Traffic Management > Load Balancing > Service Groups.
  2. Select a service group, and in the Action list, click Disable.

To enable a service group by using the command line interface

At the command prompt, type:

enable servicegroup <ServiceGroupName>

Example:

enable servicegroup Service-Group-1

To enable a service group by using the configuration utility

  1. Navigate to Traffic Management > Load Balancing > Service Groups.
  2. Select a service group, and in the Action list, click Enable.

View the status of service groups members

Navigate to Traffic Management > Load Balancing > Service Groups.

In the Service Groups page, the Effective State column displays the status of the service groups. Status UP/DOWN in the Effective State column is clickable. You can click the status and get the list of members along with their status in the same view. Select a member and click the Monitor Details button to view the reason for the status being DOWN.

Note: Prior to NetScaler release 12.0 build 56.20, the status in the Effective State column was not clickable.

localized image

Viewing the properties of a service group

You can view the following settings of the configured service groups: name, IP address, state, protocol, maximum client connections, maximum requests per connection, maximum bandwidth, and monitor threshold. Viewing the details of the configuration can be helpful for troubleshooting your configuration.

To view the properties of a service group by using the command line interface

At the command prompt, type one of the following commands to display the group properties or the properties and the group members:


show servicegroup <ServiceGroupName>

show servicegroup <ServiceGroupName> -includemembers

Example:

show servicegroup Service-Group-1

To view the properties of a service group by using the configuration utility

  1. Navigate to Traffic Management > Load Balancing > Service Groups.
  2. Click the arrow next to the service group.

Viewing service group statistics

You can view service-group statistical data, such as rate of requests, responses, request bytes, and response bytes. The Citrix ADC appliance uses the statistics of a service group, such as these, to balance the load on the services.

To view the statistics of a service group by using the command line interface

At the command prompt, type:

stat servicegroup <ServiceGroupName>

Example:

stat servicegroup Service-Group-1

To view the statistics of a service group by using the configuration utility

  1. Navigate to Traffic Management > Load Balancing > Service Groups.
  2. Select a service group, and click Statistics.

Load balancing virtual servers bound to a service group

In large-scale deployments, the same service group can be bound to multiple load balancing virtual servers. In such a case, instead of viewing each virtual server to see the service group it is bound to, you can view a list of all the load balancing virtual servers bound to a service group. You can view the following details of each virtual server:

  • Name
  • State
  • IP address
  • Port

To display the virtual servers bound to a service group by using the command line interface

At the command prompt, type the following command to display the virtual servers bound to a service group:

show servicegroupbindings <serviceGroupName>

Example:

> show servicegroupbindings SVCGRPDTLS
SVCGRPDTLS - State :ENABLED
1) Test-pers (10.10.10.3:80) - State : DOWN
2) BRVSERV (10.10.1.1:80) - State : DOWN
3) OneMore (10.102.29.136:80) - State : DOWN
4) LBVIP1 (10.102.29.66:80) - State : UP
Done
>

To display the virtual servers bound to a service group by using the configuration utility

  1. Navigate to Traffic Management > Load Balancing > Service Groups.
  2. Select a service group, and in the Action list, click Show Bindings.