Rational Training 101 HOL

Visual Studio ALM Rangers
Visual Studio
TFS Integration Tools
Rational ClearCase & ClearQuest
101
2010-11-16
Microsoft Corporation

This content was created by the Visual Studio ALM Rangers, a special group with members from the Visual
Studio Product Team, Microsoft Services, Microsoft Most Valued Professionals (MVPs) and Visual Studio
Community Leads.
TFS Integration Tools – Rational CC & CQ 101 HOL
The information contained in this document represents the current view of Microsoft Corporation on the issues discussed as of
the date of publication. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a
commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information presented after the
date of publication.
This document is for informational purposes only. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS
TO THE INFORMATION IN THIS DOCUMENT.
Microsoft grants you a license to this document under the terms of the Creative Commons
Attribution 3.0 License. All other rights are reserved.
2009 Microsoft Corporation.
Microsoft, Active Directory, Excel, Internet Explorer, SQL Server, Visual Studio, and Windows are trademarks of the Microsoft
group of companies.
All other trademarks are property of their respective owners.
Copyright 2010 Microsoft Corporation Page 2

Table of Contents
Acronyms ................................................................................................................................................................................ 4
Contributors ............................................................................................................................................................................ 5
Reviewers ................................................................................................................................................................................ 5
Introduction............................................................................................................................................................................. 6
Overview............................................................................................................................................................................. 6
Visual Studio ALM Rangers .................................................................................................................................................. 6
Prerequisites ....................................................................................................................................................................... 6
Suggested Focus and Time Map ........................................................................................................................................... 7
Placeholder Tokens ............................................................................................................................................................. 8
Lab 1 – Register and Explore the Sandbox Environment ............................................................................................................ 9
Lab 2 - Simple ClearQuest to TFS Migration..............................................................................................................................12
Checking ClearQuest Test Data ..........................................................................................................................................12
Configure the TFS Integration Platform CQ  TFS Migration Session ...................................................................................15
Run the Migration ..............................................................................................................................................................21
Lab 3 - Simple ClearCase to TFS Migration...............................................................................................................................23
Checking the ClearCase Test Data .......................................................................................................................................23
Configure the CC -> TFS Migration Session ..........................................................................................................................24
Run the Migration ..............................................................................................................................................................28
Appendix - Test Environment ..................................................................................................................................................30
Setting up the CQ test data .................................................................................................................................................30
Setting up the CC test data .................................................................................................................................................31
References..............................................................................................................................................................................38
Visual Studio 2010 Architecture Guidance ...........................................................................................................................38
General Links .....................................................................................................................................................................38

Acronyms
This guide uses the following common acronyms:
ACRONYM DESCRIPTION
CC IBM Rational Clear Case Solution
CQ IBM Rational Clear Quest Solution
HOL Hands On Lab
IIS Internet Information Server
SDK Software Development Kit
Includes software and documentation needed to develop applications that are compatible with specified
public operating-system and component interfaces.
TFS Microsoft Visual Studio Team Foundation Server.
Microsoft change management software for software development. Components include work item
tracking, source code control, policy support and notifications, and report generating capabilities.
TR TechReady is an internal Microsoft technology awareness and readiness event.
VC Version control
VSS Microsoft Visual SourceSafe
A family of Microsoft source code version control and configuring systems for software and Web
development teams.
WIT Work item tracking
WSS Microsoft Windows SharePoint Services
A Microsoft Web-based team collaboration environment that provides the ability to create and access
virtual workspaces for managing documents, discussions, lists, surveys and other important contextual
information, such as team member status and presence.

Contributors
Bob Hardister Overwatch, Visual Studio ALM Ranger
Willy-Peter Schaub Microsoft, Solution Architect | Visual Studio ALM Ranger
Reviewers
Bijan Javidi Microsoft, Principal Architect | Visual Studio ALM Ranger
Bill Essary Microsoft, Principal Architect | Visual Studio ALM Ranger
Lukasz Gratkowski Microsoft, Consultant | Visual Studio ALM Ranger
Adam Jagocki Microsoft, Consultant | Visual Studio ALM Ranger

