IBM WebSphere Application Server Network Deployment for Distributed Platforms, Version 8.0 Troubleshooting WebSphere applications Note Before using this information, be sure to read the general information under Notices” on page 349. Compilation date: July 29, 2011 © Copyright IBM Corporation 2011. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents How to send your comments ...........................vii Changes to serve you more quickly .........................ix Chapter 1. Troubleshooting ActivitySessions......................1 Troubleshooting ActivitySessions ...........................1 Chapter 2. Troubleshooting Application profiling ....................3 Application profiling exceptions ............................3 Chapter 3. Troubleshooting batch applications .....................5 Troubleshooting batch applications ..........................5 Adding log and trace settings to the batch environment ..................5 Batch common problems .............................5 Diagnosing problems using job logs .........................7 Chapter 4. Troubleshooting applications that use the Bean Validation API ..........9 Bean validation troubleshooting tips ..........................9 Chapter 5. Troubleshooting Client applications ....................11 Application client troubleshooting tips .........................11 Adding tracing and logging for stand-alone clients ....................17 Chapter 6. Troubleshooting Data access resources...................19 Troubleshooting data access problems ........................19 Data access problems..............................19 JDBC trace configuration.............................42 Chapter 7. Troubleshooting Dynamic caching .....................45 Troubleshooting dynamic cache ...........................45 Troubleshooting the dynamic cache service ......................45 Chapter 8. Troubleshooting EJB applications .....................53 Troubleshooting Enterprise JavaBeans applications ....................53 Enterprise bean and EJB container troubleshooting tips .................53 Application client log error indicates missing JAR file ..................53 Enterprise bean cannot be accessed from a servlet, a JSP file, a stand-alone program, or another client ...................................54 Troubleshooting access intents for EJB 2.x entity beans ..................57 Access intent exceptions .............................57 Access intent troubleshooting tips .........................58 Troubleshooting JPA applications...........................59 Logging applications with JPA ...........................63 Troubleshooting JPA deadlocks and transaction timeouts .................69 Chapter 9. Troubleshooting Messaging resources ...................73 Troubleshooting messaging .............................73 Messaging troubleshooting tips ..........................74 Troubleshooting message-driven beans .......................80 Troubleshooting performance monitoring statistics ...................81 Chapter 10. Troubleshooting Naming and directory...................83 Troubleshooting namespace problems .........................83 © Copyright IBM Corp. 2011 iii Naming service troubleshooting tips.........................83 Application access problems ...........................84 Viewing a namespace dump ...........................88 dumpNameSpace tool..............................91 Viewing java:, local:, and server namespace dumps..................94 Namespace dump utility for java:, local: and server namespaces .............96 Chapter 11. Troubleshooting Object Request Broker (ORB)................99 Troubleshooting Object Request Brokers ........................99 Object request broker troubleshooting tips ......................99 Object Request Broker communications trace.....................113 CORBA minor codes ..............................116 Chapter 12. OSGi Applications: Troubleshooting tips .................119 OSGi Applications: Known restrictions ........................123 Migrating and coexisting for OSGi applications .....................123 OSGi Applications: Messages ...........................126 Chapter 13. Troubleshooting security........................127 Troubleshooting security configurations ........................127 Security components troubleshooting tips ......................127 Security configuration and enablement errors .....................139 Security enablement followed by errors .......................142 Access problems after enabling security.......................150 SSL errors for security .............................155 Errors configuring SSL encrypted access for security ..................159 Single sign-on configuration troubleshooting tips for security ...............161 Security authorization provider troubleshooting tips...................164 SPNEGO trust association interceptor (TAI) troubleshooting tips (deprecated) .........168 SPNEGO troubleshooting tips ..........................175 Chapter 14. Troubleshooting Service integration ...................185 Troubleshooting service integration technologies ....................185 Resolving indoubt transactions ...........................187 Restoring a data store and recovering its messaging engine ................188 Problem solving for messaging engine file stores ....................190 Diagnosing problems with accessing file store files...................190 Reducing file store file sizes ...........................191 Problem solving for messaging engine data stores ....................192 Diagnosing problems with data store exclusive access locks ...............192 Diagnosing problems with your data store configuration .................193 Avoiding failover problems when you use DB2 v8.2 with HADR as your data store .......194 Listing messages on a message point ........................194 Deleting messages on a message point........................195 Troubleshooting service integration message problems ..................195 Understanding why best effort nonpersistent messages are being discarded .........196 Investigating why a queue is full .........................196 Investigating why a topic space is full .......................198 Investigating why point-to-point messages are not arriving ................200 Investigating why point-to-point messages are not being consumed ............205 Investigating why publish/subscribe messages are not arriving at a subscription ........212 Chapter 22. Troubleshooting Session Initiation Protocol (SIP) applications .........241 Troubleshooting SIP applications ..........................241 Tracing a SIP container .............................242 iv Troubleshooting WebSphere applications Chapter 23. Troubleshooting Transactions ......................245 Troubleshooting transactions ............................245 Transaction troubleshooting tips..........................245 Transaction service exceptions ..........................247 Transaction exceptions that involve both one-phase and two-phase commit resources......248 Chapter 24. Troubleshooting web applications ....................249 Troubleshooting web applications ..........................249 Web application deployment troubleshooting tips ...................249 JavaServer Pages troubleshooting tips .......................250 Troubleshooting contexts and dependency injection ..................253 Troubleshooting HTTP sessions...........................256 HTTP session manager troubleshooting tips .....................256 HTTP session problems ............................258 Chapter 25. Troubleshooting web services......................263 Troubleshooting web services ...........................263 Directory conventions .............................263 Web services command-line tools troubleshooting tips .................266 Web services compiled bindings troubleshooting tips ..................270 Web services client runtime troubleshooting tips....................270 Web services serialization and deserialization troubleshooting tips .............273 Web services authentication, authorization and secure transport troubleshooting tips ......275 Application client SOAP request troubleshooting tips ..................276 Universal Discovery, Description, and Integration, web service, and SOAP component troubleshooting tips .............................278 Tracing web services..............................278 Tracing SOAP messages with tcpmon .......................280 Frequently asked questions about web services ....................281 Web Services Security troubleshooting tips .....................283 Detecting and fixing problems with WS-ReliableMessaging .................297 WS-ReliableMessaging sequence reallocation ....................299 Diagnosing the problem when a reliable messaging source cannot deliver its messages .....300 Diagnosing and recovering a WS-ReliableMessaging outbound sequence that is in retransmitting state ...................................300 Deleting a failed WS-ReliableMessaging outbound sequence ...............301 WS-ReliableMessaging troubleshooting tips .....................302 Troubleshooting WSIF ..............................307 Tracing and logging WSIF ............................308 WSIF (Web Services Invocation Framework) messages .................309 Web Services Invocation Framework troubleshooting tips ................310 WSIF - Known restrictions ............................314 UDDI registry troubleshooting ...........................315 Bus-enabled