Table Of Contents

Displaying Global Server Load-Balancing Configuration Information

Displaying Resource Configuration Information

Displaying Location Configuration Information

Displaying Owner Configuration Information

Displaying Region Configuration Information

Displaying Zone Configuration Information

Displaying Source Address Configuration Information

Displaying Domain Configuration Information

Displaying Keepalive Configuration Information

Displaying Shared Keepalive Configuration Information

Displaying Answer Configuration Information

Displaying Answer Group Configuration Information

Displaying DNS Rule Configuration Information

Displaying DNS Sticky Configuration Information

Displaying Global Sticky Group Information

Displaying Global Sticky Properties Information

Displaying DNS Proximity Configuration Information

Displaying Global Proximity Group Information

Displaying Global Proximity Properties Information

Displaying Global Server Load-Balancing Configuration Information

---

The GSS provides a comprehensive set of show gslb-config commands that display GSS global server load-balancing configuration information. These commands allow you to display resource, domain, keepalive, answer, dns rule, sticky, and proximity information for your GSS configuration. The show gslb-config commands are available in all CLI modes except interface configuration mode.

This chapter contains the following major sections:

•Displaying Resource Configuration Information

•Displaying Zone Configuration Information

•Displaying Domain Configuration Information

•Displaying Keepalive Configuration Information

•Displaying Shared Keepalive Configuration Information

•Displaying Answer Configuration Information

•Displaying Answer Group Configuration Information

•Displaying DNS Rule Configuration Information

•Displaying DNS Sticky Configuration Information

•Displaying DNS Proximity Configuration Information

Displaying Resource Configuration Information

To display configuration information about GSS locations, owners, regions and zones, use the show gslb-config location, show gslb-config owner, show gslb-config region and gslb-config zone commands, respectively.

Displaying Location Configuration Information

Use the show gslb-config location command to display information for the currently configured locations on the GSS.

The syntax for the show gslb-config location command is:

show gslb-config location [location_name]

The location_name variable specifies the name of a previously created location. Enter the variable as a case-sensitive, unquoted text string.

Table 11-1 describes the fields in the show gslb-config location command output.

Table 11-1 Field Descriptions for show gslb-config location Command

Field	Description
Location	Name of the location.
Region	The region associated with the location.
Zone	The zone associated with the location.
Comments	Comments about the location.

Displaying Owner Configuration Information

Use the show gslb-config owner command to display information for the currently configured owners on the GSS.

The syntax for the show gslb-config owner command is:

show gslb-config owner [owner_name]

The owner_name variable specifies the name of a previously created owner. Enter the variable as a case-sensitive, unquoted text string.

Table 11-2 describes the fields in the show gslb-config owner command output.

Table 11-2 Field Descriptions for show gslb-config owner Command

Field	Description
Owner	Name of the owner.
Comments	Comments about the owner.

Displaying Region Configuration Information

Use the show gslb-config region command to display information for the currently configured regions on the GSS.

The syntax for the show gslb-config region command is:

show gslb-config region [region_name]

The region_name variable specifies the name of a previously created region. Enter the variable as a case-sensitive, unquoted text string.

Table 11-3 describes the fields in the show gslb-config region command output.

Table 11-3 Field Descriptions for show gslb-config region Command

Field	Description
Region	Name of the region.
Comments	Comments about the region

Displaying Zone Configuration Information

Use the show gslb-config zone command to display information for the currently configured zones on the GSS.

The syntax for the show gslb-config zone command is:

show gslb-config zone [zone_name]

The zone_name variable specifies the name of a previously created zone. Enter the variable as a case-sensitive, unquoted text string.

Table 11-4 describes the fields in the show gslb-config zone command output.

Table 11-4 Field Descriptions for show gslb-config zone Command

Field	Description
Zone	Name of the zone.
Backup IP address	The IP address of the backup probe device servicing the zone.
Index	The numerical identifier for the zone.
Probe IP address	The IP address of the primary probe device servicing the zone.

Displaying Source Address Configuration Information

To display configuration information about GSS source address lists and source addresses, use the show gslb-config source-address-list command.

The syntax for this command is:

