[Collapse]Collaborator 10
 [Expand]General Information/viewarticle/80040/
 [Expand]Getting Started/viewarticle/80359/
 [Expand]Collaborator Server/viewarticle/80060/
 [Expand]Web Client/viewarticle/80107/
 [Expand]Desktop Clients/viewarticle/80151/
 [Collapse]Version Control Integration/viewarticle/80048/
  [Expand]AccuRev Integration/viewarticle/80045/
  [Expand]CVS Integration/viewarticle/80129/
  [Expand]Git Integration/viewarticle/80194/
  [Expand]IBM Rational ClearCase Integration/viewarticle/80183/
  [Expand]IBM Rational Synergy Integration/viewarticle/80205/
  [Collapse]IBM Rational Team Concert Integration/viewarticle/80221/
    Overview/viewarticle/80116/
    How Integration Features Work/viewarticle/80437/
   [Expand]Configuring Servers and Plug-Ins/viewarticle/80438/
    Troubleshooting/viewarticle/80428/
  [Expand]Mercurial Integration/viewarticle/80214/
  [Expand]Microsoft Team Foundation Server Integration/viewarticle/80128/
  [Expand]PTC Integrity Integration/viewarticle/80198/
  [Expand]Perforce Integration/viewarticle/80126/
  [Expand]Subversion Integration/viewarticle/80125/
 [Expand]External Integrations/viewarticle/80340/
 [Expand]Techniques & Best Practices/viewarticle/80403/
 [Expand]Appendices/viewarticle/80117/
Updated: 12/23/2016 Applies To: Collaborator 10 Rating: No votes Click to rate: PoorNot badAverageGoodExcellent

Version Control Integration > IBM Rational Team Concert Integration

Top |Previous |Next

Troubleshooting

This topic lists typical issues for the Collaborator integration with Team Concert and possible solutions for them.

Issues 

Synchronizing the Review Participants List

Automatic Review Creation and File Uploading

Manual Review Creation

General Notes

In order for Collaborator and Rational Team Concert to integrate successfully, you need to configure the Rational Team Concert and Collaborator servers, as well as install and configure special plugins. If some feature is not working, then most likely some setting is invalid. Check the settings according to the information in the Configuring Servers and Plug-Ins section.

Issues

Synchronizing the Review Participants List

For reviews that were created automatically, Collaborator synchronizes the work item's Approvals and the review's Participants lists (see How Integration Features Work). If the synchronization does not work, check the following:

Look at the review phase. Collaborator does not synchronizes the lists if the review is in the Planning phase.
The review must be created automatically. Synchronization does not work for the reviews that were created with the "Add to Review" command.
Check if the user has the same names in Collaborator and Team Concert. Users with different names are not synchronized.
Make sure the Add reviewers and Remove reviewers settings of the Collaborator server are enabled. See Configuring Collaborator Server.
Check the connection between Collaborator and Team Concert. To do this, log in to Collaborator as administrator, go to Admin > Version Control, find your Rational Team Concert configuration there and click Test Connection.
Check the user's roles in Collaborator and Team Concert.
In Collaborator, the user should have a role that allows the user to finish reviews. By default, this is the Reviewer role, Observers are ignored.
In Team Concert's, the user be added to the Approvals list as a Reviewer. Approvers are ignored.
Check the Client Configuration Mapping settings of Collaborator and make sure the configuration matches the desired Team Concert server. See Mapping Configurations.
Automatic Review Creation and File Uploading

If Collaborator does not create reviews automatically when a work item's state changes, or if the files failed to upload to the review, check the following:

Check the user names in Collaborator and Team Concert. They should be the same. Otherwise, errors will occur.
Check if the Collaborator plugin for the Rational Team Concert server is installed and enabled. To do this, request the Provision Status page from the Team Concert server (​https://<your-team-concert-server:port>/ccm/admin?internal=true#com.ibm.team.repository.admin.provisionStatus) and search for smartbear on it. The page should say the Collaborator is installed and enabled. For information on installing and configuring the plugin, see Installing Collaborator Plug-In for Team Concert and Configuring Collaborator Plug-in for Team Concert.
Get the ccm.log file from the Team Concert server (see below). If the log says that follow-up actions of Collaborator cannot be found, set up and configure these actions. See Setting and Configuring Follow-Up Actions.
If Collaborator does not create reviews, or creates them for unexpected item states, check the follow-up actions' settings.
Check the work item categories in Team Concert. For example, if you are trying to create a review for work item that belongs to a team area, make sure this item does not use the project configuration.
Get the log file from the Team Concert Client (see below). If the log reports about issues with class versions, make sure you installed the appropriate version of Collaborator's Eclipse plugin. If you use Rational Team Concert 3, you need to use the plugin from previous version of Collaborator. See a note in Installing Collaborator Plug-In for Rational Team Concert.
Manual Review Creation

If you experience issues when creating reviews manually from the Team Concert client in Eclipse IDE, then most likely there are issues with the Collaborator's Eclipse plugin:

Check the installation folder of your Team Concert client. If it is installed in the <Program Files> folder, this may cause problems for Eclipse. In this case, we recommend that your user account has administrator privileges and that you run the Client as administrator.
Get the log file from the Team Concert Client (see below). If the log reports about issues with class versions, make sure you installed the appropriate version of Collaborator's Eclipse plugin. If you use Rational Team Concert 3, you need to use the plugin from previous version of Collaborator. See a note in Installing Collaborator Plug-In for Rational Team Concert.

Getting Client and Server Logs

When some functionality does not work, you need to examine the Team Concert logs to understand what went wrong.

To get the log of an Eclipse-based Team Concert client:

In the Team Concert client, select Help > About Rational Team Concert from the main menu.
In the subsequent About dialog box, click Installation Details.
In the subsequent dialog, switch to the Configuration tab and click View Error Log there.

To get the server log of Team Concert:

On the server computer, go to the <Jazz Team Server>/server/logs folder.
View the ccm.log file.

If the Team Concert server is installed on WebSphere, the log file will be in the logs directory of the Application server where Team Concert is installed.




© 2019 SmartBear Software. All rights reserved.
Email Send feedback on this document