IBM Support

MustGather: Agile Planning issues with Engineering Workflow Management

Troubleshooting


Problem

This document assists you in collecting the data necessary to diagnose and resolve IBM Engineering Workflow Management (EWM) Agile Planning issues.

Resolving The Problem

You can use the IBM Support Assistant Data Collector (ISADC) tool to quickly collect diagnostic files, such as log files, configuration files or to run traces. ISADC collects information about your Jazz Team Server environment and stores the information in a .zip archive file. If you have a need to open a service request with IBM Support for further assistance, you can send the archive file with the data collection so that they can help diagnose and fix problems.

The following information should be gathered, in addition to the normal information and log gathering done by ISADC.


General information

  • Include a screen capture showing the error or bad behavior
     
  • Collect the running process template according to How to Extract a Process template from an existing project area
     
  • Identify which Roles or Users are incurring the bad behavior
     
  • Provide ‘Plan Details’ including 'Options' and 'Column display' view of the problematic plan
     
  • Indicate whether the problem occurs with all the plan views or only specific ones. Provide details about the plan view (filters, displayed columns, and more)

For errors in the web UI, which include 'null'

  • Enable "?debug=true" in the browser and collect a screen capture of the full error

    Example: https://<servername>:9443/ccm/web/projects/Project?debug=true#action=com.ibm.team.workitem.viewWorkItem&id=xxx
Firebug trace

  • If the issue is reproducible in the web UI, add "?debug=true" to the URL and reproduce the issue. Include a screen capture of the ‘console’ section of Firebug for any related errors
     
  • Export of the output in the NET tab within Firebug
For import and export of plans

  • In the log4j.properties (..server/ccm/conf), add the following line for trace:

    log4j.logger.com.ibm.team.tpt.internal.service.ImpexService=DEBUG
     
  • Save the log4j.properties file.
     
  • Reload the log4j.properties file by accessing the following link:

    https://<server>:9443/ccm/admin?internal=true#action=com.ibm.team.repository.admin.reloadLoggingSettings

    (This step avoids having to restart the server)
     
  • Reproduce the issue and provide the ccm.log file.
Performance when working with plans
  • In the log4j.properties (..server/ccm/conf), add the following line for trace:

    log4j.logger.com.ibm.team.apt.internal.service.rest.PlanRestService=TRACE
  • Save the log4j.properties file.
     
  • Reload the log4j.properties file by accessing the following link:

    https://<server>:9443/ccm/admin?internal=true#action=com.ibm.team.repository.admin.reloadLoggingSettings

    (This step  avoids having to restart the server)
  • Start Developer Tools and navigate to Performance tab.
     
  • Click Start Recording Performance button to start recording the session
     
  • Reproduce the issue and provide the ccm.log and recorded file.

[{"Type":"MASTER","Line of Business":{"code":"LOB59","label":"Sustainability Software"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSUC3U","label":"IBM Engineering Workflow Management"},"ARM Category":[{"code":"a8m50000000CjizAAC","label":"Workflow Management-\u003EPlanning-\u003EAgile"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
08 March 2023

UID

swg21632451