IBM Support

MustGather: Source Control issues with Rational Team Concert

Troubleshooting


Problem

How to collect the data necessary to diagnose and resolve IBM Rational Team Concert (RTC) source control issues.

Cause

This MustGather will assist you in collecting the data necessary to help you diagnose and resolve the issue. If you are unable to determine the root cause using the information collected, you should open a support case with IBM Support for further investigation providing the data collected.

Resolving The Problem

You can use the IBM Support Assistant Lite (ISA Lite) Data Collector tool to quickly collect diagnostic files, such as log files, configuration files or to run traces. ISA Lite 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 information below should be gathered in addition to the normal information and log gathering done by ISA Lite.


 


SCM performance Issues

When there is a problem with transferring data between the server and the client such as a timeout, OutOfMemoryError or general slowness, collect the following data:

Enable SCM Service Logging
  1. Navigate to the /ccm/admin page and click Advanced in the right column.
     
  2. Search for the Enable SCM Service Logging property.
     
  3. Set the property to true.
     
  4. Scroll to the top of the page and click Save.
    You should see a Configuration changes saved successfully message.

A restart is not required.

Enable SCM tracing
  1. Add the following lines to <server-install-dir>/server/conf/ccm/log4j.properties:
    log4j.logger.com.ibm.team.scm=TRACE
     
  2. Enable these settings without restarting from the following URL https://<server:port>/ccm/admin?internal=true

  3. Select Reload Log Settings on the left side under Internal Tools.

To disable you must replace TRACE and DEBUG with OFF and use the Reload Log Settings operation again.
Removing them or commenting them out will prevent them from being disabled.

log4j.logger.com.ibm.team.scm=OFF

Disable the SCM Service Logging and the SCM tracing when the reproduction of the issue is complete to avoid unnecessary excessive logging.

 
Use the Query Stats counter service to gather query stats.
  1. Navigate to https://<server>/ccm/service/com.ibm.team.repository.service.ITeamServerStatusContentService Find and follow the com.ibm.team.repository.service.internal.diagnostics.IQueryStatisticsCounterContentService link.
     
  2. Press the Reset Query Stats link then the Start Collecting Query Stats link.
     
  3. To save the outout file, browse to the Query Stats View, copy and save the output to an ASCII file.
Metronome
If you are using the RTC Eclipse Client or Command Line Interface (CLI), then you can use the Metronome tool to measure server response times and diagnose which service is performing poorly during data transfer.
Gather Javacore files
Gather Javacore files according to Javacore Log Files and Application Logs document.

Reproduce the problem, collect and send in the following:


SCM CLI (Command Line Interface)
 
  • Check if the issue can be reproduced in the RTC Eclipse client (not using the CLI) or web UI.
     
  • If you encounter unresponsiveness (a hang), gather the data according to MUSTGATHER: Troubleshooting hangs of the scm.exe application
     
  • Contact IBM support about any additional traces that might be applicable when troubleshooting your issue.

SCM Eclipse Client
 
  • Enable tracing according to the Client Tracing document.
     
  • Collect the relevant screen captures.
     
  • Collect the workspace log file located in <workspace directory>/.metadata named .log

SCM Web UI
  • Collect the relevant screen captures.
     
  • Browser's developer tools can be used to collect the browser network data or to check the scripts when reproducing the issue. You can find more details how to use developer tools on Debugging the Web UI in the Development Environment.

SCM Visual Studio Client

Leverage the Jazz Community

Jazz and Rational Team Concert have an active community that can provide you with additional resources. Browse and contribute to the User forums, contribute to the Team Blog and review the Team wiki.
Refer to technote 1319600 for details and links.

[{"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Product":{"code":"SSUC3U","label":"IBM Engineering Workflow Management"},"Component":"SCM","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB02","label":"AI Applications"}}]

Product Synonym

Rational Team Concert

Document Information

Modified date:
01 November 2019

UID

swg21632546