Set location qualifiers

The database used to implement static proximity has the location of the GSLB sites. Each location has an IP address range and up to six qualifiers for that range. The qualifiers are literal strings and are compared in a prescribed order at run time. Every location must have at least one qualifier. The qualifier labels define the meaning of the qualifiers (context), which are user defined. Citrix ADC has two built-in contexts:

Geographic context, which has the following qualifier labels:

  • Qualifier 1 – “Continent”
  • Qualifier 2 – “Country”
  • Qualifier 3 – “State”
  • Qualifier 4 – “City”
  • Qualifier 5 – “ISP”
  • Qualifier 6 – “Organization”

Custom entries, which have the following qualifier labels:

  • Qualifier 1 – “Qualifier 1”
  • Qualifier 2 – “Qualifier 2”
  • Qualifier 3 – “Qualifier 3”
  • Qualifier 4 – “Qualifier 4”
  • Qualifier 5 – “Qualifier 5”
  • Qualifier 6 – “Qualifier 6”

If the geographic context is set with no Continent qualifier, Continent is derived from Country. Even the built-in qualifier labels are based on the context, and the labels can be changed. These qualifier labels specify the locations mapped with the IP addresses used to make static proximity decisions.

To perform a static proximity-based decision, the Citrix ADC appliance compares the location attributes (qualifiers) derived from the IP address of the local DNS server resolver with the location attributes of the participating sites. If only one site matches, the appliance returns the IP address of that site. If there are multiple matches, the site selected is the result of a round robin on the matching GSLB sites. If there is no match, the site selected is a result of a round robin on all configured sites. A site that does not have any qualifiers is considered a match.

To set the location qualifiers by using the command line interface

At the command prompt, type:

set locationparameter -context <context> -q1label <string> [-q2label <string>] [-q3label <string>] [-q4label <string>] [-q5label <string>] [-q6label <string>]


set locationparameter -context custom -q1label asia

To set the location qualifiers by using the configuration utility

  1. Navigate to AppExpert > Location.
  2. From the Action list, click Location Parameters and set the location qualifiers.
Set location qualifiers