show gslb-config source-address-list [source-address-list_name]

The source-address-list_name variable specifies the name of a previously created source address list. Enter the variable as a case-sensitive, unquoted text string.

Table 11-5 describes the fields in the show gslb-config source-address-list command output.

Table 11-5 Field Descriptions for show gslb-config source-address-list Command

Field	Description
Source address list	Name of the source address list.
Owner	The owner name associated with the source address list.
IP addresses	IP addresses or CIDR address blocks of the client DNS proxies for the source address list.
Comments	Comments about the source address list.

Displaying Domain Configuration Information

To display configuration information about GSS domain lists and domains, use the show gslb-config domain-list command.

The syntax for this command is:

show gslb-config domain-list [domain-list_name]

The domain-list_name variable specifies the name of a previously created domain list. Enter the variable as a case-sensitive, unquoted text string.

Table 11-6 describes the fields in the show gslb-config domain-list command output.

Table 11-6 Field Descriptions for show gslb-config domain list Command

Field	Description
Domain address list	Name of the domain list.
Owner	The owner name associated with the domain list.
Domains	Names of hosted domains that are part of the domain list, and for which the GSS acts as the authoritative DNS server.
Comments	Comments about the domain list.

Displaying Keepalive Configuration Information

To display configuration information about GSS keepalive properties, use the show gslb-config keepalive-properties command. The displayed output shows the currently configured properties for ICMP, TCP, HTTP HEAD, KAL-AP, CRA, and NS type keepalives. Both Fast and Standard failure detection mode properties are displayed for ICMP, TCP, HTTP HEAD and KAL-AP keepalive types.

The syntax for this command is:

show gslb-config keepalive-properties

Table 11-7 describes the fields in the show gslb-config keepalive-properties command output.

Table 11-7 Field Descriptions for show gslb-config keepalive-properties Command 

Field	Description
ICMP Keepalives—Standard Failure Detection Mode
interval min	The value that specifies the minimum frequency with which the GSS attempts to schedule ICMP keepalives.
ICMP Keepalives—Fast Failure Detection Mode
retries	The value that specifies the number of times that the GSS retransmits an ICMP echo request packet before declaring the device offline.
successful probes	The number of consecutive successful ICMP keepalive attempts (probes) that must be recognized by the GSS before bringing an answer back online.
TCP Keepalives—Standard Failure Detection Mode
port	The port on the remote device that is to receive the TCP-type keepalive request from the GSS.
termination	The method that the GSS initiates to close a TCP connection (graceful or reset).
timeout	The length of time allowed before the GSS retransmits data to a device that is not responding to a request.
interval min	The minimum frequency with which the GSS attempts to schedule TCP keepalives.
TCP Keepalives—Fast Failure Detection Mode
port	The port on the remote device that is to receive the TCP-type keepalive request from the GSS.
termination	The method that the GSS initiates to close a TCP connection (graceful or reset).
retries	The number of times that the GSS retransmits a TCP packet before declaring the device offline.
successful probes	The number of consecutive successful TCP keepalive attempts (probes) that must be recognized by the GSS before bringing an answer back online.
HTTP HEAD Keepalives—Standard Failure Detection Mode
port	The port on the remote device that is to receive the HTTP HEAD-type keepalive request from the GSS.
path	The server website queried in the HTTP HEAD request (for example, /company/owner).
termination	The method that the GSS initiates to close an HTTP HEAD connection (graceful or reset).
timeout	The length of time allowed before the GSS retransmits data to a device that is not responding to a request.
interval min	The minimum frequency with which the GSS attempts to schedule HTTP HEAD keepalives.
HTTP HEAD Keepalives—Fast Failure Detection Mode
port	The port on the remote device that is to receive the HTTP HEAD-type keepalive request from the GSS.
path	The server website queried in the HTTP HEAD request (for example, /company/owner).
termination	The method that the GSS initiates to close an HTTP HEAD connection (graceful or reset).
interval min	The minimum frequency with which the GSS attempts to schedule HTTP HEAD keepalives.
KAL-AP Keepalives—Standard Failure Detection Mode
capp-key	The secret key to be used for Content and Application Peering Protocol (CAPP) encryption.
interval min	The minimum frequency with which the GSS attempts to schedule KAL-AP keepalives.
KAL-AP Keepalives—Fast Failure Detection Mode
capp-key	The secret key to be used for Content and Application Peering Protocol (CAPP) encryption.
retries	The number of times that the GSS retransmits an KAL-AP packet before declaring the device offline.
successful probes	The number of consecutive successful KAL-AP keepalive attempts (probes) that must be recognized by the GSS before bringing an answer back online.
CRA Keepalives
cra-timing-decay	The value that the GSS uses to weigh recent DNS Round Trip Time (RTT) probe results relative to earlier RTT metrics.
interval min	The minimum frequency with which the GSS attempts to schedule CRA keepalives.
Name Server Keepalives
query-domain	The name of the domain name server to which an NS-type keepalive is sent.
interval min	The minimum frequency with which the GSS attempts to schedule NS keepalives.

