![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() |
This chapter describes the EXEC commands you use to monitor and troubleshoot general system processes on your network server. These processes include:
This chapter also provides a general overview of these system tasks:
See the chapters containing information about the interfaces and the protocols supported by Cisco software for descriptions of the interface- and protocol-specific debugging and monitoring commands.
Most of the network management commands are executed at the privileged-level prompt, although there is a subset of monitoring commands that you may enter at the user-level prompt.
An alphabetically arranged summary of the commands described in this chapters is included at the end of this chapter.
Use the EXEC show commands to display data structures, configuration parameters, and usage statistics for the network server. To list all the available show command options, enter this command at the EXEC prompt.
show ?Two different lists may be displayed, one at the user-level prompt, and one at the enabled, privileged-level prompt. The lists include a summary of the command function, for easy reference. See the chapter "First-Time Startup and Basic Configuration" for the procedure to enter these levels.
Use this EXEC command to monitor the Environmental Monitor card:
show envThe command displays measurement statistics for this card.
The network server has one pool of queuing elements and five pools of packet buffers of different sizes. For each pool, the network server keeps counts of the number of buffers outstanding, the number of buffers in the free list, and the maximum number of buffers allowed in the free list. To display statistics for the buffer pools on the network server, use the show buffers command. Enter this command at the EXEC prompt:
show buffers [interface]The optional argument interface causes a search of all buffers that have been associated with that interface for longer than one minute. The contents of these buffers will be printed to the screen. This option is useful in diagnosing problems where the input queue count on an interface is consistently nonzero.
Following is sample output without the optional interface argument. Table 5-1 describes the fields seen.
Buffer elements:
250 in free list (250 max allowed)
10816 hits, 0 misses, 0 created
Small buffers, 104 bytes (total 120, permanent 120):
120 in free list (0 min, 250 max allowed)
26665 hits, 0 misses, 0 trims, 0 created
Middle buffers, 600 bytes (total 90, permanent 90):
90 in free list (0 min, 200 max allowed)
5468 hits, 0 misses, 0 trims, 0 created
Big buffers, 1524 bytes (total 90, permanent 90):
90 in free list (0 min, 300 max allowed)
1447 hits, 0 misses, 0 trims, 0 created
Large buffers, 5024 bytes (total 0, permanent 0):
0 in free list (0 min, 100 max allowed)
0 hits, 0 misses, 0 trims, 0 created
Huge buffers, 12024 bytes (total 0, permanent 0):
0 in free list (0 min, 30 max allowed)
0 hits, 0 misses, 0 trims, 0 created
0 failures (0 no memory)
Field Description
Buffer elements Blocks of memory used in internal operating system
queues
Small buffers Blocks of memory used to hold network packets
Middle buffers
Big buffers
Large buffers
Huge buffers
hits Count of successful attempts to allocate a buffer
when needed
misses Count of allocation attempts which failed for lack
of a free buffer in the pool
created Count of new buffers created
trims Count of buffers destroyed
in free list Number of buffers of a given type which are not
currently allocated and are available for use
max allowed The maximum number of buffers of a given type
allowed in the system
failures The total number of allocation requests that have
failed for lack of a free buffer
no memory Number of failures due to a lack of memory to
create a new buffer
To show statistics about the memory, use the show memory command. Enter this command at the EXEC prompt:
show memoryThis command displays memory free pool statistics. These statistics include summary information about the activities of the system memory allocator, and a block-by-block listing of memory use. Sample output follows. Table 5-2 describes the fields seen; Table 5-3 lists the characteristics of each block of memory in the system.
Head Free Start Total Bytes Used Bytes Free Bytes
Processor 148B8C 1D66B0 2847860 561252 2286608
Address Bytes Prev. Next Free? PrevF NextF Alloc PC What
148B8C 916 0 148F20 7B8E *Init*
148F20 2024 148B8C 149708 ADEE *Init*
149708 536 148F20 149920 AE18 *Init*
149920 2024 149708 14A108 4A7C *Init*
14A108 72 149920 14A150 2492C *Init*
14A150 44 14A108 14A17C 36114 *Init*
14A17C 152 14A150 14A214 1DBC *Init*
14A214 2024 14A17C 14A9FC 1DE0 *Init*
14A9FC 152 14A214 14AA94 1DBC *Init*
14AA94 2024 14A9FC 14B27C 1DE0 *Init*
14B27C 100 14AA94 14B2E0 3F2FE Logger
14B2E0 152 14B27C 14B378 1DBC Router Init
14B378 480 14B2E0 14B558 y 1CE270 1CA938 5E85A IGRP Router
14B558 100 14B378 14B5BC 57A8E DECnet Input
14B5BC 60 14B558 14B5F8 y 1CAFC4 1CA508 5EF08 IGRP Router
14B5F8 72 14B5BC 14B640 7B830 XNS Router
14B640 72 14B5F8 14B688 7B830 XNS Router
14B688 52 14B640 14B6BC 7B840 XNS Router
14B6BC 88 14B688 14B714 C724C Virtual Exec
14B714 60 14B6BC 14B750 C7602 Virtual Exec
14B750 480 14B714 14B930 y 1D1768 1CAFC4 5E85A IGRP Router
Field Description
Head The hexadecimal address of the head of the
memory allocation chain
Free Start The hexadecimal address of the base of the free list
Total Bytes The total amount of system memory
Used Bytes The amount of memory in use
Free Bytes The amount of memory not in use
Field Description
Address Hexadecimal address of block
Bytes Size of block in bytes
Prev Address of previous block (should match Address on
previous line)
Next Address of next block (should match address on
next line)
Free? Tells if the block is free
Alloc PC Address of the system call that allocated the block
What Name of process that owns the block
To see information about the active processes, use the show processes command. Enter this command at the EXEC prompt:
show processesFollowing is a partial display of the command output. Table 5-4 describes the fields seen.
PID Q T PC Runtime (ms) Invoked uSecs Stacks TTY Process 1 M E 17518 40072 830 48279 606/800 0 Net Background 2 M E 5040 932 11 84727 486/800 0 Logger 32 M E 4C390 73012 6141 11889 480/800 0 IGRP Router 4 M E 22984 172 252 682 662/800 0 BOOTP Server 5 H E 5040 100324 66619 1505 606/900 0 IP Input 6 M E 21278 12188 22451 542 508/800 0 IP Protocols 7 M E 32F32 32 10926 2 592/800 0 TCP Timer 8 L E 33C1E 508 28 18142 576/800 0 TCP Protocols 9 L E 5040 1104 935 1180 666/800 0 ARP Input 10 L E 5040 352 458 768 674/800 0 Probe Input 11 H E 5040 2636 9077 290 710/800 0 Net Input 12 M T 2CF2 36976 49175 751 602/800 0 TTY Background 13 H E 5040 0 2 0 852/900 0 DECnet Input 14 M E 44AE4 21964 18029 1218 742/900 0 DECnet Routing 15 H E 5040 2848 6556 434 686/800 0 XNS Input 16 L E 5040 220 1642 133 748/800 0 XNS Protocols 17 L E 59794 13660 3310 4126 632/800 0 XNS Router 18 H E 5040 16652 59410 280 832/1000 0 AT Input 19 L E 5040 13508 59201 228 884/1000 0 AT Protocols 20 L E 73E0C 107496 40799 2634 832/1000 0 AT RTMP 21 L E 5040 56 31 1806 814/1000 0 AT NBP 22 L E 73E4A 84928 28526 2977 736/1000 0 AT ZIP
Field Description
PID Process ID
Q Queue priority (high, medium, low)
T Scheduler test (Event, Time, Suspended)
PC Current program counter
Runtime (ms) CPU time the process has used, in milliseconds
Invoked Number of times the process has been invoked
uSecs Microseconds of CPU time for each invocation
Stacks Low water mark/Total stack space available
TTY Process Terminal that controls the process and name of
process
To show stack utilization, use the show stacks command. Enter this command at the EXEC prompt:
show stacksThe show stacks command monitors the stack utilization of processes and interrupt routines. Its display includes the reason for the last system reboot. If the system was reloaded because of a system failure, a saved system stack trace is displayed. This information can be useful for analyzing crashes in the field.
To display the contents of the nonvolatile memory, if present and valid, use the show configuration command. Enter this command at the EXEC prompt:
show configurationThe nonvolatile memory stores the configuration information in the network server in text form as configuration commands.
To show the state of logging (syslog), use the show logging command. Enter this command at the EXEC prompt:
show loggingThis command displays the state of syslog error and event logging, including host addresses, and whether console logging is enabled. This command also displays SNMP (Simple Network Management Protocol) configuration parameters and protocol activity. See the section "Redirecting System Error Messages" in the chapter "Configuring the System" for an explanation of how to configure message logging. Following is a sample output. Table 5-5 describes the fields seen.
Syslog logging: enabled
Console logging: disabled
Monitor logging: level debugging, 266 messages logged.
Trap logging: level informational, 266 messages logged.
Logging to 131.108.2.238
SNMP logging: disabled, retransmission after 30 seconds
0 messages logged
Field Description
Syslog logging When enabled, system logging messages are sent to
a UNIX host which acts as a syslog server--that is,
it captures and saves the messages.
Console logging If enabled, states the level; otherwise this field
displays disabled.
Monitor logging The minimum level of severity required for a log
message to be sent to a monitor terminal (not the
console).
Trap logging The minimum level of severity required for a log
message to be sent to syslog server.
SNMP logging Shows whether SNMP logging is enabled and the
number of messages logged, and the retransmission
interval.
To display the configured protocols, use the show protocols command. Enter this command at the EXEC prompt:
show protocolsThe command shows the global and interface-specific status of any configured Level 3 protocol; for example, IP, DECnet, Novell, AppleTalk, and so forth. The following is sample output:
Global values:
Internet Protocol routing is enabled
DECNET routing is enabled
XNS routing is enabled
Appletalk routing is enabled
X.25 routing is enabled
Ethernet 0 is up, line protocol is up
Internet address is 131.108.1.1, subnet mask is 255.255.255.0
Decnet cost is 5
XNS address is 2001.AA00.0400.06CC
AppleTalk address is 4.129, zone Twilight
Serial 0 is up, line protocol is up
Internet address is 192.31.7.49, subnet mask is 255.255.255.240
Ethernet 1 is up, line protocol is up
Internet address is 131.108.2.1, subnet mask is 255.255.255.0
Decnet cost is 5
XNS address is 2002.AA00.0400.06CC
AppleTalk address is 254.132, zone Twilight
Serial 1 is down, line protocol is down
Internet address is 192.31.7.177, subnet mask is 255.255.255.240
AppleTalk address is 999.1, zone Magnolia Estates
The network server includes software to aid in tracking down problems with the network server or with other hosts on the network. The privileged EXEC command debug enables the display of several classes of network events on the console terminal. The privileged undebug command turns off the display of these classes. The EXEC command show debugging displays the state of each debugging option. See the section "Redirecting System Error Messages" in the chapter "Configuring the System" for an explanation of how to configure message logging.
To list and briefly describe all the debug command options, enter the debug ? command at the privileged-level EXEC prompt. This section provides an overview of how to use the debugging commands. See the interface and protocol-specific chapters for the debug command descriptions.
To turn on all system diagnostics, enter this command at the EXEC prompt:
debug allIts converse, the undebug all command, turns off all diagnostic output.
As an aid to diagnosing basic network connectivity, many network protocols support the packet internet groper (ping) program, which sends an echo request packet to an address, then awaits a reply. Results from this echo protocol can help in evaluating the path-to-host reliability, delays over the path, and whether the host can be reached or is functioning.
To implement this program, use the privileged EXEC command ping. When the ping command is entered, the system issues a prompt for one of the following protocol keywords--appletalk, clns, ip, novell, pup, or xns.
The default protocol is IP. After determining the protocol type, the ping command prompts for an address or host name, repeat count (default is 5), datagram size (default is 100 bytes), time-out interval (default is 2 seconds), and extended commands (default is none). The precise dialog varies from protocol to protocol.
If a host name or address is typed on the same line as the EXEC ping command, the default actions will be taken as appropriate for the protocol type of that name or address.
The ping command uses the exclamation point (!) and period (.) in its display. Each exclamation point indicates receipt of a reply. A period (.) indicates the network server timed out while waiting for a reply. Other characters may appear in the ping output display, depending on the protocol type. The output concludes with the success rate and minimum, average, and maximum round-trip times.
To abort a ping session, type the escape sequence (by default, Ctrl-^, X).
Sample displays and tips for using these protocols are included in the chapters describing the protocols supported by the Cisco ping command.
The trace command is a useful debugging command which allows the network administrator to discover the routes packets will actually take when travelling to their destination. The trace command supports IP, CLNS and VINES route tracing.
trace [destination]To invoke a simple trace test, enter the destination address or host name on the command line. The default parameters for the appropriate protocol are assumed and the tracing action begins.
To use nondefault parameters and invoke an extended trace test, enter the command without a destination argument. You will be stepped through a dialog to select the desired parameters.
Typing the escape sequence (by default, Ctrl-^, X) terminates a trace command. See the IP, ISO CLNS and VINES chapters for more information about using this command.
This section describes the privileged write commands used to manage the system configuration information.
To erase the configuration information, use the following EXEC command:
write eraseThis command erases the configuration information in the nonvolatile memory. This command does not affect the configuration in use.
To copy the configuration to memory, use the following EXEC command:
write memoryThis command copies the current configuration information to the nonvolatile memory.
To copy the configuration to the network, use the following EXEC command:
write networkThis command sends a copy of the current configuration information to a server host. You are prompted for a destination host and a file name.
To write configuration on the terminal, use the following EXEC command:
write terminalThis command displays the current configuration information on the terminal.
Included as part of the EXEC command set are commands that allow testing of system interfaces and memory.
![]() | Caution Use of these commands is not recommended, as they are intended to aid Cisco manufacturing personnel in checking out system functionality. |
To test the system interfaces, use this EXEC command:
test interfacesThe EXEC test interfaces command is intended for the factory checkout of network interfaces. It is not intended for diagnosing problems with an operational router. The test interfaces output will not report correct results if the router is attached to a "live" network. For each network interface that has an IP address that can be tested in loop back (MCI and cBus Ethernet and all serial interfaces), the test interface command sends a series of ICMP echoes. Error counters are examined to determine the operational status of the interface.
To test system memory, use this EXEC command:
test memoryThe EXEC command test memory performs a test of Multibus memory, including the nonvolatile memory.
![]() | Caution This test will overwrite the contents of memory. You will need to rewrite nonvolatile memory after running this command. If you test Multibus memory (for example, the memory used by the CSC-R four megabit Token Ring interfaces), you will need to reload the system to restore correct operation of the network interfaces. |
This section list all the EXEC system management and user commands in alphabetical order.
debug ?
Lists and briefly describes all the debug command options.
[un]debug all
Enables all diagnostic output. Its converse, the undebug all command, turns off all diagnostic output.
ping
Provides a diagnostic tool for testing connectivity. Results help evaluate path-to-host reliability, delays over the path, and whether the host is functioning.
show ?
The show ? command lists all the show command options. Two lists may be displayed, one at the user-level prompt, and one at the enabled, privileged-level prompt.
show buffers [interface]
Displays statistics for the buffer pools on the network server. The network server has one pool of queuing elements and four pools of packet buffers of different sizes. For each pool, the network server keeps counts of the number of buffers outstanding, the number of buffers in the free list, and the maximum number of buffers allowed in the free list. With the optional argument interface, this command searches all buffers that have been associated with the interface for longer than one minute.
show configuration
Displays the contents of the nonvolatile memory, if present and valid. The nonvolatile memory stores the configuration information in the network server in text form as configuration commands.
show debugging
Displays the current settings of the debug command options.
show logging
Displays the state of syslog error and event logging, including host addresses and whether console logging is enabled. This command also displays SNMP configuration parameters and protocol activity.
show memory
Displays memory free pool statistics. These statistics include summary information about the activities of the system memory allocator, and a block-by-block listing of memory use.
show processes
Displays information about all active processes.
show protocols
Displays the global and interface-specific status of any configured Level 3 protocol.
show stacks
Monitors the stack utilization of processes and interrupt routines. Its display includes the reason for the last system reboot. If the system was reloaded because of a system failure, a saved system stack trace is displayed. This information can be useful to support personnel for analyzing crashes in the field.
test interfaces
Intended for the factory checkout of network interfaces. It is not intended for diagnosing problems with an operational router.
test memory
Performs a test of Multibus memory, including the nonvolatile memory
trace [destination]
Allows the network administrator to discover the routes packets will actually take when travelling to their destination. The trace command supports both IP and CLNS route tracing. Typing the escape sequence terminates trace.
write erase
Erases the configuration information in the nonvolatile memory. This command does not affect the configuration in use.
write memory
Copies the current configuration information to the nonvolatile memory.
write network
Sends a copy of the current configuration information to a server host. You are prompted for a destination host and a file name.
write terminal
Displays the current configuration information.
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() |