Product Documentation

Managing Service Groups

Aug 31, 2016

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.

Modifying a Service Group

Updated: 2013-11-12

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.

Removing a Service Group

Updated: 2013-09-04

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

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.

Unbinding a Member from a Service Group

Updated: 2013-11-12

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 NetScaler.

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.

Unbinding a Service Group from a Virtual Server

Updated: 2013-11-12

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 NetScaler 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.

Unbinding Monitors from Service Groups

Updated: 2013-12-10

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.

Enabling or Disabling a Service Group

Updated: 2013-09-04

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.

Viewing the Properties of a Service Group

Updated: 2013-09-04

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

Updated: 2013-09-04

You can view service-group statistical data, such as rate of requests, responses, request bytes, and response bytes. The NetScaler 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

Updated: 2013-09-04

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.