Troubleshooting Guide for WebSphere Application Server
 Product documentation
 
Abstract
The Troubleshooting Guide helps you get started on the troubleshooting process. It takes you through the process of identifying which component is causing the problem, finding the appropriate troubleshooting information, then collecting any necessary MustGather information, and finally submitting a problem to IBM® Support.
 
 
Content
Select one of the following questions to help get you started:

Are you having a problem with security, the OLT/DD tool, Object Request Broker (ORB), JNDI, or Web services?
Are you having problems with WebSphere Edge Server, Edge Components, a Web server, or plug-ins?
Are you having problems with installation, migration, an application client, PMI, or performance and PD tools?
Are you having problems with starting, stopping, deploying, administering, managing workload, or with programs or classes not being found?
Are you having a problem with JSPs, Servlets, Performance (Hang, Crash, High CPU, OutOfMemory), HttpSessions, or internationalization/encoding?
Are you having problems with data access, messaging, transactions, or EJB applications?
*
If your problem does not fit into the preceding questions, visit Steps to Getting Support for WebSphere Application Server.

For a simple listing of components and descriptions, visit MustGather: Read First.
Question > Problem > Component > Troubleshooting > Collecting > Submitting
Are you having a problem with security, the OLT/DD tool, ORB, JNDI, or Web services?

No, next question






















































back to top
Problems occur when security is disabled.

No, next problem
Security Error messages:
- JSAS, SECG, SECJ, WSEC

Troubleshooting tips:
- V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents. Email or FTP
ESR
Java Security (JSSE/JCE) Error messages:
- SECJ, WSEC

Troubleshooting tips:
- V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
Find MustGather documents.
Problems occur when running the OLT/DD graphical user interface tool.

No, next problem
Object Level Trace/ Distributed Debugger Troubleshooting tips:
- V5.1

Search:
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Problems encountered when managing distributed objects (for example: EJB).

No, next problem
Object Request Broker Error messages:
- JSSL, ORBX

Troubleshooting tips:
- V5.1, V6.0

Search:
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Problems with the lookup facility for objects like enterprise beans.

No, next problem
JNDI/Naming Error messages:
- NMSV

Troubleshooting tips:
- V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Problems encountered when using:
  • SOAP
  • UDDI
  • WSGW
  • WSIF
Web services Error messages:
- SOAP, WSWS, WSIF

Troubleshooting tips:
- Web services: V6.0
- Web services security: V5.1, V6.0
- WSIF: V5.1, V6.0
- UDDI, Web service, and SOAP: V5.1, V6.0
- UDDI Registry: V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Question > Problem > Component > Troubleshooting > Collecting > Submitting
Are you having problems with WebSphere Edge Server, Edge Components, a Web server, or plug-ins?

No, next question




























back to top
Problems regarding:
  • WebSphere Edge Server
  • eND
  • Network Dispatcher
  • Load Balancer
  • Proxy Server

No, next problem
Edge Component Troubleshooting tips:
- Load Balancer: V5.1
- Caching Proxy: V5.1

Search:
- Known problems (technotes)
- Updates (fixes, patches, etc.)

Support site:
- WebSphere Edge Server
Find MustGather documents. Email or FTP
ESR
Problems with your Web server.

For non-IBM Web server specific configuration issues, go to the Web server vendor. For example:
  • Sun® for iPlanet and Sun ONE
  • Microsoft® for IIS
  • Lotus® for Domino

No, next problem
IBM HTTP Server Troubleshooting tips:
- IBM HTTP Server: V2.0.47
- Problems installing or starting: V5.1, V6.0

Search:
- Known problems (technotes)
- Updates (fixes, patches, etc.)

Support site:
- IBM HTTP Server
Find MustGather documents.
Plug-in failures, including OSE remote, HTTP Remote, and plugin-cfg.xml.
Plug-in Error messages:
- PLGC

Troubleshooting tips:
- V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Question > Problem > Component > Troubleshooting > Collecting > Submitting
Are you having problems with installation, migration, an application client, PMI, or performance and PD tools?

No, next question






















































back to top
Problems occur during the installation of WebSphere Application Server.

No, next problem
Install Error messages:
- INST, IVTL, WUPD

Documentation:
- Prerequisites

Troubleshooting tips:
- V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents. Email or FTP
ESR
Plug-in (remote) install Documentation:
- Prerequisites

Troubleshooting tips:
- V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Problems with one of the following application clients:
  • J2EE Application client
  • Applet client
  • ActiveX to EJB Bridge client
  • Plugable Application client
  • Enterprise client
  • CORBA C++ client
  • launchClient runtime errors

No, next problem
Application Client Troubleshooting tips:
- V5.1, V6.0

Search:
- Known problems (technotes)
Find MustGather documents.
Problems with the Performance Monitoring Infrastructure (PMI) or Performance Tools:
  • Tivoli Performance Viewer/ Resource Analyzer
  • Log Analyzer
  • Performance Advisors

No, next problem
PMI/Performance Tools Error messages:
- PMON, PMRM

Troubleshooting tips:
- V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Problems running problem determination stand-alone tools (for example: Log Analyzer).

