NAME

vicfg-dumppart - query, set, and scan for diagnostic partitions on an ESX/ESXi system


SYNOPSIS

 vicfg-dumppart [<conn_options>]
    [--activate <partition> |
     --deactivate <partition> |
     --find |
     --get-active |
     --get-config |
     --help |
     --list |
     --set <partition> |
     --smart-activate |
     --vihost]


DESCRIPTION

The vicfg-dumppart command queries, sets, and scans an ESX/ESXi host's diagnostic partitions. The ESX Configuration Guide and the ESXi Configuration Guide discuss diagnostic partitions in detail and explain how to create a diagnostic partition using the vSphere Client UI.


OPTIONS

connection_options

Specifies the target server and authentication information if required. Run vicfg-dumppart --help for a list of all connection options.

--activate | -a <partition>

Makes the specified partition the current diagnostic partition. This option has the same effect as --set.

--deactivate | -d <partition>

Deactivates the active diagnostic partition. Specifying the name of the partition is optional. WARNING: If you run vicfg-dumppart with this option, your system cannot write errors to a file until another partition is activated. You lose any error record if errors occur.

--find | -f

Finds all diagnostic partitions on the ESX/ESXi host and prints them. The partitions can include, in order of suitability, parallel adapter, block adapter, Fibre Channel, and hardware iSCSI.

--get-active | -t

Displays the active diagnostic partition for this system. Running vicfg-dumppart with this option returns the internal name of the partition (naa.xxxxx:1) or 'none' if no partition is set.

--get-config | -c

Lists all configured partitions on the system.

--help

Prints a help message for each command-specific and each connection option. Calling the script with no arguments or with --help has the same effect.

--list | -l

Lists all partitions on the ESX/ESXi system that have the appropriate partition type to act as a diagnostic partition. CAUTION: Execution might take several minutes and slow down your ESX/ESXi host because the command scans all LUNs on the system.

--set | -s <partition>

Sets and activates the diagnostic partition, which you must specify using naa.xxx:1 or eui.xxx syntax. Specify none to deactivate the active diagnostic partition.

--smart-activate | -S

This option is currently not supported.

--vihost | -h

When you run a vCLI command with --server pointing to a vCenter Server system, use --vihost to specify the ESX/ESXi host to run the command against.


EXAMPLES

The following examples assume you are specifying connection options, either explicitly or, for example, by specifying the server, user name, and password. Run vicfg-dumppart --help for a list of common options including connection options.

List the partitions available for diagnostic partitions: WARNING: This call scans all LUNs on the system and might degrade system performance:

   vicfg-dumppart <conn_options> -l

Get the active diagnostic partition for this system. Return the internal name of the partition:

   vicfg-dumppart <conn_options> -t

Set the diagnostic partition for this system and activate it:

   vicfg-dumppart <conn_options> -s naa.xxxxx:1

Deactivate the active diagnostic partition: WARNING: Deactivating the diagnostic partition leaves your system without any means of reporting errors until another partition is activated.

   vicfg-dumppart <conn_options> -d