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

Table 12-1 Options to the hpvmcollect Command on the VM Host (continued)
DescriptionOption
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 host1 on the VM Host, enter the following
command:
# hpvmcollect -P host1
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 host1, enter the following command:
# hpvmcollect -c -n 21 -d /tmp/hpvm_collect_archive -P host1
This command collects information about the guest called host1 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 host1
HPVM host crash/log collection tool version 0.8
Gathering info for post-mortem analysis of guest 'host1' on host
Collecting I/O configuration info ................................... OK
Collecting filesystem info .......................................... OK
Collecting system info .............................................. OK
Collecting lan info ................................................. OK
Running lanshow ..................................................... NO
Collecting installed sw info ........................................ OK
210 Reporting Problems with Integrity VM