configure debug core-dumps

configure debug core-dumps [ off | directory_path]

Description

Enables or disables the sending of core dump files to the internal memory or a USB 2.0 storage device.

Syntax Description

off Specifies that the switch does not save core dump files to memory or to removable storage devices.
directory_path Directory path (USB is /usr/local/ext; internal memory is /usr/local/tmp (default); and home directory is /usr/local/cfg.

Default

Beginning with ExtremeXOS 11.6, core dumps to internal memory (/usr/local/tmp) is enabled by default.

Usage Guidelines

Note

Note

Use this command only under the guidance of Extreme Networks Technical Support personnel to troubleshoot the switch.
The switch only generates core dump files and writes them to the specified device in the following situations:
  • If an ExtremeXOS process fails.
  • When forced under the guidance of Extreme Networks Technical Support.

If you configure the switch to write core dump files to the internal memory and attempt to download a new software image, you might have insufficient space to complete the image download. If this occurs, move or delete the core dump files from the internal memory. For example, if the switch supports a removable storage device that has space available, transfer the files to the device. On switches without removable storage devices, transfer the files from the internal memory card to a TFTP server. This frees up space on the internal memory card while keeping the core dump files.

Before you can enable and save debug information to a removable storage device, you must install the device. For more information about installing a removable storage device, refer to the hardware documentation.

After you use the eject usb-device command and manually remove a USB device, you are prompted to select another location to write the debug files to.

Stackables in Stack Mode

This command works only from the master node. If you enable it on stack master, it is applicable for all nodes.

Example

The following example enables a switch to save debug information to a USB device:

configure debug core-dumps /usr/local/ext

The following example enables the switch to save debug information to internal memory:

configure debug core-dumps /usr/local/tmp

History

This command was first available in ExtremeXOS 11.1.

The internal-memory parameter was added in ExtremeXOS 11.2.

Support for USB 2.0 storage devices was added in ExtremeXOS 12.5.3.

The options memorycard and internal-memory were removed and the variable directory_path was added in ExtremeXOS 30.3.

Platform Availability

This command is available on the ExtremeSwitching X435, X440-G2, X450-G2, X460-G2, X465, X590, X620, X670-G2, X690, X695, and X870 series switches.