将 Rational ClearCase UCM 项目代码导入 Rational Team Concert

IBM Rational Team Concert 包含一个 Rational ClearCase 连接器(同步器),可以帮助将代码从 ClearCase VOB 导入 Rational Team Concert。在计划将当前使用 Rational ClearCase 的项目迁移到 Rational Team Concert 时,您需要将 Rational ClearCase 中的项目源代码导入 Rational Team Concert 源代码控制中。本文作者 Prachi Mittal 将演示如何操作。

Prachi Mittal, 软件工程师,Rational 工具管理员, IBM

Prachi Mittal 是位于印度浦那的 IBM 印度软件实验室的一名软件工程师。她与美国的 Rochester System and Technology 集团实验室合作过,为他们的 Rational 工具环境提供支持,这些工具包括 ClearCase、ClearQuest、Focal Point 和 Rational Team Concert。她担任 Rational 工具管理员已有 3 年多的时间。



2012 年 9 月 13 日

下载 IBM® Rational® Team Concert 试用版  |  在线试用 IBM Rational 协作化生命周期管理解决方案
下载更多的 IBM 软件试用版,并加入 IBM 软件下载与技术交流群组,参与在线交流。

IBM® Rational Team Concert™ 包含支持在这两个应用程序之间操作的 IBM® Rational® ClearCase® 连接器(同步器)。本文将介绍把代码从 ClearCase 导入 Rational Team Concert 的步骤。文中还将提供集成 UCM 与 ClearQuest 时涉及到的一些步骤。

先决条件

  • 一台运行 Microsoft Windows 的计算机,可将它设置为同步主机
  • Rational Team Concert V2 或 3.0.1
  • Rational ClearCase V7.1.2

设置步骤

首先,您需要创建具有所需特权的必要 ID,设置一个同步的主机。

创建具有必要特权的用户帐户

创建一个具有必要特权的 ClearCase 用户 ID 和 Jazz 用户 ID。

ClearCase 用户 ID 权限

在 ClearCase 服务器上创建一个用户 ID。

  • 这个 ID 应该能够访问包含需要迁移到 Rational Team Concert 的数据的 VOB。
  • 如果版本控制的对象库 (versioned object base, VOB) 存储目录是与一个 Samba 应用程序共享的,请确保在 ClearCase 服务器上创建了一个 Samba ID。

Jazz 用户 ID 许可和权限

Admin 帐户所有者需要创建一个 Rational® Jazz™ 用户 ID(本例中使用 ccsync)。

Jazz 用户 ID 需要满足以下条件:

  • 拥有 ClearCase Synchronizer 客户端访问许可
  • 拥有对存储库的 JazzUser 角色访问权限
  • 被指定需要迁移其中代码的 Rational Team Concert 项目区域的成员

Jazz 用户帐户必须在该团队或项目区域中拥有执行以下任务的权限:创建工作区、创建组件、将组件传递到流、向流中添加组件、创建和修改工作项,或者创建和修改构建引擎和构建定义

设置一个同步的主机

  1. 确定一个同步的主机。在它之上应该安装了 Rational Team Concert Eclipse 客户端、ClearCase Synchronizer 和 ClearCase 客户端。
  2. 如果与 Rational ClearQuest 集成了 UCM,请确保在同步的主机上安装 Rational ClearQuest 客户端。
  3. 使用 ClearQuest Maintenance Tool 导入所需的 ClearQuest 模式存储库连接,针对 ClearQuest 客户端验证您的登录信息。
  4. 在同步的主机上创建一个用户帐户。登录 ID 应该拥有与 ClearCase ID 相同的凭证(用户 ID 和密码)。
  5. 使用您用于 ClearCase ID 的同一个用户帐户登录到同步的主机。
  6. 验证您的 ClearCase 用户帐户已正确设置:
    1. 单击 Start,然后单击 Run
    2. 输入 VOB 存储位置的路径,通常为:
      \\clearcase 服务器名称\VOB Global 路径\

      \\clearcase 服务器名称\smb.conf 中列出的用于 VOB Global 路径的共享目录\

当您连接上时,应该看到您的 VOB 的 .vbs 文件夹。

图 1. 验证与 ClearCase VOB 的连接
该屏幕区域显示了两个 .vbs 文件夹
  1. 在要同步的流或分支上创建一个新的动态视图。
  2. 将 VOB 挂载到该视图中。
  3. 签出或签入,以便在该视图中创建一个版本。
  4. 对于一个 UCM 用户:在该视图的流中创建一个基线。ClearCase ID 必须是 UCM 流所有者。
  5. 锁定和解锁该流。

迁移步骤

您现在将开始迁移。迁移包括设置一个 ClearCase 同步流、一个合并工作区、ClearCase 同步流的设置属性,以及导入操作。

设置一个 ClearCase 同步流和一个合并工作区

  1. 登录 Rational Team Concert Eclipse 客户端,然后选择 Team Artifacts 视图。
  2. 创建一个新存储库连接:
    1. 在 Team Artifacts 视图中,选择 Repository Connection
    2. 然后单击下拉菜单中的 New > Jazz Repository Connection