Introduction
Overview
Welcome to the TFS Integration Tools, based on the TFS Integration Platform, guidance and readiness kit.
Using feedback from users of the previous TFS Migration and Synchronization Toolkit, we have created documentation and
samples for the public interfaces and extension points of the TFS Integration Platform and refreshed the guidance around TFS
migrations in general.
This hands-on-lab (HOL) takes you through a guided tour of a simple migration scenarios from IBM Rational ClearCase (CC) and
IBM Rational ClearQuest (CQ) to Team Foundation Server (TFS) using the shared sandbox environment from i-solve
www.teamdevcentral.com.

Visual Studio ALM Rangers is a special group with members from the Visual Studio Product group, Microsoft Services, Microsoft
Most Valued Professionals (MVP) and Visual Studio Community Leads. Their mission is to provide out of band solutions to
missing features and guidance.
This guide targets the Microsoft “200-300 level” users of Visual Studio 2010. The target group is considered as intermediate to
advanced users of Visual Studio 2010 and has in-depth understanding of the product features in a real-world environment.
Parts of this guide may be useful to the Visual Studio novices and experts but users at these skill levels are not the focus of this
content.
Prerequisites
Access to the shared hosted training environment delivered by i-solve and available at http://www.teamdevcentral.com.
Alternatively you require an IBM Rational ClearCase and CleaQuest and a Team Foundation Server environment, as supported
by the product. Refer to the product documentation for the relevant prerquisites.

Suggested Focus and Time Map
If you are intending to follow the hands-On-Lab (HOL) step-step use these times as a guideline. If,
however, you are intending to investigate each step in detail to double the times as a bare
minimum.
Topic Duration in minutes Page

Step 1 – Register and Explore the Sandbox Environment 15min + registration lag time 9
Step 2 – Simple ClearQuest to TFS Migration 15min 12
Step 3 – Simple ClearCase to TFS Migration 15min 23
TOTAL 45 min
We wish you a pleasant and interesting journey!

Placeholder Tokens
To decouple this HOL manual from the environment, the documentation uses tokens throughout this document. Ensure you
the correct values, as specified in your registration confirmation email, are use throughout this HOL for the respective tokens.
Token Description Value
@@SANDBOX@@ TDC Client Migration Server

________________________________
@@TRIAL_USER@@ TDC Trial user Account
________________________________
@@TRIAL_PASSWORD@@ TDC Trial user Password
________________________________
@@CQDB-101@@ Rational IBM ClearQuest database.
________________________________
@@ADMIN_USER@@ User account used to access the
ClearQuest and ClearCase servers. ________________________________
@@ADMIN_PASSWORD@@ User account used to access the
ClearQuest and ClearCase servers. ________________________________
@@TFS-SERVER-101@@ Team Foundation Server
________________________________
@@TFSTPC-101@@ TFS Team Project Collection
________________________________
@@TFSTP-101@@ TFS Team Project
________________________________
@@VOB-101@@ ClearCase VOB
________________________________
@@VIEW-101@@ ClearCase View
________________________________
TAKE NOTE
The screen shots may not match your sandbox instance and are only included as reference.
The sandbox environment is created specifically for you and therefore the environmental settings are tdifferent to the default
environment and represented by the above placeholder tokens.
Refer to the placeholder tokens at all times and not the information displayed on screen shots in this hands-on-lab sandbox
environment.

Lab 1 – Register and Explore the Sandbox Environment
OBJECTIVE
In this step we will register ourselves with TeamDevCentral and explore the hosted training sandbox environment. If you have
already registered yourself on the sandbox and have received the welcome email, you should skip steps 1-3 of this lab.
1. Open your Internet Browser.

2. Navigate to teamdevcentral
http://www.teamdevcentral.com/hosted_Team_Foundation_Server_TFS_clearCase.html
3. Complete the registration form.
4. An e-mail will be sent to you containing the following information:

