Table Of Contents

Configuring Domain Lists

Domain List Overview

Creating Domain Lists

Modifying Domain Lists

Deleting Domain Lists

Where to Go Next

Configuring Domain Lists

---

This chapter describes how to create domain lists.

This chapter contains the following major sections:

•Domain List Overview

•Creating Domain Lists

•Modifying Domain Lists

•Deleting Domain Lists

Domain List Overview

Domain lists are collections of domain names for Internet or intranet resources, sometimes referred to as "hosted domains," that are being requested by your users.

Domain lists contain one or more domain names that point to content for which the GSS is acting as the authoritative DNS server and for which you wish to use the GSS technology to balance traffic and user requests. Using the domain lists feature, 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.

For example, if you had three hosted domains—www.cisco.com, support.cisco.com, and customer.cisco.com—for which the GSS was responsible, you might want to enter only those domains in your domain list, as follows:

www.cisco.com; support.cisco.com; customer.cisco.com

However, if you had 20 or more possible domains for which the GSS was responsible—www1.cisco.com, www2.cisco.com, and so on—manually entering each address may be time-consuming. In such a situation, you could create a wildcard expression that would cover all those domains, as follows:

.*\.cisco\.com

Any request for a hosted domain that matches the pattern is directed accordingly.

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.

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 5-1).

Figure 5-1 Domain Lists Page

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

Figure 5-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 5-3 Creating New Domain List - Add Domains

6. In the text box provided, enter the names of any hosted domains that you want to add to the domain list. Hosted domains may or may not correspond to standard third-level domain names but cannot exceed 128 characters in length. The following examples could be domain names configured on the GSS:

cisco.com

www.cisco.com

www.support.cisco.com

Domain names that use wildcards are also supported by the GSS. You can enter complete domain names or any regular expression that specifies a pattern by which the GSS can match incoming addresses. For example:

.*\.cisco\.com

These should be the domain names of resources for which the GSS is acting as the authoritative DNS server.

Domain names that do not use wildcards cannot exceed 128 characters. For domain names with wildcards that are valid regular expressions, the GSS can match strings up to 256 characters long.

If you are entering multiple domain names, separate each one with a semicolon, for example:

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

7. Click the Add button. The domains you entered are added to the Domain List.

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

9. Click the Submit button to save your domain list changes.

Figure 5-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 5-1).

3. From the Domain Lists list, click the Modify Domain List icon located to the left of the Domains List 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 5-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 5-3) provided to enter the names of domains you wish to add. Click the Add button to append the new domains to the existing list.

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

Figure 5-5 Modifying Domain List - Remove Domains

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

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

Deleting Domain Lists

You cannot delete domain lists that are associated with an existing DNS rule. Before proceeding with these instructions, first verify that none of your DNS rules reference the domain list that you are deleting.

---

Caution Deletions of any kind cannot be undone in the primary GSSM. If you might want to use the deleted data at a later point in time, we recommend performing a database backup of your GSSM. Refer to Chapter 9, GSS Administration and Troubleshooting for details.

---

To delete a domain list from your GSS network:

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 you want to remove. The Modifying Domain Lists details page appears (Figure 5-5).

Figure 5-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 8, Building and Modifying DNS Rules.

---

5. Click OK. You return to the Domain List list page. The domain list is removed from the list.

Where to Go Next

Chapter 6, Configuring KeepAlives, describes the modification of global keepalives and the creation of shared keepalives.