Troubleshooting
Problem
Collecting data for problems with the start and stop of IBM WebSphere Application Server, dmgr, and node agent. Gathering this information before calling IBM support will help familiarize you with the troubleshooting process and save you time.
Resolving The Problem
- Read first and related MustGathers
MustGather: Read first for WebSphere Application Server and Liberty
Administrative console problem Cluster ripple start problem Deployment problem Discovery problem on Deployment Manager Discovery problem on Node Agent JMX problem Profile wizard problem System administration problem WASService problem (Windows only) WSAdmin problem
- Collecting data manually
If an Application Server, dmgr or node agent is not able to start when issuing the command startServer servername, startManager, or startNode at the command line, or if an Application Server is unable to start or stop using the Network Deployment administrative console, collect the following documents using one of the tracing methods below.
Tracing from the WAS_PROFILE/bin command line:- Backup and purge the logs in the following directories:
WAS_PROFILE/logs/server_name
WAS_PROFILE/logs/FFDC - Open the following file:
WAS_PROFILE/config/cells/cell_name/nodes/node_name/servers/server_name/server.xml - Change the following string:
- From:
startupTraceSpecification="*=info"
- To:
startupTraceSpecification="*=info:com.ibm.ws.*=all"
- From:
- Change the following string:
- From:
maxNumberOfBackupFiles="1"
- To:
maxNumberOfBackupFiles="20"
- From:
- Save the changes.
- Run the following command:
startServer servername -trace This will log the trace to the startserver.log file located in the following directory: WAS_PROFILE/logs/server_name If you want the trace to be written to a unique file, run the following command: startServer server_name -trace -logfile path_to/servertrace.out Note: If you specify the -logfile option with only a file name and you do not specify a directory path for the log file, the file will be created in the WAS_PROFILE/bin directory. - Similarly, if the Application Server does not stop when issuing the command: stopServer server_name, stopManager, or stopNode. Follow the same procedure documented above for collecting trace documents, running the command stopServer. stopManager, or stopNode in place of startServer.
- Run the collector tool on both Network Deployment (for federated environment only) and Base Application Server profiles.
- Follow instructions to send diagnostic information to IBM support.
Tracing in the administrative console:
- Backup and purge the logs in the following directories:
WAS_PROFILE/logs/server_name
WAS_PROFILE/logs/FFDC - In the administrative console, expand the Troubleshooting section and click Logs and Trace.
- Click the link for your server.
- Click Change Log Detail Levels.
- Change the following string:
- From:
*=info
- To:
*=info:com.ibm.ws.*=all
- From:
- Increase the Maximum Number of Historical Files from 1 to 20.
- Click Apply and save and synchronize your configuration.
- Stop and restart the application server, deployment manager, or node agent.
- Run the collector tool on both Network Deployment (for federated environment only) and Base Application Server profiles.
- Follow directions on the WebSphere Application Server support portal to open a case and send data to IBM Support.
- Follow instructions to send diagnostic information to IBM support.
For a listing of all technotes, downloads, and educational materials specific to the System Management Repository component, search the WebSphere Application Server support portal.
- Backup and purge the logs in the following directories:
- Exchanging data with IBM Support
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:
- Service Request (SR)
- FTP to the Enhanced Customer Data Repository (ECuRep)
Related Information
Was this topic helpful?
Document Information
Modified date:
06 July 2022
UID
swg21201014