NAME
crashconf — configure system crash dumps
SYNOPSIS
/sbin/crashconf
[-artv]
[-i|-e
class]
[-c
mode] ...
[device...]
DESCRIPTION
crashconf
displays and/or changes the current system crash dump configuration.
The crash dump configuration consists of:
The
crash dump device
list. This list identifies all devices that can be used to store a
crash dump.
The
included class
list. This list identifies all system memory classes that
must
be included in any crash dump.
The
excluded class
list. This list identifies all system memory classes that
should not
be included in a crash dump.
The
compression mode
selection. This selection is used to turn compression
ON
or
OFF,
before dumping.
Most system memory classes are in neither the included class list nor
the excluded class list. Instead, the system determines whether or
not to dump those classes of memory based on the type of crash that
occurs.
Note the system operator may request a full crash dump at the time the
dump is taken. In this case, a full dump will be performed regardless
of the contents of the excluded class list.
Turning compression mode
ON
will result in faster and smaller dumps. If the dump is compressed,
savecrash
will also copy over the dump faster since the dump will be smaller in
size.
Since compressed dump requires additional processors and memory to do
the compression, the system may fall back on uncompressed dump if it
could not identify the processing resources required to do compressed
dump.
Any changes to the configuration take effect immediately and remain in
effect until the next system reboot, or until changed with a
subsequent invocation of
crashconf.
Using the option
-t,
changes to the
include
and
exclude class
lists and
compression mode
can be made persistent across system reboots. But the changes do
not
persist across kernel rebuilds. Use SAM or
kctune(1M)
to do this.
device
specifies a block device file name of a device that is a valid
destination for crash dumps. All such devices listed on the command
line will be added to the end of the current list of crash dump
devices, or will replace the current list of crash dump devices,
depending on whether
-r
is specified.
class
is the name (or number) of a system memory class which should be added
to the appropriate class list. The list of system memory classes can
be obtained using
crashconf
-v.
The memory page size is 4Kb.
class
may also be the word
all,
in which case all classes are added to the appropriate list. (The
effect of adding all classes to the included class list is to force
full crash dumps under all circumstances. The effect of adding all
classes to the excluded class list is to disable crash dumps.)
mode,
either
ON
or
OFF,
will turn compression
ON
or
OFF,
in the dump path.
Options
- -a
The file
/etc/fstab
is read, and all dump devices identified in it will be added to (or
will replace) the current list of crash dump devices. This is in
addition to any crash dump
devices
specified on the command line. See
fstab(4)
for information on the format of
/etc/fstab.
- -c
The
mode
specified with
-c
will be used to set the compression mode. If the system is not
able to identify enough processing resources to do compressed
dump, a warning message will be issued.
- -e
The
classes
specified with
-e
will be added to (or will replace) the list of excluded
(i.e., should not dump) classes. If any of those classes are present in
the current included class list, they will be removed from it.
- -i
The
classes
specified with
-i
will be added to (or will replace) the list of included
(i.e., must dump) classes. If any of those classes are present in
the current excluded class list, they will be removed from it.
- -r
Specifies that any changes should replace, rather than add to, the
current configuration. Thus, if
devices
or
-a
are specified, the current crash dump device list is replaced with
new contents; if
classes
are specified with
-e,
they replace the list of currently excluded classes, and if
classes
are specified with
-i,
they replace the list of currently included classes.
- -t
When used with the
-i,
-e
or
-c
options, sets the dump tunables
alwaysdump,
dontdump
and
dump_compress_on
respectively, to make the changes persistent across system reboots.
- -v
Displays the current crash dump configuration. This is the default
option if no arguments are specified. If any changes to the current
configuration are specified on the same command line as
-v,
the configuration will be displayed
after
the requested changes are made.
RETURN VALUE
Upon exit,
crashconf
returns the following values:
- 0
Success.
- 1
The requested configuration changes could not be made.
WARNINGS
On systems running VxVM 3.5, the swap volumes to be
configured for system crash dumps should be created
with the usage type as
swap
during the creation of the swap volume.
Not doing so will cause dump corruption.
You could use the
-U
option of
vxassist(1M)
to do the same.
The output of
crashconf
is not designed to be parsed by applications or scripts, but only to be
read by humans. The output format may change without notice.
Applications which require crash dump configuration information should
retrieve that information using
pstat(2).
Dump devices created by
lvcreate(1M)
must be contiguous
(-Cy
option) with bad
block relocation turned off
(-rn
option).
High Availability for HP's A-A Dump Devices
The product, DUMPAAEnable Ver B.11.23.0609.01, enables
high-availability features for HP's Active-Active (A-A)
Disk Array devices when configured as dump devices.
The product Securepath version A.3.0F.02F.00F or higher is also
required to be installed along with this product on the system, for
enabling these features.
This product provides the following features for HP's A-A devices
- 1.
Active path configuration:
An Active-Active device can be configured as a dump device through
any of the paths to the device.
If the path through which dump
configuration is being attempted is currently offline, then an
alternate active path will be used for configuration.
Use
-l
to display the actual path used for configuration.
If all the paths to the device are offline, then configuration will fail.
- 2.
Failover/Path change:
If the path that was used for dump configuration of an
Active-Active device goes offline, then an alternate active path will
be automatically configured for dump.
Use
-l
to display the actual path used for dump.
- 3.
Duplicate device identification:
An Active-Active device will have multiple device special files
(/dev/dsk/c#t#d#
files), one corresponding to each path to that device.
Configuration of an existing Active-Active dump device through an
alternate device special file
(c#t#d#)
is considered as a duplicate
device and configuration will not be allowed.
A-A Dump Option
crashconf
recognizes the following new options :
- -l
Displays the current crash dump configuration similar to
-v.
The
-l
option displays actual path (the path used for dump
configuration) in addition to user configured path
(the path specified by the user) for A-A dump devices.
The actual path is displayed in brackets right
below the user configured path, if the actual path
is different from the user configured path.
The paths are displayed using the corresponding device special files
(c#t#d#).
If there are no paths available to a dump device it is shown as OFFLINE.
Actual path information will be shown only for A-A dump devices
that are full devices.
AUTHOR
crashconf
was developed by HP.