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
SecurityError messages:
- JSAS, SECG,SECJ, WSEC

Troubleshooting tips:
- V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGatherdocuments.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 MustGatherdocuments.
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.)
FindMustGatherdocuments.
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.)
FindMustGatherdocuments.
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.)
FindMustGatherdocuments.
Problems encountered when using:
  • SOAP
  • UDDI
  • WSGW
  • WSIF
Web servicesError 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 ComponentTroubleshooting tips:
- Load Balancer:V5.1
- Caching Proxy: V5.1

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

Support site:
- WebSphere Edge Server
FindMustGatherdocuments.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 ServerTroubleshooting 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 MustGatherdocuments.
Plug-in failures, including OSE remote, HTTP Remote, and plugin-cfg.xml.
Plug-inError messages:
- PLGC

Troubleshooting tips:
- V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGatherdocuments.
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
InstallError messages:
- INST, IVTL, WUPD

Documentation:
- Prerequisites

Troubleshooting tips:
- V5.1, V6.0

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

Troubleshooting tips:
-V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGatherdocuments.
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 ClientTroubleshooting tips:
- V5.1, V6.0

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

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

Troubleshooting tips:
- V5.1, V6.0

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

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

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

Troubleshooting tips:
- V5.1, V6.0

Search:
- IBM Education Assistant
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGatherdocuments.
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/RepositoryError 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
DeployError messages:
- ADMA, WUDU

Troubleshooting tips:
- V5.1, V6.0

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

No, next problem
ClassloaderSearch:
- 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 ConsoleError 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 ToolsError 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 ManagementError 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
JSPTroubleshooting tips:
- V5.1, V6.0

Search:
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGatherdocuments.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 SDKSearch:
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGather documents.
CrashSearch:
- Known problems (technotes)
Find MustGatherdocuments.
Receiving the following errors:
  • java.lang.OutOfMemory
  • UnsatisfiedLink
  • Too Many Open Files
  • Hangs or high CPU utilization

No, next problem
Out of MemorySearch:
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGatherdocuments.
Hangs/Performance DegradationTroubleshooting tips:
- V6.0

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

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

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

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

No, next problem
Dynamic CacheError messages:
- DRSW, DYNA

Troubleshooting tips:
-V5.1, V6.0

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

No, next problem
Sessions and Session ManagementError messages:
- SESN

Troubleshooting tips:
- V5.1, V6.0

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

No, next problem
Double Byte Character Set (DBCS)Search:
- Known problems (technotes)
- Updates (fixes, patches, etc.)
Find MustGatherdocuments.
Servlet Engine/Web ContainerTroubleshooting 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 PoolingTroubleshooting 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 MustGatherdocuments.
Problems starting the EJB Container.

No, next problem
EJB ContainerError 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): AIX, HPUX, Linux, Multi-Platform, Solaris, Windows
    Software version: 3.5, 4.0, 5.0, 5.1, 6.0
    Reference #: 7005324
    IBM Group: Software Group
    Modified date: 2004-12-10