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

GSLB virtual server statistics

Starting from Citrix ADC version 12.1 build 51.xx and later, the GSLB virtual server statistics also display the following information in addition to details such as; vserver hits, current persistence session, request bytes, response bytes, spillover threshold, spillover hits, current client established connections, and vserver down backup hits.

  • Primary LB method failures: Number of times the primary GSLB method has failed.
  • Backup LB method failures: Number of times the backup GSLB method has failed.
  • Vserver persistence hits: The number of times the request is served through the persistence sessions.

Note: The primary or the backup method can fail when primary method is static proximity and backup method is RTT. In this scenario, if there is no location corresponding to LDNS IP, the static proximity fails and backup method is attempted. The statistics are updated based on the following:

  • If the backup method is successful, only primary method failure statistics are incremented.
  • If RTT calculation is not successful, then backup method also fails. In this case, both primary and backup method failure statistics are incremented.

When the backup method fails, the last resort method of round robin is used.

The following image is a sample of GSLB virtual server statistics from CLI.

GSLB vserver stats cli

The following image is a sample of GSLB virtual server statistics from GUI.

GSLB vserver stats gui

GSLB service statistics

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.