Product Documentation

Configure a GSLB virtual server

A GSLB virtual server is an entity that represents one or more GSLB services and balances traffic between them. It evaluates the configured GSLB methods or algorithms to select a GSLB service to which to send the client request.

Note

A GSLB virtual server protocol requirement is mainly to create a relation between the virtual server and the services that are bound to the virtual server. This also keeps CLI/APIs consistent with respect to other types of virtual servers. The Service Type parameter on a service or a virtual server is not leveraged while serving the DNS requests. It is instead referenced during site persistence, monitoring, and for the purpose of doing lookups via MEP.

To create a GSLB virtual server by using the command line interface

At the command prompt, type the following commands to add a GSLB virtual server and verify the configuration:

-  add gslb vserver <name> <serviceType> -ipType (IPv4 | IPv6)
-  show gslb vserver <name>

Example:

add gslb vserver Vserver-GSLB-1 HTTP -ipType IPv4
add gslb vserver Vserver-GSLB-2 HTTP -ipType IPv6
show gslb vserver Vserver-GSLB-1
show gslb vserver Vserver-GSLB-2

To modify or remove a GSLB virtual server by using the command line interface

  • To modify a GSLB virtual server, use the set gslb vserver command, which is just like using the add gslb vserver command, except that you enter the name of an existing GSLB virtual server.
  • To reset a parameter to is default value, you can use the unset gslb vserver command followed by the vserverName value and the name of the parameter to be unset.
  • To remove a GSLB virtual server, use the rm gslb vserver command, which accepts only the name argument.

To configure a GSLB virtual server by using the configuration utility

  1. Navigate to Traffic Management > GSLB > Virtual Servers.
  2. Add a new GSLB virtual server, or select an existing GSLB virtual server and edit its settings.

To view the statistics of a GSLB virtual server by using the command line interface

At the command prompt, type:

stat gslb vserver <name>

Example:

stat gslb vserver Vserver-GSLB-1

To view the statistics of a GSLB virtual server by using the configuration utility

Navigate to Traffic Management > GSLB > Virtual Servers, select the virtual server and click Statistics.

Statistics of a GSLB service

When you run the stat gslb service command from the command line or click on the Statistics link from the configuration utility, the following details of the service will be displayed:

  • Request bytes. Total number of request bytes received on this service or virtual server.
  • Response bytes. Number of response bytes received by this service or virtual server.
  • Current client established connections. Number of client connections in ESTABLISHED state.
  • Current load on the service. Load on the service (Calculated from the load monitor bound to the service).

The data of number of requests and responses, and the number of current client and server connections may not be displayed or may not be synchronized with the data of the corresponding load balancing virtual server.

Clearing the GSLB virtual server or service statistics

Note: This feature is available in NetScaler release 10.5.e.

You can now clear the statistics of a GSLB virtual server and service. Citrix ADC provides the following two options to clear the statistics:

  • Basic: Clears the statistics that are specific to the virtual server but retains the statistics that are contributed by the bound GLSB service.
  • Full: Clears both the virtual server and the bound GSLB service statistics.

To clear the statistics of a GSLB virtual server by using the command line interface

At the command prompt, type:

stat gslb vserver <name> -clearstats <basic | full>

Example:

stat gslb vserver Vserver-GSLB-1 –clearstats basic

To clear the statistics of a GSLB service by using the command line interface

At the command prompt, type:

stat gslb service <name> -clearstats <basic | full>

Example:

stat gslb service service-GSLB-1 –clearstats basic

To clear the statistics of a GSLB virtual server by using the configuration utility

  1. Navigate to Traffic Management > GSLB > Virtual Servers.
  2. Select the GSLB virtual server and, click Statistics, and then click Clear.
  3. From the Clear drop-down list, select Basic or Full, and then click OK.

To clear the statistics of a GSLB service by using the configuration utility

  1. Navigate to Traffic Management > GSLB > Services.
  2. Select the GSLB service and, click Statistics, and then click Clear.
  3. From the Clear drop-down list, select Basic or Full, and then click OK.

Enabling and Disabling GSLB Virtual Servers

When you create a GSLB virtual server, it is enabled by default. If you disable it, it cannot process traffic. A disabled GSLB virtual server is not included in GSLB configuration but is not removed from the Citrix ADC appliance.

To enable or disable a GSLB virtual server by using the command line interface

At the command prompt, type one of the following commands:

enable gslb vserver <name>@  

disable gslb vserver <name>@  

Example:

enable gslb vserver Vserver-GSLB-1
disable gslb vserver Vserver-GSLB-1

To enable or disable a GSLB virtual server by using the configuration utility

  1. Navigate to Traffic Management > GSLB > Virtual Servers.
  2. Select a virtual server and, from the Action list, select enable or disable.