HP-UX vPars and Integrity VM V6.1.5 Administrator Guide (5900-2295, April 2013)

Table 35 Options to the hpvmcollect Command on the VSP (continued)
DescriptionOption
Includes the latest crash dump directory in the archive. This option is used
if the guest or the VSP 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
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/VM.
The -r option is valid only with the -s option.
-rdirectory
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/VM
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/VM 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
220 Reporting problems with vPars and Integrity VM