IBM® Rational Team Concert™ includes IBM® Rational® ClearCase® connectors (synchronizers) that support operations between these two applications. This article describes the steps for importing code from ClearCase to Rational Team Concert. It also covers steps involved when there is UCM integration with ClearQuest.
- A computer running Microsoft Windows that can be set up as synchronization host
- Rational Team Concert Version 2 or 3.0.1
- Rational ClearCase Version 7.1.2
First, you need to create the necessary IDs with the required privileges and set up a synchronized host.
Create user accounts with necessary privileges
Create a ClearCase user ID and a Jazz User ID with the necessary privileges.
ClearCase User ID permissions
Create a user ID on the ClearCase server.
- This ID should have access to VOB with the data that needs to be migrated to Rational Team Concert.
- If the versioned object base (VOB) storage directory is shared with a Samba application, make sure to create a Samba ID on the ClearCase server.
Jazz User ID license and permissions
The Admin account holder needs to create a Rational® Jazz™ user ID (use ccsync for this example).
The Jazz user ID needs to meet these criteria:
- Has ClearCase Synchronizer Client Access License
- Has JazzUser role access to the repository
- Is designated as a member of Rational Team Concert project area where the code needs to be migrated
The Jazz user account must have process permissions in that team or project area to perform these tasks: create workspaces, create components, deliver to streams, add components to streams, create, and modify work items, or create and modify build engines and build definitions
Set up a synchronized host
- Decide on a synchronized host machine. It should have the Rational Team Concert Eclipse client, ClearCase Synchronizer, and ClearCase client installed on it.
- If there is UCM integration with Rational ClearQuest, make sure to install the Rational ClearQuest client on the synchronized host.
- Import the required ClearQuest schema repository connections by using the ClearQuest Maintenance Tool, and verify your login information for the ClearQuest client.
- Create a user account on the synchronized host machine. The login ID should have same credentials (user ID and password) as the ClearCase ID.
- Log in to the synchronized host using the same user account that you use for the ClearCase ID.
- Verify that your ClearCase user account is set up correctly:
- Click Start and then Run.
- Enter the path to the VOB storage location, typically either:
\\clearcase server name\VOB Global path\
\\clearcase server name\shared directory listed in smb.conf for the VOB Global path\
When you are connected, you should see the .vbs folder for your VOB.
Figure 1. Verify the connection to ClearCase VOBs
- Create a new dynamic view on the stream or branch to be synchronized.
- Mount VOBs in that view.
- Check out or check in to create a version in that view.
- For a UCM user: Create a baseline in the stream for that view. The ClearCase ID must be the UCM stream owner.
- Lock and unlock the stream.
You will be starting the migration now. Migration includes setting up a ClearCase synchronized stream, a merge workspace, setting properties of the ClearCase synchronized stream, and the import action.
Set up a ClearCase synchronized stream and a merge workspace
- Log in to the Rational Team Concert Eclipse client, and select the Team Artifacts view.
- Create a new repository connection:
- In the Team Artifacts view, select Repository Connection.
- Then click New > Jazz Repository Connection in the drop-down menus.
Figure 2. Connect to the Jazz repository from the Eclipse client
- In the Jazz Repository Connection dialog window, fill in the details:
- Location: Fill in the URI. The name will be automatically populated as the Rational Team Concert server from URI.
- Authentication: Select Authentication Type as Username and Password from drop-down menu, and then fill in the User ID and password.
- Click Finish.
Figure 3. Enter URL, login ID, and password
- Connect to project areas within the connected Jazz repository (Figure 4):
- In the Team Artifacts view, go to Repository Connections and select the Repository Connection that you created in steps 2 and 3.
- Select Manage Connected Project Areas from the drop-down menu.
- Select the project area of interest by checking the box next to the project in the Manage Connected Project Areas window.
Figure 4. Manage connected project areas
- Click Finish.
Figure 5. Select the project area
- If you already have a Jazz repository connection, log in:
- In the Team Artifacts view, go to Repository Connections and select the existing connection.
- Right-click the repository connection, and select Log In to connect.
Figure 6. Log in to the repository
- Create new synchronized stream for importing the code by selecting File > New > Other.
Figure 7. Set up a new stream synchronized with ClearCase
- In the Select a wizard view (Figure 8), under Jazz Source Control, select ClearCase Synchronized Stream, and then click Next.
Figure 8. Select appropriate option in Jazz source control
- In the ClearCase Stream Information view (Figure 9), select Import from an existing UCM stream.
- In the ClearCase stream selector field, enter the stream name.
- So that you can import the history along with the code, select the check box for Import with history from ClearCase.
For base ClearCase, select Import from existing Base ClearCase branch.
Figure 9. Enter the name of the ClearCase stream where the code resides
- In the ClearCase Storage Information view (Figure 10), for the "UNC path to local share" field, enter
\\hostname\viewstorage, where hostname is the synchronized machine hostname and viewstorage is a shared directory created for ClearCase view storage in the C: drive of the synchronized machine.
- Select a radio button for an appropriate line ending of text files in the VOB option.
- Click Next.
Figure 10. Enter the path to the shared folder on the synchronized machine
- Select the project area or team area for which code is being imported, and click Next.
Figure 11. Select the owner of the new synchronized stream
A new merge workspace will be created in this step, and you can change the default name. You can also associate an existing work item in Rational Team Concert for code import.
- In the "Jazz synchronization engine options" field, type the Jazz ID (ccsync), which was created for code import in the Jazz repository.
This ID has a ClearCase Synchronizer Client Access License assigned to it. The Install location is the location where ClearCase synchronizer is installed, and it ends with ccctools.
- Click Finish.
Figure 12. Enter Jazz Source control Information
If your project is enabled for ClearQuest
After the synchronization stream is created, you will get prompted to import files. This step is required only if your ClearCase project is enabled for IBM® Rational® ClearQuest®. If the UCM project is not ClearQuest-enabled, skip this step, and just click OK. If your ClearCase project is ClearQuest-enabled, you need to add settings, so cancel the Import window for now.
Set ClearCase synchronized stream properties
There are two properties for the ClearCase synchronized stream that you need to set: ClearCase provider properties and Jazz provider properties.
- In the ClearCase Synchronized Streams view, right-click the synchronized stream that was created previously, and select Properties.
Figure 13. Open the properties of the synchronized stream
Set ClearCase provider properties
The ClearCase Provider Properties page includes filling the ClearQuest schema repository name, the ClearQuest database name that is integrated with ClearCase VOBs, and filling in the ClearQuest login ID.
- In the Properties window, select the ClearCase provider properties.
- Set the following property values:
- Set CLEARQUEST_DBSET_NAME to the name of the Rational ClearQuest schema repository for the database that supports the UCM project. This repository must be accessible from the synchronization host.
- Set CLEARQUEST_LOGIN_NAME to a Rational ClearQuest user name to use with the UCM project.
- Set CLEARQUEST_USERDB_NAME to the name of the Rational ClearQuest user database used by the UCM project. This database must be accessible from the synchronization host.
Figure 14. Set ClearCase provider properties
Set Jazz provider properties
- In Jazz Provider properties, look for the path listed against STREAM_SCRIPT_DIR (Figure 15), change the directory to the path (Figure 16), and fill in the ClearQuest password in the admin.cq_passwd file:
- Select Jazz provider properties. In the folder named STREAM_SCRIPT_DIR, create a text file named
name.cq_password, where name is the value of the CLEARQUEST_LOGIN_NAME property. The file must contain a single line in this form:
where xxxxxx is the password of the user named CLEARQUEST_LOGIN_NAME. The synchronization process ClearCase account must have permission to read this file. It should not be readable by others.
Figure 15. Jazz Provider Properties showing path for ClearQuest password file
- Click OK.
Figure 16. Local path shown by STREAM_SCRIPT_DIR
Request synchronization or select what to synchronize
After the properties are set for the synchronization stream, you can either request synchronization or select files, folders, and baselines to synchronize (import).
- To request synchronization, right-click the ClearCase synchronized stream in the ClearCase Synchronized Streams view, and click Request Synchronization (Figure 17)
Figure 17. Submit the synchronization request
- To select files to synchronize, right-click ClearCase synchronized stream in the ClearCase Synchronized Streams view, and click Select Files To Synchronize (or you can click the pencil icon on top right, see Figure 18).
You can update files that are already imported by using the Synchronize option. Use the Import option only for fresh files that are not in Jazz source control.
Figure 18. Select files and folders to be imported (synchronized)
If you select the files, folders, and baselines to synchronize or import option (Figure 18), you will see mounted VOBs. Browse to select the appropriate component. In ClearCase terminology, mounted VOBs are the VOBs that are active, and users can read and modify data only if VOBs are mounted.
- Select files and folders inside VOB that need to be imported.
Figure 19. Browse to find files to import
- There are two options: either import all baselines or import only baselines that have specific attribute types associated with them (Figure 20).
- Click Finish.
Figure 20. Select whether to import all or only selected baselines
Figure 21. Import window showing import is in progress
The remaining screen captures show the status of the import process as it progresses.
Figure 22. Status of the import is Pending
Figure 23. Status of the Active
Figure 24. Refresh the view to see the latest status
Figure 25. ClearCase Synchronized Streams view shows status
- More about Rational Team Concert:
- Find Rational Team Concert articles and links to many other resources on IBM developerWorks, and check the product overview page, features and benefits, system requirements, and the user information center.
- Check the Rational Team Concert page on Jazz.net.
- Watch the Using Rational Team Concert in a globally distributed team webcast or a demonstration of the Dashboards and reports, or listen to the podcast about IBM Rational Team Concert and Jazz.
- Visit the Rational software area on developerWorks for technical resources and best practices for Rational Software Delivery Platform products.
- Subscribe to the developerWorks weekly email newsletter, and choose the topics to follow. Stay current with developerWorks technical events and webcasts focused on a variety of IBM products and IT industry topics.
- Improve your skills. Check the Rational training and certification catalog, which includes many types of courses on a wide range of topics. You can take some of them anywhere, any time, and many of the "Getting Started" ones are free.
Get products and technologies
- Download Rational Team Concert from Jazz.net and try it, free, on up to 10 projects for as long as you want (requires registration).
- Evaluate IBM software in the way that suits you best: Download it for a trial, try it online, use it in a cloud environment, or spend a few hours in the SOA Sandbox learning how to implement service-oriented architecture efficiently.
- Join the Rational Team Concert discussions or ask questions in the Jazz.net forums.
- Rate or review Rational software. It’s quick and easy.
- Share your knowledge and help others who use Rational software by writing a developerWorks article. Find out what makes a good developerWorks article and how to proceed.
- Follow Rational software on Facebook, Twitter (@ibmrational), and YouTube, and add your comments and requests.
- Ask and answer questions and increase your expertise when you get involved in the Rational forums, cafés, and wikis.
- Get social about thought leadership. Join the Rational community to share your Rational software expertise and get connected with your peers.