MustGather: Read first for all WebSphere Application Server products

Technote (FAQ)
Problem
MustGather documents aid in problem determination and save time resolving Problem Management Records (PMRs).

Collecting MustGather data early, even before opening the PMR, helps IBM® Support quickly determine if:
  1. Symptoms match known problems (rediscovery).
  2. There is a non-defect problem that can be identified and resolved.
  3. There is a defect that identifies a workaround to reduce severity.
  4. Locating root cause can speed development of a code fix.
Solution
MustGather: Readme first table of contents:

GatheringGathering general information
GatheringGathering component specific information
SubmittingSubmitting information to IBM Support


Gathering general information

For WebSphere Application Server V5.0.2 or later, use thecollector tool to capture general information for each host machine. If you are running a version previous to V5.0.2, you can also manually collect the general information.

Entering "Collector -summary" output into an electronically-opened PMR (ESR) eliminates waiting on the phone to provide general information to Level 1 support.


Gathering component specific information

For assistance in help identifying the component causing problems, visit the Troubleshooting Guide for WebSphere Application Server.

Otherwise, take a look at the components and the component descriptions in the table below. If one of the product components below matches your symptom or the part of the product with which you are experiencing problems, follow the instructions in the associated MustGather document:

View all MustGather documents.
Components
Collector Tool
Upgrade Policies
IBM Education Assistant
100% CPU Usage
Administrative Console (all non-scripting)
Administrative Scripting Tools (for example: wsadmin or ANT)
Application Client
Application Server Toolkit (AST)
Classloader
Crash
Data Replication Services
DB Connections/Connection Pooling
Deploy (for example: AAT or ANT or EAR/WAR/JAR)
Double Byte Character Set (DBCS)
Dynamic Cache
Edge Component
EJB Container
General
Hangs/Performance Degradation
HTTP Transport
IBM HTTP Server
Install
Java 2 Connectivity (J2C)
Java Management Extensions (JMX) or JMX client API
Java Message Service (JMS)
Java Security (JSSE/JCE)
Java Transaction Service (JTS)
Java SDK
JNDI/Naming
JSP
Migration
Object Level Trace/Distributed Debugger (OLT/DD)
Object Request Broker (ORB)
Out of Memory
PD tools (for example Log Analyzer)
Plug-in
Plug-in (remote) Install
PMI/Performance Tools
Programming Model Extensions (PME)
Security
Servlet Engine/Web Container
Sessions and Session Management
System Management/Repository
Web Services (for example: SOAP or UDDI or WSGW or WSIF)
Workload Management (WLM)
Components
IBM Education Assistant
Upgrade Policies
Collector Tool
View all MustGather documents.


Submitting information to IBM Support

After a PMR is open, you can submit diagnostic MustGather data to IBM.

If using ESR, update the PMR to indicate that data has been sent.


Collector Tool

If you are running WebSphere Application Server V5.0 or higher, use the collector tool to capture information for components specified in the table above.

Entering "Collector -summary" output into an electronically-opened PMR (ESR) eliminates waiting on the phone to provide general information to Level 1.


Manually gathering general information

For releases of WebSphere® Application Server previous to V5.0.2,manually gather the following information for each host machine:
  • Hostname
  • The product and version of the Web server, if one is installed
  • The application server or clone, if either are installed
  • The WebSphere Application Server version and edition
  • The installed interim fixes
  • Your operating system and version
  • The operating system patches or maintenance level
  • The number of CPUs that you have
  • The amount of RAM that you have


Related information
Cross Reference information
SegmentProductComponentPlatformVersionEdition
Application ServersWebSphere Application Server for z/OSz/OS











Document Information

Product categories: Software, Application Servers, Distributed Application & Web Servers, WebSphere Application Server, General
Operating system(s): AIX, HPUX, Linux, Multi-Platform, Solaris, Windows
Software version: 3.5, 4.0, 5.0, 5.1, 6.0
Software edition: Advanced, Base, Network Deployment, Single Server
Reference #: 1145599
IBM Group: Software Group
Modified date: 2005-01-06