Cisco GSS GUI-Based Global Server Load-Balancing Configuration Guide (Software Version 1.3)
Configuring Domain Lists

Table Of Contents

Configuring Domain Lists

Creating Domain Lists

Modifying Domain Lists

Deleting Domain Lists

Where to Go Next


Configuring Domain Lists


This chapter describes how to configure domain lists on your GSS network. Domain lists are collections of domain names for Internet or intranet resources, sometimes referred to as hosted domains, that have been delegated to the GSS for DNS query responses. Domain lists contain one or more domain names that point to content for which the GSS acts as the authoritative DNS server and for which you intend to use the GSS global server load-balancing technology to balance traffic and user requests.

Using domain lists, you can enter complete domain names or any valid regular expression that specifies a pattern by which the GSS can match incoming addresses. The GSS supports POSIX 1003.2-extended regular expressions when matching wildcards.

Each GSS can support a maximum of 2000 hosted domains and 2000 hosted domain lists, with a maximum of 500 hosted domains supported for each domain list.

This chapter contains the following major sections:

Creating Domain Lists

Modifying Domain Lists

Deleting Domain Lists

Where to Go Next

Creating Domain Lists

To create a domain list:

1. From the primary GSSM GUI, click the DNS Rules tab.

2. Click the Domain Lists navigation link. The Domain Lists list page appears (Figure 4-1).

Figure 4-1 Domain Lists Page

3. Click the Create Domain List icon. The Creating New Domain List details page appears. (Figure 4-2.)

Figure 4-2 Creating New Domain List Details Page—General Configuration

4. In the General Configuration details page (General Configuration navigation link), perform the following:

a. In the Name field, enter a name for the new domain list. Domain list names cannot contain spaces.

b. From the Owner drop-down list, select the contact with whom the domain list will be associated.

c. In the Comments text area, enter any comments for the new domain list.

5. Click the Add Domains navigation link to access the Add Domains section of the page. Use this section to add new hosted domains to your list.

Figure 4-3 Creating New Domain List—Add Domains

6. In the space provided, enter the names of any hosted domains that you want to add to the domain list. You can enter complete domain names or any regular expression that specifies a pattern by which the GSS can match incoming addresses. Enter the domain names of resources for which the GSS acts as the authoritative DNS server.

Note the following guidelines when entering hosted domains:

Hosted domains cannot exceed 128 characters. The following examples illustrate domain names configured on the GSS:

cisco.com
www.cisco.com
www.support.cisco.com

If entering multiple domain names, separate each name with a semicolon as follows:

www.cisco.com; support.cisco.com; cdn.cisco.com

The GSS supports domain names that use wildcards. The GSS supports POSIX 1003.2 extended regular expressions when matching wildcards. Any request for a hosted domain that matches the pattern is directed accordingly.

For example, assume that you have 20 or more possible domains that the GSS is responsible, such as www1.cisco.com, www2.cisco.com, and so on. You can create a wildcard expression that covers all of those domains:

.*\.cisco\.com

For domain names with wildcards that are valid regular expressions, the GSS can match strings up to 256 characters.

7. Click the Add button. The GSS adds the specified domains to the domain list.

8. Click the General Configuration navigation link and view the domain list. The domain names appear under the Current Members section of the details page (Figure 4-4).

9. Click the Submit button to save your domain list changes and return to the Domain List lists page.

Figure 4-4 Creating Domain List—Current Members List

Modifying Domain Lists

To modify an existing domain list:

1. From the primary GSSM GUI, click the DNS Rules tab.

2. Click the Domain Lists navigation link. The Domain Lists list page appears (see Figure 4-1).

3. From the Domain Lists list, click the Modify Domain List icon located to the left of the domain list that you want to modify. The Modifying Domain List details page appears.

4. In the General Configuration details page (General Configuration navigation link), use the fields provided to modify the name, comments, or owner for the domain list (see Figure 4-2). Domain list names cannot contain spaces.

5. To add more domains to the list, click the Add Domains navigation link. Use the text box (see Figure 4-3) provided to enter the names of the domains that you want to add. Click the Add button to append the new domains to the existing list.

6. To remove the domains from the domain list, click the Remove Domains navigation link. The Remove Domains section of the page appears (Figure 4-5). Click the check box accompanying each domain that you want to remove from the list, then click the Remove Selected button. The GSS removes the deleted domain lists from the page.

Figure 4-5 Modifying Domain List—Remove Domains

7. Review your updated domain lists under the Current Members section of the details page (see Figure 4-4).

8. Click the Submit button to save your changes and return to the Domain List list page.

Deleting Domain Lists

You cannot delete domain lists associated with an existing DNS rule. Before deleting a domain list, verify that none of your DNS rules reference the domain list that you are about to delete. If necessary, deselect the domain list from the DNS rule. Refer to Chapter 7, Building and Modifying DNS Rules, for information about modifying a DNS rule.


Caution Deletions of any kind cannot be undone in the primary GSSM. Before deleting any data that you think you might want to use at a later point in time, perform a database backup of your GSSM. Refer to the Global Site Selector Administration Guide for details.

To delete a domain list from your GSS network, perform the following steps:

1. From the primary GSSM GUI, click the DNS Rules tab.

2. Click the Domain Lists navigation link. The Domain Lists list page appears listing existing domain lists.

3. Click the Modify Domain List icon located to the left of the domain list that you want to remove. The Modifying Domain Lists details page appears (Figure 4-6).

Figure 4-6 Modifying Domain List—Delete Icon

4. Click the Delete Domain List icon in the upper right corner of the page. The GSS software prompts you to confirm your decision to delete the domain list.


Note If an error appears informing you that the domain list is referenced by a DNS rule, disassociate the domain list from the DNS rule and then attempt to delete the domain list again. Refer to Chapter 7, Building and Modifying DNS Rules.


5. Click OK to confirm your decision. You return to the Domain List list page.

Where to Go Next

Chapter 5, Configuring Keepalives, describes the modification of global keepalives and the creation of shared keepalives.