How To
Summary
Instructions for VMRM debug data gather.
Objective
Environment
Steps
Collect the following data needed to investigate the VMRM issue.
1) On the KSYS LPAR:
Remove old data (old VMRM data is not completely cleaned up by "snap -r").
# snap -r
# rm -fr /tmp/ctsupt /tmp/ibmsuptEnsure there is sufficient free space in the tmp filesystem (~300MB).
snap vmsnapThe snap command stores the data at the following location: /tmp/ibmsupt
Submit all snap files from:
/tmp/ibmsupt
/tmp/ibmsupt/snap.pax.Z
/tmp/ibmsupt/ksys.pax.ZRename any file before it is submitted. If it is a snap.pax.Z file add KSYS --
** NOTE: Upload to IBM as two separate files. **
mv /tmp/ibmsupt/snap.pax.Z TSxxxxxxxxxx.snap.pax.Z
mv /tmp/ibmsupt/ksys.pax.Z TSxxxxxxxxxx.ksys.pax.Z====
2-) On the HMCs as user hscpe, do:
pedbg -c -q 4Look for a file like this --
/dump/HMClogs*zipChange the filename to be unique if necessary and submit it
=======================================================================
***STOP HERE***
=======================================================================
After reviewing KSYS snap, the problem may require VIOS snap data to debug further. Please following the following steps to gather VIOS data.
3) On each VIOS do:
Log in to the VIO server as "padmin" and collect a snap.
$ snapThe snap output is copied to:
/home/padmin/snap.pax.ZSee: https://www.ibm.com/support/pages/node/671013 for more details.
Rename the file and submit it.
# mv snap.pax.Z TSxxxxxxxxx.<VIOS_hostname>.snap.pax.Z---
4) If any managed Virtual Machine is an AIX LPAR, collect this data from such LPARs:
Gather a snap -ac
# snap -r
# snap -acThe output goes to:
/tmp/ibmsuptRename the file and submit it.
# mv snap.pax.Z TSxxxxxxxxx.<VM_hostname>.snap.pax.ZIf you are using VMRM HA, gather this data:
# ksysvmmgr snapIf the ksysvmmgr command is not on your VM, install the ksys.vmmon.rte fileset.
This command creates a *.pax.gz file in:
/var/ksys/log/snap/*.pax.gzThe "*" part of the file name is the date and time.
Rename the file and submit it.
# mv *.pax.gz TSxxxxxxxxx.*.pax.gz---
For VMRM GUI problem.
(GUI debug data gathering instructions follow. Get at least the KSYS vmsnap from previous steps. The KSYS vmsnap includes the ui logs in later versions.)
Collect the following data needed to investigate VMRM GUI issues:
1) Send screen captures showing evidence of the error if available.
2) On the GUI Server, do:
# cd /
# tar -cvf /tmp/TSxxxxxxxxx.server.tar ./opt/IBM/ksys/ui/*3) If the GUI Server is not deployed on the GUI Agent KSYS, on the GUI Agent KSYS do:
# cd /
# tar -cvf /tmp/TSxxxxxxxxx.agent.tar ./opt/IBM/ksys/ui/*4) If multiple VMRM KSYS clusters are part of the issue, do step 3 on all GUI Agent KSYS.
Add a KSYS name to the tar files --
# tar -cvf /tmp/TSxxxxxxxxx.agent.KSYSname.tar ./opt/IBM/ksys/ui/*5) Submit the tar files. The tar files can be compressed to reduce size.
Document Location
Worldwide
Was this topic helpful?
Document Information
Modified date:
16 February 2026
UID
ibm16454141