Displaying Shared Keepalive Configuration Information

To display configuration information about shared keepalives, use the show gslb-config shared-keepalive command. The displayed output shows the currently configured properties for ICMP, TCP, HTTP HEAD, and KAL-AP shared keepalives.

The syntax for this command is:

show gslb-config shared-keepalive [ip_address]

The ip_address variable specifies the IP address that was specified for any previously configured shared keepalives.

Table 11-8 describes the fields in the show gslb-config shared-keepalive command output.

Table 11-8 Field Descriptions for show gslb-config shared-keepalive Command 

Field	Description
ICMP Shared Keepalives
ip_address	The IP address used to test the online status for the linked VIP.
TCP Shared Keepalives
ip_address	The IP address used to test the online status for the linked VIP
port	The port on the remote device that is to receive the TCP-type keepalive request from the GSS.
termination	The method that the GSS initiates to close a TCP connection (graceful or reset).
HTTP Shared Keepalives
ip_address	The IP address used to test the online status for the linked VIP.
port	The port on the remote device that is to receive the HTTP HEAD-type keepalive request from the GSS.
host tag	Domain name that is sent to the VIP as part of the HTTP HEAD query.
path	The path that is relative to the server website being queried in the HTTP HEAD request.
KAL-AP Shared Keepalives
ip_address	The IP address used to test the online status for the linked VIP.
secondary ip_address	The IP address used to query a second Cisco CSS or CSM in a virtual IP (VIP) redundancy and virtual interface redundancy configuration.
capp-secure enable	Specifies that the capp-secure option is enabled. This option must be enabled if you intend to use Content and Application Peering Protocol (CAPP) encryption.
key	The encryption key that is used to encrypt interbox communications using CAPP.
retries	The number of times that the GSS retransmits an KAL-AP packet before declaring the device offline. Applicable only for Fast failure detection mode.
successful probes	The number of consecutive successful KAL-AP keepalive attempts (probes) that must be recognized by the GSS before bringing an answer back online. Applicable only for Fast failure detection mode.

Displaying Answer Configuration Information

Use the show gslb-config answer command in global server load-balancing configuration mode to display the current property settings for configured answers.

The syntax of this command is:

show gslb-config answer [ip_address {type} | name]

The variables for this command are:

•ip_address—(Optional) Use this option to display answers that specify the IP address. Enter an unquoted text string in dotted-decimal format.

•type—Specifies an answer type for the specified IP address. Valid options are:

–cra—Specifies a CRA-type answer

–ns—Specifies an NS-type answer

–vip—Specifies a VIP-type answer

•name—(Optional) Use this option to display the answer that uses the specified name.

Table 11-9 describes the fields in the show gslb-config answer command output for VIP-, CRA- and NS-type answers.

Table 11-9 Field Descriptions for show gslb-config answer Command 

