|
|
Table Of Contents
Cisco Global Site Selector Commands
Cisco Global Site Selector Commands
This chapter provides an alphabetical listing of the command-line interface (CLI) commands for the Cisco Global Site Selector (GSS). EXEC, global configuration, and interface configuration commands are all included in this chapter.
Documentation of each command contains some combination of the following information:
•
Command syntax—Information on the correct structure and syntax for the command
•
•
•
For more information on accessing a CLI session, or the different CLI command modes, see "Command-Line Interface Command Summary."
?
To display a list of the available commands and syntax options, use the ? command, for example:
?
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Usage Guidelines
This command displays the commands and syntax options available to you at the point at which you enter the command.
Command Modes
User EXEC, privileged EXEC, global configuration, interface configuration
Examples
In the following example, the ? command displays the possible commands at a variety of junctures.
Host> ?cd Change directorydir Directory listdnslookup Resolve hostname (DNS)enable Turn on privileged commandsexit Exit from the EXECftp Open FTP session to hosthelp Description of the interactive help systemlls list files in long infols Directory listping Ping a remote hostpwd Show present working directoryscp SecureCopy files [scp from to]show Show running system informationtelnet Open telnet session to hosttype View a fileHost> show ?clock Display system clockftp Display ftp statusntp Display NTP configurationssh Display ssh statustelnet Display telnet statusterminal-length Display terminal lengthuptime Display system uptimeuser Display user informationusers Display configured usersversion Display system versionRelated Commands
help
access-group
To assign an access list to an interface on your GSS, use the access-group global configuration command. To disassociate access lists from an interface, use the no form of this command.
access-group name interface {eth0 | eth1}
no access-group name interface {eth0 | eth1}
Syntax Description
Defaults
No default behavior or values
Command Modes
Global configuration
Usage Guidelines
To assign an access list to a GSS interface, use the access-group command. An access list is a set of rules used to filter traffic to the GSS. If no access list is assigned to an interface, that interface will permit all packets to pass to the GSS.
Only one access list can be assigned to an interface at a time.
Examples
Host(config)# access-group icmp-rule eth0Related Commands
access-list
interface
access-list
To configure access lists on the GSS that allow you to permit or deny packet access based on criteria that you establish such as protocol type, source address, or destination port, use the access-list global configuration command. To modify or delete access lists from your GSS, use the no form of this command.
access-list name {permit | deny} protocol [source-address source-netmask | host source-address | any] operator port [port] [destination-port operator port [port]]
no access-list name {permit | deny} protocol [source-address source-netmask | host source-address | any] operator port [port] [destination-port operator port [port]]
Syntax Description
Defaults
No default behavior or values
Command Modes
Global configuration
Usage Guidelines
To accept or deny packets arriving at the GSS based on criteria such as the transfer protocol used and the packet source address, use the access-list command. An access list is a set of rules used to filter traffic to the GSS device. Rules can be used to either permit or deny packets and are associated with a particular interface using the access-group command. Each access list consists of one or more conditions. If a packet does not match any of the access list rules for an interface, it is automatically dropped.
Examples
Host(config)# access-list rule1 1.2.3.4 255.255.255.240 type redirectHost(config)# access-list rule2 permit udp any destination-port eq 80Host(config)# access-list rule3 permit tcp host 1.2.3.4Host(config)# no access-list rule4 permit udp any destination-port eq 80autosense
To enable autosense on an interface, use the autosense interface configuration command. To disable this function, use the no form of this command.
autosense
no autosense
Syntax Description
This command has no arguments or keywords.
Defaults
Autosense is enabled by default.
Command Modes
Interface configuration
Usage Guidelines
The autosense command is part of the suite of interface commands for the GSS and can only be used along with the interface command.
When enabled, the autosense feature allows the current GSS interface to select the proper mode (i.e. full-duplex, half-duplex) for communicating with other network devices.
Make sure that autosense has been disabled before configuring an Ethernet interface. When autosense is on, manual configurations are overridden.
You must reboot the GSS using the reload command following a change to the autosense setting on an interface.
Examples
Host(config)# interface eth0Host(config-eth0)# autosenseHost(config-eth0)# no autosenseRelated Commands
interface
bandwidth
To configure an interface bandwidth, use the bandwidth interface configuration command. To restore default values, use the no form of this command.
andwidth mbits
no bandwidth
Syntax Description
Defaults
No default behavior or values
Command Modes
Interface configuration
Usage Guidelines
Use this command to set the bandwidth on Fast Ethernet interfaces only. Gigabit Ethernet interfaces run at 1000 Mbps only and are not user-configurable.
Examples
Host(config)# interface eth0Host(config-eth0)# bandwidth 10Host(config-eth0)# no bandwidthcd
To change directory, use the cd command in user or privileged EXEC mode.
cd directoryname
Syntax Description
Defaults
No default behavior or values
Command Modes
User and privileged EXEC
Usage Guidelines
Use this command to maneuver between directories and for file management. The directory name becomes the default prefix for all relative paths. Relative paths do not begin with a slash "/". Absolute paths begin with a slash "/".
Enter cd.. to move to the directory that is one level higher than the one you are in.
Examples
Relative path:
Host> cd local1Absolute path:
Host> cd /local1Related Commands
clear
To reset GSS statistics for a specific subsystem, use the clear command in EXEC mode.
clear statistics {boomerang | dns | keepalive {all | cra | http-head | icmp | kalap | ns}}
Syntax Description
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Usage Guidelines
Use the clear command to reset global server load-balancing statistics for one or more of your GSS components. Clearing statistics for a GSS component erases all records of routing activity and performance for that device. When clearing statistics for a keepalive type, you must have at least one of that keepalive type already configured on your network.
Examples
Host# clear statistics boomerangHost# clear statistics dnsAre you sure? (yes/no) yesHost# clear statistics kale craAre you sure? (yes/no) yescra keepalive statistics clearedHost# clear statistics kale kalapAre you sure? (yes/no) yeskal-ap keepalive statistics clearedclock
To set the current time or time zone for a GSS device, use the clock EXEC command.
clock {set hh:mm:ss MONTH DD YYYY | timezone timezonename}
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Examples
In the following examples, the clock command is used to set the GSS device time and time zone.
Host# clock set 13:01:05 march 24 2003Host# clock timezone GMTconfigure
To enter global configuration mode, use the configure command in privileged EXEC mode. You must be in global configuration mode to enter global configuration commands.
configure
To exit global configuration mode, use the end, Ctrl-Z, or exit commands.
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Usage Guidelines
The configure command is a privileged-level command, so you must enter enable before entering configure.
Examples
Host> enableHost# configureHost(config)#Related Commands
Ctrl-Z
copy
To copy configuration settings to or from the GSS device, use the copy command.
copy {disk startup-config filename | startup-config disk filename | running-config {disk filename | startup-config] }
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Usage Guidelines
When supplying an output filename, enter the name only. Do not include path information with the filename.
Examples
In the following examples, the copy command is used to load a new startup configuration to the device from a file, and to copy the current running configuration to a file.
Host# copy disk startup-config configfileHost# copy running config disk runconfigfileRelated Commands
scp
ftp
del
To delete files from your GSS device, use the del command in EXEC mode.
del filename
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Examples
Host> enableHost# del oldtechrept.tgzHost#Related Commands
copy
dir
To view a long list of files in a directory, use the dir EXEC command.
dir [directory]
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Usage Guidelines
Use this command to view a detailed list of files contained within the working directory, including names, sizes, and time created. The equivalent command is lls.
Examples
Host# dirsize time of last change name-------------- ------------------------- -----------3931934 Tue Sep 19 10:41:32 2000 errlog-cache-20000918-164015431 Mon Sep 18 16:57:40 2000 ii.cfg431 Mon Sep 18 17:27:46 2000 ii4.cfg431 Mon Sep 18 16:54:50 2000 iii.cfg1453 Tue Sep 19 10:34:03 2000 syslog.txt1024 Tue Sep 19 10:41:31 2000 <DIR> testdirRelated Commands
ls
lls
disable
To turn off privileged EXEC mode, use the disable command in privileged EXEC mode.
disable
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Usage Guidelines
The disable command places you in user EXEC mode. To turn privileged EXEC mode back on, use the enable command.
Examples
Host# disableHost>Related Commands
dnslookup
To resolve a host or domain name to an IP address, use the dnslookup EXEC command.
dnslookup {hostname | domainname}
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Examples
In the following examples, the dnslookup command is used to resolve the host name myhost.cisco.com to IP address 172.31.69.11, cisco.com to IP address 192.168.219.25, and the IP address 10.0.11.0 to thehost.cisco.com.
Host# dnslookup myhostofficial hostname: myhost.cisco.comaddress: 172.31.69.11Host# dnslookup cisco.comofficial hostname: cisco.comaddress: 192.168.219.25Host# dnslookup 10.0.11.0official hostname: thehost.cisco.comaddress: 10.0.11.0enable
To access privileged EXEC commands, use the enable EXEC command.
enable
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC
Usage Guidelines
To access privileged EXEC mode from user EXEC mode, use the enable command. The disable command takes you from privileged EXEC mode to user EXEC mode.
Examples
Host> enableHost#Related Commands
disable
exit
end
To exit the EXEC or global configuration command shell, use the end EXEC or global configuration command.
end
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
User EXEC, privileged EXEC, and global configuration
Usage Guidelines
Use the end command in any configuration mode to return to EXEC mode. This is equivalent to the Ctrl-Z or the exit command.
The end command issued in the user-level EXEC shell terminates the console or Telnet session.
Examples
Host(config)# endHost# endHost>Related Commands
Ctrl-Z
exit
exec-timeout
To modify the length of time that must expire before a GSS device automatically logs off an inactive user, use the exec-timeout global configuration command.
exec-timeout minutes
no exec-timeout
Syntax Description
minutes
Length of time, in minutes, that accounts must be inactive before they are timed out (0 to 44,640 minutes).
Defaults
The default timeout for a GSS device is 150 minutes.
Command Modes
Global configuration
Usage Guidelines
Use the exec-timeout command in global configuration mode to lengthen or shorten the period for which a user logged on to a GSS device in EXEC mode must be idle before the session is automatically terminated. Users logged on to GSS devices in global configuration mode are not affected by the exec-timeout setting.
Use the no form of this command to erase the exec-timeout setting and restore the default timeout value of 150 minutes on the GSS device.
Examples
Host(config)# exec-timeout 10exit
To access the EXEC command shell from the global, interface, and debug configuration command shells, use the exit EXEC, global configuration, and interface configuration command.
exit
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC, global configuration, and interface configuration
Usage Guidelines
Use the exit command in any configuration mode to return to EXEC mode. This is equivalent to the Ctrl-Z or the end command.
The exit command issued in the user-level EXEC shell terminates the console or Telnet session.
Examples
Host(config)# exitHost# exitHost>Related Commands
end
ftp
To enable File Transfer Protocol (FTP) or launch an FTP session on your GSS device, use the ftp EXEC and global configuration command. Use the no form of this command in global configuration mode to disable FTP on your GSS device.
ftp enable
no ftp enable
Syntax Description
Defaults
FTP is disabled on a GSS device by default.
Command Modes
EXEC and global configuration
Usage Guidelines
Use the ftp enable command in global configuration mode to enable the FTP server on the selected device. Use the ftp command in EXEC or global configuration mode to launch the FTP client, which can be used to transfer a file to and from remote machines.
Examples
Host(config)# ftp enableHost# ftpRelated Commands
show ftp
telnet
scp
fullduplex
To configure an interface for full-duplex operation, use the fullduplex interface configuration command. To disable this function, use the no form of this command.
fullduplex
no fullduplex
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Interface configuration
Usage Guidelines
Use this command to configure an interface for full-duplex operation. Full duplex allows data to travel in both directions at the same time through an interface or a cable. A half-duplex setting ensures that data only travels in one direction at any given time. Although full duplex is faster, the interfaces sometimes cannot operate effectively in this mode. If you encounter excessive collisions or network errors, configure the interface for half duplex rather than full duplex.
Examples
Host(config)# interface eth0Host(config-eth0)# fullduplexHost(config-eth0)# no fullduplexRelated Commands
halfduplex
gss
To manage your GSS devices, use the gss privileged EXEC command.
gss {enable {gssm-primary | gssm-standby {primary_GSSM_hostname | primary_GSSM_IP_address} | gss {primary_GSSM_hostname | primary_GSSM_IP_address}}} | restart | start | status | stop | tech-report filename}
Syntax Description
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Usage Guidelines
The gss command provides a variety of options for managing your GSSs and GSSMs, including:
•
•
•
Examples
Host# gss stopHost# gss statusCisco GSS(1.0.0.22.3) GSS Manager - primary [Wed Jul 10 18:45:25 UTC 2002]Normal Operation [runmode = 5]%CPU %MEM START PID SERVER0.0 0.3 16:23 900 system0.0 0.4 16:23 1170 database0.0 1.6 16:23 1175 tomcat0.0 0.1 16:23 1459 apache0.0 2.2 16:23 1184 crm0.0 1.6 16:23 1216 crdirector0.0 0.1 16:23 1201 dnsserver0.0 0.1 16:23 1240 keepalive0.0 0.1 16:23 1220 boomerang0.0 1.6 16:23 1035 nodemgr0.0 0.0 16:23 419 syslogd--- --- --- --- ucd-snmpd [DISABLED]Related Commands
gssm
gss-communications
gss-tcp-keepalives
gss-communications
To designate the current interface as the interface that will be used for GSS interdevice communication, use the gss-communications interface configuration command. To disable interdevice communications on the selected interface, use the no form of this command.
gss-communications
no gss-communications
Syntax Description
This command has no arguments or keywords.
Defaults
The first Ethernet interface (eth0) is used for interdevice communications by default.
Command Modes
Interface configuration
Examples
Host(config)# interface eth0Host(config-eth0)# gss-communicationsRelated Commands
gss
gss-tcp-keepalives
interface
gssm
To manage your primary and standby Global Site Selector Managers and your GSS database, use the gssm privileged EXEC command.
gssm {backup {database filename | full filename} | database {create | delete | invalidate | maintain | purge-log-records {count number_records | days number_days} | report | status | validate} | primary-to-standby | restore filename | standby-to-primary}
Syntax Description
No default behavior or values
Command Modes
Privileged EXEC
Usage Guidelines
Use the gssm database command to manage the embedded PostgreSQL GSS database. The various command options allow you to monitor the status of your database as well as perform standard maintenance tasks such as backing up and restoring the database, validating database content, and purging records.
Use the gssm standby-to-primary and primary-to-standby options to switch the role of the selected GSSM in your GSS network.
Use the restore option to restore an earlier version of the GSSM from a full backup image.
Examples
Host# gssm database reportGSSM database validation report written to validation.logHost# gssm database statusGSSM database is running.Host# gssm database validateGSSM database passed validation.Host# gssm primary-to-standbyStandby GSSM enabled.Host# gssm standby-to-primaryStandby GSSM disabled.Related Commands
gss
gss-communications
gss-tcp-keepalives
gss-tcp-keepalives
To designate the current interface as the interface that will be used for GSS keepalive communication, use the gss-tcp-keepalives interface configuration command. To disable keepalive communications on the selected interface, use the no form of this command.
gss-tcp-keepalives
no gss-tcp-keepalives
Syntax Description
This command has no arguments or keywords.
Defaults
The first Ethernet interface (eth0) is used for keepalive traffic by default.
Command Modes
Interface configuration
Examples
Host(config)# interface eth0Host(config-eth0)# gss-tcp-keepalivesRelated Commands
gss
gss-communications
interface
halfduplex
To configure an interface for half-duplex operation, use the halfduplex interface configuration command. To disable this function, use the no form of this command.
halfduplex
no halfduplex
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Interface configuration
Usage Guidelines
Use this command to configure an interface for half-duplex operation. Full duplex allows data to travel in both directions at the same time through an interface or a cable. A half-duplex setting ensures that data only travels in one direction at any given time. Although full duplex is faster, the interfaces sometimes cannot operate effectively in this mode. If you encounter excessive collisions or network errors, configure the interface for half duplex rather than full duplex.
Examples
Host(config)# interface eth0Host(config-eth0)# halfduplexHost(config-eth0)# no halfduplexRelated Commands
fullduplex
help
To obtain online help for the command-line interface, use the help EXEC or global configuration command.
help
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC and global configuration
Usage Guidelines
You can get help at any point in a command by entering a question mark (?). If nothing matches, the help list will be empty, and you must back up until entering a ? shows the available options.
Two styles of help are provided:
•
•
Examples
Host# helpHost# help copy ?hostname
To configure the network name of the GSS device, use the hostname global configuration command. To reset the host name to the default setting, use the no form of this command.
hostname name
no hostname name
Syntax Description
name
New host name for the GSS device; the name is case sensitive. The name may be from 1 to 22 alphanumeric characters.
Defaults
The default host name is localhost.localdomain.
Command Modes
Global configuration
Usage Guidelines
Use this command to configure the host name for the GSS device. The host name is used for the command prompts and default configuration filenames. The no form of this command erases the configured host name and restores the default value.
For the purposes of GSS interdevice communications, the hostname should be configured on the same interface (eth0 or eth1) that is being used for GSS communications, as set using the gss-communications command.
Examples
The following example changes the host name to gss1.cisco.com.
localhost.localdomain(config)# hostname gss1.cisco.comgss1.cisco.com(config)#The following example removes the host name.
gss1.cisco.com(config)# no hostname gss1.cisco.comlocalhost.localdomain(config)#Related Commands
gss-communications
interface
ip
install
To install a new version of the GSS software on your GSS device, use the install privileged EXEC command.
install filename
Syntax Description
Command Modes
Privileged EXEC
Usage Guidelines
Use this command to install a new image of the GSS software on the Cisco Global Site Selector hardware. The upgrade file must be present on the Global Site Selector before you execute this command.
Examples
The following example installs an updated version of the GSS software.
Host# install /gss.upgRelated Commands
show version
interface
To configure a GSS Ethernet interface, use the interface global configuration command.
interface Ethernet {0 | 1}{autosense | bandwidth mbits | exit | fullduplex | halfduplex | ip address ip-address netmask | no | gss-communications | shutdown}
Syntax Description
Defaults
No default behavior or values
Command Modes
Global configuration
Usage Guidelines
Use the interface command to configure your GSS device Ethernet interfaces (0 or 1). Commands can be issued directly from global configuration mode, or you can use the interface command to enable interface configuration mode, which makes it easier to configure multiple interface parameters.
To display the interface identifiers (for example, interface Ethernet 0), use the
show running-config or show startup-config commands. The autosense, bandwidth, fullduplex,
halfduplex, ip, and shutdown commands are listed separately in this command reference.Examples
The following example configures an attribute of GSS interface Ethernet 0 with a single CLI command.
Host(config)# interface eth0 half-duplexAn interface can be configured in a sequence of CLI commands as follows.
Host(config)# interface eth0Host(config-eth0)# half-duplexHost(config-eth0)# exitHost(config)#Related Commands
show interface
show running-config
show startup-config
ip
To change initial network device Internet Protocol configuration settings, use the ip global configuration command. To delete or disable these settings, use the no form of this command.
ip {default-gateway ip-address | domain-name name | name-server ip-addresses | route destination_address netmask gateway}
no ip {default-gateway ip-address | domain-name name | name-server ip-addresses | route destination_address netmask gateway}
Syntax Description
Defaults
No default behavior or values
Command Modes
Global configuration
Usage Guidelines
To define a default gateway, use the ip default-gateway global configuration command. To delete the IP default gateway, use the no form of this command. The GSS uses the default gateway to route IP packets when there is no specific route found to the destination.
To define a default domain name, use the ip domain-name global configuration command. To remove the IP default domain name, use the no form of this command. The GSS appends the configured domain name to any host name that does not contain a domain name. The appended name is resolved by the DNS server and then added to the host table. The GSS must have at least one domain name server specified for the host name resolution to work correctly.
To specify the address of one or more name servers to use for name and address resolution, use the ip name-server global configuration command. You can specify up to eight name servers for the GSS device. To disable IP name servers, use the no form of this command.
To configure static IP routing, use the ip route global configuration command. To disable an IP routing, use the no form of this command.
Use the ip route command to add a specific static route for a network host. Any IP packet designated for the specified host uses the configured route.
Examples
Host(config)# ip default-gateway 192.168.7.18Host(config)# no ip default-gatewayHost(config)# ip route 172.16.227.128 172.16.227.250Host(config)# no ip route 172.16.227.128 172.16.227.250Host(config)# ip domain-name cisco.comHost(config)# no ip domain-nameHost(config)# ip name-server 10.11.12.13Host(config)# no ip name-server 10.11.12.14Related Commands
show ip routes
ip address
To configure the IP address of a GSS device network interface, use the ip address interface configuration command. To disable a specific network address, use the no form of this command.
ip address ip-address ip-subnet
no ip address ip-address ip-subnet
Syntax Description
Defaults
No default behavior or values
Command Modes
Interface configuration
Usage Guidelines
Use this command to set or change the IP address and subnet mask of the GSS network interfaces.
The ip address interface configuration command allows configuration of secondary IP addresses for a specified interface as follows.
Host(config)# interface eth0Host(config-eth0)# ip address ip-address ip-subnetThe same IP address cannot be assigned to more than one interface. The following command configures the IP address for the GSS communications interface.
Host(config-eth0)# ip address ip-address ip-subnet gss-communicationsUse the no form of the command to disable a specific IP address.
Host(config-eth0)# no ip address ip-address ip-subnet
Note
Examples
Host(config-eth0)# ip address 10.10.10.10 255.0.0.0Host(config-eth0)# no ip addresslls
To view a long list of directory names, use the lls user EXEC, privileged EXEC, and global configuration command.
lls [directory]
Syntax Description
Defaults
No default behavior or values
Command Modes
User EXEC, privileged EXEC, and global configuration
Usage Guidelines
This command provides detailed information about files and subdirectories stored in the present working directory (including size, date, time of creation, sysfs name, and long name of the file). The dir command can also be used to perform the same function.
Examples
Host# llstotal 97684-rw-r--r-- 1 root root 39 Mar 8 21:04 JVM_EXIT_CODE-rw-r--r-- 1 root root 99706921 Mar 7 15:33 MERLOT.upg-rw-r--r-- 1 root root 9 Mar 14 21:23 RUNMODE-rw-r--r-- 1 root root 33427 Mar 14 21:23 gss.logdrwxr-xr-x 2 root root 4096 Mar 7 16:22 admindrwxr-xr-x 3 root root 4096 Mar 7 18:05 apache-rw-r--r-- 1 root root 117 Mar 7 18:05 audit.logsrwxr-xr-x 1 root root 0 Mar 7 15:40 cli_configsrwxr-xr-x 1 root root 0 Mar 7 15:40 cli_execdrwxr-xr-x 14 root root 4096 Mar 7 18:05 core-files-rw-r--r-- 1 root root 61 Mar 14 21:23 datafeed.cfgsrwxrwxrwx 1 root root 0 Mar 7 15:40 dataserver-socket-rw-r--r-- 1 root root 18 Mar 7 15:39 nicinfo.cfg-rw-r--r-- 1 root root 5072 Mar 7 18:05 node.statedrwxrwxrwx 2 root root 4096 Mar 8 21:04 pid-rw-rw-rw- 1 root root 9127 Mar 14 21:23 props.cfg-rw-r--r-- 1 root root 63 Mar 14 21:23 runmode-comment-rw-r--r-- 1 root root 553 Mar 8 21:02 running.cfgdrwxr-xr-x 4 root root 4096 Mar 8 18:34 squid-rw-r--r-- 1 root root 49 Mar 7 18:05 sysMessages.logdrwxr-xr-x 2 root root 4096 Mar 7 15:40 sysmsgdrwxrwxrwx 2 root root 4096 Mar 8 21:02 sysout-rw-r--r-- 1 root root 41652 Mar 14 21:23 system.logRelated Commands
dir
ls
lsof
logging
To configure system logging on your GSS device, use the logging global configuration command. To disable logging functions, use the no form of this command.
logging {disk {enable | priority loglevel | subsystem name priority loglevel} | host {enable | ip ip_addresses | priority loglevel | subsystem name priority loglevel}}
no logging {disk {enable | priority loglevel | subsystem name priority loglevel} | host {enable | ip ip_addresses | priority loglevel | subsystem name priority loglevel}}
Syntax Description
Defaults
Logging: enabled
Log filename: /...syslog.txt
Command Modes
Global configuration
Usage Guidelines
Use this command to set specific parameters of the system log file. Decisions about what level of logging to use can be made globally, or configured on a subsystem-by-subsystem basis. For example, you could configure the Global Site Selector Manager (crm keyword) to log all error-level messages, but the node manager (nodemgr keyword) to log a larger set of all notice-level messages.
To configure the GSS to send varying levels of event messages to an external syslog host, use the logging host subsystem option. Logging can be configured to send various levels of messages to disk using the logging disk subsystem option.
Examples
Host(config)# logging disk priority errorHost(config)# logging host 10.1.2.3 priority noticeHost(config)# logging disk subsystem crdirector priority informationHost(config)# logging host subsystem kale priority errorHost(config)# no logging disk priority errorRelated Commands
show logging
ls
To view a list of files or subdirectory names within a directory, use the ls user EXEC, privileged EXEC, and global configuration command.
ls [directory]
Syntax Description
Defaults
No default behavior or values
Command Modes
User EXEC, privileged EXEC, and global configuration
Usage Guidelines
To list the filenames and subdirectories within a particular directory, use the ls directory command; to list the filenames and subdirectories of the current working directory, use the ls command. To view the present working directory, use the pwd command.
Examples
Host# lsadmincli_execdumphttp-usersmerlot.logpidsquidsystem.lognode.staterunning.cfgsysouttrace.logRelated Commands
dir
lls
lsof
pwd
lsof
To view a list of all open files on your GSS device, use the lsof EXEC command.
lsof
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Usage Guidelines
To list the names, file properties, and locations of all files that are currently open on your GSS device, use the lsof command.
Examples
Host# lsofCOMMAND PID USER FD TYPE DEVICE SIZE NODE NAMEinit 1 root cwd DIR 8,7 4096 2 /init 1 root rtd DIR 8,7 4096 2 /init 1 root txt REG 8,7 25968 492 /sbin/initinit 1 root mem REG 8,7 341331 29 /lib/ld-2.1.3.soinit 1 root mem REG 8,7 4105868 36 /lib/libc-2.1.3.soinit 1 root 0u unix 0xf7f86f40 5851 socketinit 1 root 10u FIFO 8,8 4098 /rw/dev/initctlkflushd 2 root cwd DIR 8,7 4096 2 /kflushd 2 root rtd DIR 8,7 4096 2 /kflushd 2 root 0u unix 0xf7f86f40 5851 socketkflushd 2 root 10u FIFO 8,8 4098 /rw/dev/initctlkupdate 3 root cwd DIR 8,7 4096 2 /kupdate 3 root rtd DIR 8,7 4096 2 /kupdate 3 root 0u unix 0xf7f86f40 5851 socketkupdate 3 root 10u FIFO 8,8 4098 /rw/dev/initctlkswapd 4 root cwd DIR 8,7 4096 2 /kswapd 4 root rtd DIR 8,7 4096 2 /kswapd 4 root 0u unix 0xf7f86f40 5851 socketkswapd 4 root 10u FIFO 8,8 4098 /rw/dev/initctlkeventd 5 root cwd DIR 8,7 4096 2 /keventd 5 root rtd DIR 8,7 4096 2 /keventd 5 root 0u unix 0xf7f86f40 5851 socketkeventd 5 root 10u FIFO 8,8 4098 /rw/dev/initctl...Related Commands
dir
ls
lls
pwd
no
To undo a global configuration command or set its defaults, use the no form of a global configuration command to undo the original command.
no command
Syntax Description
Defaults
No default behavior or values
Command Modes
Interface configuration, global configuration
Usage Guidelines
Use the no command to disable functions or negate a command. If you need to negate a specific command, such as the default gateway IP address, you must include the specific string in your command, such as no ip default-gateway ip-address.
Examples
Host(config)# no ip name-server 10.11.12.14Host(config)# no ntp server 172.16.22.44ntp-server
To configure the Network Time Protocol (NTP) and to allow the system clock to be synchronized by a time server, use the ntp-server global configuration command. To disable this function, use the no form of this command.
ntp-server {hostname | ip-address}
no ntp-server {hostname | ip-address}
Syntax Description
hostname
Host name of the time server providing the clock synchronization (maximum of 4).
ip-address
IP address of the time server providing the clock synchronization (maximum of 4).
Defaults
The default NTP version number is 3.
Command Modes
Global configuration
Usage Guidelines
Use this command to synchronize the GSS clock with the specified Network Time Protocol server. When specifying more than one server, separate the NTP server addresses using spaces.
Examples
Host(config)# ntp-server 172.16.22.44 172.100.10.17Host(config)# no ntp-server 172.16.22.44Related Commands
clock
show clock
show ntp status
ping
To send Internet Message Control Protocol (ICMP) echo packets for diagnosing basic network connectivity on networks, use the ping EXEC command.
ping {hostname | ip-address}
Syntax Description
Defaults
No default behavior or values
Command Modes
User and privileged EXEC
Usage Guidelines
To use this command with the hostname argument, be sure that the DNS functionality is configured on your GSS. To force the timeout of a nonresponsive host, or to eliminate a loop cycle, press Ctrl-C.
Examples
Host# ping gss.cisco.comPING 172.16.0.0 (172.16.0.0) from 10.1.13.5 : 56(84) bytes of data.64 bytes from gss.cisco.com (172.16.0.0): icmp_seq=0 ttl=35 time=57.3 ms64 bytes from gss.cisco.com (172.16.0.0): icmp_seq=1 ttl=35 time=55.8 ms64 bytes from gss.cisco.com (172.16.0.0): icmp_seq=2 ttl=35 time=55.5 ms64 bytes from gss.cisco.com (172.16.0.0): icmp_seq=3 ttl=35 time=57.6 ms64 bytes from gss.cisco.com (172.16.0.0): icmp_seq=4 ttl=35 time=55.3 msproperty
To manually adjust a system configuration property for your GSS network, use the property global configuration command.
property set property_name property_value
Syntax Description
Defaults
No default behavior or values
Command Modes
Global configuration
Usage Guidelines
The property command should only be used under the direct supervision of a Cisco Technical Support representative. Modifying system configuration properties can cause GSS devices to restart, or require the GSSM to be manually restarted. In addition, modifying a system configuration property, if done improperly, may adversely affect your GSS network.
Examples
Host(config)# property set Gui.Session.Timeout 10pwd
To view the present working directory, use the pwd EXEC command.
pwd
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC
Usage Guidelines
Use this command to display the present working directory of the GSS.
Examples
Host# pwd/adminRelated Commands
cd
dir
lls
ls
reload
To halt and perform a cold restart on your GSS device, use the reload EXEC command.
reload
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Usage Guidelines
To reboot the GSS device, use the reload command. If no configurations are saved to Flash memory, you are prompted to enter configuration parameters upon restart. Any open connections are dropped after you issue this command.
Examples
Host# reloadRelated Commands
write
restore-factory-defaults
To reset your GSS device to its initial state, restoring all factory default settings, use the restore-factory-defaults command in EXEC mode.
restore-factory-defaults
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Usage Guidelines
Should your GSS device be improperly configured or otherwise malfunctioning, the restore-factory-defaults command can be used to restore the device to its initial state, allowing you to properly configure it for use on your network.
The restore-factory-defaults command erases your GSSM database and all of its data and resets all network settings, returning your GSS hardware to the same state it was in when it first arrived from the factory. Make sure that you have backed up any vital data before executing the restore-factory-defaults command.
Examples
Host# restore-factory-defaultsRelated Commands
restore
rotate-logs
To force the GSS device to restart its log files and rotate out the existing log files, use the rotate-logs command, for example:
rotate-logs
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Usage Guidelines
This command forces the GSS device to save archive copies of all existing log files and replace them with fresh log files. Existing log files are archived locally using the following naming convention:
logfile_name.log.~number~
where logfile_name.log is name of the archived log file, for example: gss.log or kale.log, and ~number~ is an incremented number representing the number of times the logs have been rotated. For example, ~3~.
Command Modes
Privileged EXEC
Examples
Host# rotate-logsRelated Commands
logging
scp
To securely copy files from a GSS device that you are logged in to, use the scp command in EXEC mode.
scp {source_path [source_filename] user@target_host:target_path}
To securely copy files from another device to a GSS device you are logged in to, use the scp command in EXEC mode.
scp {user@source_host:/source_path [source_filename] target_path}
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Usage Guidelines
After logging in to the CLI for either the device from which or to which you will be copying, enter the scp command, following the syntax description provided above. You may be prompted to log in to the remote device before you are allowed to navigate to the target directory.
Examples
Host> scp /tmp/system.log 10.1.2.3:/cisco/state/dump/home
Host> scp 10.0.0.0:/cisco/state/mygssmfile.log /cisco/state/dump/homeRelated Commands
ftp
show access-group
To display a list of the access lists associated with your GSS interfaces, use the show access-group EXEC command.
show access-group
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC
Usage Guidelines
The show access-group command displays a list of which access lists are attached to each of the two GSS interfaces, eth0 and eth1.
Examples
Host# show access-groupRelated Commands
access-group
access-list
show access-list
show access-list
To display a list of the access-lists configured on your GSS device, use the show access-list EXEC command.
show access-list
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC
Usage Guidelines
The show access-list command displays a list of access lists on your GSS device, regardless of whether they are being used or not. Access lists must be applied to a particular GSS interface before they can be used to filter GSS traffic.
Examples
Host# show access-listaccess-list:alist1access-list alist1 permit tcp any destination-port eq 80access-list alist1 deny tcp host 192.168.1.101Related Commands
access-group
access-list
show access-group
show clock
To display the system clock, use the show clock EXEC command.
show clock
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC
Examples
The following example shows date and time information, such as day of the week, month, time (hh:mm:ss), and year in Greenwich mean time (GMT).
Host# show clockSystem time: Wed Apr 28 20:52:48 2002 GMTRelated Commands
clock
show ftp
To display the status of FTP on your GSS device, use the show ftp EXEC command.
show ftp
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Usage Guidelines
This command only displays the operating status of FTP and cannot be used to transfer files to or from the GSS device.
Command Modes
EXEC
Examples
In the following example, the show ftp command shows that FTP is enabled.
Host# show ftpftp is disabledRelated Commands
ftp
show telnet
show ssh
show interface
To display hardware interface information, use the show interface EXEC command.
show interface ethernet {eth0 | eth1}
Syntax Description
eth0
First Ethernet interface (eth0) on your GSS device.
eth1
Second Ethernet interface (eth1) on your GSS device.
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Examples
Host# show interface eth0Interface eth0ip address 172.16.10.10 255.255.255.0gss-communicationsautosenseInterface Diagnostic outputBasic registers of MII PHY #1: 3000 782d 02a8 0154 05e1 40a1 0003 0000.Basic mode control register 0x3000: Auto-negotiation enabled.You have link beat, and everything is working OK.Your link partner advertised 40a1: 100baseTx 10baseT.Interface statisticseth0 Link encap:Ethernet HWaddr 00:08:A3:4D:74:12inet addr:172.16.10.10 Bcast:172.16.10.255 Mask:255.255.255.0UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1RX packets:187837 errors:0 dropped:0 overruns:0 frame:0TX packets:98285 errors:0 dropped:0 overruns:0 carrier:0collisions:0 txqueuelen:100Interrupt:9 Base address:0x7400Related Commands
interface
show running-config
show ip routes
To display the IP routing table, use the show ip routes EXEC command.
show ip routes
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Examples
Host# show ip routesKernel IP routing tableDestination Gateway Genmask Flags Metric Ref Use Iface172.16.175.0 0.0.0.0 255.255.255.0 U 0 0 0 eth010.0.0.0 0.0.0.0 255.0.0.0 U 0 0 0 lo0.0.0.0 172.16.175.1 0.0.0.0 UG 0 0 0 eth0Related Commands
ip route
show logging
To display the system message log configuration, use the show logging EXEC command.
show logging
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Examples
Host# show loggingLogging to disk is enabled.Priority for disk logging is Informational(6).Logging to host is disabled.Priority for host logging is Warning(4).Related Commands
log
logging
show logs
To send the log activity to your current session, use the show log EXEC command.
show logs {follow | tail}
Syntax Description
follow
Displays the log file as data is appended to it.
tail
Displays only the last 10 lines of the log file.
Command Modes
Privileged EXEC
Usage Guidelines
Use the show logs command to send the log activity to your current session. The show logs command displays the contents of the gss.log file, which contains information on GSS activity that is most useful to GSS administrators.
Examples
The following example shows how to send the GSS log activity to your current session.
Host# show logsgss.logJul 10 17:11:43 gss1-css SYS-6-GSS-CTRL[3565] Terminating GSSJul 10 17:11:43 gss1-css SYS-7-LIB-FILE[3566] Wrote `/cisco/merlot/state/CONTROL'Jul 10 17:11:43 gss1-css SYS-7-LIB-UTIL[3568] Sending kill to nm-notifier pid: 3466Jul 10 17:11:45 gss1-css NMR-6-NODEMGR[2565] Processing control command.Jul 10 17:11:45 gss1-css NMR-6-NODEMGR[2565] NM Received terminate command.Jul 10 17:11:45 gss1-css NMR-5-NODEMGR[2565] stopping all serversJul 10 17:11:45 gss1-css NMR-6-NODEMGR[2565] Stopping runmode 5 processesJul 10 17:11:45 gss1-css NMR-6-NODEMGR[2565] Stopping: keepalive using external killJul 10 17:11:45 gss1-css NMR-6-NODEMGR[2565] stopping dnsserver Using pe.destroyJul 10 17:11:45 gss1-css CRD-4-SELECTORCOMMERREOF[2772] EOFJul 10 17:11:45 gss1-css CRD-6-SERVERSTATUSCHG[2772] server Selector changes status from Started to 4Jul 10 17:11:45 gss1-css NMR-6-NODEMGR[2565] stopping boomerang Using pe.destroyJul 10 17:11:46 gss1-css CRD-4-KALECOMMERREOF[2772] EOFJul 10 17:11:46 gss1-css CRD-6-SERVERSTATUSCHG[2772] server KALE changes status from Started to 4Jul 10 17:11:47 gss1-css NMR-6-NODEMGR[2565] Runmode 5 servers stopped successfully.Jul 10 17:11:47 gss1-css NMR-6-NODEMGR[2565] Stopping runmode 3 processesJul 10 17:11:47 gss1-css NMR-6-NODEMGR[2565] Stopping: crm using external killJul 10 17:11:48 gss1-css EXTERNAL-6-NONE[3595] Sending command server.stop IControllerJul 10 17:11:49 gss1-css CRM-5-ASERVEXIT[2737] Shutting down with exit code ExitStop while processing command from '172.30.174.77'Jul 10 17:11:49 gss1-css NMR-6-NODEMGR[2565] Stopping: crdirector using external killJul 10 17:11:50 gss1-css NMR-6-NODEMGR[2565] stopping tomcat Using pe.destroyJul 10 17:11:50 gss1-css NMR-6-NODEMGR[2565] Stopping: apache using external kill...Related Commands
logging
show logging
show memory
To display memory blocks and statistics, use the show memory EXEC command.
show memory
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Examples
Host# show memorytotal: used: free: shared: buffers: cached:Mem: 1073311744 79802368 993509376 0 10178560 22958080Swap: 268414976 0 268414976MemTotal: 1048156 kBMemFree: 970224 kBMemShared: 0 kBBuffers: 9940 kBCached: 22420 kBBigTotal: 131072 kBBigFree: 114784 kBSwapTotal: 262124 kBSwapFree: 262124 kBshow ntp
To display the Network Time Protocol (NTP) configuration, use the show ntp EXEC command.
show ntp
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
User EXEC
Examples
Host# show ntp172.28.11.18172.17.9.14Related Commands
ntp
show processes
To display a list of GSS processes, use the show processes EXEC command.
show processes
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Examples
Host# show processesNAME PID MEM CPUTIME START---- --- --- ------- -----system 814 0.3 00:00:00 Mar19postgresql 1068 0.4 00:00:00 Mar19tomcat 31045 2.0 00:00:01 Mar20apache 1321 0.1 00:00:00 Mar19controller 1072 2.3 00:00:07 Mar19CrDirector 1084 1.7 00:00:03 Mar19selector 1536 0.1 00:00:00 Mar19kale 1543 0.1 00:00:00 Mar19nodemgr 932 1.7 00:00:02 Mar19init 1 0.0 00:00:10 Mar19kflushd 2 0.0 00:00:00 Mar19kupdate 3 0.0 00:00:00 Mar19kswapd 4 0.0 00:00:00 Mar19keventd 5 0.0 00:00:00 Mar19mdrecoveryd 6 0.0 00:00:00 Mar19syslogd 286 0.0 00:00:02 Mar19klogd 295 0.0 00:00:00 Mar19crond 495 0.0 00:00:00 Mar19xntpd 655 0.1 00:00:00 Mar19sshd 720 0.0 00:00:06 Mar19run-merlot 814 0.3 00:00:00 Mar19mingetty 835 0.0 00:00:00 Mar19mingetty 836 0.0 00:00:00 Mar19getty 837 0.0 00:00:00 Mar19getty 838 0.0 00:00:00 Mar19parser_server 839 0.3 00:00:00 Mar19dataserver 840 0.0 00:00:00 Mar19java 932 1.7 00:00:02 Mar19...show properties
To display a list of configuration property settings for the GSS device, use the show properties privileged EXEC command.
show properties
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Examples
Host# show propertieslogger.default.LocalThreshold : 7 [default=6]ApacheUseNonSecure : 0DataFeed.persistRate : 600DisableJIT : 0Gui.Session.Timeout : 120LogRotateEntry0 : /cisco/merlot/state/gss.log {LogRotateEntry1 : /cisco/merlot/state/audit.log {LogRotateEntry10 : /cisco/merlot/state/system.log {LogRotateEntry11 : /cisco/merlot/state/cdmAuditTrail.log {LogRotateEntry2 : /cisco/merlot/state/trace.log {LogRotateEntry3 : /cisco/merlot/state/sysMessages.log {LogRotateEntry4 : /cisco/merlot/state/sysout/*.log {LogRotateEntry5 : /cisco/merlot/state/apache/log/*_log {LogRotateEntry6 : /cisco/merlot/state/tomcat/log/*.log {LogRotateEntry7 : /cisco/merlot/state/snmpd/snmpd.log {LogRotateEntry8 : /cisco/merlot/state/snmpd/snmpd.jnk {LogRotateEntry9 : /cisco/merlot/state/snmpd/ucd-snmpd.log {Messenger.messageBinMax : 100Messenger.sendRate : 30000NodeMgr.DisableNodeRestart : 0NodeMgr.DisabledRebootSleepTime : 30NodeMgr.MerlotStopKillTimeout : 12NodeMgr.ProcessStopKillTimeout : 10NodeMgr.RmiCommandTimeout : 15NodeMgr.enableFailureReboot : 0NodeMgr.healthCheckInitWaitSec : 300...Related Commands
property
show running-config
To display the current running configuration information on the terminal, use the show running-config EXEC command. This command replaces the write terminal command.
show running-config
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Usage Guidelines
Use this command in conjunction with the show startup-config command to compare the information in running memory to the startup configuration used during bootup.
Examples
Host# show running-configinterface eth0ip address 10.1.2.46 255.255.255.0gss-communicationshostname gss1.cisco.comip default-gateway 10.1.2.1ip name-server 172.31.102.3gssm database creategssm enable-primaryssh enabletelnet enableRelated Commands
configure
copy running-config
copy startup-config
show ssh
To display Secure Shell (SSH) status and configuration information, use the show ssh EXEC command.
show ssh
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
User EXEC
Examples
Host# show sshssh is enabledRelated Commands
ssh
show startup-config
To display the startup configuration, use the show startup-config EXEC command.
show startup-config
Syntax Description
This command has no keywords or arguments.
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Usage Guidelines
Use this command to display the configuration used during an initial bootup, stored in nonvolatile random-access memory (NVRAM).
Examples
Host# show startup-configinterface eth0ip address 10.1.2.3 255.255.255.0gss-communicationshostname atcr1.cisco.comip default-gateway 10.1.2.1ip name-server 172.31.101.9gssm database creategssm enable-primaryssh enabletelnet enableRelated Commands
configure
copy running-config
show running-config
show statistics
To display GSS load balancing statistics, use the show statistics EXEC command.
show statistics {boomerang {domain domain_name | global } | dns {answer-group {list | group_name [verbose]} | domain {list | domain_name [verbose]}| domain-group {list | domain_group_name [verbose]}| global | rule {list | rule_name [verbose]}| source-address-group {list | source-address_group_name [verbose]}} | keepalive {all | cra {IP_address | list}| global | http-head {IP_address | list} | icmp {IP_address | list} | kalap {IP_address | list} | ns {IP_address | list}}}
Syntax Description
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Usage Guidelines
Use the show show statistics command to display content routing and load-balancing statistics for each component of your GSS global server load-balancing operation: boomerang (CRAs), DNS, and keepalives. The show statistics command is used to gauge DNS traffic flow to and from your GSS device, as well as report on the status of GSS devices across your network, and on the success of the device in matching incoming DNS requests to answers on the GSS network. For example, the show statistics command can be used to view the traffic handled by a particular DNS rule, which matches D-proxies to answers, or to analyze the traffic to a particular hosted domain being managed by the GSS.
When viewing DNS statistics, the verbose option allows you to view detailed statistics on each component of your DNS rules, for example, statistics for each answer that makes up an answer group, or each domain that makes up a domain group.
Examples
Host# show statistics dns answer-group ChrisAGWizardtotalHitCount=0Host# show statistics dns answer-group ChrisAGWizard verbosetotalHitCount=0id addr hitCount status-----------------------------------------------183 10.0.0.0 0 down185 10.1.0.0 0 down181 10.2.0.0 0 downHost# show statistics rule ChrisRRtotalHitCount=0, totalSuccessCount=0Clause 0 hitCount=0 successCount=0id address hitCount------------------------------------------70 10.222.0.0 080 10.223.0.0 1274 10.224.0.0 0Host# show statistics globalBMASDnsQueriesRcvd =9BMASDnsHostAddrQueriesRcvd =6BMASDnsResponsesSent =2BMASDnsReponsesNoError =2BMASDnsResponsesErrors =0BMASDnsQueriesUnmatched =7BMASDnsDrops =0BMASDnsNSFWDSent =0BMASDnsBoomServReqSent =0BMASDnsNSFWDResponsesRcvd =0BMASDnsReqRatePerSecondCur =0BMASDnsReqRatePerSecondPeak=0Host# show statistics domain-group foo-newtotalHitCount=0DomainName HitCount-----------------------------------------www.foo.com 0gif.foo.com 0www.cdn.foo.com 0Related Commands
clear
show logs
show system-status
show system-status
To display a report on the current operating status of your GSS device, including the online status, current software version used, as well as memory and CPU usage for each of the GSS components, use the show system-status EXEC command.
show system-status
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Examples
Host# show system-statusCisco GSS(1.0.0.22.3) GSS Manager - primary [Mon Jul 22 16:56:37 UTC 2002]Normal Operation [runmode = 5]%CPU %MEM START PID SERVER0.0 0.3 Jul10 900 system0.0 0.4 Jul10 1170 database0.0 1.9 Jul10 1175 tomcat0.0 0.1 Jul10 1459 apache0.0 2.3 Jul10 1184 crm0.0 1.8 Jul10 1216 crdirector0.0 0.1 Jul10 1201 dnsserver0.0 0.1 Jul10 1240 keepalive0.0 0.1 Jul10 1220 boomerang0.0 2.4 Jul10 1035 nodemgr0.0 0.0 Jul10 419 syslogd--- --- --- --- ucd-snmpd [DISABLED]Related Commands
gss status
gssm database status
gssm database report
show tech-support
To display a report on the current operating status of your GSS device that can be used by Cisco technical support representatives to help troubleshoot problems on your GSS network, use the show tech-support privileged EXEC command.
show tech-support
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Privileged EXEC, global configuration
Examples
Host(config)# show tech-supportCisco GSS(1.0.0.22.3) GSS Manager - primary [Mon Jul 22 16:58:30 UTC 2002]Normal Operation [runmode = 5]%CPU %MEM START PID SERVER0.0 0.3 Jul10 900 system0.0 0.4 Jul10 1170 database0.0 1.9 Jul10 1175 tomcat0.0 0.1 Jul10 1459 apache0.0 2.3 Jul10 1184 crm0.0 1.8 Jul10 1216 crdirector0.0 0.1 Jul10 1201 dnsserver0.0 0.1 Jul10 1240 keepalive0.0 0.1 Jul10 1220 boomerang0.0 2.4 Jul10 1035 nodemgr0.0 0.0 Jul10 419 syslogd--- --- --- --- ucd-snmpd [DISABLED]==> /var/log/messages <==2002-07-10 16:23:08 relog: Booting...==> /cisco/merlot/state/acr.log <====> /cisco/merlot/state/system.log <==Jun 15 07:11:40 host-css2 rc: Stopping keytable succeededJun 15 07:11:42 host-css2 inet: inetd shutdown succeededJun 15 07:11:45 host-css2 crond: crond shutdown succeededJun 15 07:11:46 host-css2 dd: 1+0 records inJun 15 07:11:46 host-css2 dd: 1+0 records outJun 15 07:11:46 host-css2 random: Saving random seed succeededJun 15 07:11:48 host-css2 kernel: Kernel logging (proc) stopped.Jun 15 07:11:48 host-css2 kernel: Kernel log daemon terminating.Jun 15 07:11:50 host-css2 syslog: klogd shutdown succeededJun 15 07:11:51 host-css2 exiting on signal 15==> /cisco/merlot/state/apache/log/error_log <==...Related Commands
tcpdump
show telnet
To display the status of the Telnet option on your GSS device, use the show telnet EXEC command.
show telnet
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
User EXEC
Usage Guidelines
This command only displays the operating status of Telnet and cannot be used to connect to remote devices.
Examples
In the following example, the show telnet command indicates that Telnet is enabled.
Host# show telnettelnet is enabledRelated Commands
telnet
show ftp
show ssh
show terminal-length
To display the terminal length setting for your GSS device, use the show terminal-length user EXEC command.
show terminal-length
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
User EXEC
Usage Guidelines
This command displays the maximum number of rows of data that are output at once during a terminal session.
Examples
Host# show terminal-lengthterminal length 23Related Commands
terminal-length
show uptime
To find out how long the GSS device has been running, use the show uptime EXEC command.
show uptime
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
User EXEC
Examples
In the following example, the show uptime command displays how long the GSS device has been running.
Host# show uptimeSystem has been up for 7 Days 5 Hours 22 Minutesshow user
To display user information for a particular user, use the show user EXEC command.
show user username name
Syntax Description
Defaults
No default behavior or values
Command Modes
User EXEC
Examples
Host# show user username paulr-adminpaulr-admin adminRelated Commands
show users
show users
To display users, use the show users EXEC command.
show users
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
User EXEC
Examples
Host# show userslstar adminadmin adminpaulr-admin adminRelated Commands
show user
show version
To display version information about the GSS software, use the show version EXEC command.
show version
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
User EXEC
Examples
Host# show versionGlobal Site Selector (GSS)Copyright (c) 1999-2002 by Cisco Systems, Inc.Version 1.0(0.22.3)Compiled Tue Jul 9 16:56:08 2002 by atripath - changeset 25175uptime is 2 Hours 13 Minutes and 59 secondsModel Number: GSS-4480-K9shutdown
To shut down the operating system on the GSS device, use the shutdown EXEC command. To shut down a particular Ethernet interface on the GSS device use the shutdown interface configuration command.
shutdown
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Privileged EXEC, interface configuration
Usage Guidelines
The shutdown command performs a shutdown of the GSS operating system or interface. In some cases, the GSS device will also be powered down following a shutdown.
Examples
Host# shutdownHost(config)# interface eth0Host(config-eth0)# shutdownsnmp
To enable Simple Network Management Protocol (SNMP) on your GSS device, use the snmp command in global configuration mode.
snmp enable
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration
Examples
Host(config)# snmp enableRelated Commands
ftp
ntp
ssh
telnet
ssh
To enable or disable Secure Shell (SSH) on the GSS device, use the ssh command. Use the no form of this command to disable SSH.
ssh enable
no ssh enable
Syntax Description
Defaults
No default behavior or values
Command Modes
Global configuration
Examples
Host(config)# ssh enableRelated Commands
telnet
tail
To display the last ten lines of a file, use the tail EXEC command.
tail filename
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Usage Guidelines
Use this command to display the end of a file within any GSS file directory. This command may be used to monitor features such as transaction logging or system logging (syslog).
Examples
Host# tail system.logShowing file system.logJun 15 07:11:40 host-css2 rc: Stopping keytable succeededJun 15 07:11:42 host-css2 inet: inetd shutdown succeededJun 15 07:11:45 host-css2 crond: crond shutdown succeededJun 15 07:11:46 host-css2 dd: 1+0 records inJun 15 07:11:46 host-css2 dd: 1+0 records outJun 15 07:11:46 host-css2 random: Saving random seed succeededJun 15 07:11:48 host-css2 kernel: Kernel logging (proc) stopped.Jun 15 07:11:48 host-css2 kernel: Kernel log daemon terminating.Jun 15 07:11:50 host-css2 syslog: klogd shutdown succeededJun 15 07:11:51 host-css2 exiting on signal 15End of file system.log...Related Commands
dir
lls
ls
lsof
mkfile
type
tcpdump
To output all TCP traffic to and from a particular GSS interface, use the tcpdump EXEC command.
tcpdump {eth0 | eth1}
Syntax Description
eth0
Interface Ethernet 0, the first network interface on the Global Site Selector.
eth1
Interface Ethernet 1, the second network interface on the Global Site Selector.
Defaults
No default behavior or values
Command Modes
EXEC
Usage Guidelines
The tcpdump command outputs a record of all TCP traffic to and from a named interface to the screen.
Examples
This is an example of the tcpdump command and its output.
Host# tcpdump eth0Kernel filter, protocol ALL, datagram packet sockettcpdump: listening on eth019:20:45.678641 > gssm.cisco.com.ssh > 10.1.2.3.1178: P 2126255246:2126255346(100) ack 4828790 win 32680 (DF) [tos 0x10]19:20:45.680534 > gssm.cisco.com.49165 > gss.cisco.com.domain: 9217+ PTR? 187.0.1.2.in-addr.arpa. (43)19:20:45.681090 < gss.cisco.com.domain > gssm.cisco.com.49165: 9217 NXDomain* 0/1/0 (111)19:20:45.681421 > gssm.cisco.com.49165 > gss.cisco.com.domain: 9218+ PTR? 172.13.89.10.in-addr.arpa. (42)19:20:45.681984 < gss.cisco.com.domain > gssm.cisco.com.49165: 9218* 1/2/2 PTR gssm.cisco.com. (145)19:20:45.682396 > gssm.cisco.com.49165 > gss.cisco.com.domain: 9219+ PTR? 172.5.89.10.in-addr.arpa. (41)19:20:45.682950 < gss.cisco.com.domain > gssm.cisco.com.49165: 9219* 1/2/2 PTR gss.cisco.com. (142)19:20:45.683218 > gssm.cisco.com.ssh > 10.1.2.3.1178: P 100:376(276) ack 1 win 32680 (DF) [tos 0x10]19:20:45.683568 > gssm.cisco.com.ssh > 10.1.2.3.1178: P 376:748(372) ack 1 win 32680 (DF) [tos 0x10]19:20:45.683902 > gssm.cisco.com.ssh > 10.1.2.3.1178: P 748:1120(372) ack 1 win 32680 (DF) [tos 0x10]19:20:45.688517 > gssm.cisco.com.ssh > 10.1.2.3.1178: P 1120:1372(252) ack 1 win 32680 (DF) [tos 0x10]19:20:45.696298 B arp who-has 192.168.1.1 tell 192.168.1.219:20:45.696506 > gssm.cisco.com.49165 > gss.cisco.com.domain: 9220+ PTR? 10.128.1.2.in-addr.arpa. (44)19:20:45.697003 < gss.cisco.com.domain > gssm.cisco.com.49165: 9220 NXDomain 0/1/0 (109)19:20:45.697173 > gssm.cisco.com.49165 > gss.cisco.com.domain: 9221+ PTR? 22.128.168.192.in-addr.arpa. (45)19:20:45.697471 < 10.1.2.3.1178 > gssm.cisco.com.ssh: . 1:1(0) ack 0 win 8600 (DF)19:20:45.697649 < gss.cisco.com.domain > gssm.cisco.com.49165: 9221 NXDomain 0/1/0 (110)19:20:45.697922 > gssm.cisco.com.ssh > 10.1.2.3.1178: P 1372:1696(324) ack 1 win 32680 (DF) [tos 0x10]telnet
To establish a Telnet connection to a GSS device, use the telnet command in EXEC or global configuration mode.
telnet [enable] [hostname | ip-address]
Syntax Description
Defaults
No default behavior or values.
Command Modes
User EXEC, privileged EXEC, and global configuration
Usage Guidelines
SSH and Telnet can run concurrently.
Examples
Host(config)# telnet enableHost# telnet 10.1.2.3Related Commands
ftp
ntp
snmp
ssh
terminal-length
To adjust the amount of screen information that can be displayed at one time on your terminal, use the terminal global configuration command.
terminal-length number
no terminal-length
Syntax Description
Defaults
The default terminal length is 23 lines.
Command Modes
Global configuration
Usage Guidelines
The terminal-length command allows you to adjust the number of rows of output that will be sent to your terminal screen at once by the GSS. The maximum number of rows is 512.
When terminal-length is set to 0, the GSS sends all of its data to the screen at once, without pausing.
Use the no form of this command to restore the default terminal length, 23 lines.
Examples
Host(config)# terminal-length 512Host(config)# no terminal-lengthtraceroute
To display the route to a host destination, use the traceroute EXEC command.
traceroute {hostname | ip address}
Syntax Description
hostname
Host name of the device to which you want to trace the packet route.
ip-address
IP address of the device with which you want to trace the packet route.
Defaults
No default behavior or values
Command Modes
EXEC
Usage Guidelines
Use this command to display the route a packet takes to a host destination that you specify.
Examples
Host> traceroute www.cisco.comtraceroute to www.cisco.com (192.133.219.25), 30 hops max, 38 byte packets1 bxb11-bb-gw1 (172.20.33.22) 1.112 ms 0.377 ms 0.353 ms2 bxb11-man-gw2 (10.1.2.3) 0.586 ms 0.342 ms 0.314 ms3 ch2-man-gw2 (10.3.4.5) 4.462 ms 4.135 ms 4.558 ms4 sjck-rbb-gw2 (172.16.3.4) 75.958 ms 75.953 ms 75.891 ms5 sj-wall-1 (172.18.6.7) 76.292 ms 76.336 ms 75.971 ms6 sjce-dirty-gw1 (172.21.240.197) 77.098 ms 76.664 ms 76.286 ms7 sjck-sdf-ciod-gw2 (172.21.239.102) 77.437 ms 77.845 ms 76.462 ms8 * * *9 * www (192.133.219.25) 78.627 ms *WHAT_ID HOW ===...type
To display a file, use the type EXEC command.
type filename
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Usage Guidelines
Use this command to display the contents of a file within any GSS file directory. This command can be used to monitor features such as transaction logging or system logging (syslog).
Examples
Host# type /audit.logatcr1.cisco.com>type audit.log# Start logging at Tue Jan 22 23:59:30 GMT 2002#=== WHEN WHAT_TABLE WHAT_ID HOW ===# Start logging at Wed Jan 23 00:01:25 GMT 2002#=== WHEN WHAT_TABLE WHAT_ID HOW ===# Start logging at Thu Jan 31 14:42:40 GMT 2002#=== WHEN WHAT_TABLE WHAT_ID HOW ===...Related Commands
dir
lls
ls
lsof
mkfile
tail
username
To establish username authentication, use the username global configuration command.
username name {password word privilege {user | admin} | delete}
Syntax Description
Defaults
No default behavior or values
Command Modes
Global configuration
Usage Guidelines
The username global configuration command is used to create new user or administrative accounts, change the password and privilege level for existing user accounts, or delete existing accounts.
Examples
The following example demonstrates how a new account can be set up or removed from a GSS device.
Host(config)# username testuser password mypassword privilege userHost(config)# exitHost# show user username testusertestuser userHost(config)# username testuser deleteRelated Commands
show user
show users
write
To save the current running configuration of the GSS as its startup configuration, use the write EXEC or global configuration command.
write memory
Syntax Description
memory
Saves recent configuration changes to the GSS that are stored in memory as the startup configuration.
Defaults
No default behavior or values
Command Modes
Privileged EXEC, global configuration
Usage Guidelines
Use the write command to save changes to the running configuration of the GSS device as the new startup configuration for device.
Examples
Host# write memory
Posted: Mon Mar 21 11:33:31 PST 2005
All contents are Copyright © 1992--2005 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.
