CIP Troubleshooting

Description

A class of global configuration commands exist in the Cisco IOS software that allow you to output a core dump from a router or a processor card in the router when the Cisco IOS software halts unexpectedly. These are the exception global configuration commands. The exception commands have been hidden from the user configuration interface until Cisco IOS Software Release 11.2(8).

The exception slot global configuration command lets you configure a CIP to output a core dump when the Cisco IOS software running on the CIP halts unexpectedly.

The exception slot command for the CIP uses FTP to transfer data from the CIP to a host system.

---

Note The output obtained by means of the exception command can be interpreted by a qualified Cisco technical support person.

---

Platforms

This feature is supported on the following platforms:

• Cisco 7000 series with RSP7000

• Cisco 7500 series

Configuration Tasks

This section describes the configuration task that is associated with the CIP core dump feature:

• Configure CIP Core Dump

Configure CIP Core Dump

Perform the following tasks in global configuration mode:

Task	Command
Configure the router FTP services.	ip domain-name name ip name-server address ip ftp username name ip ftp password password
Configure the CIP core dump feature.	exception slot [slot] protocol//:host/file

While the router is running, you can use the write EXEC command to write the contents of a CIP that is not halted.

Command Reference

This section documents new commands. All other commands used with this feature are documented in the Cisco IOS Release 11.2 command references. The following commands have been added or modified as a result of feature enhancements:

• exception slot

exception slot

Use the exception slot global configuration command to provide a core dump of a CIP on the Cisco 7000 with RSP7000 and Cisco 7500 series. Use the no form of the command to disable the core dump.

exception slot [ slotnum ] protocol://host/filename
no exception slot [ slotnum ] protocol://host/filename

Syntax Description

slotnum	(Optional) Slot number of the CIP. If no slotnum is specified, all installed CIPs will output a core dump when they halt unexpectedly.
protocol	Protocol for transferring the file. Currently the only allowed value is FTP.
host	Name or IP address of the host that receives the core dump information.
filename	Filename on the host that receives the core dump information. The maximum name length is 31 characters. When written to the host, .slot is automatically appended, where slot is the slot number.

Default

This command has no defaults.

Command Mode

Global configuration

Usage Guideline

This command first appeared in Cisco IOS Release 11.2.

You must configure FTP services on the router before you can create a CIP core dump.

Do not exceed your host limits on filename length. An additional two characters are added to the filename, .slot , where slot is the slot number.

Example

The following example shows how to configure a router to perform a CIP core dump:

ip domain-name cisco.com
   ip name-server 168.69.161.21
   ip ftp username tech1
   ip ftp password tech1
exception slot ftp://168.18.2.196/cipdump

Assuming the CIP is installed in slot 3, the filename cipdump.3 will be written to the host.

Related Commands

ip domain-name
ip name-server
ip ftp username
ip ftp password