a. Connectionnformation and credentials for the sandbox, refered to as @@SANDBOX@@,
@@TRIAL_USER@@ and @@TRIAL_PASSWORD@@ in this document.
b. ClearCase VOB information, refered to as @@VOB-101@@ and @@VIEW-101@@ in this document
c. ClearQuest Database information, refered to as @@CQDB-101@@ in this document
d. ClearCase and ClearQuest admin credentials, refered to as @@ADMIN_USER@@ for the user and
@@ADMIN_PASSWORD@@ for the password in this document.
e. Team Foundation Server connection information, refered to as @@TFS-SERVER-101@@ in this document
f. Team Foundation Server Team Project Collection information, refered to as @@TFSTPC-101@@ in this
document
g. Team Foundation Server Team Project information, refered to as @@TFSTP-101@@ in this document
5. Wait for the confirmation before proceeding with this hands-on-lab (HOL).

6. Use Remote Desktop Connection console and create a connection to the sandbox:@@SANDBOX@@
7. Logon with the credentials @@TRIAL_USER@@ and @@TRIAL_PASSWORD@@:
8. Familiarize yourself with the environment.

a. ClearQuest … Select IBM Rational ClearQuest from the All Programs menu and take note that the
ClearQuest client software is installed on the sandbox.
b. ClearCase … Select IBM Rational ClearCase from the All Programs menu and take note that the ClearCase
client software is installed on the sandbox.
c. TFS Integration Platform

 Documentation … Select Microsoft Team Foundation Server Integration Tools, select
documentation and peruse the Readiness Package.

 TFS Integration Shell … just under the Documentation shortcut is the tool we will be using to
create and executre migration session in subsequent HOL steps.
REVIEW
We registered ourselves and explored the hosted training sandbox environment. We are now ready to delve into a simple
ClearQuest and ClearCase to Team Foundation Server migration.

Lab 2 - Simple ClearQuest to TFS Migration
OBJECTIVE
In this step we will perform a simple migration from ClearQuest to Team Foundation Server.
Checking ClearQuest Test Data

1. Start the IBM Rational ClearQuest Client and close the welcome screen if it appears as shown below.
2. Create a new database connection.

Select File -> Database -> Connect -> New Connection
3. Select 7.0.0 Schema Repository>

4. Specify User ID: @@ADMIN_USER@@ and click Finish
5. Specify @@ADMIN_PASSWORD@@ as the password and select the @@CQDB-101@@ database. In this case the
database defined by @@CQDB-101@@ is UCM : as shown.

6. Select the All Defects query under Public Queries -> UCMUserQueries. Ensure that at least one defect, with history, is
available.
7. If you get no data returned when using the Defects query, please refer to Setting up the CQ test data on page 30.
IMPORTANT
Please do NOT make changes to the ClearQuest or ClearCase test environment or data!

Configure the TFS Integration Platform CQ  TFS Migration Session

1. Start the TFS Integration shell
Start -> All Programs -> Microsoft Team Foundation Server Integration Tools -> TFS Integration
2. If the following Group Membership Test dialog appears, select Yes.
3. Select Create New Configuration

4. Path to c:\program files\Microsoft Team Foundation Server Integration Tools\Configurations\IBM Rational.
5. Select the IBM Rational directory and then the ClearQuest.xml template.
6. Select the Right Source Configure button as highlighted.

7. Select the TFS 2010 Migration WIT Provider.
8. Select the @@ TFS-SERVER-101@@ server, then select the @@TFSTPC-101@@ Team Project Collection, then select
the @@TFSTP-101@@ Team Project and select Connect.
9. Select the Left Source Configure button as highlighted.
10. Select the ClearQuest Adapter.

11. Select the @@CQDB-101@@ database, specify the @@ADMIN_USER@@ as User ID, the
@@ADMIN_PASSWORD@@ as the password and select OK.
12. Select … browse button from the Queries group.
13. Select the Public Queries -> UCMUserQueries -> Defects query and select OK.
14. Click on the Edit XML Custom Settings button.

