Troubleshooting
Problem
Diagnosing The Problem
b) Download aixperf.sh from this technote: aixperf.sh
If your current process ID (PID) is 1234, then run the command:
./aixperf.sh 1234
If you have multiple PIDs, that you want to collect data for, then separate them with a space:
./aixperf.sh 1234 5678
./aixperf.sh -c CPU_THRESHOLD_VALUE 1234 5678
** Note: The script does not work using the server name, it must be the current process ID (PID) number.
(2) Submitting required data:
Zip the files gathered:
- aixperf_RESULTS.<DATE>.<TIMESTAMP>.tar.gz created by aixperf.sh (including javacores)
- WAS_HOME/profiles/<profile_name>/logs (SystemOut.log, SystemErr.log, native_stderr.log, native_stdout.log, verbosegc)
- server.xml for the server(s) that you are providing data for
(3) Send the results to IBM Support: "Exchanging information with IBM Support"
Frequently asked questions:
- What is the impact of enabling verboseGC?
VerboseGC data is critical to diagnosing these issues. It can be enabled on production systems because it has a negligible impact on performance (< 1%).
- What is the aixperf_RESULTS.<DATE>.<TIMESTAMP>.tar.gz file and where can I find it?
The aixperf_RESULTS.<DATE>.<TIMESTAMP>.tar.gz file is created while running the aixperf.sh script and contains output from the commands called by the script. It is created in the directory from which you execute the script.
- Does the script gather javacores?
Yes if javacores are in the default directory or in the user-specified directory (set by -Xdump:directory generic JVM argument or IBM_JAVACOREDIR environment variable).
- What are 'javacores' and where do I find them?
Javacores are snapshots of the JVM activity and are essential to troubleshooting these issues. These files usually can be found in the <profile_root>. If you do not find the files here, you can search your entire system for them using the following command:find / -name "*javacore*"
Only if asked to do so by Support:
./aixmon.sh
It creates two files: ps_mon.out and vmstat_mon.out. The script can be stopped by using Ctrl+C keys.
aixmon.sh.zip
./aixperf60.sh 23456 (use the actual PID number for your JVM)
Note: Both aixperf60.sh and dbxtrace_aix.sh are created in the same directory and dbx must be installed to diagnose high CPU issues.
aixperf60.sh.zip | dbxtrace_aix.sh.zip
These scripts will create a file named aixperf_RESULTS.tar.gz and javacore text files. These scripts need to be executed as the root user. As with any script, you might need to add execute permissions before executing the script (chmod).
Related Information
Recording your screen to share with IBM Support
MustGather: Read first for WebSphere Application Server
How to enable verbosegc in WebSphere
IBM Thread and Monitor Dump Analyzer
Submitting information to IBM support
Steps for getting support for WebSphere Application Server
Was this topic helpful?
Document Information
Modified date:
16 March 2023
UID
swg21052641