IBM Support

MUSTGATHER data to diagnose Performance Issues on PowerVM VIOS

How To


Summary

This document discusses data collection needed by IBM Support to diagnose performance issues on a PowerVM Virtual I/O Server (VIOS).

Objective

Data required to diagnose VIOS performance problem.

Environment

This document applies to PowerVM VIOS version 3.1 and 4.1

Steps

Note 1:  For performance problem on AIX, IBM i, or Linux clients, stop here and contact your local Operating System Support Representative for initial problem determination.  If you have a current IBM Software Maintenance Agreement, you can open a case for the Operating System version in question.
Note 2:  To diagnose performance problem on a PowerVM VIOS,  continue with the remaining of this document.  Data collection must be captured at the time the issue is ongoing
If the problem happens intermittently, wait for the problem to reoccur to capture the data discussed next.
If the problem is not longer happening and need root cause after the fact, see What to expect when requesting Root Cause Analysis (RCA) (applies to AIX, HMC, IBM i, PowerHA, PowerVM, Power Systems) 
1. Capture on-demand VIOS Performance Advisor data by using part command
The part command provides performance reports with suggestions for making configurational changes to the environment, and helps to identify areas for further investigation.
For example, to capture performance report for 10 minutes, log in to the VIOS, as padmin, and run:
$ part -i 10        where -i is the interval within 10-60 minutes
image-20230825093533-3
Click here for more details. 
The *.tar file includes a file named, vios_advisor.xml. This is the VIOS Performance Advisor report that can be viewed using a browser.  The report generates a Recommended Value if the current allocated resources such as CPU or memory are deemed to be low.   This Recommended Value is calculated based on the VIOS workload going on at the time of the data collection.  Therefore, if the  VIOS workload has peak hours or the performance problem happens at a certain time, the data must be collected during that time.
Recommended Action
Using your preferred browser, review the VIOS Performance Advisor reportvios_advisor.xml
If the report shows a Recommended Value for CPU or memory, increase the value accordingly.  If the problem continues after that, repeat step 1 to verify low CPU or memory is no longer an issue.  Then, proceed to step 2.
Note 3:  Performance tuning is beyond the scope of VIOS Support.
Note 4:  For storage performance problems, contact your Storage Support Representative.
2. Capture VIOS perfpmr data
Refer to the following support document for details on all data required:
  1. Provide answers to all questions in item #1.
  2. Capture performance data using perfpmr.sh (VIOS 3.1 is based on AIX 7.2 and  VIOS 4.1 is based on AIX 7.3)
    1. To verify VIOS version, login as padmin, and run:
      $ ioslevel
    2. The perf72.tar.Z script automatically captures VIOS snap data and puts it in the snap_data subdirectory.  Other VIOS key data is captured in vio.cfg file located in the main directory .  Although, perfpmr does not capture a full VIOS snap, this data is typically enough to investigate performance issues on VIOS.

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSPHKW","label":"PowerVM Virtual I\/O Server"},"ARM Category":[{"code":"a8mKe000000TN3qIAG","label":"PERFORMANCE"}],"ARM Case Number":"TS004699110","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
14 October 2024

UID

ibm16388724