HP Integrity Virtual Machines 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
hpvmcollect -P vm_name -p vm_number [-c] [-f] [-g] [-h] [-l] [-b bug-report-number]
[-d directory] [-n crash-dump-number] [-s host] { (On the VM Host) }
hpvmcollect [-c] [-f] [-g] [-h] [-l] [-b bug-report-number] [-d directory] [-n
crash-dump-number] [-s host] { (On the guest) }
DESCRIPTION
The hpvmcollect command collects log files, system status, device information, system and
Integrity Virtual Machines configuration, guest information, and, optionally, crash dumps.
When run on a VM Host, it collects systemwide information as well as information for a specified
guest. In this case, you may specify a guest using the virtual machine name or the virtual machine
number.
When run in a guest, the hpvmcollect command collects only the information associated 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
No options can be specified more than once.
hpvmcollect 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 crash-dump-number
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 only be used with the -c option.
176