You are having an application deployment problem with IBM Business Process Manager. You would like to know what documentation you must collect (MustGather) so that the IBM Business Process Manager Support team can diagnose your problem. If you gather this documentation before contacting support it will expedite the troubleshooting process, and save you time.
Diagnosing the problem
Setting the trace string
On the AppTarget cluster for the Process Center and the Process Server, set the trace string to *=info:WLE.*=all:WAS.clientinfopluslogging=all:com.ibm.bpm.fds.*=all:ProcessApplicationLifecycle=all:
Note: Enabling this trace might slow down your system. This delay can lead to transaction time-outs and errors. Disable this trace after collecting the requested information.
To set the tracing and generate a new set of log files and traces, complete the following steps for the servers or clusters that show the issue:
- In the Integrated Solutions Console, under Troubleshooting > Log and Trace, click the server name for which you want to change the settings.
- Click Change Log Detail Levels.
- Select the configuration tab to set the tracing. This change takes effect after the next server restart and a completely new set of log files can be collected. Optionally, select the runtime tab to dynamically set the tracing.
- Enter the trace string and click OK.
- If you selected the configuration tab, stop the server.
- Archive and delete the current log files, traces, and ffdc from the following directories:
- Start the server and check the trace.log file to make sure that the correct tracing is set.
- Reproduce the problem and note down the timestamp. Check the trace.log file to ensure that the time of the issue is covered in the file and gather the complete server log files and ffdc directory.
- Delete the trace string from the Log Detail Level for your server.
Note: Ensure that you have set the Maximum trace file size (recommendation: 20MB) and the number of historical trace files (recommendation: 20) to an appropriate value. You can find those values at Servers > Application Servers > server_name > Diagnostic Trace Service.
General diagnostic information
Collect the general troubleshooting information as described in Collect troubleshooting data for the IBM Business Process Manager products.
- Simplified and isolated test case without any custom dependencies and without access to external customer systems
- *.twx export from IBM Process Designer
- Project Interchange (PI) and enterprise archive (EAR) file from the involved Advanced Integration Services, if applicable
- A detailed step-by-step description on how to reproduce the problem
Provide the contents of the following tables:
- LSW_SERVER (on Process Center)
- LSW_DEPLOYMENT (only on Process Center)
- LSW_INSTALLATION (only on Process Server)
- LSW_SNAPSHOT (from Process Center and Process Server)
If you deploy a snapshot to an offline Process Server, provide the complete command that is failing and its output from the command-line console.
If you see long delays when the application is deployed, collect 4-5 thread dumps from the Process Center and the Process Server side (AppTarget cluster). These thread dumps should be 30-40 seconds apart when the deployment is running.
What to do next
- Review the log files and traces at the time of the problem to try to determine the source of the problem.
- Use IBM Support Assistant to search for known problems in the product documentation, forums, and technotes.
- If you cannot find related problems or cannot solve the problem, send the information you have collected to IBM by following the instructions in Exchanging Information with IBM Technical Support.
BPM product documentation - Installing process apps
BPM product documentation - Troubleshooting app deploy
Password limitations when deploying to offline Process
A simplified Chinese translation is available
|Business Integration||IBM BPM Advanced Pattern on Red Hat Enterprise Linux Server||Application Deployment||Linux Red Hat - xSeries||8.0.1, 8.0|
|Business Integration||IBM Business Process Manager Express||Application Deployment||Linux, Windows||8.5, 8.0.1, 8.0, 7.5.1, 7.5|
|Business Integration||IBM Business Process Manager Standard||Application Deployment||AIX, Linux, Solaris, Windows||8.5, 8.0.1, 8.0, 7.5.1, 7.5|
|Business Integration||IBM Business Process Manager Advanced Pattern on AIX||Application Deployment||AIX||8.0.1|