Cisco GSS CLI-Based Global Server Load-Balancing Configuration Guide (Software Version 1.3) - Configuring Domain Lists [Cisco ACE GSS 4400 Series Global Site Selector Appliances]

Table Of Contents

Configuring Domain Lists

Logging in to the CLI and Enabling Privileged EXEC Mode

Configuring Domain Lists

Deleting Domain Lists and Domains

Displaying Domain List Information

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

Each GSS supports 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:

•Logging in to the CLI and Enabling Privileged EXEC Mode

•Configuring Domain Lists

•Displaying Domain List Information

•Where to Go Next

Logging in to the CLI and Enabling Privileged EXEC Mode

Note To log in and enable privileged EXEC mode in the GSS, you must be a configured user with admin privileges. Refer to the Cisco Global Site Selector Administration Guide for information on creating and managing user accounts.

To log in to the primary GSSM and enable privileged EXEC mode at the CLI:

1. If you are remotely logging in to the primary GSSM through Telnet or SSH, enter the host name or IP address of the GSSM to access the CLI.

If you are using a direct serial connection between your terminal and the GSSM, use a terminal emulation program to access the CLI. For details about making a direct connection to the GSS device using a dedicated terminal and about establishing a remote connection using SSH or Telnet, refer to the Cisco Global Site Selector Getting Started Guide.

2. Specify your GSS administrative username and password to log in to the GSSM. The CLI prompt appears.
gssm1.example.com> 
3. At the CLI prompt, enable privileged EXEC mode as follows:
gssm1.example.com> enable
gssm1.example.com# 
Configuring Domain Lists

To configure a domain list, use the domain-list command in global server load-balancing configuration mode.

The syntax for this command is:

domain-list name [comments text | owner name]

The variables and options for this command are:

•name—Specifies a name for the new domain. Enter a unique alphanumeric name, with a maximum of 80 characters. Spaces are not allowed.

•comments text—(Optional) Specifies descriptive information or important notes about the domain list. Enter a maximum of 256 alphanumeric characters. Comments with spaces must be entered in quotes.

•owner name—(Optional) Specifies an existing owner name with which the domain list is to be associated. See the "Configuring Owners" section in Chapter 2, Configuring Resources.

After you enter the domain-list command, the prompt changes to the domain list mode, where you specify domains to be added to the domain list. To enter multiple domains, repeat the domain command in domain list mode. You can enter a maximum of 500 domains for each 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.

For example, to create a domain list called E-COMMERCE and add the domain DATABASEEXAMPLE.COM to the list, enter:
gssm1.example.com# config
gssm1.example.com(config)# gslb
gssm1.example.com(config-gslb)# domain-list E-COMMERCE owner 
WEB-SERVICES
gssm1.example.com(config-gslb)# domain-list E-COMMERCE comments 
"GLOBAL DOMAIN LIST FOR ECOMMERCE"
gssm1.example.com(config-gslb-dl[dl-name])# domain DATABASEEXAMPLE.COM

Note the following guidelines when entering hosted domains:

•Domain names 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, repeat the domain command:
gssm1.example.com(config-gslb-dl[dl-name])# domain WWW.EXAMPLE.COM
gssm1.example.com(config-gslb-dl[dl-name])# domain 
SUPPORT.EXAMPLE.COM
gssm1.example.com(config-gslb-dl[dl-name])# domain CDM.EXAMPLE.COM
•With the exception of the "?" wildcard, which is not supported, the GSS supports domain names that use wildcards. Wildcard syntax is based on POSIX 1003.2 extended regular expressions. Any request for a hosted domain that matches the pattern is directed accordingly.

For example, if you have 20 or more possible domains that the GSS is responsible for, such as www1.cisco.com, www2.cisco.com, and so on, you can create a wildcard expression that covers all of those domains. For example:
.*\.cisco\.com
For domain names with wildcards that are valid regular expressions, the GSS can match strings up to 256 characters.

Note The use of the "?" wildcard is allowed for domain names only when using the script play-config command to play a GSLB configuration file. Refer to "File Modification Guidelines" in Chapter 10, Creating and Playing GSLB Configuration Files for more information.

Deleting Domain Lists and Domains

If you need to delete a domain list, first verify that none of your DNS rules reference the domain list that you are about to delete. You cannot delete domain lists associated with an existing DNS rule. If necessary, remove 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, enter:
gssm1.example.com(config-gslb)# no domain-list E-COMMERCE
To delete a domain from a domain list, enter:
gssm1.example.com(config-gslb-dl[dl-name])# no domain CDM.EXAMPLE.COM
Displaying Domain List Information

Use the show gslb-config domain-list command to display information about the domain lists currently configured for the GSS.

For example, to display previously created domain lists, enter:
gssm1.example.com(config-gslb)# show gslb-config domain-list
domain-list dl4 owner E-COMMERCE
		 domain DATABASEEXAMPLE.COM
		 domain EXAMPLE.COM
domain-list dl3 owner WEB-GLOBAL
		 domain DATABASEEXAMPLE.COM
		 domain EXAMPLE.COM
domain-list dl2 owner WEB-SERVICES
		 domain DATABASEEXAMPLE.COM
domain-list dl1  owner System
		 domain DATABASEEXAMPLE.COM
		 domain EXAMPLE.COM
Where to Go Next

Chapter 5, Configuring Keepalives, describes how to modify global keepalives and create shared keepalives.

	Cisco GSS CLI-Based Global Server Load-Balancing Configuration Guide (Software Version 1.3)
	Configuring Domain Lists
