Troubleshooting
Problem
You are having issues with the IBM REST API that is provided with the IBM Business Automation Workflow products. You would like to know what information you must collect (MustGather) so that the IBM Business Automation Workflow Support team can diagnose your problem. If you gather this documentation before you contact support, then it expedites the troubleshooting process and saves you time.
Diagnosing The Problem
For example, you might be experiencing a problem when you try to access an API that uses the REST API tester or you might have issues when you claim or work on a task from IBM Process Portal.
Setting the trace string
Set the trace string on the AppTarget cluster to:
*=info:WLE.*=all:com.ibm.bpm.rest.*=all
Or a lightweight trace (if requested):
*=info:com.ibm.bpm.wle.util.*=all:com.ibm.bpm.rest.*=all
Note: Enabling the trace might slow down your system. This delay can lead to transaction timeouts and errors. Disable this trace after you collect the requested information.
1. Change the number of historical files to 20 at 50MB each in the WebSphere Application Server administrative console.
2. Change the log level in the Runtime configuration for each AppTarget to <trace string noted above>
3. Reproduce the issue.
4. Disable the trace in the Runtime configuration in the WebSphere Application Server administrative console by setting it to "*=info"
5. Collect the entire server logs directory (including FFDC) from the BAW node profile(s),
"/$install_root/profiles/$baw_node/logs/"
2. Change the log level in the Runtime configuration for each AppTarget to <trace string noted above>
3. Reproduce the issue.
4. Disable the trace in the Runtime configuration in the WebSphere Application Server administrative console by setting it to "*=info"
5. Collect the entire server logs directory (including FFDC) from the BAW node profile(s),
"/$install_root/profiles/$baw_node/logs/"
6. TeamWorksConfiguration.running.xml file:
"profiles/$baw_node/config/cells/$cell_name/nodes/$node_name/servers/$server_name/process-center(server)"
General diagnostic information
Collect the general troubleshooting information as described in the Collect troubleshooting data for IBM Business Automation Workflow products document.
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 Business Automation Workflow documentation or the support site to search for known problems.
- Once you complete gathering all the needed information and diagnostics, you can add them to your case. Alternatively, you can upload files to ECURep. For more information, see Enhanced Customer Data Repository (ECURep) - Overview.
[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS8JB4","label":"IBM Business Automation Workflow"},"ARM Category":[{"code":"a8m50000000CcVtAAK","label":"REST API"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"},{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSFPJS","label":"IBM Business Process Manager"},"ARM Category":[{"code":"a8m50000000CcVtAAK","label":"REST API"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]
Product Synonym
BPM; BAW
Was this topic helpful?
Document Information
Modified date:
14 September 2022
UID
swg21666278