Table Of Contents
Viewing ACE Hardware and Software Configuration Information
Displaying Software Version Information
Displaying Software Copyright Information
Displaying Hardware Information
Displaying Hardware Inventory
Displaying System Processes
Displaying Process Status Information and Memory Resource Limits
Displaying System Information
Displaying ICMP Statistics
Displaying Technical Support Information
Viewing ACE Hardware and Software Configuration Information
The ACE CLI provides a comprehensive set of show commands in Exec mode that you can use to gather ACE hardware and software configuration information. This chapter includes the following major sections:
•
Displaying Software Version Information
•Displaying Software Copyright Information
•Displaying Hardware Information
•Displaying Hardware Inventory
•Displaying System Processes
•Displaying Process Status Information and Memory Resource Limits
•Displaying System Information
•Displaying ICMP Statistics
•Displaying Technical Support Information
To view the contents of the current running-configuration file and startup-configuration file, see Chapter 5, Managing the ACE Software.
Note The show buffer, show cde, show fifo, show hyp, show lcp, show netio, show np, show scp, and show vnet commands display internal system-level hardware show output for use by trained Cisco personnel as an aid in debugging and troubleshooting the ACE. Consult the Cisco Application Control Engine Module Command Reference for background information about those show commands.
Displaying Software Version Information
To display the version of system software that is currently running on the ACE in Flash memory, use the show version command. You use the show version command to verify the software version on the ACE before and after an upgrade.
The syntax for this command is:
show version
For example, to display the entire output for the show version command, enter:
host1/Admin# show version
Cisco Application Control Software (ACSW)
TAC support: http://www.cisco.com/tac
Copyright (c) 2002-2006, Cisco Systems, Inc. All rights reserved.
The copyrights to certain works contained herein are owned by
other third parties and are used and distributed under license.
Some parts of this software are covered under the GNU Public
License. A copy of the license is available at
http://www.gnu.org/licenses/gpl.html.
loader: Version 12.2[117]
system: Version 3.0(0)A1(1) [build 3.0(0)A1(1)
_01:26:21-2006/03/13_/auto/a
dbu-rel/ws/REL_3_0_0_A1_1]
system image file: [LCP] disk0:c6ace-t1k9-mzg.3.0.0_A1_1.bin
licensed features: no feature license is installed
cpu: 0, model: SiByte SB1 V0.2, speed: 700 MHz
cpu: 1, model: SiByte SB1 V0.2, speed: 700 MHz
total: 957816 kB, free: 374588 kB
shared: 0 kB, buffers: 2572 kB, cached 0 kB
total: 500040 kB, used: 449976 kB, available: 50064 kB
last boot reason: reload command by admin
configuration register: 0x1
host kernel uptime is 1 days 10 hours 59 minute(s) 10 second(s)
Displaying Software Copyright Information
To display the software copyright information for the ACE, use the show copyright command. The syntax for this command is:
show copyright
For example, enter:
host1/Admin# show copyright
Cisco Application Control Software (ACSW)
TAC support: http://www.cisco.com/tac
Copyright (c) 2002-2006, Cisco Systems, Inc. All rights reserved.
The copyrights to certain works contained herein are owned by
other third parties and are used and distributed under license.
Some parts of this software are covered under the GNU Public
License. A copy of the license is available at
http://www.gnu.org/licenses/gpl.html.
Displaying Hardware Information
To display ACE hardware inventory details, use the show hardware command. The syntax for this command is:
show hardware
For example, to display the ACE hardware inventory details, enter:
host1/Admin # show hardware
Table 6-1 describes the fields in the show hardware command output.
Table 6-1 Field Descriptions for show hardware Command
Field
|
Description
|
Product Number
|
Product number of the ACE
|
Serial Number
|
Serial number of the ACE
|
Card Index
|
Location of the ACE, specified as an index value
|
Hardware Rev
|
Hardware revision of the ACE
|
Feature Bits
|
Enabled feature bits of the ACE hardware
|
Slot No.
|
Slot number in the Catalyst chassis where the ACE is installed
|
Type
|
Type of module installed in the Catalyst 6500 series chassis.
|
Module Mode
|
Supported internetworking speeds of the in Gigabits per second (Gbps).
|
Displaying Hardware Inventory
To display the system hardware inventory of the ACE, use the show inventory command. This command displays information about the field replaceable units (FRUs) in the ACE, including product identifiers, serial numbers, and version identifiers.
The syntax for this command is:
show inventory [raw]
The optional raw keyword displays information about each temperature sensor in the ACE.
For example, to display the ACE hardware inventory details, enter:
host1/Admin # show inventory
Table 6-2 describes the fields in the show inventory command output.
Table 6-2 Field Descriptions for show inventory Command
Field
|
Description
|
Name
|
Name assigned to the ACE in the Catalyst 6500 series chassis.
|
Descr
|
Description of the of the ACE installed in the Catalyst 6500 series chassis. If you specify the raw keyword, Descr also displays information about each temperature sensor in the ACE.
|
PID
|
Product identifier of the ACE
|
VID
|
Version identifier of the ACE
|
SN
|
Serial number of the ACE
|
Table 6-3 describes the fields in the show inventory raw command output.
Table 6-3 Field Descriptions for show inventory raw Command
Field
|
Description
|
Name
|
Name assigned to the temperature sensor in the ACE
|
Descr
|
Description of the of temperature sensor
|
PID
|
Not applicable
|
VID
|
Not applicable
|
SN
|
Not applicable
|
Displaying System Processes
To display general information about all of the processes running on the ACE, use the show processes command. The show processes command displays summary CPU information for the SiByte 1250 Processor.
The show processes command is available only to Admin users (users with an Admin role) across all contexts. The displayed system processes information is at the CPU system level (the total CPU usage) and is not on a per-context level.
The syntax for this command is:
show processes [cpu | log [details | pid process_id] | memory]
The keywords, arguments, and options are:
•cpu—Displays processes CPU information for the SiByte 1250 Processor, the BCM1250 dual core MIPS processor.
•log—Displays information about process logs.
•details—Displays detailed process log information for all process identifiers.
•pid process_id—Displays process information about a specific process identifier.
•memory—Displays processes memory information.
For example, to display processes memory information for the SiByte 1250 Processor, enter:
host1/Admin# show processes mem
PID MemAlloc StackBase/Ptr Process
----- -------- ----------------- ----------------
1 14592 7fff7f40/7fff77d0 init
Table 6-4 describes the fields in the show processes command output. The show processes command displays summary CPU information for the SiByte 1250 Processor.
Table 6-4 Field Descriptions for show processes Command
Field
|
Description
|
PID
|
Process identifier.
|
State
|
Process state. Included below is a summary of the different process state codes that can appear to describe the state of a process:
•D—Uninterruptible sleep (usually I/O related)
•ER—Error while running
•NR—Not running
•R—Running or runnable (on run queue)
•S—Interruptible sleep (waiting for an event to complete)
•T—Stopped, either by a job control signal or because it is being traced
•W—Paging
•X—Process is dead
•Z—Defunct ("zombie") process, terminated but not reaped by its parent
|
PC
|
Current program counter in hex format.
|
Start_cnt
|
Number of times a process has been started.
|
TTY
|
Terminal that controls the process. A "—" usually means a daemon is not running on any particular tty.
|
Process
|
Name of the process.
|
Table 6-5 describes the fields in the show processes cpu command output.
Table 6-5 Field Descriptions for show processes cpu Command
Field
|
Description
|
CPU Utilization
|
Lists the percentage of CPU utilization for the ACE for a five-second interval, one-minute interval, and a five-minute interval
|
PID
|
Process identifier
|
Runtime (ms)
|
CPU time the process has used, expressed in milliseconds
|
Invoked
|
Number of times the process has been invoked
|
uSecs
|
Microseconds of CPU time in average for each process invocation
|
1 Sec
|
CPU utilization in percentage for the last second
|
5 Sec
|
CPU utilization in percentage for the last five seconds
|
1 Min
|
CPU utilization in percentage for the last minute
|
5 Min
|
CPU utilization in percentage for the last five minutes
|
Process
|
Name of the process
|
Table 6-6 describes the fields in the show processes log command output.
Table 6-6 Field Descriptions for show processes log Command
Field
|
Description
|
Process
|
Name of the process
|
PID
|
Process identifier
|
Normal-exit
|
Indicates whether the process exited normally
|
Stack
|
Indicates whether there is a stack trace in the log
|
Core
|
Indicates whether there exists a core file
|
Log-create-time
|
Time when the log file was generated
|
Table 6-7 describes the fields in the show processes log details | pid command output.
Table 6-7 Field Descriptions for show processes log | pid details Command
Field
|
Description
|
Service
|
Name of the service.
|
Description
|
Brief description of the service.
|
Started at
|
Time the process started.
|
Stopped at
|
Time the process stopped.
|
Uptime
|
Length of time the process was active.
|
Start type
|
System manager option indicating the process restartability characteristics (that is, whether it is a stateless restart or stateful restart).
|
Death reason
|
Reason the system manager killed the process (for example, no sysmgr heartbeats).
|
Exit code
|
Exit code with which the process exited. Normally, the Exit code provides the signal number which killed the process.
|
CWD
|
Current working directory.
|
Virtual memory
|
Virtual memory addresses where the code, data heap, and stack of the process are located.
|
PID
|
Process identifier.
|
SAP
|
Service access point.
|
UUID
|
Universal unique identifier of the SiByte 1250 Processor
|
Table 6-8 describes the fields in the show processes memory command output.
Table 6-8 Field Descriptions for show processes memory Command
Field
|
Description
|
PID
|
Process identifier
|
MemAlloc
|
Total memory allocated by the process
|
StackBase/Ptr
|
Process stack base and current stack pointer in hex format
|
Process
|
Name of the process
|
Displaying Process Status Information and Memory Resource Limits
To display detailed process status information and memory resource limits, use the show terminal internal info Exec mode command.
The syntax for this command is:
show terminal internal info
For example, enter:
host1/Admin# show terminal internal info
Table 6-9 describes the fields in the show terminal internal info command output.
Table 6-9 Field Descriptions for show terminal internal info
Command
Field
|
Description
|
Process Information
|
Name
|
Name of the executable that started the process.
|
State
|
Process state. Included below is a summary of the different process state codes that can appear to describe the state of a process:
•D—Uninterruptible sleep (usually I/O related)
•ER—Error while running
•NR—Not running
•R—Running or runnable (on run queue)
•S—Interruptible sleep (waiting for an event to complete)
•T—Stopped, either by a job control signal or because it is being traced
•W—Paging
•X—Process is dead
•Z—Defunct ("zombie") process, terminated but not reaped by its parent
|
TGID
|
Terminal group identifier.
|
PID
|
Process identifier.
|
PPID
|
Parent process identification number.
|
TracerPID
|
Tracer process identification number.
|
UID
|
Identifier of the user that started the process (four element list).
|
GID
|
Identifier of the group the process belongs to (four element list).
|
FDSize
|
Process file descriptor size.
|
Groups
|
Total number of groups.
|
VmSize
|
Total amount of virtual memory used by the process (in kBytes).
|
VmLck
|
Total locked virtual memory (in kBytes).
|
VmRSS
|
Total amount of physical memory used by the process (in kBytes).
|
VmData
|
Virtual memory data size (in kBytes).
|
VmStk
|
Virtual memory stack size (in kBytes).
|
VmExe
|
Executable virtual memory (in kBytes).
|
VmLib
|
Virtual memory library size (in kBytes).
|
SigPnd
|
Signals pending.
|
SigBlk
|
Signals blocked.
|
SigIgn
|
Signals ignored.
|
SigCat
|
Signals caught.
|
CapInh
|
Capability inherited privilege
|
CapPrm
|
Capability privilege (processor resource manager)
|
CapEff
|
Capability effective privilege
|
Memory Limits
|
Core file size
|
Maximum size of core file (in blocks) that may be created.
|
Data seg size
|
Maximum size (in kbytes) of the data segment for a process.
|
File size
|
Maximum size (in blocks) of files created by the shell.
|
Max locked memory
|
Maximum size (in kbytes) which a process may lock into memory.
|
Max memory size
|
Maximum size (in kbytes) to which a process's resident set size may grow. This imposes a limit on the amount of physical memory to be given to a process.
|
Open files
|
Maximum number of open files for this process.
|
Pipe size
|
Pipe buffer size (in bytes).
|
Stack size
|
Maximum size (in kbytes) of the stack segment for a process.
|
CPU time
|
Maximum amount of CPU time (in seconds) to be used by each process
|
Max user processes
|
Maximum number of simultaneous processes for the user identifier.
|
Virtual memory
|
Maximum amount (in kbytes) of available virtual memory available to the process.
|
Displaying System Information
To display the system information, use the show system command. The syntax for this command is:
show system {error-id {hex_id | list} | internal | resources | uptime}
The keywords, arguments, and options are:
•error-id—Displays description about errors.
•hex_id—The error ID in hexadecimal format. The range is 0x0 to 0xffffffff.
•list—Specifies all error IDs.
•internal—Specifies a series of internal system-level commands for use by trained Cisco personnel only.
•resources—Displays system-related CPU and memory statistics.
•uptime—Displays how long the ACE has been up and running.
For example, to display CPU and memory statistics for the ACE, enter:
host1/Admin# show system resources
Table 6-10 describes the fields in the show system resources command output.
Table 6-10 Field Descriptions for show system resources
Command
Field
|
Description
|
Load average
|
Load is defined as number of running processes. The average reflects the system load over the past one-minute, five-minute, and 15-minute interval.
|
Processes
|
Number of processes in the system, and how many processes are actually running when you issue the command.
|
CPU states
|
The CPU usage percentage in user mode, kernel mode, and idle time in the last one second.
|
Memory usage
|
Total memory, used memory, free memory, memory used for buffers, and memory used for cache in KB. Buffers and cache are also included in the used memory statistics.
|
Table 6-11 describes the fields in the show system uptime command output.
Table 6-11 Field Descriptions for show system uptime Command
Field
|
Description
|
System start time
|
Date and time when the ACE was turned on
|
System uptime
|
Length of time that the ACE hardware and software has been running
|
Kernel uptime
|
Length of time that the operating system (OS) has been running
|
Displaying ICMP Statistics
To display ICMP statistics, use the show icmp statistics command. The syntax for this command is:
show icmp statistics
For example, enter:
host1/Admin # show icmp statistics
Use the clear icmp statistics command to clear the ICMP statistics.
Table 6-12 describes the fields in the show icmp statistics command output.
Table 6-12 Field Descriptions for show icmp-statistics Command
Field
|
Description
|
Total Messages
|
Total number of ICMP messages transmitted or received by the ACE
|
Errors
|
Number of ICMP error messages transmitted or received by the ACE
|
Echo Request
|
Number of ICMP echo request messages transmitted or received by the ACE
|
Echo Reply
|
Number of ICMP echo reply messages transmitted or received by the ACE
|
Unreachable
|
Number of ICMP unreachable packets transmitted or received by the ACE
|
TTL Expired
|
Number of ICMP TTL-expired messages transmitted or received by the ACE
|
Redirect
|
Number of ICMP redirect messages transmitted or received by the ACE
|
Address Mask
|
Number of ICMP Address Mask Request messages transmitted or received by the ACE
|
Param problem
|
Number of ICMP Parameter Problem messages transmitted or received by the ACE
|
Source Quench
|
Number of ICMP Source Quench messages transmitted or received by the ACE
|
Time Stamp
|
Number of ICMP Timestamp (request) messages transmitted or received by the ACE
|
Displaying Technical Support Information
The show tech-support command is useful when collecting a large amount of information about your ACE for troubleshooting purposes with Cisco technical support. The output of this command can be provided to technical support representatives when reporting a problem.
The show tech-support command displays the output of several show commands at once. The output from this command varies depending on your configuration. Use the show tech-support command in Exec mode to display general information about the ACE when reporting a problem.
You can choose to have detailed information for each command or even specify the output for a particular interface or module. Each command output is separated by line and the command precedes the output.
Note Explicitly set the terminal length command to 0 (zero) to disable auto-scrolling and enable manual scrolling. Use the show terminal command to view the configured the terminal size. After obtaining the output of this command, remember to reset you terminal length as required (refer to the "Configuring Terminal Display Attributes" section in Chapter 1, Setting Up the ACE).
Note You can save the output of this command to a file by appending > filename to the show tech-support command see Chapter 5, Managing the ACE Software). If you save this file, verify you have sufficient space to do so; each of these files may take about 1.8 MB.
The default output of the show tech-support command includes the output of the following commands:
•show hardware—Discussed in the "Displaying Hardware Information" section
•show interface—Discussed in the Cisco Application Control Engine Module Routing and Bridging Configuration Guide
•show process—Discussed in the "Displaying System Processes" section
•show running-config—Discussed in Chapter 5, Managing the ACE Software
•show version—Discussed in the "Displaying Software Version Information" section
The syntax for this command is:
show tech-support [details]
The optional details keyword provides detailed information for each show command.
For example, to display an excerpt of current running state of the ACE, enter:
host1/Admin# show tech-support
Cisco Application Control Software (ACSW)
TAC support: http://www.cisco.com/tac
Copyright (c) 2002-2006, Cisco Systems, Inc. All rights reserved.
The copyrights to certain works contained herein are owned by
other third parties and are used and distributed under license.
Some parts of this software are covered under the GNU Public
License. A copy of the license is available at
http://www.gnu.org/licenses/gpl.html.
loader: Version 12.2[117]
system: Version 3.0(0)A1(1) [build 3.0(0)A1(1)
_01:26:21-2006/03/13_/auto/a
dbu-rel/ws/REL_3_0_0_A1_1]
system image file: [LCP] disk0:c6ace-t1k9-mzg.3.0.0_A1_1.bin
licensed features: no feature license is installed
--More--Generating configuration....
cpu: 0, model: SiByte SB1 V0.2, speed: 700 MHz
cpu: 1, model: SiByte SB1 V0.2, speed: 700 MHz
total: 957816 kB, free: 367840 kB
shared: 0 kB, buffers: 2928 kB, cached 0 kB
total: 500040 kB, used: 449976 kB, available: 50064 kB
last boot reason: reload command by admin
configuration register: 0x1
host kernel uptime is 2 days 16 hours 41 minute(s) 20 second(s)
NAME: "module 3", DESCR: "Application Control Engine 8G"
PID: WS-SVC-NTS10-1-K9 , VID: V00, SN: SAD0837030D
Product Number: WS-SVC-NTS10-1-K9
Serial Number: SAD0837030D
Use the tac-pac command in Exec mode to redirect the output of the show tech-support command to a file that you can then send to the disk0: file system on the ACE or to a remote server using File Transfer Protocol (FTP), Secure Copy Protocol (SCP), Secure Transfer Protocol (SFTP), or Trivial Transfer Protocol (TFTP).
Note The output of the show tech-support command is in gzip format. We recommend that you include the .gz extension in the filename so that it can be easily unzipped from the destination filesystem.
The syntax for the command is:
tac-pac {disk0:[path/]filename | {ftp://server/path[/filename] |
sftp://[username@]server/path[/filename] |
tftp://server[:port]/path[/filename]}
The keywords, arguments, and options are:
•disk0:[path/]filename—Specifies that the file destination is the disk0: file system of the current context. If you do not provide the optional path, the ACE copies the file to the root directory on the disk0: file system.
•ftp://server/path[/filename]—Specifies the File Transfer Protocol (FTP) network server and, optionally, the file name.
•sftp://[username@]server/path[/filename]—Specifies the Secure File Transfer Protocol (SFTP) network server and, optionally, the file name.
•tftp://server[:port]/path[/filename]—Specifies the Trivial File Transfer Protocol (TFTP) network server and, optionally, the file name.
For example, to send the output of the show tech-support command to a remote FTP server, enter:
host1/Admin# tac-pac ftp://192.168.1.2/tac-output_10-7-07.gz
