HP Integrity Virtual Machines 4.3: Installation, Configuration, Administration

-c
Includes the latest crash dump directory in the archive. This
option is used if the guest or the VM Host crashes or hangs. Valid
on both the VM Host and the guest.
-d directory
Specifies a target directory in which to create the
hpvmcollect_archive directory. Valid on both the VM Host
and the guest.
-f
Forces an archive to be overwritten, if it exists, rather than
renamed with an appended timestamp. Valid on both the VM
Host and the guest.
-g
Cleans up a guest debug memory dump directory after a memory
dump has been collected into the hpvmcollect archive. Valid
on the VM Host only.
-n #
Specifies the number of crash dumps to copy to the archive. Valid
on both the VM Host and the guest. By default, the
hpvmcollect command copies the latest crash dump directory
(based on the bounds file). This option can be used only with the
-c option.
-l
Leaves the collected information in the directory rather than an
archiving it. Valid on both the VM Host and the guest. The -l
option and the -s option are mutually exclusive.
-s hostname
Specifies a host name to receive the archive, which is copied
using scp. Verify that you can login to the host without a
password. Valid on both the VM Host and the guest. Note that
the -l option and the -s option are mutually exclusive.
-h
Displays the help message. Valid on both the VM Host and the
guest.
-r directory
Specifies a remote target directory in which to store the collected
archive, overriding the default of /crashes. Valid on both the VM
Host and the guest. The -r option is valid only with the -s
option.
RETURN VALUES
The hpvmcollect command exits with one of the following values:
0: Successful completion.
1: One or more error conditions occurred.
DIAGNOSTICS
The hpvmcollect command displays the status of each collection line by line:
• OK: The item collection was successful.
NO: The option was not used to collect the item.
N/A: hpvmcollect was supposed to collect the item but failed. Possible reasons include:
The command is not available (for example, it may not be in $PATH).
The command exited with an error; thus, there was no collection.
The condition that triggers the log file generation did not occur.
EXAMPLES
On a VM Host, collect VM Host and guest myguest information:
# hpvmcollect -P myguest
HPVM host crash/log collection tool version 3.0
249