Search:     Advanced search

TestTrack ClearCase Integration

Article ID: 548  |  Last updated: 29 Dec, 2014

TestTrack 2011.1.2 and earlier supports integration with ClearCase on Windows and Linux. 

This article includes information about integration requirements, configuring the integration, performing ClearCase actions, and troubleshooting.

Note: The following steps were tested using ClearCase 7.0.1 and TestTrack 2008.2.1.


  • The project must be in a view.
  • You must use the TestTrack Native Client.
  • You must have ClearCase installed and be able to access and work with the view. You may want to map a drive to the view.

Configuring the integration

  1. In the TestTrack Client, choose Tools > SCC Integration. The Configure SCC Integration dialog box opens with the Local Options category selected.

  2. Select ClearCase and click Make Current.
  3. Select the User Options category.

  4. Click Browse to select the ClearCase view to use with TestTrack and click OK.
  5. Click Validate Connection. A connection confirmation dialog box is displayed. Click OK to close the confirmation dialog box.
  6. After the connection to the view is validated, click the Project Paths category to choose the directories in the view to make available to TestTrack. You can only attach files from the selected directories and their children.

  7. Optionally select the Check In Options category to select the TestTrack workflow event to use in the TestTrack Check In dialog box. Fix is the default.
  8. Click OK to save the changes.

Performing ClearCase actions in TestTrack

You can access the following ClearCase commands on the Source Code tab when editing TestTrack items: Attach, Detach, Update, Check Out, Check In, Undo Check Out, View, and History.

Attach File

Attaches ClearCase source code files to TestTrack items.

  1. Click the Source Code tab and click Attach File. The Attach Files dialog box opens.

  2. Select the files you want to attach to the item and click Add.
  3. Click OK. The source code files are attached.
  4. Click OK in the Edit window to save the changes.


Removes attached source code files from items.

  1. Select the source files you want to detach on the Source Code tab and click Detach. You are prompted to confirm the action.
  2. Click Yes to confirm the detach. The file is no longer attached to the item.
  3. Click OK in the Edit window to save the changes.


Retrieves the latest read-only version of the ClearCase file.

Note: You can only update files TestTrack is configured to connect to a snapshot view.

  1. Select the files you want to update and click Update. The Update Files dialog box opens.
  2. Select any update options and click OK. The file is updated.

Check Out

Retrieves a writable copy of the file to your view.

  1. Select the file to check out and click Check Out. The Check Out Files dialog box opens.

  2. Select a replacement option and click OK. The ClearCase - Select Activity dialog box opens.

  3. For better tracking, add an activity for check out made from TestTrack and click OK. The file is checked out.
    Note: You must browse to your view to open the checked out file and edit it.

Check In

Submits changes to a checked out file to ClearCase. The version created by check is displayed in the Fixed Revision column on the item Source Code tab.

Note: Check in is only available if the file has been modified and the changes have been saved.

  1. Select the file to check in and click Check In. The Check In Files dialog box opens.

  2. Enter any comments and click Check In or Check In & Fix.
    • Check In checks in the file to ClearCase. The version created by the check in is updated in the Source Code tab.
    • Check In & Fix is available if you are checking in changes to a file attached to a defect. If you click Check In & Fix, the Fix dialog box opens. Enter the effort time, any notes, and a resolution and click OK. The file is checked in and the defect moves to the Fix state.
  3. Click OK in the Edit window to save the changes.

Undo Check Out

Removes the check out lock from ClearCase.

  1. Select the checked out file and click Undo Check Out. The Undo Check Out Files diaog box opens.
  2. Select how to handle the local file in your view and click OK. The check out lock is removed from the file.
    Note: The undo check out operation from TestTrack automatically creates the .keep file is the checked out file has modifications.

Displays the contents of the latest version of the file in ClearCase.

  1. Select the file you want to view and click View. The View Files dialog box opens.
  2. Select TestTrack Viewer to view the file with the TestTrack text file viewer or select Registered application to use the application associated with the selected file type in the operating system.
  3. Click OK. The file content is displayed.


Displays the entire history of the file from ClearCase

  1. Select the file you want to view the history of and click History. The Rational ClearCase History Browser dialog box opens.

  2. Close the history browser when you finish reviewing the history.


ClearCase is not in the Available Providers list when configuring SCC integration

TestTrack cannot find ClearCase in the following registry key: HKEY_LOCAL_MACHINESOFTWARESourceCodeControlProviderInstalledSCCProviders

Make sure ClearCase is installed correctly because a successful installation should automatically populate the registry key.

Buttons on the Source Code tab are disabled

Review your SCC Integration settings. A likely cause is that the ClearCase Versioned Object Base (VOB) has not been mounted. Select the Local Options category and click Validate Connection to test the connection.

'The project in the ClearCase provider could not be opened' error is returned

This error occurs when the connection cannot be validated. The most likely cause of this error is that the VOB has not been mounted.

In Windows, mount the VOB by opening it through My Computer. When you open it, the ClearCase View Tool displays a message indicating that the VOB has been mounted. After the VOB is mounted, validate the connection again in TestTrack.

'Project must be in a view Rational ClearCase AddProject' error is returned

This error occurs when the drive selected to use in the integration is not a view. Edit the integration settings and select a drive that is a ClearCase view.

'Unable to properly initialize ClearCase provider' error is returned

This error occurs when TestTrack cannot locate the ClearCase path or the proper DLLs in the ClearCase path. Check your PATH environment variable and make sure you have a valid ClearCase path variable.

Timeout errors in TestTrack

When TestTrack is configured to use ClearCase integration, using source code functions may lead to a timeout error in TestTrack. These errors occur when the ClearCase server is not running and a user is working in TestTrack. Opening an item generally takes 1-2 minutes per source file attached to a record. If there are several files attached, TestTrack appears to stop responding because it takes longer than expected to open the record.

Close TestTrack and contact your ClearCase administrator to verify the ClearCase server is running. If you are experiencing difficulties with the ClearCase server, you can disable SCC integration in the TestTrack Client until the problem is fixed.

Article ID: 548  |   Last updated: 29 Dec, 2014

Prev   Next
TestTrack Subversion Integration     Unicode Client Error Occurs When Configuring the TestTrack...