MustGather: Read first for all WebSphere Application Server products
 Technote (troubleshooting)
 
Problem(Abstract)
MustGather documents aid in problem determination and save time resolving Problem Management Records (PMRs).
 
Resolving the problem
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.


Do you want to automate the collection of MustGather data?
You can automatically collect this data using IBM Support Assistant (ISA) Lite - a special offering that contains the data collector component of the IBM Support Assistant Workbench.

For a full range of problem-solving features, install the IBM Support Assistant Workbench - your support workbench for finding answers and solving problems. The workbench contains all the data collection capability of ISA Lite plus much more!



MustGather: Readme first table of contents:

Gathering general information
Gathering component specific information
Submitting information to IBM Support


Gathering general information

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

Entering "Collector -summary" output into an electronically-opened PMR (SR) 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
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
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
High Availability (HA)
HTTP Transport
IBM HTTP Server
IBM Support Assistant
Install
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)
Scheduler
Security
Service Integration Technology
Servlet Engine/Web Container
Sessions and Session Management
System Management/Repository
Trial
read
Web Services (for example: SOAP or UDDI or WSGW or WSIF)
Web Services Security
Workload Management (WLM)
Components
IBM Education Assistant
Upgrade Policies
View all MustGather documents.



Submitting information to IBM Support

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

If using SR, 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 (SR) 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
Segment Product Component Platform Version Edition
Application Servers WebSphere Application Server - Express General AIX, HP-UX, Linux, Solaris, Windows 6.1, 6.0, 5.1, 5.0
Application Servers Runtimes for Java Technology Java SDK
 
 


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > General
Operating system(s): Windows
Software version: 7.0
Software edition:
Reference #: 1145599
IBM Group: Software Group
Modified date: Jun 30, 2007