Field	Description
Output for VIP-Type Answers
type	The answer type (VIP).
ip_address	The VIP address field for the answer. This is the VIP address to which the GSS will forward requests.
name	The optional name for the answer.
location	The optional location name to which the answer is associated.
active/suspend	The current state of the answer (active or suspend).
keepalive type (and configuration information)	The type (ICMP, TCP, HTTP HEAD, or KAL-AP). See Displaying Keepalive Configuration Information for output details for these keepalive types.
Output for CRA-Type Answers
type	The answer type (CRA).
ip_address	The interface or circuit address of the CRA.
name	The optional name for the answer.
location	The optional location name to which the answer is associated.
enable/disable	Enable indicates that the GSS is to perform keepalive checks on the answer. Disable indicates that the GSS uses a one-way delay to calculate a static RTT.
delay	The one-way delay time in milliseconds that is used by the GSS to calculate a static round-trip time (RTT).
active/suspend	The current state of the answer (active or suspend).
Output for Name Server-Type Answers
type	The answer type (NS).
ip_address	The name server that the GSS is to forward its requests.
name	The optional name for the answer.
enable/disable	Enable indicates that the GSS is to perform keepalive checks on the name server. Disable indicates that the GSS assumes that the name server is always online.
domain	The name of the domain name server to which an NS-type keepalive is sent (to determine the online status).
active/suspend	The current state of the answer (active or suspend).

Displaying Answer Group Configuration Information

Use the show gslb-config answer-group command in global server load-balancing configuration mode to display the current property settings for configured answers.

The syntax of this command is:

show gslb-config answer-group [name]

The name variable specifies the name of a specific answer group.

Table 11-10 describes the fields in the show gslb-config answer-group command output for VIP-, CRA- and NS-type answers.

Table 11-10 Field Descriptions for show gslb-config answer-group Command

Field	Description
type	The answer group type (CRA, NS, or VIP).
name	The optional name for the answer group.
owner	The optional owner name to which the answer group is associated.

Displaying DNS Rule Configuration Information

Use the show gslb-config dns rule command in global server load-balancing configuration mode to display the current property settings for all configured dns rules and balance clauses for each rule.

The syntax of this command is:

show gslb-config dns rule [name]

The name variable specifies the name of a previously created dns rule.

Table 11-11 describes the fields in the show gslb-config dns rule command output. Output for balance clauses that use VIP-, NS-, and CRA-type answer groups is also shown.

Table 11-11 Field Descriptions for show gslb-config dns rule
Command 

Field	Description
dns rule name	The name of the DNS rule.
owner	The name of the owner with whom the rule is associated.
source address list	The name of the source address list from which requests originate.
domain list	The name of the domain list to which DNS queries are addressed.
query	The DNS query type (a or all) that is applied to the rule.
sticky method	Displays how (by domain or domain list) the GSS supports DNS stickiness in a DNS rule.
timeout	The time interval that can pass without the sticky database receiving a lookup request for an entry. This value overrides the global value (for this DNS rule).
Output for Balance Clauses that Use VIP-Type Answer Groups
clause number	The balance clause number (1, 2, or 3)
vip-group name	The name of the answer group specified for the clause.
method	The method type for the balance clause: (round-robin, least-loaded, ordered, weighted-round-robin, or hashed)
ttl number	The duration of time in seconds that the requesting DNS proxy caches the response sent from the GSS and considers it to be a valid answer.
count number	The duration of time in seconds that the requesting DNS proxy caches the response sent from the GSS and considers it to be a valid answer.
Output for Balance Clauses that Use NS-Type Answer Groups
clause number	The balance clause number (1, 2, or 3)
vip-group name	The name of the answer group specified for the clause.
method	The method type for the balance clause: (round-robin, ordered, weighted-round-robin, or hashed)
Output for Balance Clauses that Use CRA-Type Answer Groups
clause number	The balance clause number (1 or 2)
vip-group name	The name of the answer group specified for the clause.
ttl number	The duration of time in seconds that the requesting DNS proxy caches the response sent from the GSS and considers it to be a valid answer.
fragment number	The number of address records (A-records) that the GSS to returns for requests that match the DNS rule.
ip-ttl number	The maximum number of network hops that are utilized when returning a response to a CRA from a match on a DNS rule.
max-prop-delay number	The maximum propagation delay (in milliseconds) that is observed before the boomerang server component of the GSS forwards a DNS request to a CRA.
method boomerang	The DNS rule uses boomerang DNS race to determine the best site.
pad	The amount of extra data (in bytes) included with each CRA response packet.
secret key	The key used to encrypt critical data sent between the GSS boomerang server and CRAs.
server-delay number	The maximum delay (in milliseconds) that is observed before the boomerang server component of the GSS returns the address of its "last gasp" server as a response to the requesting name server.