图 2. 从 Eclipse 客户端连接到 Jazz 存储库
显示屏幕和下拉菜单选择
  1. 在 Jazz Repository Connection 对话框窗口中,填入详细信息:
    • Location:填入 URI。该名称是作为 Rational Team Concert 服务器从 URI 自动填充的。
    • Authentication:从下拉菜单选择 Username and Password 作为 Authentication Type,然后填入用户 ID 和密码。
  2. 单击 Finish
图 3. 输入 URL、登录 ID 和密码
用于连接 Jazz 存储库的登录窗口
  1. 连接到所连接的 Jazz 存储库中的项目区域(参见图 4):
    1. 在 Team Artifacts 视图中,转到 Repository Connections 并选择您在第 2 和 3 步中创建的 Repository Connection。
    2. 从下拉菜单中选择 Manage Connected Project Areas
    3. 通过在 Manage Connected Project Areas 窗口中勾选项目旁边的方框,选择感兴趣的项目区域。
图 4. Manage connected project areas
在菜单上选择了 Manage Connected Project Areas
  1. 单击 Finish
图 5. 选择项目区域
已勾选了 Training Project 旁边的复选框
  1. 如果已有一个 Jazz 存储库连接,则登录:
    1. 在 Team Artifacts 视图中,转到 Repository Connections 并选择现有的连接。
    2. 右键单击存储库连接,选择 Log In 以进行连接。
图 6. 登录存储库
连接 Jazz 存储库的菜单选择
  1. 通过选择 File > New > Other,创建用于导入代码的新的同步流。
图 7. 设置一个与 ClearCase 同步的新流
依次选择 File、New 和 Other
  1. 在 Select a wizard 视图中(参见图 8),在 Jazz Source Control 下,选择 ClearCase Synchronized Stream,然后单击 Next
图 8. 在 Jazz 源控制中选择合适的选项
标为 New, Select a wizard 的屏幕
  1. 在 ClearCase Stream Information 视图(参见图 9)中,选择 Import from an existing UCM stream
  2. 在 ClearCase stream selector 字段中,输入流名称。
  3. 这样您就可以与代码一起导入历史记录,选择复选框 Import with history from ClearCase

备注
对于 base ClearCase,请选择 Import from existing Base ClearCase branch。

图 9. 输入代码所在的 ClearCase 流的名称
输入 ClearCase 源代码导入信息
  1. 在 ClearCase Storage Information 视图中(参见图 10),对于 “UNC path to local share” 字段,请输入 \\hostname\viewstorage,其中 hostname 是同步的机器主机名,viewstorage 是在同步机器的 C: 驱动器中为 ClearCase 视图存储创建的共享目录。
  2. 在 VOB 选项中选择文本文件的合适的行结尾的单选按钮。
  3. 单击 Next
图 10. 输入同步机器上的共享文件夹的路径
输入视图存储的共享文件夹路径
  1. 选择将要导入其代码的项目区域或团队区域,单击 Next。
图 11. 选择新的同步流的所有者
Select Project or Team Area 视图

将在此步骤中创建一个新的合并工作区,您可以更改默认名称。也可以关联 Rational Team Concert 中一个用于代码导入的现有工作项。

  1. 在 “Jazz synchronization engine options” 字段中,键入 Jazz ID (ccsync),它是为 Jazz 存储库中的代码导入而创建的。

此 ID 被分配了一个 ClearCase Synchronizer 客户端访问许可。安装位置是安装 ClearCase synchronizer 的位置,是以 ccctools 结尾的。

  1. 单击 Finish
图 12. 输入 Jazz 源控制信息
输入 Jazz ID、Password 和 Install location

如果您的项目启用了 ClearQuest

创建同步流后,系统会提示您导入文件。这一步只在您的 ClearCase 项目启用了 IBM® Rational® ClearQuest® 时才需要。如果 UCM 项目未启用 ClearQuest,则会跳过此步骤,单击 OK。如果 ClearCase 项目启用了 ClearQuest,则需要添加设置,所以目前会取消 Import window。

设置 ClearCase 同步流属性

您需要设置 ClearCase 同步流的两个属性:ClearCase 提供程序属性和 Jazz 提供程序属性。

  1. 在 ClearCase Synchronized Streams 视图中,右键单击以前创建的同步流,选择 Properties
图 13. 打开同步流的属性
ClearCase 同步流属性

设置 ClearCase 提供程序属性