15. You will notice value and field mapping, which defines the field and value mapping from the ClearQuest defect to the
TFS Bug work item. This topic is out of scope for this 101 and will be covered in great detail as part of the deep dive
HOL. Click Cancel to leave the editor.
16. Select the Xml tab at the bottom and locate the CustomSettings tag. Add the following line, which is also highlighted
in the illustration below. This key defines the delimiter used for date/time fields in queries, which by default uses a ‘
character and for the sandbox requires a # as the backend database for ClearQuest is Access CQ.
<CustomSetting SettingKey="CQQueryTimeDelimiter" SettingValue="#" />
IMPORTANT
Ensure that you add the line to the “source”, the first MigrationSource, not the target.
NOTE
The product documentation may not have a reference to this new feature yet.
17. Select the Save to Database button.

18. The TFS Migration Shell will show the session as “not yet migrated” and stopped.

Run the Migration

Next we will run the migration session, which will migrate the ClearQuest defect over to Team Foundation Server as a Bug work
item type.
1. Select Start under the Current Migration heading.
2. The shell will show the pipeline processing from discovery, analysis, to migration. Once complete you will see the
“your current session completed successfully” status, with two items migrated which relate to the defect and
associated work item, plus the history.
3. Select the output tab to see more detailed log information.

4. You can optionally select the View Logs menu under the General heading in the navigation pane to get a list of all the
migration session logs.
5. Close the TFS Integration Shell.

6. Open Visual Studio 2010 and locate the @@TFSTP-101@@ team project in the Team Explorer. Right click the Work
Items node and select New Query.
7. Define Bug as the Work Item Type and [Any] as the State. Select Run and take note that the ClearQuest Defect is
returned as part of the result set.
8. Explore the work item and the history thereof.

This concludes the ClearQuest to TFS migration. Next we will look at a simple ClearCase to TFS migration.
REVIEW
We have performed a simple migration from ClearQuest to TFS using the TFS Integration Tools.

Lab 3 - Simple ClearCase to TFS Migration
OBJECTIVE
In this step we will perform a simple migration from ClearCase to Team Foundation Server.
Checking the ClearCase Test Data

1. Select the IBM Rational Clear Case Explorer.
Start -> All Programs -> IBM Rational ClearCase -> ClearCase Explorer
2. You will see the view assigned to your user account, the IntegrationTestVOB and the simple wpccalculator test
project. If no test data is available, then please refer to Setting up the CC test data on page 31.

Configure the CC -> TFS Migration Session

1. Start the TFS Integration shell
Start -> All Programs -> Microsoft Team Foundation Server Integration Tools -> TFS Integration
2. Select Create New Configuration
3. Path to c:\program files\Microsoft Team Foundation Server Integration Tools\Configurations.

4. Select the IBM Rational directory and then the ClearCase.xml template.
5. Click on the Configure button for the Right Source and select the TFS 2010 Migration VC Provider.
6. Select the @@TFS-SERVER-101@@ server, then select the @@TFSTPC-101@@ Team Project Collection, then select
the @@TFSTP-101@@ Team Project and select Connect.

7. Select the Configure button for the Left Source and select the ClearCase Detailed History Adapter.
8. Complete the configuration as follows and once complete, select OK.
1. Select the view @@VIEW-101@@.

2. Select the @@VOB-101@@ VOB.
3. Select the local drive that corresponds to your view. To verify you are using the correct label, open Windows
Explorer and find the drive mapping that corresponds to your view. In this example it would be drive Z:
4. Check the Detect Changes in CC option.
5. Select a local directrory to be used as the download folder during the migration.

9. Define the path for the left source to be the same as the VOB, which migrates everything within the VOB.
10. Take a moment to verify the configuration and then select Save to Database.
1. Workflow type is a One-way migration.
2. VOB is set to @@VOB-101@@.
3. Left source path is the same as the VOB, plus the sub-directory \Test.
4. The target is set to @@TFS-SERVER-101@@.
5. The target path is set to $/@@TFSTPC-101@@.
11. The TFS Migration Shell will show the session as “not yet migrated” and stopped.

