HP-UX vPars and Integrity VM V6.3 Administrator Guide

Table 39 Options to the hpvmcollect command on the VSP (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
Selects all vPars/VMs on the VSP for inclusion in the collection. Valid only
on the VSP.
-a
Specifies a remote target directory in which to store the collected archive,
overriding the default of/crashes.Valid on both the VSP and the vPar and
VM guest. The -r option is valid only with the -s option.
-r directory
If the VSP hangs, generate a crash dump using the TC command on the VSP console. When the
VSP 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
vPars and Integrity VM problems.
The hpvmcollect command is a shell script that can be run on either the VSP or the vPar and
VM guest to gather system information, log files, Integrity VM logs, and configuration files for later
analysis.
Because the hpvmcollect command collects generic vPars and Integrity VM and HP-UX operating
system and system information, it might 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 vPar and VM 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 vPars and Integrity VM and VSP information.
For example, to gather information for a VM named host1 on the VSP, 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 VSP 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 VSP 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 VSP:
# hpvmcollect -P host1
HPVSP crash/log collection tool version B.06.10.05
Gathering info for post-mortem analysis of guest 'host1' on host
Collecting I/O configuration info ................................... OK
Collecting filesystem info .......................................... OK
276 Reporting problems with vPars and Integrity VM