ClearCase Provider Properties 页面包含填写 ClearQuest 模式存储库名称、与 ClearCase VOB 集成的 ClearQuest 数据库名称,填入 ClearQuest 登录 ID。

  1. 在 Properties 窗口中,选择 ClearCase 提供程序属性。
  2. 设置以下属性值:
    • 将 CLEARQUEST_DBSET_NAME 设置为支持 UCM 项目的数据库的 Rational ClearQuest 模式存储库的名称。这个存储库必须可从同步主机访问。
    • 将 CLEARQUEST_LOGIN_NAME 设置为要用于 UCM 项目的 Rational ClearQuest 用户名。
    • 将 CLEARQUEST_USERDB_NAME 设置为 UCM 项目所使用的 Rational ClearQuest 用户数据库的名称。此数据库必须可从同步主机访问。
图 14. 设置 ClearCase 提供程序属性
ClearCase Provider Properties 页面

设置 Jazz 提供程序属性

  1. 在 Jazz Provider 属性中,查找列出的 STREAM_SCRIPT_DIR 的路径(参见图 15),将该目录更改为该路径(参见图 16),在 admin.cq_passwd 文件中填入 ClearQuest 密码:
  2. 选择 Jazz 提供程序属性。在名为 STREAM_SCRIPT_DIR 的文件夹中,创建一个名为 name.cq_password 的文本文件,其中 name 是 CLEARQUEST_LOGIN_NAME 属性的值。该文件仅包含一行具有以下格式的内容:

    -password=xxxxxx

    其中 xxxxxx 是名为 CLEARQUEST_LOGIN_NAME 的用户的密码。同步流程 ClearCase 帐户必须拥有读取此文件的权限。它应该不可供其他帐户读取。
图 15. Jazz Provider Properties 显示了 ClearQuest 密码文件的路径
Jazz Provider Properties 上的 STREAM_SCRIPT_DIR
  1. 单击 OK
图 16. STREAM_SCRIPT_DIR 显示的本地路径
admin.cq_password 文件

请求同步或选择要同步的内容

为同步流设置了属性之后,您可以请求同步或选择要同步(导入)的文件、文件夹和基线。

  1. 要请求同步,右键单击 ClearCase Synchronized Streams 视图中的 ClearCase 同步流,单击 Request Synchronization(参见图 17)
图 17. 提交同步请求
请求与 ClearCase 同步
  1. 要选择需要同步的文件,请右键单击 ClearCase Synchronized Streams 视图中的 ClearCase 同步流,然后单击 Select Files To Synchronize(或者您可以单击右上角的铅笔图标,如图 18 所示)。

备注:
您可以使用 Synchronize 选项更新已导入的文件。仅对未在 Jazz 源控制中的新文件使用 Import 选项。

图 18. 选择要导入(同步)的文件和文件夹
选择要同步的文件和文件夹的图标

如果选择 files, folders, and baselines to synchronize or import 选项(参见图 18),您将看到挂载的 VOB。找到并选择合适的组件。在 ClearCase 术语中,挂载的 VOB 是活动的 VOB,只有挂载了 VOB,用户才可以读取和修改数据。

  1. 选择 VOB 中需要导入的文件和文件夹。
图 19. 浏览以查找要导入的文件
要同步的文件的浏览窗口
  1. 有两个选项:导入所有基线或仅导入拥有关联的特定的特性类型的基线(参见图 20)。
  2. 单击 Finish
图 20. 选择导入所有基线还是仅导入选定的基线
选择了用于导入所有基线的单选按钮
图 21. 导入窗口显示正在导入
导入文件期间的进度条

剩下的屏幕截图显示了正在进行的导入流程的状态。

图 22. 导入的 Pending 状态
状态列显示 Pending
图 23. Active 状态
状态列显示 Import Active
图 24. 刷新视图以查看最新状态
最右侧的 Refresh Table 选项
图 25. ClearCase Synchronized Streams 视图显示了状态
状态列显示导入成功、日期和时间

参考资料

学习

获得产品和技术

讨论

条评论

developerWorks: 登录

标有星(*)号的字段是必填字段。


需要一个 IBM ID?
忘记 IBM ID?


忘记密码?
更改您的密码

单击提交则表示您同意developerWorks 的条款和条件。 查看条款和条件

 


在您首次登录 developerWorks 时,会为您创建一份个人概要。您的个人概要中的信息(您的姓名、国家/地区,以及公司名称)是公开显示的,而且会随着您发布的任何内容一起显示,除非您选择隐藏您的公司名称。您可以随时更新您的 IBM 帐户。

所有提交的信息确保安全。

选择您的昵称



当您初次登录到 developerWorks 时,将会为您创建一份概要信息,您需要指定一个昵称。您的昵称将和您在 developerWorks 发布的内容显示在一起。

昵称长度在 3 至 31 个字符之间。 您的昵称在 developerWorks 社区中必须是唯一的,并且出于隐私保护的原因,不能是您的电子邮件地址。

标有星(*)号的字段是必填字段。

(昵称长度在 3 至 31 个字符之间)

单击提交则表示您同意developerWorks 的条款和条件。 查看条款和条件.

 


所有提交的信息确保安全。


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=10
Zone=Rational
ArticleID=835257
ArticleTitle=将 Rational ClearCase UCM 项目代码导入 Rational Team Concert
publish-date=09132012