-
Cisco GSS Command Reference (Software Version 3.0)
-
CLI Command Summary by Mode
-
Preface
-
Using the Command-Line Interface
-
Cisco Global Site Selector CLI Commands
-
Global Configuration Mode Commands
-
DDoS Module Configuration Mode Commands
-
DRP Agent Configuration Mode Commands
-
Interface Configuration Mode Commands
-
Global Server Load-Balancing Configuration Mode Commands
-
Proximity Properties Configuration Mode Commands
-
Rule Configuration Mode Commands
-
Sticky Properties Configuration Mode Commands
-
Table Of Contents
DRP Agent Configuration Mode Commands
(config-drp) authentication key
(config-drp-path-rtt) probe-type
(config-drp-path-rtt) burst-size
(config-drp-path-rtt) destination-port
(config-drp-path-rtt) sourceport
(config-drp-path-rtt) init-ttl
(config-drp-path-rtt) max-failure-ttl
(config-drp-tcp-rttprobe) destination-port
(config-drp-tcp-rttprobe) sourceport
(config-drp-tcp-rttprobe) timeout
DRP Agent Configuration Mode Commands
The primary GSSM uses Director Response Protocol (DRP) agents to determine the most proximate answer for a DNS request relative to the requesting D-proxy. A DRP agent can be a Cisco IOS-based router or another GSS configured as a DRP agent. This section describes the commands in the DRP agent configuration mode, which enable you to configure DRP agent functions on the GSS.
To access the DRP agent configuration mode, use the drp command in global configuration mode. The CLI prompt then changes to the DRP agent configuration mode as follows:
gssm1.example.com(config)# drpgssm1.example.com(config-drp)#drp [authentication key | enable | probe icmp-rtt | probe path-rtt |
probe tcp-rtt]
authentication key
See the (config-drp) authentication key command for a detailed syntax description.
enable
See the (config-drp) enable command for a detailed syntax description.
probe icmp-rtt
See the (config-drp) probe icmp-rtt command for a detailed syntax description.
probe path-rtt
See the (config-drp) probe path-rtt command for a detailed syntax description.
probe tcp-rtt
See the (config-drp) probe tcp-rtt command for a detailed syntax description.
(config-drp) authentication key
To enable Director Response Protocol (DRP) authentication key chain IDs, use the authentication key command in DRP agent configuration mode. To disable DRP authentication key chain IDs, use the no form of this command.
authentication key key id 0-255
no authentication key key id 0-255
Syntax Description
Command Modes
DRP agent configuration
Examples
The following example shows how to enable DRP authentication key chain ID 240:
gssm1.example.com(config)# drpgssm1.example.com(config-drp)# authentication key 240gssm1.example.com(config-drp)# exitgssm1.example.com(config)#Related Commands
(config-drp) enable
To enable the GSS as a Director Response Protocol (DRP) agent, use the enable command in DRP agent configuration mode. To disable the GSS as a DRP agent, use the no form of this command.
enable
no enable
Syntax Description
This command has no keywords or arguments.
Command Modes
DRP agent configuration
Examples
The following example shows how to enable the GSS as a DRP agent:
gssm1.example.com(config)# drpgssm1.example.com(config-drp)# enablegssm1.example.com(config-drp)# exitgssm1.example.com(config)#The following example shows how to disable the GSS as a DRP agent:
gssm1.example.com(config)# drpgssm1.example.com(config-drp)# no enablegssm1.example.com(config-drp)# exitgssm1.example.com(config)#Related Commands
(config-drp) authentication key
(config-drp) probe icmp-rtt
To configure parameters related to the Internet Control Message Protocol (ICMP) probe, use the probe icmp-rtt command.
probe icmp-rtt timeout
Syntax Description
timeout
See the (config-drp-icmp-rtt) timeout command for a detailed syntax description.
Command Modes
DRP agent configuration.
Usage Guidelines
After you enter the command, the CLI prompt changes and you are in the TCP RTT configuration submode.
Examples
The following example shows how to configure parameters related to the ICMP probe:
gssm1.example.com(config-drp)# probe icmp-rttgssm1.example.com(config-drp-icmp-rtt)#Related Commands
(config-drp) authentication key
(config-drp-icmp-rtt) timeout
To configure a timeout value for the Internet Control Message Protocol (ICMP) probe, use the timeout command. To indicate that no timeout value will be specified, use the no form of this command.
timeout 1-5
no timeout
Syntax Description
1-5
Tmeout value for the ICMP probe. Valid timeout values are from 1-5 seconds with 3 seconds as the default.
Command Modes
ICMP RTT configuration submode
Examples
The following example shows how to configure a timeout value for the ICMP probe:
gssm1.example.com(config-drp-icmp-rtt)# timeout 5gssm1.example.com(config-drp-icmp-rtt)# exitgssm1.example.com(config-drp)#Related Commands
(config-drp) probe path-rtt
To configure parameters related to the path probe, use the probe path-rtt command.
probe path-rtt [probe-type {tcp | udp} | burst-size 1-20 | timeout 1-10 | destination-port 1-65535 | sourceport {dynamic | static} | init ttl 1-32 | max-failure-ttl 1-32 | max ttl 1-255]
Syntax Description
probe-type tcp | udp
See the (config-drp-path-rtt) probe-type command for a detailed syntax description.
burst-size 1-20
See the (config-drp-path-rtt) burst-size command for a detailed syntax description.
timeout 1-10
See the (config-drp-path-rtt) timeout command for a detailed syntax description.
destination-port 1-65535
See the (config-drp-path-rtt) destination-port command for a detailed syntax description.
sourceport dynamic | static 1-65535
See the (config-drp-path-rtt) sourceport command for a detailed syntax description.
init ttl 1-32
See the (config-drp-path-rtt) init-ttl command for a detailed syntax description.
max-failure-ttl 1-32
See the (config-drp-path-rtt) max-failure-ttl command for a detailed syntax description.
max ttl 1-255
See the (config-drp-path-rtt) max ttl command for a detailed syntax description.
Command Modes
DRP agent configuration.
Examples
The following example shows how to configure parameters related to the path probe:
gssm1.example.com(config-drp)# probe icmp-rttgssm1.example.com(config-drp-icmp-rtt)#Related Commands
(config-drp) authentication key
(config-drp-path-rtt) probe-type
To configure the type of packet (UDP or TCP) to be used for path probing, use the probe-type command.
probe-type {tcp | udp}
Syntax Description
Command Modes
Path RTT configuration submode
Examples
The following example shows how to configure the type of packet (UDP or TCP) to be used for path probing:
gssm1.example.com(config-drp)# probe path-rttgssm1.example.com(config-drp-path-rtt)# probe-type udpgssm1.example.com(config-drp-path-rtt)# exitgssm1.example.com(config-drp)#Related Commands
(config-drp-path-rtt) burst-size
(config-drp-path-rtt) destination-port
(config-drp-path-rtt) sourceport
(config-drp-path-rtt) init-ttl
(config-drp-path-rtt) max-failure-ttl
(config-drp-path-rtt) burst-size
To configure the number of TCP-SYN-ACK packets sent at a time, use the burst-size command. To designate that burst sizes will not be sent, use the no form of this command.
burst-size 1-20
no burst-size
Syntax Description
1-20
Number of TCP-SYN-ACK packets sent at a time. Valid values are from 1-20 with a default burst size of 5.
Command Modes
Path RTT configuration submode
Examples
The following example shows how to configure the number of TCP-SYN-ACK packets sent at a time:
gssm1.example.com(config-drp)# probe path-rttgssm1.example.com(config-drp-path-rtt)# burst-size 5gssm1.example.com(config-drp-path-rtt)# exitgssm1.example.com(config-drp)#Related Commands
(config-drp-path-rtt) probe-type
(config-drp-path-rtt) destination-port
(config-drp-path-rtt) sourceport
(config-drp-path-rtt) init-ttl
(config-drp-path-rtt) max-failure-ttl
(config-drp-path-rtt) timeout
To configure the timeout value for the path probe, use the timeout command. To indicate that no timeout value will be configured, use the no form of this command.
timeout 1-10
no timeout
Syntax Description
1-10
Timeout value for the path probe. Valid values are from 1-10 with a default timeout value of 3 seconds.
Command Modes
Path RTT configuration submode
Examples
The following example shows how to configure the timeout value for the path probe:
gssm1.example.com(config-drp)# probe path-rttgssm1.example.com(config-drp-path-rtt)# timeout 3gssm1.example.com(config-drp-path-rtt)# exitgssm1.example.com(config-drp)#Related Commands
(config-drp-path-rtt) probe-type
(config-drp-path-rtt) burst-size
(config-drp-path-rtt) destination-port
(config-drp-path-rtt) sourceport
(config-drp-path-rtt) init-ttl
(config-drp-path-rtt) max-failure-ttl
(config-drp-path-rtt) destination-port
To configure the path probe destination port, use the destination-port command. To indicate that no path probe destination port will be configured, use the no form of this command.
destination-port 1-65535
no destination-port
Syntax Description
1-65535
Path probe destination port value. Valid values are from 1-65535 with a default destination port of 53.
Command Modes
Path RTT configuration submode
Examples
The following example shows how to configure the path probe destination port:
gssm1.example.com(config-drp)# probe path-rttgssm1.example.com(config-drp-path-rtt)# destination-port 555gssm1.example.com(config-drp-path-rtt)# exitgssm1.example.com(config-drp)#Related Commands
(config-drp-path-rtt) probe-type
(config-drp-path-rtt) burst-size
(config-drp-path-rtt) sourceport
(config-drp-path-rtt) init-ttl
(config-drp-path-rtt) max-failure-ttl
(config-drp-path-rtt) sourceport
To configure the path probe source port, use the sourceport command. To indicate that the path probe source port will not be configured, use the no form of this command.
sourceport dynamic | static 1-65535
no sourceport dynamic | static 1-65535
Syntax Description
dynamic
Configures a dynamic path probe source port.
static
Configures a static path probe source port number.
1-65535
Port numbers can range from 1-65535 with a default source port of 53.
Command Modes
Path RTT configuration submode
Examples
The following example shows how to configure the path probe source port:
gssm1.example.com(config-drp)# probe path-rttgssm1.example.com(config-drp-path-rtt)# sourceport static 65530gssm1.example.com(config-drp-path-rtt)# exitgssm1.example.com(config-drp)#Related Commands
(config-drp-path-rtt) probe-type
(config-drp-path-rtt) burst-size
(config-drp-path-rtt) destination-port
(config-drp-path-rtt) init-ttl
(config-drp-path-rtt) max-failure-ttl
(config-drp-path-rtt) init-ttl
To configure an initial Time-to-Live (TTL) for path probing, use the init ttl command. To indicate that no TTL will be configured, use the no form of this command.
init-ttl 1-32
no init-ttl
Syntax Description
Command Modes
Path RTT configuration submode
Examples
The following example shows how to configure an TTL for path probing:
gssm1.example.com(config-drp)# probe path-rttgssm1.example.com(config-drp-path-rtt)# init-ttl 20gssm1.example.com(config-drp-path-rtt)# exitgssm1.example.com(config-drp)#Related Commands
(config-drp-path-rtt) probe-type
(config-drp-path-rtt) burst-size
(config-drp-path-rtt) destination-port
(config-drp-path-rtt) sourceport
(config-drp-path-rtt) max-failure-ttl
(config-drp-path-rtt) max-failure-ttl
To configure an acceptable number of last successive failure packets, use the max-failure-ttl command. To indicate that no acceptable number of failure packets will be configured, use the no form of this command.
max-failure-ttl 1-32
no max-failure-ttl
Syntax Description
1-32
Acceptable number of last successive failure packets. Valid values are from 1-32 with a default of 5.
Command Modes
Path RTT configuration submode
Examples
The following example shows how to configure an acceptable number of last successive failure packets:
gssm1.example.com(config-drp)# probe path-rttgssm1.example.com(config-drp-path-rtt)# max-failure-ttl 12gssm1.example.com(config-drp-path-rtt)# exitgssm1.example.com(config-drp)#Related Commands
(config-drp-path-rtt) probe-type
(config-drp-path-rtt) burst-size
(config-drp-path-rtt) destination-port
(config-drp-path-rtt) sourceport
(config-drp-path-rtt) init-ttl
(config-drp-path-rtt) max ttl
To configure a maximum TTL for path probing, use the max-ttl command. to indicate that no maximum TTL for path probing will be configured, use the no form of this command.
max-ttl 1-255
no max-ttl
Syntax Description
Command Modes
Path RTT configuration submode
Examples
The following example shows how to configure a maximum TTL for path probing:
gssm1.example.com(config-drp)# probe path-rttgssm1.example.com(config-drp-path-rtt)# max-ttl 37gssm1.example.com(config-drp-path-rtt)# exitgssm1.example.com(config-drp)Related Commands
(config-drp-path-rtt) probe-type
(config-drp-path-rtt) burst-size
(config-drp-path-rtt) destination-port
(config-drp-path-rtt) sourceport
(config-drp-path-rtt) init-ttl
(config-drp-path-rtt) max-failure-ttl
(config-drp) probe tcp-rtt
To configure parameters related to TCP probing, use the probe tcp-rtt command.
probe tcp-rtt [destination-port 1-65535 | sourceport {dynamic | static 1-65535} | timeout value]
Syntax Description
destination-port 1-65535
See the (config-drp-tcp-rttprobe) destination-port command for a detailed syntax description.
soureeport dynamic | static 1-65535
See the (config-drp-tcp-rttprobe) sourceport command for a detailed syntax description.
timeout value
See the (config-drp-tcp-rttprobe) timeout command for a detailed syntax description.
Command Modes
DRP agent configuration.
Usage Guidelines
After you enter the command, the CLI prompt changes and you are in the TCP RTT configuration submode.
Examples
The following example shows how to configure parameters related to TCP probing:
gssm1.example.com(config-drp)# probe tcp-rttgssm1.example.com(config-drp-icmp-rtt)#Related Commands
(config-drp) authentication key
(config-drp-tcp-rttprobe) destination-port
To configure a TCP destination port, use the destination-port command. To indicate that no destination port will be configured, use the no form of this command.
destination-port 1-65535
no destination-port
Syntax Description
Command Modes
TCP RTT probe configuration submode
Examples
The following example shows how to configure a TCP destination port:
gssm1.example.com(config-drp)# probe tcp-rttgssm1.example.com(config-drp-tcp-rttprobe)# destination-port 17gssm1.example.com(config-drp-tcp-rttprobe)# exitgssm1.example.com(config-drp)#Related Commands
(config-drp-tcp-rttprobe) sourceport
(config-drp-tcp-rttprobe) timeout
(config-drp-tcp-rttprobe) sourceport
To configure the TCP probe source port, use the sourceport command. To indicate that the TCP probe source port will not be configured, use the no form of this command.
sourceport dynamic | static 1-65535
no sourceport dynamic | static 1-65535
Syntax Description
Command Modes
TCP RTT probe configuration submode
Examples
The following example shows how to configure a TCP probe source port:
gssm1.example.com(config-drp)# probe tcp-rttgssm1.example.com(config-drp-tcp-rttprobe)# sourceport dynamicgssm1.example.com(config-drp-tcp-rttprobe)# exitgssm1.example.com(config-drp)#Related Commands
(config-drp-tcp-rttprobe) destination-port
(config-drp-tcp-rttprobe) timeout
(config-drp-tcp-rttprobe) timeout
To configure the timeout value for the TCP probe, use the timeout command. To indicate that no timeout value will be configured, use the no form of this command.
timeout value
no timeout
Syntax Description
value
Timeout value for the TCP probe. Valid values are from 1- 5 with a default timeout value of 3 seconds.
Command Modes
TCP RTT configuration submode
Examples
The following example shows how to configure the timeout value for the TCP probe:
gssm1.example.com(config-drp)# probe tcp-rttgssm1.example.com(config-drp-tcp-rttprobe)# timeout 4gssm1.example.com(config-drp-tcp-rttprobe)# exitgssm1.example.com(config-drp)#Related Commands
(config-drp-tcp-rttprobe) destination-port
(config-drp-tcp-rttprobe) sourceport