Report defects through your support channel. Use the following instructions
to collect data to submit with your problem report.
Run the hpvmcollect command to gather information
about the guest before modifying any guest. Preserve the state of the VM Host
and Integrity VM to best match with the environment when the VM Host crashed.
If multiple guests are running, run the hpvmcollect command
for guest that was running at the time.
After the hpvmcollect archive is stored
on the VM Host, reboot the guest that caused the VM Host to crash.
Run the hpvmcollect command on the guest
again. Include this information in the hpvmcollect archive
from the VM Host.
Report the information through your support channel.
If the VM Host hangs, make sure a crash dump is generated by using TC 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-related logs, and configuration files for later analysis.
Because the hpvmcollect command collects generic
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 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:
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 has crashed, 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 -Pcompass1
HPVM host crash/log collection tool version 0.8
Gathering info for post-mortem analysis of guest 'compass1' 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
Collecting messages from vmm ........................................ OK
Collecting lv info .................................................. N/A
Collecting disk info ................................................ N/A
Collecting passthru disk info ....................................... N/A
Collecting file backing store info .................................. N/A
Copying guest's log file ............................................ OK
Copying guest's tombstone file ...................................... NA
Copying guest's console log file .................................... OK
Copying hpvm configuration .......................................... OK
Coping hpvm control script .......................................... OK
Copying guest's config file ......................................... OK
Getting status of the guest ......................................... OK
Getting detailed status of the guest ................................ OK
Getting guest's entitlement ......................................... OK
Copying guest's config file change log .............................. OK
Copying VMM image ................................................... OK
Copying hpvmdvr image ............................................... OK
Copying hpvmntdvr image ............................................. OK
Copying NVRAM image ................................................. OK
Collecting IPMI logs ................................................ OK
Collecting crash dump ............................................... NO
Running crashinfo ................................................... NO
Collecting tombstone ................................................ NO
Collecting system message buffer .................................... OK
Collecting system syslogs ........................................... OK
Collecting measureware log .......................................... N/A
Finished with the collection
Tar archiving and compressing ....................................... TGZ
Remote copying the archive ......................................... NO
The collection is
"/var/opt/hpvm/common/hpvmcollect_archive/compass1_Oct.04.05_165043EDT.tar.gz" |
|
If you get an error message such as the following, you are out of disk
space in the current directory or in the directory you specified with the -d option:
msgcnt 10 vxfs: mesg 001: vx_nospace - /dev/vg00/lvol5 file system full(1 block
extent)
Tar: end of tape
Tar: to continue, enter device/file name when ready or null string to quit.
|
Use a file system with enough free space for the archive, especially
when you use the -c option.
When you use the hpvmcollect command on the guest,
it is not necessary to specify a guest name. By default, the guest name is
used as an archive directory name. You can use the -d option
to specify the archive name. The following is an example of the hpvmcollect when
it is run on the guest compass1:
|
compass1# hpvmcollect -c
HPVM guest crash/log collection tool version 0.8
Gathering info for post-mortem analysis on guest (hostname 'compass1')
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
Collecting crash dump 1 ............................................ OK
Running crashinfo ................................................... NO
Collecting tombstone ................................................ N/A
Collecting system message buffer .................................... OK
Collecting system syslogs ........................................... OK
Collecting measureware log .......................................... N/A
Finished with the collection
Tar archiving and compressing ....................................... TAR
Remote copying the archive ......................................... NO
The collection is
"//hpvmcollect_archive/compass1_Sep.29.05_122453PST.tar"
|
|
|
| |
|
 | NOTE: To use the hpvmcollect command on the guest, you must install the guest
kit on the guest as described in “Installing
a Guest Depot” in Chapter 3. |
|
| |
|
Additional data collected by the hpvmcollect command
includes log files (guest, Integrity VM, and VM Host) as well as VM Host
system information, including output from the ioscan, lanscan,
and swlist commands. The hpvmcollect command
also collects information about devices used by the guest. Output from the crashinfo and lanshowcommands
are included, if available.
The hpvmcollect command records device information
in the following files:
config/
host.diskinfo
host.fsinfo
host.ioscan
host.laninfo
host.sysinfo |
Printable version
