IBM Support

Diagnostic tools for troubleshooting Case Manager problems

How To


Summary

This document is a list of the diagnostic tools that are referenced in the Case Manager diagnostic and data collection documentation.

Steps

.

.

.

Table of Contents

Ping Page links
Browser developer tool console trace
Fiddler trace
Content Navigator debug-level tracing
Case Manager tracing
Content Platform Engine (CPE) subsystem tracing
Content Platform Engine(CPE) log files
IBM Case Manager (ICM) configuration tool log files

.

Ping Page links

Component Link
Case Manager (ICM) http://< ICM serveserver name or IP>:<port>/CaseManager/CASEREST/v1/info
Content Navigator (ICN) http://< ICN server name or IP>:<port>/navigator/Ping
Content Platform Engine (CPE) http://<CPE server name>:<port>/FileNet/Engine
Content Platform Engine Process

http://<CPE server name>:<port>/peengine/IOR/ping

 

Back to Table of Contents

.

.

Browser developer tool console trace

To display thedeveloper tool console tab in Chrome and Firefox:

  1. Click CTRL-SHIFT-I while the browser window is in focus. The browser developer tool will be displayed.
  2. Click on the Console tab in the developer tool.

 

To collect the contents of the console tab:

In Chrome: 
Right-click inside the Console tab, and choose Save As.

In Firefox:

  1. Right-click inside the Console tab, and choose Select All.
  2. Right-click inside the Console tab, and choose Copy.
  3. Paste the clipboard to a text editor and save it to a file.
Back to Table of Contents

.

.

Fiddler tracing

  1. Download and install the latest version of the Telerik Fiddler tool from www.telerik.com/download/fiddler.
  2. Start Fiddler on your workstation where you are diagnosing the problem.
  3. Make sure the File > Capture Traffic menu command is checked.
  4. If Case Manager client connects via SSL, then go to Tools > Fiddler options > HTTPS, and make sure the decrypt HTTPS traffic option is checked.
  5. Reproduce the problem in the browser.
  6. As you work in the browser, Fiddler will trace the calls made in the browser session.
  7. After reproducing the problem, you can save the trace in a *.saz file. Click on the Save button on the Toolbar.
Back to Table of Contents

.

.

Content Navigator debug-level tracing

  1. Log in to the IBM Content Navigator administration desktop.
  2. Click the Settings tab and then click the Logging subtab.
  3. Set the logging level for the applications to Debug.
  4. Click Save and then click Close.
  5. Log out of the IBM Content Navigator administration desktop.
  6. Restart the application server instance where IBM Content Navigator is deployed.

The output is saved to the Content Navigator server SystemOut.log file.

Back to Table of Contents

.

.

Case Manager tracing

Add the following trace string in the WebSphere Application Server administration console:

*=info:com.ibm.acm.*=all:com.ibm.casemgmt.*=all 

For instructions to configure WebSphere, see this tech note:  http://www-01.ibm.com/support/docview.wss?uid=swg21254706

The output is written to the WebSphere SystemOut.log and trace log files in the WebSphere logs directory.

Back to Table of Contents

.

.

Content Platform Engine (CPE) subsystem tracing

You can enable CPE subsystem tracing in ACCE. Before tracing, IBM support will provide the names of the subsystems that tracing is requested for.

Follow the steps in this tech note to enable subsystem tracing:  http://www-01.ibm.com/support/docview.wss?rs=0&uid=swg21308282

The output is written to the WebSphere SystemOut.log file and the CPE p8_server_trace.log and p8_server_error.log files.

Back to Table of Contents

.

.

Content Platform Engine(CPE) log files
The CPE log files are located in the WebSphere Application Server profile directory ([WebSphere profile]\FileNet\[server name]). 

Content Engine log files: p8_server_error.log
  p8_server_trace.log
Process Engine log files: pesvr_system.log
  pesvr_trace.log
Back to Table of Contents

.

.

IBM Case Manager (ICM) configuration tool log files

The Case Manager configuration tool log files are generated by default. No configuration is necessary. These are the log files you can collect:

  • The CMCT log files have the file name of ICM_Case_Manager_[ICM version]_CMCTx.log, and are under the Case Manager installation location logs subdirectory (for example: ...IBM/CaseManagement/logs).
  • The metadata log file is called .log, and is under the Case Manager installation location logs/.metadata subdirectory (for example: ...IBM/CaseManagement/logs/.metadata).
  • The log files generated by various tasks are file names that correspond to the task. These are located under the Case Manager installation location configure/tmp subdirectory (for example: ...IBM/CaseManagement/configure/tmp). You can collect all the *.log files from that directory for an analysis.

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSCTJ4","label":"IBM Case Manager"},"Component":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
11 July 2018

UID

ibm10716557