esxcfg-dumppart

Section: Maintenance Commands (8)
Index Return to Main Contents

BSD mandoc
VMware ESX 4.0

NAME

esxcfg-dumppart - VMware ESX 4.0 diagnostic partition configuration tool

SYNOPSIS

esxcfg-dumppart OPTIONS

DESCRIPTION

esxcfg-dumppart provides an interface to copy a zdump from dump partition. It also provides interface to extract logs from a zdump, query, set, and scan for diagnostic partitions on ESX.

OPTIONS

-l -list: List all partitions on the system that have the appropriate partition type to act as an ESX diagnostic partition. WARNING: Listing will scan all LUNs on a system and may degrade system performance.
-t -get-active: Get the active diagnostic partition for this system. This will return the internal name of the partition (naa.xxxxx:x) or 'none' if no partition is set.
-c -get-config: Get the configured diagnostic partition for the system. This partition may or many not be the active partition, and in a SAN situation this partition may have disappeared.
-s -set naa.xxxxx:x: Set the active and configured diagnostic partition for this system using the vmhba name of the partition to use.
-f -find: Using the same method as the list option, find all the diagnostic partitions on this ESX system. Based on the type of storage, print the partitions in order of their desirability to be used as a diagnostic partition. The order of priority for diagnostic partitions is Parallel adapter, block adapter, Fibre Channel, Hardware iSCSI, software iSCSI.
-C -copy: Copy a zdump from the dump partition specified by --devname option.
-D -devname: Dump partition name (/vmfs/devices/disks/naa.xxxxx:x). This is a mandatory parameter to --copy.
-z -zdumpname: User specified name of the zdump file. This is an optional parameter to --copy.
-n -newonly: Copy only if its a new zdump. This is an optional paramter to --copy.
-o -slot: Specify the slot number to start copying the zdump from. This is an optional paramter to --copy.
-L -log: Extract the logs from a specified zdump.
-S -smart-activate: Activate the diagnostic partition if one is set and available. Otherwise, scan the system and choose an appropriate partition using the same criteria as is used in "find".
-a -activate: Activate the configured diagnostic partition.
-d -deactivate: Deactivate the current active diagnostic partition. WARNING: this will leave your system without any means of reporting errors until another partition is activated.
-h -help: Print the help message.

EXAMPLE

--set naa.xxxxx:1 (For partition number 1)

--copy --devname /vmfs/devices/disks/naa.xxxxx:x --newonly --zdumpname esxdump (to copy new zdump only)

--log esxdump

COPYRIGHT

This document was created by man2html, using the manual pages. Brought to you by Bouke Groenescheij, www.jume.nl
Time: 15:25:08 GMT, May 26, 2009