Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX 11i Version 1.5 System Crash Dump White Paper > Chapter 1 HP-UX 11i Version 1.5 System Crash Dump

Crash Dump Configuration

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

In the HP-UX operating system prior to release 11.0, the only configuration option was the ability to specify which devices would be used to store a crash dump. This option was set during kernel build and only took effect after rebooting the system on the new kernel

Now, by default, the system dumps to the swap partition. If the root disk is VxFS, the system dumps to a swap partition on the root disk; for example, /dev/dsk/cntndn. During runtime the default location can be changed to dump to another (secondary) disk, but the following limitations currently apply if you do that:

  • The default location cannot thereafter be restored during runtime. To restore the default location, the system must be rebooted.

  • Any previous contents of the secondary disk will be lost because a dump will overwrite it from block 0.

In addition to the kernel and logical volume device crash dump configurations, there are two other methods and some additional options.

  • Crash dump configuration can be done during system initialization (see rc(1M) and rc.config.d(4) man pages)

  • Crash dump configuration can be done during run time directly through the crashconf(1M) command. A kernel reboot is not required.

Configuration of dump devices is modeled on configuration of swap devices Consider this comparison between them:

Table 1-2 Title not available (Crash Dump Configuration)

Swap Devices

Dump Devices

A system call, swapon(2) configures swap devices.

A system call, crashconf(2), configures dump devices.

A command, swapon(1M), can configure a swap device named on its command line.

A command, crashconf(1M), can configure one or more dump devices named on its command line.

swapon(1M) can also read /etc/fstab and configure all devices marked as "swap".

crashconf(1M) can also read /etc/fstab and configure all devices marked "dump".

SAM can be used to configure swap devices.

SAM can be used to configure swap devices.

The primary swap device can also be configured into the kernel at kernel build time.

Dump devices can also be configured into the kernel at kernel build time, in the exact same manner as before.

 

An important feature listed in the table above is the ability to read /etc/fstab and configure all devices marked "dump".

In addition to configuring dump devices, crashconf (both the system call and the command) can also be used to configure the classes of memory that will be included in, or excluded from, the dump. If desired, this information can also be configured at kernel build time, by setting the bitmask tunables alwaysdump and dontdump. Refer to the /usr/include/sys/crashconf.h file or the output of the crashconf(1M) command for the current list of memory classes.

In most circumstances, it should not be necessary to modify the list of individual memory classes to be dumped. The default settings provide adequate information for debugging nearly all system panics while eliminating as much extraneous data from the dump as possible.

In actual practice, if crash dump is reconfigured at all, it is usually done to force a full dump, or to disable dumps entirely.

Full dumps are enabled by including all pages in the dump. This is done with "crashconf -i all" or by setting CRASH_INCLUDED_PAGES="all" in /etc/rc.config.d/crashconf.Dumps are disabled by excluding all pages from the dump. Again, this is done with "crashconf -e all" or by setting CRASH_EXCLUDED_PAGES="all" in /etc/rc.config.d/crashconf.

Finally, crashconf(1M) uses the pstat interfaces pstat_getcrashinfo(2) and pstat_getcrashdev(2) to provide a report of which devices are configured, which memory classes will be included, and how much space a selective dump will take. This information can be used to determine the amount of dump space that should normally be configured. Specifying "-v" on the crashconf(1M) command line will display the current crash dump configuration to verify that the expected changes have taken effect.

How Much Dump Space Do I Need?

For selective dumps, use crashconf(1M) to find out how much space would be needed for a selective dump of your machine. (Use the -v flag, and run it while your system is under its normal or higher than normal workload.) The space needed will vary depending on the workload of the machine, so add another 25% or so to be safe. The total dump space should meet or exceed this amount.

For machines that are relatively stable and don't expect to dump often, this is enough. If a full dump is needed from such a machine, additional space can be configured for it on the fly, anyway. This space can also be used for swap unless reboot times are critical.

For machines on which full dumps are required, the full size of physical memory, plus a little bit for dump headers and tables, should be configured as dump space. At least the amount needed for a selective dump should be configured on a device that is not used for swap activity.

For example, the size of a selective dump for a 1GB RAM system typically ranges from 100MB to 200MB (10% to 20%). Extrapolating this to a 64GB system, a dump could be as large as 12GB.

Whenever you have dump devices that are not also used for swap activity, make sure that they are configured last. This will cause them to be used first (dump goes from the end backward), which will minimize the chance of writing into an area shared by swap. Writing into swap space is undesirable because it will slow down your reboot processing; see “Post-Reboot Dump Processing”, for details.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2001 Hewlett-Packard Development Company, L.P.