If you believe that you have found a possible performance problem in AIX, there are tools and procedures for reporting the problem and supplying problem-analysis data. They are intended to ensure that you get a prompt and accurate response with a minimum of effort and time on your part.
The main sections in this topic are:
Performance problems are often reported right after some change to the system's hardware or software. Unless there is a pre-change baseline measurement with which to compare post-change performance, quantification of the problem is impossible. Still better would be collection of a full set of performance and configuration information using the PerfPMR package, as recommended in Check Before You Change.
Having the Performance Diagnostic Tool (PDT) installed and operational also provides a baseline of overall system performance.
You should report suspected AIX performance problems to the IBM Software Service organization. Use your normal software problem-reporting channel. If you are not familiar with the correct problem-reporting channel for your organization, check with your IBM representative.
When you report the problem, you should supply the following basic information:
If this is the first report of the problem, you will receive a PMR number for use in identifying any additional data you supply and for future reference.
You will probably be asked to provide data to help IBM analyze the problem. An IBM-provided tools package called PerfPMR can collect the necessary data. On AIX Version 3.2.5, PerfPMR is an informal tool available from your IBM representative. On AIX Version 4, PerfPMR is an optionally installable package on the AIX Base Operating System distribution medium.
Your IBM representative can obtain a copy of AIX Version 3.2.5 PerfPMR on suitable media.
To install PerfPMR, you:
# cd /tmp # mkdir perfpmr # cd perfpmr
# tar -xvf/dev/fd0 perfpmr.tarbinz
# mv perfpmr.tarbinz perfpmr.tarbin.Z
# uncompress perfpmr.tarbin.Z
# tar -xvf perfpmr.tarbin
# ./Install
To acquire the correct version of perfpmr, visit IBM's web site: www.ibm.com. Enter perfpmr in the search box, and search All IBM. The result of the query is a window entitled "AIX Performance PMR Data Collection Scripts - perfpmr." Click the download button to transfer to the perfpmr ftp site. Several different versions of perfpmr are listed (for example, perf32, perf41, perf42, and perf43).
Each folder contains the following:
perfxx.tar.Z file | Compressed tar file containing perfpmr |
message | Description of the contents |
license.agreement | IBM International Program License Agreement |
readme | Instructions on obtaining and installing perfpmr, collecting data, and sending the data to IBM |
To install PerfPMR from the Web, you:
# mkdir /tmp/perf41 # cd /tmp/perf41
# zcat /tmp/perf41.tar.Z | tar -xvf -
# sh ./Install
The installation process places the PerfPMR package in a directory called /usr/sbin/perf/pmr. The package takes approximately 200KB of disk space.
All of the following items should be included when the supporting information for the PMR is first gathered:
To capture and package the data in usable form, perform the following steps on each of the systems involved with the problem. If possible, step 6 should be performed on all of the systems at (approximately) the same time.
$ lslpp -lI perfagent.tools
If this package has been installed, the tools are available.
In AIX Version 4, add /usr/sbin/perf/pmr to the PATH. For example:
# echo $PATH /usr/bin:/etc:/usr/local/bin:/usr/ucb:.: # PATH=$PATH:/usr/sbin/perf/pmr: # export PATH
In Version 3, add to the PATH the directory in which you installed PerfPMR (in place of /usr/sbin/perf/pmr) and the directory for the performance tools, /usr/lpp/bosperf.
# mkdir perfdata # cd perfdata
# perfpmr 3600
(in Version 3, perfpmr is named perfpmr.sh.)
# cd .. # tar -cvf pmrnumber.tarbin perfdata # compress pmrnumber.tarbin
Where pmrnumber is the number assigned to the PMR by Software Service.
# tar -cvf /dev/fd0 pmrnumber.tarbin.Z
# tar -xvf /dev/fd0
IBM Corporation, Mail Drop 2900 11400 Burnet Road Austin, TX 78758 Attn: AIX Program Services: V4DEFECT (or V3DEFECT, as appropriate)
Outside the United States, send the data to your IBM Software Service organization.