Table Of Contents
Displaying ACE Hardware and Software System Information
Information About Displaying ACE Hardware and Software Information
Displaying Hardware Information
Displaying Installed Software Information
Displaying System Processes and Memory Resources Limits
Displaying General System Process Information
Displaying Detailed Process Status Information and Memory Resource Limits
Displaying System Information
Displaying or Clearing ICMP Statistics
Displaying or Collecting Technical Information for Reporting Problems
Displaying ACE Hardware and Software System Information
This chapter describes how to display ACE hardware and software system information.
This chapter does not include information for displaying the running- or startup-configuration files. To display the contents of these files, see Chapter 4, Managing the ACE Software.
This chapter contains the following major sections:
•
Information About Displaying ACE Hardware and Software Information
•Displaying Hardware Information
•Displaying Installed Software Information
•Displaying System Processes and Memory Resources Limits
•Displaying System Information
•Displaying or Clearing ICMP Statistics
•Displaying or Collecting Technical Information for Reporting Problems
Information About Displaying ACE Hardware and Software Information
The ACE CLI provides a comprehensive set of show commands in Exec mode that you can use to gather the following system information:
•Installed hardware and software information
•System processes
•System information
•Technical support
The show buffer, show fifo, show netio, show np, 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. For background information about theose show commands, see the Cisco 4700 Series Application Control Engine Appliance Command Reference.
Displaying Hardware Information
To display ACE hardware information, perform one of the following tasks:
Command
|
Purpose
|
show hardware
|
Displays the ACE hardware details.
|
show inventory [raw]
|
Displays the system hardware inventory of the ACE. This command displays information about the field replaceable units (FRUs) in the ACE, including product identifiers, serial numbers, and version identifiers.
The optional raw keyword displays information about each component in the ACE.
|
Table 5-1 describes the fields in the show hardware command output.
Table 5-1 Field Descriptions for the show hardware Command
Field
|
Description
|
Product Number
|
Product number of the ACE
|
Serial Number
|
Serial number of the ACE
|
Hardware Rev
|
Hardware revision of the ACE
|
VID
|
Version identification number of the ACE
|
MFG Part Num
|
Manufacturing part number of the ACE
|
MFG Revision
|
Manufacturing revision of the ACE
|
Slot No.
|
Not applicable
|
Type
|
Identifies the device type as an ACE appliance
|
Table 5-2 describes the fields in the show inventory command output.
Table 5-2 Field Descriptions for the show inventory Command
Field
|
Description
|
Name
|
Name assigned to the ACE component
Note If you do not specify the raw keyword, the only named object that displays is the ACE appliance. If you specify the raw keyword, each monitored component of the ACE displays
|
Descr
|
Description of the ACE component
|
PID
|
Product identifier of the ACE
|
VID
|
Hardware revision of the ACE
|
SN
|
Serial number of the ACE
|
Examples
The following example shows the output of the show hardware command:
host1/Admin # show hardware
Product Number: ACE-4710-K9
Serial Number: QCN21220038
MFG Part Num: 800-29070-02
Displaying Installed Software Information
To display the installed software copyright or version information for the ACE, perform one of the following tasks:
Command
|
Purpose
|
show copyright
|
Displays the software copyright information for the ACE.
|
show version
|
Displays the version of system software that is currently running on the ACE in Flash memory.
You use the show version command to verify the software version on the ACE before and after an upgrade.
|
Examples
The following example shows the output for the show copyright command:
host1/Admin# show copyright
Cisco Application Control Software (ACSW)
TAC support: http://www.cisco.com/tac
Copyright (c) 1985-2010, 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.
The following example shows the output for the show version command:
host1/Admin# show version
Cisco Application Control Software (ACSW)
TAC support: http://www.cisco.com/tac
Copyright (c) 1985-2010 by 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.
system: Version A4(1.0) [build 3.0(0)A4(1.0) adbuild_03:31:25-2010/09/17
6_/auto/adbure_nightly2/nightly_rel_a4_1_0_throttle/REL_3_0_0_A4_1_0
system image file: (hd)c4710ace-t1k9-mz.A4_1_0.bin
Device Manager version 4.1 (0) 20080805:0415
installed license: ACE-AP-VIRT-020 ACE-AP-C-1000-LIC
total: 6226392 kB, free: 4315836 kB
shared: 0 kB, buffers: 17164 kB, cached 0 kB
total: 935560 kB, used: 611564 kB, available: 276472 kB
last boot reason: Unknown
configuration register: 0x1
kernel uptime is 0 days 21 hours 25 minute(s) 17 second(s)
Displaying System Processes and Memory Resources Limits
This section describes how display system processes and memory resource limits and contains the following topics:
•Displaying General System Process Information
•Displaying Detailed Process Status Information and Memory Resource Limits
Displaying General System Process Information
To display general information about all of the processes running on the ACE, perform the following task:
Command
|
Purpose
|
show processes [cpu | log [details | pid process_id] | memory]
|
Displays general information about all of the processes running on the ACE. This command is available only to 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 show processes command with no options displays summary CPU information for the Intel Pentium processor.
The keywords, arguments, and options are:
•cpu—Displays CPU information for the Intel Pentium processor
•log—Displays information about process logs
•details—Displays process log information for all process identifiers
•pid process_id—Displays information about a specific process identifier
•memory—Displays memory information about the processes
|
Table 5-3 describes the fields in the show processes command output for the summary CPU information.
Table 5-3 Field Descriptions for the 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 hexadecimal 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 5-4 describes the fields in the show processes cpu command output.
Table 5-4 Field Descriptions for the show processes cpu Command
Field
|
Description
|
CPU Utilization
|
Lists the percentage of CPU utilization for the ACE for a 5-second interval, 1-minute interval, and a 5-minute interval
|
PID
|
Process identifier
|
Runtime (ms)
|
CPU time the process has used, expressed in milliseconds
|
Invoked
|
Number of times that the process has been invoked
|
uSecs
|
Microseconds of CPU time as an average for each process invocation
|
1 Sec
|
CPU utilization as a percentage for the last second
|
5 Sec
|
CPU utilization as a percentage for the last 5 seconds
|
1 Min
|
CPU utilization as a percentage for the last minute
|
5 Min
|
CPU utilization as a percentage for the last 5 minutes
|
Process
|
Name of the process
|
Table 5-5 describes the fields in the show processes log command output.
Table 5-5 Field Descriptions for the show processes log Command
Field
|
Description
|
Process
|
Name of the process
|
PID
|
Process identifier
|
Normal-exit
|
Status of whether the process exited normally
|
Stack
|
Status of whether a stack trace is in the log
|
Core
|
Status of whether a core file exists
|
Log-create-time
|
Time when the log file was generated
|
Table 5-6 describes the fields in the show processes log details | pid command output.
Table 5-6 Field Descriptions for the 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 that the process was active.
|
Start type
|
System manager option that indicates the process restartability characteristics (that is, whether it is a stateless restart or stateful restart).
|
Death reason
|
Reason that the system manager killed the process (for example, no sysmgr heartbeats).
|
Exit code
|
Exit code with which the process exited.
Note 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 CPU.
|
Table 5-7 describes the fields in the show processes memory command output.
Table 5-7 Field Descriptions for the 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
|
Examples
The following example shows the output for the show processes mem command:
host1/Admin# show processes mem
PID MemAlloc StackBase/Ptr Process
----- -------- ----------------- ----------------
1 495616 bffffed0/bffff9c0 init
Displaying Detailed Process Status Information and Memory Resource Limits
To display detailed process status information and memory resource limits, perform the following task:
Command
|
Purpose
|
show terminal internal info
|
Displays detailed process status information and memory resource limits.
|
Table 5-8 describes the fields in the show terminal internal info command output.
Table 5-8 Field Descriptions for the 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
|
SleepAVG
|
Percentage sleep rate of the task.
|
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 that 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 KB).
|
VmLck
|
Total locked virtual memory (in KB).
|
VmRSS
|
Total amount of physical memory used by the process (in KB).
|
VmData
|
Virtual memory data size (in KB).
|
VmStk
|
Virtual memory stack size (in KB).
|
VmExe
|
Executable virtual memory (in KB).
|
VmLib
|
Virtual memory library size (in KB).
|
VmPTE
|
Virtual memory pointer size (in kBytes)
|
Threads
|
Number of threads.
|
SigPnd
|
Signals pending.
|
ShdPnd
|
Shared pending signals.
|
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 KB) 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 KB) which a process may lock into memory.
|
Max memory size
|
Maximum size (in KB) to which a process resident set size may grow.
Note This restriction 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 KB) 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 KB) of available virtual memory available to the process.
|
Displaying System Information
To display the system information for the ACE, perform the following task:
Command
|
Purpose
|
show system {cpuhog | error-id {hex_id | list} | internal | kcache | kmem | kmemtrack | resources | skbtrack | uptime | watchdog [memory]}
|
Displays the system information.
The keywords and argument are as follows:
•cpuhog—Displays information related to the process watchdog timer that monitors CPU usage by any currently active processes. This keyword is intended for use by trained Cisco personnel for troubleshooting purposes only.
•error-id—Displays description about errors.
•hex_id—Error ID in hexadecimal format. The range is from 0x0 to 0xffffffff.
•list—Specifies all error IDs.
•internal—Displays Cisco internal system-related functions. The internal keywords and related keywords, options, and arguments are intended for use by trained Cisco personnel for troubleshooting purposes only. This option is available in the Admin context only.
•kcache—Displays the Linux kernel cache statistics..
•kmem—Displays the Linux kernel memory usage.
•kmemtrack—Displays the kernal memory allocations in the kernel loadable modules. This keyword is intended for use by trained Cisco personnel for troubleshooting purposes only.
•resources—Displays system-related CPU and memory statistics.
•skbtrack—Displays the socket buffer (network buffer) allocations in the kernel loadable modules. This keyword is intended for use by trained Cisco personnel for troubleshooting purposes only.
•uptime—Displays how long the ACE has been up and running. This keyword is available in all user contexts.
•watchdog memory—Displays whether the low memory watchdog is enabled or disabled. When the watchdog is enabled, its timeout is displayed. The system watchdog memory command allows you to configure the Memory watchdog timeout.
|
Table 5-9 describes the fields in the show system kmem command output.
Table 5-9 Field Descriptions for the show system kmem Command
Field
|
Description
|
Mem
|
Total
|
Total usable Linux kernel RAM (physical RAM minus the reserved bits and the kernel binary code)
|
Used
|
Total Linux kernel RAM in use.
|
Free
|
Available Linux kernel RAM.
|
Shared
|
Always zero.
|
Buffers
|
Memory in buffer cache.
|
Cached
|
RAM used for the page cache (disk cache) minus the RAM used for the swap cache.
|
Swap
|
Total
|
Total amount of physical swap memory.
|
Used
|
Total swap memory in use.
|
Free
|
Available swap memory.
|
MemTotal
|
Total usable Linux kernel RAM (physical RAM minus the reserved bits and the kernel binary code).
|
MemFree
|
Available Linux kernel RAM.
|
MemShared
|
Always zero.
|
Buffers
|
Memory in buffer cache.
|
Cached
|
RAM used for the page cache (disk cache) minus the RAM used for the swap cache.
|
SwapCached
|
Memory that once was swapped out, is swapped back in, but is still in the swap file. If this memory is needed, it does not need to be swapped out again because it is already in the swap file. This saves I/O.
|
Active
|
Memory that has been used recently and usually not reclaimed unless it is absolutely necessary.
|
Inactive
|
Memory that is unused or easily freeable.
|
HighTotal
|
Total amount of memory in the high memory (highmem) region. Highmem is all memory above approximately 860 MB of physical RAM. The kernel uses indirect methods to access the high memory region. Data cache can go in this memory region.
|
HighFree
|
Total amount of available memory in the highmem area.
|
LowTotal
|
Amount of memory in the low memory region (non-highmem memory).
|
LowFree
|
Amount of free memory in the low memory region. The kernel can address low memory directly. All kernel data structures need to go into low memory.
|
SwapTotal
|
Total amount of physical swap memory.
|
SwapFree
|
Available swap memory.
|
Committed_AS
|
An estimate of how much RAM you would need to make a 99.99% guarantee that there never is an out-of-memory (OOM) condition for a particular workload. Normally, the kernel overcommits memory. For example, if you dynamically allocate 1 GB of memory, no demand is placed on that memory until you actually start using it. The Committed_AS is an estimate of how much RAM or swap memory you would need in a worst-case scenario.
|
Table 5-10 describes the fields in the show system resources command output.
Table 5-10 Field Descriptions for the show system resources Command
Field
|
Description
|
Load average
|
Load that is defined as the number of running processes. The average reflects the system load over the past 1-minute, 5-minute, and 15-minute interval.
|
Processes
|
Number of processes in the system, and how many processes are actually running when you enter the command.
|
CPU states
|
CPU usage percentage in user mode, kernel mode, and idle time in the last 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 5-11 describes the fields in the show system uptime command output.
Table 5-11 Field Descriptions for the 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 have been running
|
Kernel uptime
|
Length of time that the operating system (OS) has been running
|
Table 5-12 describes the fields in the show system watchdog memory command output.
Table 5-12 Field Descriptions for the show system watchdog memory Command
Field
|
Description
|
Memory watchdog
|
State of the low memory watchdog: Enabled or Disabled.
|
Timeout
|
Timeout interval for the enabled watchdog. When the watchdog is disabled, its timeout is not displayed.
|
Displaying or Clearing ICMP Statistics
To display or clear the Internet Control Message Protocol (ICMP) statistics, perform one of the following tasks:
Command
|
Purpose
|
show icmp statistics
|
Displays Internet Control Message Protocol (ICMP) statistics.
|
clear icmp statistics
|
Clears the Internet Control Message Protocol (ICMP) statistics.
|
Table 5-13 describes the fields in the show icmp statistics command output.
Table 5-13 Field Descriptions for the 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 Time Stamp (request) messages transmitted or received by the ACE
|
Displaying or Collecting Technical Information for Reporting Problems
To display or collect general information about the ACE for use when reporting a problem, perform one of the following tasks:
Command
|
Purpose
|
show tech-support [details]
|
Displays general information about the ACE for use when you report a problem. You can use this command to collect a large amount of information about your ACE and provide the command output to technical support representatives.
This command displays the output of several show commands at once. The command output varies depending on your configuration.
The optional details keyword provides detailed information for each show command.
You can choose to have detailed information for each command or even specify the output for a particular interface or appliance. Each command output is separated by the line and the command that precedes the output.
The default output of the show tech-support command includes, for example, the output of the following commands:
•show hardware—See the "Displaying Hardware Information" section
•show interface—See the Cisco 4700 Series Application Control Engine Appliance Routing and Bridging Configuration Guide
•show process—See the "Displaying General System Process Information" section
•show running-config—See Chapter 4, Managing the ACE Software
•show version—See the "Displaying Installed Software Information" section
When using this command, explicitly set the terminal length command to 0 (zero) to disable autoscrolling and enable manual scrolling. Use the show terminal command to view the configured terminal size. After obtaining the output of this command, reset your terminal length as required (see the "Configuring Terminal Display Attributes" section in Chapter 1, Setting Up the ACE).
You can save the output of this command to a file by appending > filename to the show tech-support command (see Chapter 4, Managing the ACE Software). If you save this file, verify that you have sufficient space to do so; each file may take about 1.8 MB.
|
| |
|
tac-pac {disk0:[path/]filename | {ftp://server/path[/filename] | scp://[username@]server/path[/filename] | sftp://[username@]server/path[/filename] | tftp://server[:port]/path[/filename]}
|
Redirects the same information as the show tech-support command output to a file on either the ACE disk0: or a remote server.
The keywords, arguments, and options are as follows:
•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 FTP network server and, optionally, the filename.
•scp://[username@]server/path[/filename]—Specifies the SCP network server and optional file name.
•sftp://[username@]server/path[/filename]—Specifies the SFTP network server and, optionally, the filename.
•tftp://server[:port]/path[/filename]—Specifies the TFTP network server and, optionally, the filename.
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 file system.
|
Examples
The following example shows the show tech-support command output:
Cisco Application Control Software (ACSW)
TAC support: http://www.cisco.com/tac
Copyright (c) 1985-2010 by 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.
system: Version A4(1.0) [build 3.0(0)A4(1.0)
adbuild_03:31:25-2008/08/06_/auto/adbure_nightly2/nightly_rel_a4_1_0_
throttle/REL_3_0_0_A4_1_0
system image file: (hd)c4710ace-t1k9-mz.A4_1_0.bin
Device Manager version 4.1 (0) 20080805:0415
installed license: ACE-AP-VIRT-020 ACE-AP-C-1000-LIC
total: 6226392 kB, free: 4315836 kB
shared: 0 kB, buffers: 17164 kB, cached 0 kB
total: 935560 kB, used: 611564 kB, available: 276472 kB
last boot reason: Unknown
configuration register: 0x1
kernel uptime is 0 days 21 hours 25 minute(s) 17 second(s)
*** Context 0: cmd parse error ***
cpu: 0, model: Intel(R) Pentium(R) 4, speed: 3399.991 MHz
total: 6226704 kB, free: 4637164 kB
shared: kB, buffers: 19436 kB, cached 0 kB
total: 861668 kB, used: 348552 kB, available: 469344 kB
last boot reason: reload command by root
configuration register: 0x1
switch kernel uptime is 0 days 18 hours 59 minute(s) 49 second(s)
Tue Aug 5 10:13:57 UTC 2008
NAME: "Appliance", DESCR: "ACE 4710 Application Control Engine Appliance"
PID: ACE-4710-K9 , VID: , SN: 2061
Feedback