Run the Migration

1. Select Start from under Current Migratioin on the navigation pane.
2. Observe as te discovert, analysis and migration status changes. When complete, the shell wil show “Your current
session completed successfully”.
3. Optionally select the Output tab for a more verbose log.

4. Switch to Visual Studio 2010 Team Explorer, map a workspace if needed and perform a “Get Latest Version” on the
@@TFSTPC-101@@ node in Source Explorer.
5. The (1) wpfcalculator project will appear and (2) you can optionally review the history of the @@TFSTPC-101@@
version control by right clicking on the @@TFSTPC-101@@ node and selecting History.
6. This concludes the simple migration of source code from ClearCase to Team Foundation Server.
REVIEW
We have performed a simple migration from ClearCase to TFS using the TFS Integration Tools.

Appendix - Test Environment

This appendix is “for your information” only and documents how the test environment was pre-configured.
Setting up the CQ test data

1. Complete Checking ClearQuest Test Data up to the step that refers you to this section.
2. Click the down arrow to the right of the create new icon
3. Select Defect
4. Specify ClearQuest Defect for the headline, select 1-Critical for Severity and optionally specify an arbitrary
description.
5. Click OK to create the defect record

6. Create a Defects query named “Defects” if not available and select to display the ID, Headline, Severity, State and
Description.
7. Run the query to display the CQ defect record you just created

Setting up the CC test data

Create the VOB
1. Select the Create VOB option from
All Programs -> IBM Rational ClearCase -> Administration -> Create VOB
2. Name the VOB “IntegrationTestVOB”
3. Select the option “Allow this VOB to contain multiple components”

4. Select Next to browse for a suitable location
5. Select a directory or optionally create and then select a directory to store the VOB and select OK.

What about the Project VOB, which is different and the “Make this a public VOB” checkbox dialog? I took the “Test” project
VOB and did not make it public (default) and then clicked Finish. Then a confirmation dialog comes up and I clicked OK. NOTE: If
you already have CC open, to see the VOB you must hit F5 to refresh CC (or close and reopen it)
Create the View

1. Launch the Rational ClearCase Explorer
All Programs -> IBM Rational ClearCase -> Reational ClearCase Explorer
2. Select the Toolbox tab, select Base ClearCase and then select Create View.

3. Accept the default of No and select Next.
4. Select Dynamic view type.
5. Optionally specify a comment.

6. Select OK.
7. The view of the VOB can be seen in the explorer.

Add test data to the VOB
NOTE!!: You must do this for every file and folder. There is no regressive checkin ability out of the box. There are utilities that
people use to implement this.
1. Download a sample application, such as:

http://www.c-sharpcorner.com/UploadFile/mahesh/WPFCalc08252008102556AM/WPFCalc.aspx
2. Open Windows File Explorer and select the drive which you mapped against the VOB as part of the view and copy te
sample to the directory as shown. NOTE: You can copy directly into the CC Explorer view panel. The content of the
VOB must lool like:
3. Switch back to Rational ClearCase Explorer and select Refresh.
4. You will now notice the sample application in the VOB. Right click on WcfCalculator and select Add to Source Control.

5. Select OK to complete the checkin.
IMPORTANT
You must do this for every file and folder. There is no regressive checkin ability out of the box. There are utilities that you could
use to implement this regressive feature.

References
Visual Studio 2010 Architecture Guidance
The following documentation and information material is included in the Visual Studio 2010 Architecture Guidance.
 Visual Studio 2010 Architecture Guidance – Scenarios
 Visual Studio 2010 Architecture Guidance – Questions & Answers
 Visual Studio 2010 Architecture Guidance – New Solution Scenario (HOL)
 Visual Studio 2010 Architecture Guidance – Explore an Existing System Scenario (HOL)
 Visual Studio 2010 Architecture Guidance – Creating extensions with the feature extension (HOL)
 Visual Studio 2010 Architecture Guidance – Extensibility Layer Diagrams (HOL)
 Visual Studio 2010 Architecture Guidance – Reusable Architecture Scenario (HOL)
 Visual Studio 2010 Architecture Guidance – Validating an Architecture Scenario (HOL)
