CHAPTER 6-1 Administration Guide, Cisco ACE Application Control Engine OL-25343-01 6 Displaying ACE Hardware and Software System Information Note The information in this chapter applies to both the ACE module and the ACE appliance unless otherwise noted. 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 5, 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 following commands display internal system-level hardware show output for use by trained Cisco personnel as an aid in debugging and troubleshooting the ACE: • show buffer, show fifo, show netio, show np and show vnet commands • (ACE module only) show cde, show hyp, show lcp, and show scp commands
24
Embed
Displaying ACE Hardware and Software System Information
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
AdministOL-25343-01
C H A P T E R 6
Displaying ACE Hardware and Software System Information
Note The information in this chapter applies to both the ACE module and the ACE appliance unless otherwise noted.
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 5, 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 following commands display internal system-level hardware show output for use by trained Cisco personnel as an aid in debugging and troubleshooting the ACE:
• show buffer, show fifo, show netio, show np and show vnet commands
• (ACE module only) show cde, show hyp, show lcp, and show scp commands
6-1ration Guide, Cisco ACE Application Control Engine
Chapter 6 Displaying ACE Hardware and Software System InformationDisplaying Hardware Information
For background information about these show commands, see the Command Reference, Cisco ACE Application Control Engine.
Displaying Hardware InformationTo display ACE hardware information, perform one of the following tasks:
Command Purpose
show hardware Displays the ACE hardware details. For descriptions of the fields in the command output, see the following table:
• (ACE30 module only) Table 6-1
• (ACE appliance only) Table 6-2
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 raw option displays information about each temperature sensor (ACE module) or component (ACE appliance) in the ACE.
For descriptions of the fields in the show inventory command output, see the following table:
• (ACE30 module only) Table 6-3
• (ACE appliance only) Table 6-4
show dc dc_number console (ACE module only) Displays whether the master or the slave network processor console is directed to the base board front panel for the specified daughter card. For example, if the master network processor is directed to the front panel, the following message appears:
mCPU console is directed to base board front panel
See the set dc dc_number console command in the “Setting the Daughter Card Network Processor for Console Access” section.
Table 6-1 Field Descriptions for the ACE Module show hardware Command
Field Description
Hardware
Product Number Product number of the ACE30 (ACE30-MOD-K9)
Serial Number Serial number of the ACE30 (SADnnnnnnTn)
Card Index Location of the ACE30, specified as a fixed index value of 207
Hardware Rev Hardware revision of the ACE30
Feature Bits Enabled feature bits of the ACE30 hardware
Slot No. Slot number in the switch or router chassis where the ACE30 is installed
Type Identifies the module type installed in the switch or router chassis as an ACE30 module
Module Mode Supported internetworking speeds in Gigabits per second (Gbps)
Daughter Card Daughter card in slot 1 of the ACE30
Product Number Product number of daughter card 1 (ACEMOD-EXPN-DC)
Serial Number Serial number of daughter card 1 (SADnnnnnnVx)
6-2Administration Guide, Cisco ACE Application Control Engine
OL-25343-01
Chapter 6 Displaying ACE Hardware and Software System InformationDisplaying Hardware Information
Card Index Location of daughter card 1, specified as a fixed index value of 309
Hardware Rev Hardware revision of the daughter card
Feature Bits Enabled feature bits of the daughter card hardware
Slot No. Slot number (1) in the ACE30 where the daughter card is installed
Controller FPGA Hardware revision of the field-programmable gate array (FPGA) controller
NP 1 Network processor 1
Clock Rate Clock rate of NP1 (600000000 Hz)
Memory Size Size of the NP1 memory (4096 MB)
NP 2 Network Processor 2
Clock Rate Clock rate of NP2 (600000000 Hz)
Memory Size Size of the NP2 memory (4096 MB)
Daughter Card Daughter card in slot 2 of the ACE30
Product Number Product number of daughter card 2 (ACEMOD-EXPN-DC)
Serial Number Serial number of daughter card 2 (SADnnnnnnVx)
Card Index Location of daughter card 2, specified as a fixed index value of 309
Hardware Rev Hardware revision of the daughter card
Feature Bits Enabled feature bits of the daughter card hardware
Slot No. Slot number (2) in the ACE30 where the daughter card is installed
Controller FPGA Hardware revision of the field-programmable gate array (FPGA) controller
NP 3 Network processor 3
Clock Rate Clock rate of NP3 (600000000 Hz)
Memory Size Size of the NP3 memory (4096 MB)
NP 4 Network processor 4
Clock Rate Clock rate of NP4 (600000000 Hz)
Memory Size Size of the NP4 memory (4096 MB)
Table 6-2 Field Descriptions for the ACE Appliance show hardware Command
Field Description
Product Number Product number of the ACE appliance
Serial Number Serial number of the ACE appliance
Hardware Rev Hardware revision of the ACE appliance
VID Version identification number of the ACE appliance
MFG Part Num Manufacturing part number of the ACE appliance
MFG Revision Manufacturing revision of the ACE appliance
Slot No. Not applicable
Type Identifies the device type as an ACE appliance
Table 6-1 Field Descriptions for the ACE Module show hardware Command (continued)
Field Description
6-3Administration Guide, Cisco ACE Application Control Engine
OL-25343-01
Chapter 6 Displaying ACE Hardware and Software System InformationDisplaying Hardware Information
Examples
(ACE module only) The following example shows the output of the show inventory raw command for the ACE module:
switch/Admin# show inventory raw
NAME: "module 11", DESCR: "Application Control Engine Service Module" PID: ACE30-MOD-K9 , VID: 2.3, SN: SAD114005T7
Table 6-3 Field Descriptions for the ACE Module show inventory Command
Field Description
Name Name assigned to the ACE30 (module nn) and the two daughter cards (submodule 1 and 2) in the switch or router chassis.
If you specify the raw option, the Name field displays “temperature” for the temperature sensor in the ACE30.
Descr Description of the ACE30 (Application Control Engine Service Module) and the two daughter cards installed in the switch or router chassis.
If you specify the raw option, this field also displays a brief description of each temperature sensor in the ACE30.
PID Product identifier of the ACE30 (ACE30-MOD-K9) and the daughter cards (ACEMOD-EXPN-DC). If you specify the raw option, this field is not applicable.
VID Hardware revision of the ACE30 and the daughter cards. If you specify the raw option, this field is not applicable.
SN Serial number of the ACE30 and the daughter cards. If you specify the raw option, this field is not applicable.
Table 6-4 Field Descriptions for the ACE Appliance show inventory Command
Field Description
Name Name assigned to the ACE appliance component
If you do not specify the raw option, ACE appliance is the only named object that is displayed. If you specify the raw option, this field also displays each monitored component of the ACE appliance.
Descr Description of the ACE appliance.
If you specify the raw option, this field also displays the description for each component.
PID Product identifier of the ACE appliance.
If you specify the raw option, this field is not applicable for the other components.
VID Hardware revision of the ACE appliance.
If you specify the raw option, this field is not applicable for the other components.
SN Serial number of the ACE appliance.
If you specify the raw option, this field is not applicable for the other components.
6-4Administration Guide, Cisco ACE Application Control Engine
OL-25343-01
Chapter 6 Displaying ACE Hardware and Software System InformationDisplaying Installed Software Information
Displaying Installed Software InformationTo 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.
6-5Administration Guide, Cisco ACE Application Control Engine
OL-25343-01
Chapter 6 Displaying ACE Hardware and Software System InformationDisplaying Installed Software Information
Examples
The following example shows the output for the show copyright command:
host1/Admin# show copyrightCisco Application Control Software (ACSW)TAC support: http://www.cisco.com/tacCopyright (c) 1985-2010, Cisco Systems, Inc. All rights reserved.The copyrights to certain works contained herein are owned byother third parties and are used and distributed under license.Some parts of this software are covered under the GNU PublicLicense. A copy of the license is available athttp://www.gnu.org/licenses/gpl.html.
(ACE module only) The following example shows the output for the show version command:
switch/Admin# show versionCisco Application Control Software (ACSW)TAC support: http://www.cisco.com/tacCopyright (c) 1985-2010 by Cisco Systems, Inc. All rights reserved.The copyrights to certain works contained herein are owned byother third parties and are used and distributed under license.Some parts of this software are covered under the GNU PublicLicense. A copy of the license is available athttp://www.gnu.org/licenses/gpl.html.
Software loader: Version 12.2[123] system: Version A4(1.0) [build 3.0(0)A4(1.0) 12:57:44-2010/09/17_REL_3_0_0_A4_1_0] system image file: [LCP] disk0:gmt.bin installed license: ACE30-MOD-16-K9
last boot reason: reload command by adminconfiguration register: 0switch kernel uptime is 1 days 2 hours 27 minute(s) 7 second(s)
(ACE appliance only) The following example shows the output for the show version command:
host1/Admin# show versionCisco Application Control Software (ACSW)TAC support: http://www.cisco.com/tacCopyright (c) 1985-2010 by Cisco Systems, Inc. All rights reserved.The copyrights to certain works contained herein are owned byother third parties and are used and distributed under license.Some parts of this software are covered under the GNU PublicLicense. A copy of the license is available athttp://www.gnu.org/licenses/gpl.html.
Software loader: Version 0.95
6-6Administration Guide, Cisco ACE Application Control Engine
OL-25343-01
Chapter 6 Displaying ACE Hardware and Software System InformationDisplaying System Processes and Memory Resources Limits
system: Version A4(1.0) [build 3.0(0)A4(1.0) adbuild_03:31:25-2010/09/176_/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
Hardware cpu info: Motherboard: number of cpu(s): 2 Daughtercard: number of cpu(s): 16 memory info: total: 6226392 kB, free: 4315836 kB shared: 0 kB, buffers: 17164 kB, cached 0 kB cf info: filesystem: /dev/hdb2 total: 935560 kB, used: 611564 kB, available: 276472 kB
last boot reason: Unknownconfiguration register: 0x1 kernel uptime is 0 days 21 hours 25 minute(s) 17 second(s)
Displaying System Processes and Memory Resources LimitsThis 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
6-7Administration Guide, Cisco ACE Application Control Engine
OL-25343-01
Chapter 6 Displaying ACE Hardware and Software System InformationDisplaying System Processes and Memory Resources Limits
Displaying General System Process InformationTo display general information about all of the processes running on the ACE, perform the following task:
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 SiByte 1250 Processor (ACE module) or Intel Pentium processor (ACE appliance). Table 6-5 describes the fields for the command output.
The optional keywords and argument are as follows:
• cpu—Displays CPU information for the SiByte 1250 Processor, the BCM1250 dual core MIPS processor (ACE module), or Intel Pentium processor (ACE appliance). Table 6-6 describes the fields for this option.
• log—Displays information about process logs. Table 6-7 describes the fields for this option.
The options for the log keyword are as follows.
– details—Displays process log information for all process identifiers
– pid process_id—Displays information about a specific process identifier
Table 6-8 describes the fields for the details and pid options.
• memory—Displays memory information about the processes. Table 6-9 describes the fields for this option.
6-8Administration Guide, Cisco ACE Application Control Engine
OL-25343-01
Chapter 6 Displaying ACE Hardware and Software System InformationDisplaying System Processes and Memory Resources Limits
Table 6-5 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 6-6 Field Descriptions for the show processes cpu Command
Field Description
CPU Utilization 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
6-9Administration Guide, Cisco ACE Application Control Engine
OL-25343-01
Chapter 6 Displaying ACE Hardware and Software System InformationDisplaying System Processes and Memory Resources Limits
Table 6-7 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 6-8 Field Descriptions for the show processes log [details | pid] 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.
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 6-9 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
6-10Administration Guide, Cisco ACE Application Control Engine
OL-25343-01
Chapter 6 Displaying ACE Hardware and Software System InformationDisplaying System Processes and Memory Resources Limits
Examples
(ACE module only) The following example shows the output for the show processes mem command:
Displaying Detailed Process Status Information and Memory Resource LimitsTo 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 6-10 describes the fields in the command output.
Table 6-10 Field Descriptions for the show terminal internal info Command
Field Description
Process Information
Name Name of the executable that started the process.
6-14Administration Guide, Cisco ACE Application Control Engine
OL-25343-01
Chapter 6 Displaying ACE Hardware and Software System InformationDisplaying System Processes and Memory Resources Limits
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).
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 a specific error ID or all error IDs.
– hex_id—Error ID in hexadecimal format. The range is from 0x0 to 0xffffffff.
– list—Displays all error IDs.
• internal—Displays Cisco internal system-related functions. The internal keywords and options 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, see Table 6-11.
• 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, see Table 6-12.
• 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, see Table 6-13. This keyword is available in all user contexts.
• watchdog [lcp | memory | scp]—Displays whether the watchdog is enabled or disabled. When it is enabled, its timeout is displayed. When you enter the watchdog keyword without an option, all watchdogs are displayed, see Table 6-14. To display a specific watchdog, enter one of the following options:
– lcp—(ACE module only) LCP process watchdog. The current SCP watchdog watches this process. However, if the LCP process is not scheduled on time, this watchdog reboots the ACE module.
– memory—Low memory watchdog when the ACE memory reaches 99 percent.The system watchdog memory command allows you to configure the Memory watchdog timeout.
– scp—(ACE module only) Watchdog for SCP keepalive messages from the hardware timer interrupt level.
Note (ACE module only) The LCP and SCP timeouts are not configurable.
6-17Administration Guide, Cisco ACE Application Control Engine
OL-25343-01
Chapter 6 Displaying ACE Hardware and Software System InformationDisplaying System Information
Table 6-11 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.
6-18Administration Guide, Cisco ACE Application Control Engine
OL-25343-01
Chapter 6 Displaying ACE Hardware and Software System InformationDisplaying or Clearing ICMP Statistics
Table 6-14 describes the output fields for the show system watchdog command.
Displaying or Clearing ICMP StatisticsTo display or clear the Internet Control Message Protocol (ICMP) statistics, perform one of the following tasks:
Table 6-12 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 6-13 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 6-14 Field Descriptions for the show system watchdog Command
Field Description
LCP watchdog (ACE module only) State of the LCP process watchdog: Enabled or Disabled.
Memory watchdog State of the low memory watchdog: Enabled or Disabled.
SCP watchdog (ACE module only) State of the SCP watchdog: Enabled or Disabled.
Timeout Timeout interval for the enabled watchdog. When the watchdog is disabled, its timeout is not displayed.
Command Purpose
show icmp statistics Displays Internet Control Message Protocol (ICMP) statistics. Table 6-15 describes the fields in the show icmp statistics command output.
clear icmp statistics Clears the Internet Control Message Protocol (ICMP) statistics.
6-19Administration Guide, Cisco ACE Application Control Engine
OL-25343-01
Chapter 6 Displaying ACE Hardware and Software System InformationDisplaying or Clearing ICMP Statistics
Table 6-15 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
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
6-20Administration Guide, Cisco ACE Application Control Engine
OL-25343-01
Chapter 6 Displaying ACE Hardware and Software System InformationDisplaying or Collecting Technical Information for Reporting Problems
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 ACE. 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 Routing and Bridging Guide, Cisco ACE Application Control Engine.
• show process—See the “Displaying General System Process Information” section.
• show running-config—See Chapter 5, 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.
• (ACE module only) See the “Configuring Terminal Display Attributes” section in Chapter 1, “Setting Up the ACE Module.”.
• (ACE appliance only) See the “Configuring Terminal Display Attributes” section in Chapter 2, “Setting Up the ACE Appliance.”
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 that you have sufficient space to do so; each file may take about 1.8 MB.
6-21Administration Guide, Cisco ACE Application Control Engine
OL-25343-01
Chapter 6 Displaying ACE Hardware and Software System InformationDisplaying or Collecting Technical Information for Reporting Problems
Examples
(ACE module only) The following example shows the show tech-support command output for the ACE module:
host1/Admin# show tech-support
`show version`Cisco Application Control Software (ACSW)TAC support: http://www.cisco.com/tacCopyright (c) 1985-2010, Cisco Systems, Inc. All rights reserved.The copyrights to certain works contained herein are owned byother third parties and are used and distributed under license.Some parts of this software are covered under the GNU PublicLicense. A copy of the license is available athttp://www.gnu.org/licenses/gpl.html.
Software loader: Version 12.2[123] system: Version 3.0(0)A4(1.0) [build 3.0(0)A4(1.0) _01:26:21-2006/03/13_/auto/adbu-rel/ws/REL_3_0_0_A4_1_0] system image file: [LCP] disk0:c6ace-t1k9-mzg.3.0.0_A4_1_0.bin licensed features: ACE30-MOD-16-K9
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.
Command Purpose
6-22Administration Guide, Cisco ACE Application Control Engine
OL-25343-01
Chapter 6 Displaying ACE Hardware and Software System InformationDisplaying or Collecting Technical Information for Reporting Problems
(ACE appliance only) The following example shows the show tech-support command output for the ACE appliance:
`show version`Cisco Application Control Software (ACSW)
6-23Administration Guide, Cisco ACE Application Control Engine
OL-25343-01
Chapter 6 Displaying ACE Hardware and Software System InformationDisplaying or Collecting Technical Information for Reporting Problems
TAC support: http://www.cisco.com/tacCopyright (c) 1985-2010 by Cisco Systems, Inc. All rights reserved.The copyrights to certain works contained herein are owned byother third parties and are used and distributed under license.Some parts of this software are covered under the GNU PublicLicense. A copy of the license is available athttp://www.gnu.org/licenses/gpl.html.
Software loader: Version 0.95 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