MustGather: Problems during deployment of EAR/JAR/WAR files in WebSphere Application Server
 Technote (troubleshooting)
 
Problem(Abstract)
Collecting data for problems with the IBM® WebSphere® Application Server for problems that occur during the installation of an application (EAR/JAR/WAR) environment. Gathering this MustGather information before calling IBM support will help you understand the problem and save time analyzing the data.
 
Resolving the problem

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!


1. Learning more 2. Troubleshooting 3. Collecting data

If you have already contacted support, continue on to the component-specific MustGather information. Otherwise, click: MustGather: Read first for all WebSphere Application Server products.

Deployment specific MustGather information
  1. Note the application (EAR/WAR/JAR) that is causing the problem.
  2. If possible, stop all WebSphere processes and clear the following directory:

    install_root/logs


  3. Restart the Deployment Manager or Application Server process.
  4. Set the following Runtime mode trace:
    • For Application Server versions 6.0 and 6.1:
      1. In the administrative console, navigate to Troubleshooting > Logs and Trace > dmgr > Diagnostic Trace > Change Log Detail Levels.
        Then, select the Runtime tab.

        Note: If you are in a Base environment, select server1 instead of the dmgr server. If the problem is the application is not expanded to the installedApps directory, then also enable the traces on the NodeAgent process as well.
      2. In the Change Log Detail Levels, modify existing trace string to:

        *=info:com.ibm.ws.console.app*=all:com.ibm.ws.management.*=all:com.ibm.web
        sphere.management.*=all

      3. Click Apply or OK so that the trace string is saved.
    • For Application Server versions 5.0 and 5.1:
      1. In the administrative console, navigate to Troubleshooting > Logs and Trace > dmgr > Diagnostic Trace
        Then, select the Runtime tab.

        Note: If you are running in a Base environment, select server1 instead of the dmgr server

      2. In the Trace Specification field, modify existing trace string to:

        com.ibm.ws.console.app*=all=enabled:com.ibm.ws.management.*=all=ena
        bled:com.ibm.websphere.management.*=all=enabled


        Click Apply or OK so that the trace string is saved.
  5. If you are using wsadmin, enable the following tracing:
    1. Modify the wsadmin.properties file located in the following directory:

      install_root/properties

    2. Uncomment the following line:

      #com.ibm.ws.scripting.traceString=com.ibm.*=all=enabled
  6. Recreate the problem.
  7. Save the screen capture of administrative console if error is displayed on console screen.
  8. Run the collector tool

    Note: If you are running in a Network Deployment environment, run on both Network Deployment and base. For more details, see the following Information Center topic:
  9. Send the collector outputs along with the specific EAR/WAR/JAR file that is causing the problem. Also provide a clear description of what options are chosen during the install process (If using a script to install the application, include it as well). Send the screen capture of the administrative console if error is displayed on the console screen.
  10. Follow instructions to send diagnostic information to IBM support.

For a listing of all technotes, downloads, and educational materials specific to the Deploy component, search the WebSphere Application Server support site.
 
Related information
Submitting information to IBM support
Steps to getting support
MustGather: Read first
Troubleshooting guide
 
 
Cross Reference information
Segment Product Component Platform Version Edition
Application Servers Runtimes for Java Technology Java SDK
 
 


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > Deploy (for example: AAT or ANT or EAR/WAR/JAR)
Operating system(s): Windows
Software version: 6.1
Software edition:
Reference #: 1199344
IBM Group: Software Group
Modified date: Feb 19, 2007