Displaying DNS Sticky Configuration Information

Use the show gslb-config sticky-group and show gslb-config sticky-properties commands to display global sticky group and global sticky property information, respectively. To display sticky method information for currently configured DNS rules, see Displaying Answer Configuration Information.

Displaying Global Sticky Group Information

Use the show gslb-config sticky-group command to display global sticky group information.

The syntax for this command is:

show gslb-config sticky-group [name]

The name variable specifies the name of a previously created sticky group.

Table 11-12 describes the fields in the show gslb-config sticky-group command output.

Table 11-12 Field Descriptions for show gslb-config sticky-group Command

Field	Description
name	The name of the previously created sticky group
ip_address	The IP address of the sticky group.
netmask	The netmask of the sticky group

Displaying Global Sticky Properties Information

Use the show gslb-config sticky-properties command to display information about global sticky settings.

The syntax for this command is:

show gslb-config sticky-properties

Table 11-13 describes the fields in the show gslb-config sticky-properties command output.

Table 11-13 Field Descriptions for show gslb-config sticky-properties Command

Field	Description
enable	Indicates the stickiness enable state (global or local).
mask netmask	Displays the global subnet mask value that the GSS uses to uniformly group contiguous D-proxy addresses as an attempt to increase the number of clients that the sticky database can support.
timeout	Indicates the value for the maximum time period that an unused answer remains valid in the sticky database.

Displaying DNS Proximity Configuration Information

Use the show gslb-config proximity-group and show gslb-config proximity-properties commands to display global proximity group and global proximity property information, respectively.

Displaying Global Proximity Group Information

Use the show gslb-config proximity-group command to display global proximity group information.

The syntax for this command is:

show gslb-config proximity-group [name]

The name variable specifies the name of a previously created proximity group.

Table 11-14 describes the fields in the show gslb-config proximity-group command output.8

Table 11-14 Field Descriptions for show gslb-config proximity-group Command

Field	Description
name	The name of the previously created proximity group.
ip_address	The IP address for the proximity group.
netmask	The netmask for the proximity group.

Displaying Global Proximity Properties Information

Use the show gslb-config proximity-properties command to display information about global proximity settings.

The syntax for this command is:

show gslb-config proximity-properties

Table 11-15 describes the fields in the show gslb-config proximity-properties command output.

Table 11-15 Field Descriptions for show gslb-config sticky-properties
Command 

Field	Description
enable	Indicates the global proximity enable state.
mask netmask	Indicates the global subnet mask that the GSS uses to uniformly group contiguous D-proxy addresses as an attempt to increase the number of supported D-proxies in the PDB.
timeout minutes	Indicates the maximum time interval that can pass without the PDB receiving a lookup request for an entry before the GSS removes that entry.
equivalence number	Indicates the percentage value that the GSS applies to the most proximate RTT value (the closest) to help identify the relative RTT values of other zones that the GSS should consider as equally proximate.
refresh-interval hours	Indicates the frequency of the refresh probing process to probe and update RTT values for the entries in the PDB.
discovery-sequence	Indicates the type of probe method used initially by the Cisco IOS-based router during the probe discovery process with the requesting client's D-proxy.
acceptable-rtt number	Indicates the value that the GSS uses as an acceptable RTT value when determining the most proximate answer.
acceptable-zone number	Indicates the percentage value that the GSS uses to determine if an acceptable number of zones return valid RTT values.
wait enable	Indicates the wait enable state. When enabled, the GSS will wait to perform a proximity selection until it receives the appropriate RTT and zone information based on the proximity settings.
authentication drp enable	Indicates the authentication drp enable state. When enabled, the GSS authenticates packets that it exchanges with the DRP agent in a probing device through the exchange of DRP keys.
key drp	Displays all configured DRP key ID numbers and names.