This section describes the tasks for managing crash dump procedures for your system.
Keep the following points in mind when you are working with system crash information:
You must assume the root role to access and manage system crash information. See Using Your Assigned Administrative Rights in Securing Users and Processes in Oracle Solaris 11.3.
Starting with the Oracle Solaris 11.3 release, when a system crashes, a copy of its physical memory can be held in RAM until the system reboots, then written to the file system. This process is called a deferred dump. If a deferred dump is not possible, the physical memory is written to a dump device during a crash. See Crash Files Now Deferred Until After Reboot in Oracle Solaris 11.3.
Do not disable the option of saving system crash dump files on the system. System crash dump files provide an invaluable way to determine what is causing the system to crash.
Dedicated ZFS volumes are used for swap and dump areas. For instructions, see Managing ZFS Swap and Dump Devices in Managing ZFS File Systems in Oracle Solaris 11.3.
To display the current crash dump configuration, assume the root role and issue the dumpadm command with no arguments.
# dumpadm Dump content: kernel with ZFS metadata Dump device: /dev/zvol/dsk/rpool/dump (dedicated) Savecore directory: /var/crash Savecore enabled: yes Save compressed: on
This example output shows the following configuration:
The dump content is kernel memory pages with ZFS metadata.
Kernel memory will either be held in memory until a reboot or dumped on a dedicated dump device, /dev/zvol/dsk/rpool/dump.
System crash dump files will be saved in the /var/crash directory.
Saving crash dump files is enabled.
Crash dump files are saved in compressed format.
To modify the crash dump configuration, assume the root role and use the dumpadm command.
The syntax for the dumpadm command is as follows:
# /usr/sbin/dumpadm [-enpuy] [-c content-type] [-d dump-device] [-m mink | minm | min%] [-s savecore-dir] [-r root-dir] [-z on | off]
Specifies the type of data to dump. The possible values are as follows:
kernel which dumps the kernel memory pages only
all which dumps all memory pages
curproc which dumps kernel memory and the memory pages of the process whose thread was executing when the crash occurred
allproc which dumps kernel memory pages and all process pages
zfs which dumps kernel pages that store ZFS metadata
The default dump content is kernel memory with ZFS metadata. For example:
# dumpadm -c kernel # dumpadm -c +zfs # dumpadm -c -zfs # dumpadm -c curproc+zfs
Specifies the device that stores dump data temporarily when the system crashes. The primary dump device is the default dump device. When the dump device is not the swap area, savecore runs in the background, which speeds up the boot process.
Prints an estimate of disk space required for storing a compressed crash dump. The value is computed using the current configuration and currently running system.
Specifies the minimum free disk space for saving crash dump files by creating a minfree file in the current savecore directory. This parameter can be specified in KB (mink), MB (minm) or file system size percentage (min%). If no minimum free space has been configured, the default is 1MB.
The savecore command consults this file prior to writing the crash dump files. If writing the crash dump files would decrease the amount of free space below the minfree threshold due to their size, the dump files are not written and an error message is logged. For information about recovering from this scenario, see Saving Data When the Crash Dump Directory Is Full.
Specifies that savecore will not be run automatically when the system reboots. This dump configuration is not recommended because the system will attempt to preserve a crash dump image in memory.
Produces machine-readable output.
Specifies an alternate directory for storing crash dump files. In Oracle Solaris 11, the default directory is /var/crash.
Forcibly updates the kernel dump configuration based on the contents of the /etc/dumpadm.conf file.
Modifies the dump configuration to automatically execute the savecore command upon reboot, which is the default for this dump setting.
Modifies the dump configuration to control the operation of the savecore command upon reboot. The on setting enables the saving of a core file in a compressed format. The off setting automatically uncompresses the crash dump file. Because crash dump files can be extremely large and therefore require less file system space if they are saved in a compressed format, the default is on.
In this example, all of memory is dumped to the dedicated dump device, /dev/zvol/dsk/rpool/dump. A minimum of 10% of the file system space must be available as free space after the crash dump files are saved.
# dumpadm Dump content: kernel with ZFS metadata Dump device: /dev/zvol/dsk/rpool/dump (dedicated) Savecore directory: /var/crash Savecore enabled: yes Save compressed: on # dumpadm -c all -d /dev/zvol/dsk/rpool/dump -m 10% Dump content: all pages Dump device: /dev/zvol/dsk/rpool/dump (dedicated) Savecore directory: /var/crash (minfree = 5935131KB) Savecore enabled: yes Save compressed: on # dumpadm -n Dump content: all pages Dump device: /dev/zvol/dsk/rpool/dump (dedicated) Savecore directory: /var/crash (minfree = 5935131KB) Savecore enabled: no Save compressed: on # dumpadm -y Dump content: all pages Dump device: /dev/zvol/dsk/rpool/dump(dedicated) Savecore directory: /var/crash (minfree = 5935131KB) Savecore enabled: yes Save compressed: onExample 2 Disabling the Saving of Crash Dumps
This example shows how to disable the saving of crash dumps on your system.
# dumpadm -n Dump content: all pages Dump device: /dev/zvol/dsk/rpool/dump (dedicated) Savecore directory: /var/crash (minfree = 5697105KB) Savecore enabled: no Save compressed: on
![]() | Caution - Oracle Solaris strongly recommends that you do not disable the saving of crash dumps. Crash dumps provide an invaluable way to determine what causes your system to crash. |
This example shows how to enable the saving of crash dumps on your system.
# dumpadm -y Dump content: all pages Dump device: /dev/zvol/dsk/rpool/dump (dedicated) Savecore directory: /var/crash (minfree = 5697105KB) Savecore enabled: yes Save compressed: on