ADC

Set location qualifiers

August 20, 2024

Contributed by:

C C

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>]
<!--NeedCopy-->

Example:

set locationparameter -context custom -q1label asia
<!--NeedCopy-->

To set the location qualifiers by using the configuration utility

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

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Set location qualifiers

August 20, 2024

Contributed by:

C C

August 20, 2024

Contributed by:

C C

Set location qualifiers

To set the location qualifiers by using the command line interface

To set the location qualifiers by using the configuration utility

In this article