No, next problem
PD Tools Troubleshooting tools:
- V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
Find MustGather documents.
Problems when migrating from one release of WebSphere Application Server to another.
Migration Error messages:
- MIGR

Troubleshooting tips:
- V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Question > Problem > Component > Troubleshooting > Collecting > Submitting
Are you having problems with starting, stopping, deploying, administering, managing workload, or with programs or classes not being found?

No, next question


























































back to top
Problems regarding:
  • Deployment Manager start and stop issues.
  • Application Server startup problems.
  • Administrative Server startup problems.
  • Nanny problems.
  • Node Agent and deployment manager discovery problems.
  • addnode, syncnode, removenode, and so forth.
  • Repository Configuration corruption

No, next problem
System Management/Repository Error messages:
- ADML, ADMN, ADMR, ADMS, ADMU

Troubleshooting tips:
- V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents. Email or FTP
ESR
Problems regarding:
  • Application Assembly Tool (AAT)
  • EARexpander
  • ANT
  • Install of EAR/WAR/JAR files.

No, next problem
Deploy Error messages:
- ADMA, WUDU

Troubleshooting tips:
- V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Receiving the following errors:
  • NoClassDefFound
  • ClassNotFound
  • ClassCastException
  • FileNotFound

No, next problem
Classloader Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Problems regarding:
  • XMLConfig
  • Administrative Console
  • wscp
  • wsadmin failures

No, next problem
Administrative Console Error messages:
- ADMU, ADMC, ADMA

Troubleshooting tips:
- V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Administrative Scripting Tools Error messages:
- WSCP, ADMA

Troubleshooting tips:
- V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Problems specific to workload management using service classes, applenvs or WLM problems that occur in runtime.
Workload Management Error messages:
- WWLM

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Question > Problem > Component > Troubleshooting > Collecting > Submitting
Are you having a problem with JSPs, Servlets, Performance (Hang, Crash, High CPU, OutOfMemory), HttpSessions, or internationalization/ encoding?

No, next question








































































back to top
Programming issues with JSPs.

No, next problem
JSP Troubleshooting tips:
- V5.1, V6.0

Search:
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents. Email or FTP
ESR
JDK problems:
  • Core dump of Java process.
  • Unable to get thread dump, heapdump, core, dbxtrace, pstack, and so forth.

No, next problem
Java SDK Search:
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Crash Search:
- Known problems (technotes)
Find MustGather documents.
Receiving the following errors:
  • java.lang.OutOfMemory
  • UnsatisfiedLink
  • Too Many Open Files
  • Hangs or high CPU utilization

No, next problem
Out of Memory Search:
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Hangs/Performance Degradation Troubleshooting tips:
- V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
100% CPU Usage Troubleshooting tips:
- V5.1, V6.0

Search:
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Problems occur during the use of the HTTP Transport (internal Web server) as bypass of plug-in.

No, next problem
HTTP Transport Troubleshooting tips:
- V5.1, V6.0

Search:
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Problems when configuring or running dynamic cache or data replication services (DRS).

No, next problem
Dynamic Cache Error messages:
- DRSW, DYNA

Troubleshooting tips:
- V5.1, V6.0

Search:
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Problems or errors maintaining HttpSessions (for example: loss of session data or problems with HttpSession failover).

No, next problem
Sessions and Session Management Error messages:
- SESN

Troubleshooting tips:
- V5.1, V6.0

Search:
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Internationalization/ encoding configuration and code problems.

No, next problem
Double Byte Character Set (DBCS) Search:
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Servlet Engine/Web Container Troubleshooting tips:
- V5.1, V6.0

Search:
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Question > Problem > Component > Troubleshooting > Collecting > Submitting
Are you having problems with data access, messaging, transactions, or EJB applications?












































No, back to top
Problems with connection protocols such as JDBC, JMS, JTA.

Note: Database specific configuration issues go to the database vendor. For example:
  • DB2
  • Oracle

No, next problem
DB Connections/ Connection Pooling Troubleshooting tips:
- JDBC: V5.1, V6.0
- DB2: V5.1, V6.0
- Sybase: V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents. Email or FTP
ESR



















Java Message Service (JMS) Error Messages:
- WMSG, MSGS

Troubleshooting tips:
- V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Problems connecting to a working database (for example: data sources).

No, next problem
Java 2 Connectivity (J2C) Error messages:
- J2CA

Troubleshooting tips:
- JDBC: V5.1, V6.0

Search:
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Problems starting the EJB Container.

No, next problem
EJB Container Error messages:
- BNDE, CNTR

Troubleshooting tips:
- V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
Problems with any internal facilities needed by WebSphere components to coordinate resources that are involved in transactional work. Java Transaction Service (JTS)


Error messages:
- WTRN

Troubleshooting tips:
- V5.1, V6.0

Search:
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.


Question > Problem > Component > Troubleshooting > Collecting > Submitting
 
 
 


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > General
Operating system(s): HP-UX
Software version: 4.0
Software edition:
Reference #: 7005324
IBM Group: Software Group
Modified date: Dec 10, 2004