IBM Support

MustGather: Problems during deployment of EAR/JAR/WAR files in WebSphere Application Server Traditional

Troubleshooting


Problem

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 helps you to understand the problem and save time analyzing the data.

Symptom

.

Resolving The Problem

Tab navigation

Types of Issues:

Tab navigation


1. Collect a copy of the application (EAR/WAR/JAR) which is having the problem so support might be able to re-create.


2. If possible, stop all WebSphere Application Server processes and clear the following directory:

profile_root / logs


3. Restart the Deployment Manager or Application Server process.


4. Set the following Runtime mode trace:
 
a. In the administrative console, navigate to:

"Troubleshooting > Logs and Trace > dmgr > Diagnostic Trace > Change Log Detail Levels".

b. 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.

c. In the Change Log Detail Levels, modify the existing trace string to:
*=info:com.ibm.ws.console.app*=all:com.ibm.ws.management.application.*=all:com.ibm.websphere.management.application.*=all

d. If the issue is coming from annotation scanning, modify the existing trace string to:
 
*=info:com.ibm.ws.console.app*=all:com.ibm.config.eclipse.wtp=finer:com.ibm.ws.ecs=finer:com.ibm.config.annotations=finer:com.ibm.ws.management.application.*=all:com.ibm.websphere.management.application.*=all

e. Click Apply or OK so that the trace string is saved.
5. If the deployment was performed using wsadmin, enable wsadmin tracing as follows:
a. Modify the wsadmin.properties file located in the following directory:

    profile_root / properties
 
b. Replace this line:
#com.ibm.ws.scripting.traceString=com.ibm.*=all=enabled

with the following line:
 
com.ibm.ws.scripting.traceString=com.ibm.ws.scripting.AdminAppClient*=all:com.ibm.ws.scripting.AbstractShell*=all:com.ibm.ws.management.*=all:com.ibm.websphere.management.*=all
If the issue is coming from annotation scanning, replace with following line instead:
 
com.ibm.ws.scripting.traceString=com.ibm.ws.scripting.AdminAppClient*=all:com.ibm.ws.scripting.AbstractShell*=all:com.ibm.ws.management.*=all:com.ibm.websphere.management.*=all:com.ibm.config.eclipse.wtp=fine:com.ibm.ws.metadata.annotations.*=all:com.ibm.ws.websvcs.annotations.*=all


6. Recreate the problem.


7. If an error is displayed on the console screen, save a screen capture of the error in the administrative console.


8. Run the collector tool.

Note: If you are running in a Network Deployment environment, run on both Network Deployment and Node profiles. For more information, see the following Information Center topic:
In addition to the documents about the collector, IBM made available the following video which shows collector in Windows environment:
 
For unix environments the video still can be used, just need to adapt the paths to unix style, the extension from .bat to .sh and use root user ID instead of Administrator
Collect the following to send to IBM® Support:
 
  • Collector outputs from step 8.
  • Specific EAR/WAR/JAR file that is causing the problem
  • A clear description of what options are chosen during the installation process
    (If you are using a script to install the application, include it as well).
  • A screen capture of the administrative console if the error is displayed on the console screen.
     
Follow instructions to send diagnostic information to IBM® Support.

For a listing of all technotes, downloads, and educational materials specific to the Deployment component, search the WebSphere Application Server support site.

 

[{"Type":"MASTER","Line of Business":{"code":"LOB67","label":"IT Automation \u0026 App Modernization"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"ARM Category":[{"code":"a8m50000000CdUcAAK","label":"WebSphere Application Server traditional-All Platforms-\u003ESystem Management-\u003ETraditional WAS-\u003EDeploy"}],"ARM Case Number":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.5.5;9.0.0;9.0.5"},{"Product":{"code":"SSNVBF","label":"Runtimes for Java Technology"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Component":"Java SDK","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB08","label":"Cognitive Systems"}}]

Document Information

Modified date:
05 March 2024

UID

swg21199344