HP Integrity Virtual Machines 4.2: Installation, Configuration, and Administration

hpvmcollect(1M)
NAME
hpvmcollect -- Collects crash dumps, logs, system status, and configuration on the VM Host and
guests for post-mortem analysis.
SYNOPSIS
On the VM Host:
hpvmcollect { -P vm-name | -p vm-number } [-f] [-g] [-h] [-b bug-report-number]
[-d directory] [-c [-n #]] [-l | -s hostname [-r directory]]
On the Guest:
hpvmcollect [-f] [-h] [-b bug-report-number] [-d directory] [-c [-n #]] [-l | -s
hostname [-r directory]]
DESCRIPTION
The hpvmcollect command collects log files, system status, device information, system and
Integrity Virtual Machines configuration, guest information, and crash dumps.
When run on a VM Host, this command collects systemwide information as well as information
for a specified guest. In this case, you can specify a guest using the virtual machine name or the
virtual machine number.
When run in a guest, the hpvmcollect command collects information associated only with the
guest.
The hpvmcollect command creates a directory and produces a tar archive or a compressed
tar archive containing the collected information and places it in your current directory. By
default, the archive name is constructed by appending a timestamp to the guest name.
Only superusers can execute the hpvmcollect command.
Options
The following options can be specified only once.
The hpvmcollect command recognizes the following command-line options and arguments:
-b bug-report-number
Overrides the default archive name with bug-report-number plus
the specified label. If an archive with the same name exists, it is
renamed by appending a timestamp to the original name before
the new archive is created. Valid on both the VM Host and the
guest.
-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
229