General Links
Visual Studio ALM Rangers Site
http://msdn.microsoft.com/teamsystem/ee358786.aspx
http://www.tinyurl.com/almrangers
Team System Widgets

http://www.teamsystemwidgets.com
Videos for Team System

http://msdn.microsoft.com/vsts2008/bb507749.aspx?wt.slv=topsectionsee
MSDN Site
http://msdn.microsoft.com/default.aspx

Rational Training 101 HOL

Uploaded by

Document Information

Original Description:

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Rational Training 101 HOL

Uploaded by

Copyright:

Available Formats

Visual Studio ALM Rangers

Visual Studio ALM Rangers

Copyright 2010 Microsoft Corporation Page 2

Copyright 2010 Microsoft Corporation Page 3

Copyright 2010 Microsoft Corporation Page 4

Copyright 2010 Microsoft Corporation Page 5

Visual Studio ALM Rangers

Copyright 2010 Microsoft Corporation Page 6

Suggested Focus and Time Map

Topic Duration in minutes Page

We wish you a pleasant and interesting journey!

Copyright 2010 Microsoft Corporation Page 7

Token Description Value

@@SANDBOX@@ TDC Client Migration Server

Copyright 2010 Microsoft Corporation Page 8

Lab 1 – Register and Explore the Sandbox Environment

1. Open your Internet Browser.

3. Complete the registration form.

4. An e-mail will be sent to you containing the following information:

Copyright 2010 Microsoft Corporation Page 9

7. Logon with the credentials @@TRIAL_USER@@ and @@TRIAL_PASSWORD@@:

8. Familiarize yourself with the environment.

c. TFS Integration Platform

Copyright 2010 Microsoft Corporation Page 10

Copyright 2010 Microsoft Corporation Page 11

Lab 2 - Simple ClearQuest to TFS Migration

Checking ClearQuest Test Data

2. Create a new database connection.

3. Select 7.0.0 Schema Repository>

Copyright 2010 Microsoft Corporation Page 12

Copyright 2010 Microsoft Corporation Page 13

Copyright 2010 Microsoft Corporation Page 14

Configure the TFS Integration Platform CQ  TFS Migration Session

2. If the following Group Membership Test dialog appears, select Yes.

3. Select Create New Configuration

Copyright 2010 Microsoft Corporation Page 15

6. Select the Right Source Configure button as highlighted.

Copyright 2010 Microsoft Corporation Page 16

9. Select the Left Source Configure button as highlighted.

10. Select the ClearQuest Adapter.

Copyright 2010 Microsoft Corporation Page 17

12. Select … browse button from the Queries group.

14. Click on the Edit XML Custom Settings button.

Copyright 2010 Microsoft Corporation Page 18

17. Select the Save to Database button.

Copyright 2010 Microsoft Corporation Page 19

Copyright 2010 Microsoft Corporation Page 20

Run the Migration

3. Select the output tab to see more detailed log information.

Copyright 2010 Microsoft Corporation Page 21

5. Close the TFS Integration Shell.

8. Explore the work item and the history thereof.

Copyright 2010 Microsoft Corporation Page 22

Lab 3 - Simple ClearCase to TFS Migration

Checking the ClearCase Test Data

Copyright 2010 Microsoft Corporation Page 23

Configure the CC -> TFS Migration Session

2. Select Create New Configuration

3. Path to c:\program files\Microsoft Team Foundation Server Integration Tools\Configurations.

Copyright 2010 Microsoft Corporation Page 24

Copyright 2010 Microsoft Corporation Page 25

8. Complete the configuration as follows and once complete, select OK.

1. Select the view @@VIEW-101@@.