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

Table 12-1 Options to the hpvmcollect Command on the VM Host (continued)
DescriptionOption
Includes the latest crash dump directory in the archive. This option is used
if the guest or the VM Host fails or hangs.
-c
Forces an archive to be overwritten, if it exists, rather than renamed with
an appended time stamp.
-f
Displays the help message for the hpvmcollect command.-h
Leaves the collected information in a directory rather than in an archive
file. The directory name follows the same naming convention as the archive
name.
-l
Deletes old guest memory dump data as part of data collection.
-g
If the VM Host hangs, generate a crash dump using the TC command on the VM Host console.
When the VM Host crashes, it tries to dump a predefined set of memory pages into the crash
dump area, including those that belong to Integrity VM. This is crucial to collecting a successful
crash dump to analyze Integrity VM problems.
The hpvmcollect command is a shell script that can be run on either the VM Host or the guest
to gather system information, log files, Integrity VM logs, and configuration files for later analysis.
Because the hpvmcollect command collects generic Integrity VM and HP-UX operating system
and system information, it may not collect all the information needed to analyze the source of
the problem. Make sure that all the relevant information is included in the collection. For example,
if the guest is running an Oracle® application, include the Oracle application log files and
configuration.
By default, the hpvmcollect command creates a directory called hpvmcollect_archive in
your current directory, and copies and collects all the Integrity VM and VM Host information.
For example, to gather information for a guest named compass1 on the VM Host, enter the
following command:
# hpvmcollect -P compass1
This command creates a directory called hpvmcollect_archive in your current directory (if
it does not already exist) and then collects information about the VM Host crash dump. The
information is then put into a tar file format (if there is a crash dump) or tar.gz file format (if
there is no crash dump). Do not modify the guest configuration before running the hpvmcollect
command.
If you do not want to archive the collection into tar.gz but simply want to examine the contents
of the collection, use the -l option to leave the contents as they are.
If the VM Host failed, use the -c option to collect crash dump files as well. Because the -c option
collects the latest crash dump, use the -n option to specify a crash dump number.
Use the -d option to specify a different directory in which to store the hpvmcollect_archive.
For example, to collect information about compass1, enter the following command:
# hpvmcollect -c -n 21 -d /tmp/hpvm_collect_archive compass1
This command collects information about the guest called compass1 using crash dump number
21. The final archive is under /tmp/hpvm_collect_archive directory. The following is an
example of hpvmcollect output on the VM Host:
# hpvmcollect -P compass1
HPVM host crash/log collection tool version 0.8
Gathering info for post-mortem analysis of guest 'test' on host
Collecting I/O configuration info ................................... OK
Collecting filesystem info .......................................... OK
Collecting system info .............................................. OK
170 Reporting Problems with Integrity VM