Troubleshooting guide

D-2
ATM and Layer 3 Switch Router Troubleshooting Guide
OL-1969-01
Appendix
Using exception Commands
The following example configures a switch router to use rcp to dump the core file when it crashes:
Switch# configure terminal
Switch (config)# ip rcmd remote-username red
Switch (config)# exception protocol rcp
Switch (config)# exception dump 172.17.92.2
The following example configures a switch router to use FTP to dump the core file when it crashes:
Switch# configure terminal
Switch (config)# ip ftp username red
Switch (config)# ip ftp password blue
Switch (config)# exception protocol ftp
Switch (config)# exception dump 172.17.92.2
Note The remote machine must be configured to allow the switch router to write to it. For example, if you
are using rcp with a UNIX system, the .rhosts file for the remote user must contain an entry for the
switch router. Refer to the documentation for your FTP or rcp server for details.
This procedure can fail for certain types of system crashes. However, if successful, the core dump file
will be the size of the memory available on the processor.
Creating an Exception Memory Core Dump
During the debugging process, you can cause the switch router to create a core dump and reboot when
certain memory size parameters are violated. The exception memory commands define a minimum
contiguous block of memory in the free pool and a minimum size for the free memory pool.
[no] exception memory fragment size
[no] exception memory minimum size
The value of size is in bytes and is checked every 60 seconds. If you enter a size that is greater than the
free memory and the exception dump command has been configured, the switch router creates a core
dump and reloads the Cisco IOS software after 60 seconds. If the exception dump command is not
configured, the switch router reloads without generating a core dump.
The following example configures the switch router to monitor the free memory. If the free memory falls
below 250,000 bytes, the switch router dumps the core and reloads.
Switch# configure terminal
Switch (config)# exception dump 131.108.92.2
Switch (config)# exception core-file memory.overrun
Switch (config)# exception memory minimum 250000