Cisco GSS CLI-Based Global Server Load-Balancing Configuration Guide (Software Version 1.3) Index Preface Introducing the Global Site Selector Configuring Resources Configuring Source Address Lists Configuring Domain Lists Configuring Keepalives Configuring Answers and Answer Groups Building and Modifying DNS Rules Configuring DNS Sticky Configuring Network Proximity Creating and Playing GSLB Configuration Files Displaying Global Server Load-Balancing Configuration Information Displaying GSS Global Server Load-Balancing Statistics Primary GSSM Global Server Load-Balancing Error Messages Sticky and Proximity XML Schema Files Glossary	Download this chapter Configuring Domain Lists Download the complete book Cisco Global Site Selector CLI-Based Global Server Load-Balancing Configuration Guide Book-Length PDF, Software Version 1.3 (PDF - 5 MB) Table Of Contents Configuring Domain Lists Logging in to the CLI and Enabling Privileged EXEC Mode Configuring Domain Lists Deleting Domain Lists and Domains Displaying Domain List Information 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 IP addresses. Each GSS supports 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: •Logging in to the CLI and Enabling Privileged EXEC Mode •Configuring Domain Lists •Displaying Domain List Information •Where to Go Next Logging in to the CLI and Enabling Privileged EXEC Mode Note To log in and enable privileged EXEC mode in the GSS, you must be a configured user with admin privileges. Refer to the Cisco Global Site Selector Administration Guide for information on creating and managing user accounts. To log in to the primary GSSM and enable privileged EXEC mode at the CLI: 1. If you are remotely logging in to the primary GSSM through Telnet or SSH, enter the host name or IP address of the GSSM to access the CLI. If you are using a direct serial connection between your terminal and the GSSM, use a terminal emulation program to access the CLI. For details about making a direct connection to the GSS device using a dedicated terminal and about establishing a remote connection using SSH or Telnet, refer to the Cisco Global Site Selector Getting Started Guide. 2. Specify your GSS administrative username and password to log in to the GSSM. The CLI prompt appears. gssm1.example.com> 3. At the CLI prompt, enable privileged EXEC mode as follows: gssm1.example.com> enable gssm1.example.com# Configuring Domain Lists To configure a domain list, use the domain-list command in global server load-balancing configuration mode. The syntax for this command is: domain-list name [comments text \| owner name] The variables and options for this command are: •name—Specifies a name for the new domain. Enter a unique alphanumeric name, with a maximum of 80 characters. Spaces are not allowed. •comments text—(Optional) Specifies descriptive information or important notes about the domain list. Enter a maximum of 256 alphanumeric characters. Comments with spaces must be entered in quotes. •owner name—(Optional) Specifies an existing owner name with which the domain list is to be associated. See the "Configuring Owners" section in Chapter 2, Configuring Resources. After you enter the domain-list command, the prompt changes to the domain list mode, where you specify domains to be added to the domain list. To enter multiple domains, repeat the domain command in domain list mode. You can enter a maximum of 500 domains for each 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. For example, to create a domain list called E-COMMERCE and add the domain DATABASEEXAMPLE.COM to the list, enter: gssm1.example.com# config gssm1.example.com(config)# gslb gssm1.example.com(config-gslb)# domain-list E-COMMERCE owner WEB-SERVICES gssm1.example.com(config-gslb)# domain-list E-COMMERCE comments "GLOBAL DOMAIN LIST FOR ECOMMERCE" gssm1.example.com(config-gslb-dl[dl-name])# domain DATABASEEXAMPLE.COM Note the following guidelines when entering hosted domains: •Domain names 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, repeat the domain command: gssm1.example.com(config-gslb-dl[dl-name])# domain WWW.EXAMPLE.COM gssm1.example.com(config-gslb-dl[dl-name])# domain SUPPORT.EXAMPLE.COM gssm1.example.com(config-gslb-dl[dl-name])# domain CDM.EXAMPLE.COM •With the exception of the "?" wildcard, which is not supported, the GSS supports domain names that use wildcards. Wildcard syntax is based on POSIX 1003.2 extended regular expressions. Any request for a hosted domain that matches the pattern is directed accordingly. For example, if you have 20 or more possible domains that the GSS is responsible for, such as www1.cisco.com, www2.cisco.com, and so on, you can create a wildcard expression that covers all of those domains. For example: .\.cisco\.com For domain names with wildcards that are valid regular expressions, the GSS can match strings up to 256 characters. Note* The use of the "?" wildcard is allowed for domain names only when using the script play-config command to play a GSLB configuration file. Refer to "File Modification Guidelines" in Chapter 10, Creating and Playing GSLB Configuration Files for more information. Deleting Domain Lists and Domains If you need to delete a domain list, first verify that none of your DNS rules reference the domain list that you are about to delete. You cannot delete domain lists associated with an existing DNS rule. If necessary, remove 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, enter: gssm1.example.com(config-gslb)# no domain-list E-COMMERCE To delete a domain from a domain list, enter: gssm1.example.com(config-gslb-dl[dl-name])# no domain CDM.EXAMPLE.COM Displaying Domain List Information Use the show gslb-config domain-list command to display information about the domain lists currently configured for the GSS. For example, to display previously created domain lists, enter: gssm1.example.com(config-gslb)# show gslb-config domain-list domain-list dl4 owner E-COMMERCE domain DATABASEEXAMPLE.COM domain EXAMPLE.COM domain-list dl3 owner WEB-GLOBAL domain DATABASEEXAMPLE.COM domain EXAMPLE.COM domain-list dl2 owner WEB-SERVICES domain DATABASEEXAMPLE.COM domain-list dl1 owner System domain DATABASEEXAMPLE.COM domain EXAMPLE.COM Where to Go Next Chapter 5, Configuring Keepalives, describes how to modify global keepalives and create shared keepalives.
	© 1992-2009 Cisco Systems, Inc. All rights reserved. Terms & Conditions \| Privacy Statement \| Cookie Policy \| Trademarks of Cisco Systems, Inc.