RTC与ClearQuest的集成

作者 彭小桢

近日搭建了一个RTC(Rational Team Concert)与ClearQuest的集成环境，RTC本身是基于Jazz协作平台的应用，因此也更深刻的体会到Jazz的团队协作理念和它的连接性等特点。在此，本人希望通过这篇文章让更多的同行了解到Jazz的优势，并且总结一些在搭建和使用集成环境过程中的心得和技巧与大家分享。

Jazz的特点

首先，什么是Jazz？Jazz 是 IBM Rational 面向软件交付技术的下一代协作平台。Jazz 平台专门面向全球化和跨地域团队开发，通过这一全新的平台，地理上分隔的开发人员将能互相协作，共同构建软件。从而使得软件交付实现更加协作化、高效率和无缝衔接。

其次，对于已经使用各种软件来搭建工作的成熟团队而言，Jazz 的开放性和可扩展性架构将使团队能组装团队专用的软件交付平台，并自行选择软件提供商的产品和解决方案。Jazz的连接器框架提供一个可集成例如 ClearCase, ClearQuest, 以及 Subversion 等其他源代码控制和变更管理系统的框架。专门设计使向 Jazz 的迁移易于进行。通过组装您理想的软件交付平台，增加灵活性。

下面本文主要讲讲Jazz集成ClearQuest的原理和技巧。

RTC与ClearQuest的集成架构

Rational Team Concert ClearQuest Connector 就是开发人员专门为大家设计的用于集成RTC和ClearQuest的工具。ClearQuest Connector用于同步Jazz work items和ClearQuest的记录，两边的客户端可以共享相同的数据内容。在同步的过程中，需要建立一个同步规则，使得双方的数据类型能够互相映射。如下图所示，ClearQuest Connector使用ClearQuest Gateway这个服务进程一端跟Jazz Sever保持通信，另一端连接ClearQuest的数据库，以此达到双方的同步。

如何配置ClearQuest Connector

在对ClearQuest和Jazz Server数据同步之前，自然是要配置好ClearQuest Connector 和Jazz Server的环境。下面，基于本人的经验和技巧，列出配置的主要步骤和注意事项，希望能对大家有所帮助。

1.       安装Jazz Team Server和ClearQuest。二者可以不在同一台机器上，但是为了方便配置，建议把ClearQuest Connector和ClearQuest安装在同一台机器上。

2.       配置ClearQuest。

(1)    为ClearQuest安装并且注册JazzInterop 包(目前已经到了1.0.6版本)，并且应用到要进行同步的Dbset上，然后升级用户数据库。具体的操作命令和步骤请参考ClearQuest用户指南。

(2)    在ClearQuest用户数据库中创建一个具有SQL editor权限的用户，填写user name，Email。同时为Jazz 创建一个用户名和邮件地址完全相同的用户，并且这个用户具有ClearQuest Connector权限。注意，必须保证双方的登录名，密码，用户名，邮件地址完全相同。

(3)    登录ClearQuest客户端，创建需要同步的数据的文件夹和查询。比如，需要同步项目是A的所有缺陷记录，就在文件夹中创建相应的查询。在同步的过程中，系统会先运行查询获得相应的数据，然后进行同步。如果文件夹中没有查询，就表示同步所有的数据。

3.       配置ClearQuest Connector。

(1) 打开安装目录下的cqconnector.properties文件，设置6个主要参数。比如：

com.ibm.rational.interop.pollingPeriod=60

cq.dbSetDbName=JazzDbset/SAMPL

cq.userid=cqconnector

cq.password=cqconnector

com.ibm.team.uris=https://cqconnector:cqconnector@localhost:9443/jazz

cq.queryTreeRoot=Public Queries/JazzConnector

(2) 在命令行窗口运行server.startup.bat文件，启动ClearQuest Connector。

如果连接ClearQuest成功，应该在http://localhost:8444/InteropGateway/InteropServlet页面看到Connector与ClearQuest数据库的连接信息。

4.       配置Jazz Team Server

(1) 用第2步创建的Jazz用户创建一个Project Area。在Project Configuration和Team Configuration的权限中，选中Item Connectors，否则这个项目不能进行同步。

(2) 用第2步创建的Jazz用户创建一个External Repository Connection，连接Project Area选择(1)中创建好的项目。

(3) 创建同步规则。用户可以为自己的数据类型来创建同步规则，也可以导入安装目录下的样本规则。

(4) 启动outgoing synchronization，否则不能进行Jazz和ClearQuest之间的双向同步。

现在，ClearQuest Connector已经配置完成，用户可以双向同步数据了！