Technote (troubleshooting)
Problem(Abstract)
The following MustGather will assist you in setting up the traces and collecting the data required to analyze a classloader issue. This MustGather is needed to analyze exceptions such as:
ClassNotFoundException, NoClassDefFoundError, ClassCastException, NoSuchMethodError, LinkageError, UnsatisfiedLinkError, VerifyError, UnsupportedClassVersionError.
Resolving the problem
Tab navigation
- Troubleshooting
- Collecting data- selected tab,
The following MustGather will assist you in setting up the traces and collecting the data required to analyze a classloader issue. This MustGather is needed to analyze exceptions such as:
ClassNotFoundException, NoClassDefFoundError, ClassCastException, NoSuchMethodError, LinkageError, UnsatisfiedLinkError, VerifyError, UnsupportedClassVersionError.
To improve the accuracy of complete data collection, IBM recommends you use the automated data collectors within IBM Support Assistant. Not only will the automated collector gather the equivalent of the manual process, it will also provide a secure file transfer of the collection to IBM.
Collecting data using the IBM Support Assistant Data Collector
- Go to the ISA Data Collector site for WebSphere Application Server.
- Start the ISA Data Collector:
- To run online, select the option to collect from this system using the current browser and click Start Collection.
- To run locally, select the option to collect from this or another system using a downloadable utility. Download and extract the zip file to your WAS_HOME directory. From a command line, run isadc.[sh|bat] or launch index.html to use the web interface.
- To run online, select the option to collect from this system using the current browser and click Start Collection.
- Select the Runtime > Classloader Problem collector and click Start.
- Follow the prompts to automatically submit the collected data to IBM Support.
Perform the following steps to collect WebSphere Application Server specific information.
- Backup and clear all Application Server logs:
native_stderr
native_stdout
SystemErr
SystemOut
The log files are located in the following directory:
<profile_root>/logs/server_name/*
Clear all WebSphere Application Server FFDC logs. FFDC files are located in the following directory:
<profile_root>/profile_name/logs/ffdc/*
Note: If you have configured to write FFDC log files into a different location, then clear them accordingly.
- Enable and collect Application Server traces with the following trace string:
com.ibm.ws.classloader.*=all
For more details, see How to set up a trace.
- Enable Java™ Virtual Machine (JVM) classloader traces through the Admin console:
- Select Servers, choose Application servers and select the server you want to configure.
- In the Server Infrastructure section, open Java and Process Management and select Process Definition.
- Under Additional Properties, select Java Virtual Machine.
- Check the Verbose class loading checkbox.
- Add the following string to the Generic JVM arguments field:
-Dws.ext.debug=true
- Click OK.
- Select Servers, choose Application servers and select the server you want to configure.
- Save the changes.
- Restart the server.
- Run the collector tool against the problem profile.
- Send IBM support the collector output, trace files and all the Application Server logs. Follow instructions to send diagnostic information to IBM support.
What to do next
Once you have collected the preceding information, send the diagnostic information to IBM support
Related information
Submitting information to IBM support
Steps to getting support for WebSphere Application Server
MustGather: Read first for WebSphere Application Server
Troubleshooting guide for WebSphere Application Server
To diagnose or identify a problem, it is sometimes necessary to provide Technical Support with data and information from your system. In addition, Technical Support might also need to provide you with tools or utilities to be used in problem determination. You can submit files using one of following methods to help speed problem diagnosis:
- IBM Support Assistant (ISA)
- Service Request (SR)
- FTP to the Enhanced Customer Data Repository (ECuRep)
| Segment | Product | Component | Platform | Version | Edition |
|---|---|---|---|---|---|
| Application Servers | WebSphere Application Server - Express | Java SDK | AIX, HP-UX, Linux, Solaris, Windows | 8.5, 8.0, 7.0, 6.1, 6.0 | |
| Application Servers | Runtimes for Java Technology | Java SDK |
Rate this page:
Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.