HP Integrity Virtual Machines Installation, Configuration, and Administration Version A.03.50

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.
Thehpvmcollect 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.
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 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.
192