外部存储库连接是一个 Rational Team Concert™ 项,它的属性包含 Jazz™ Team Server
在创建与外部存储库的连接时所需的信息。您需要为 ClearQuest® 网关创建外部存储库连接。
开始之前
要创建、修改和删除外部存储库连接,您必须被授予开发者或 ClearQuest
连接者客户访问许可证。此外,必须配置项目区域,以便将许可权授予您的用户角色。要设置许可权,请打开项目区域,接着依次单击过程配置选项卡和,选择角色,然后从允许的操作列表中选择项连接者。
关于此任务
您可以使用 ClearQuest 连接器安装向导来创建外部存储库连接。本主题说明如何使用
Rational Team Concert Eclipse 客户机来创建外部存储库连接。本主题还说明如何对外部存储库连接禁用或启用传出同步。如果使用 ClearQuest 连接器安装向导来创建外部存储库连接,那么必须对该连接启用传出同步。此向导将创建禁用了传出同步的外部存储库连接。
要创建外部存储库连接,请执行下列操作:
- 登录到 Rational Team Concert 客户机。
- 在团队工件视图中,右键单击存储库连接,然后选择。在同步规则视图中,右键单击外部存储库连接,然后选择。
- 如果您已登录到多个 Jazz 存储库,请选择要为其创建外部存储库连接的存储库。单击下一步。在“外部存储库连接”窗口中的名称字段中,为该连接输入名称。在连接信息字段中输入
ClearQuest 网关的 URI。例如:http://YOUR-CQ-GATEWAY-HOST:8081/cqconnector/gateway。如果已将主管
ClearQuest 网关的 Tomcat 服务器配置成要求进行用户认证才能为请求提供服务,请在用户标识和密码字段中输入值。否则,请保留那些字段为空。您输入的用户标识和密码必须与
install-directory/gateway/tomcat/conf 目录中的 tomcat-users.xml 文件中指定的那些值匹配。
通过在项目区域中设置许可权并接着从项目区域字段中选择该项目区域,可以限制对外部存储库连接的访问。设置外部存储库连接的项目区域后,就无法对其进行变更。如果需要将该字段设置为另一个项目区域或者不设置任何项目区域,那么可以删除该外部存储库连接,然后删除新的外部存储库连接。
如果需要暂时停止从 Jazz 服务器到此 ClearQuest
网关的同步,请选择禁用传出同步。对
ClearQuest 用户数据库执行维护,并且它暂时不可用时,您可能想禁用传出同步。要启用传出同步,请清除禁用传出同步复选框。单击保存以保存该外部存储库连接。
对于安全套接字层(SSL)连接,外部存储库连接的缺省端口号是 8444;对于非 SSL 连接而言,是 8081。要变更缺省端口号,请编辑
/jazz/connectors/gateway/tomcat/conf 目录中的 server.xml 文件。要禁用非 SSL 连接并将
Tomcat 服务器配置为要求进行用户认证,请执行下列步骤:
- 启动 ClearQuest 网关,然后将其停止,这将把 cqconnector.war 文件解压缩。
- 编辑 install-directory/gateway/tomcat/conf 目录中的 server.xml 文件,以便将以下元素注释掉:
<Connector port="8081" maxHttpHeaderSize="8192"
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8444" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true" />
- 编辑 install-directory/gateway/tomcat/webapps/cqconnector/gateway/WEB-INF
目录中的 web.xml 文件,以便将以下元素注释掉:
<security-constraint>
<web-resource-collection>
<web-resource-name>secure</web-resource-name>
<url-pattern>/*</url-pattern>
</web-resource-collection>
<auth-constraint>
<role-name>*</role-name>
</auth-constraint>
<user-data-constraint>
<transport-guarantee>CONFIDENTIAL</transport-guarantee>
</user-data-constraint>
</security-constraint>
- 打开 /jazz/connectors/gateway/tomcat/conf 目录中的 tomcat-users.xml 文件。缺省用户标识和密码都是
cqconnector。请变更密码。并且,您可以选择变更用户标识。
- 缺省情况下,tomcat-users.xml 文件中的密码以明文方式存储,但您可以对该密码进行加密并配置
Tomcat 以便识别该密码。要完成此任务,请使用 repotools -convertTomcatUsers
命令。转到 JazzInstallDir/server/repotools 目录。然后,输入此命令并指定 tomcat-users.xml 文件的路径。例如:
repotools -convertTomcatUsers tomcatUsersPath=install-directory/gateway/tomcat/conf/tomcat-users.xml
转换后的 tomcat-users.xml 文件名为 tomcat-users.xml.converted。请将其重命名为
tomcat-users.xml。如果您需要变更密码,那么必须在未经编码的原始文件副本中进行变更,然后再次运行
repotools -convertTomcatUsers。请将未经编码的原始文件保留在安全的位置。
运行此命令之后,请编辑 /jazz/connectors/gateway/tomcat/conf 目录中的 server.xml 文件,如下所示:
将以下元素注释掉:
<Realm className="org.apache.catalina.realm.UserDatabaseRealm"
resourceName="UserDatabase"/>
取消对以下元素的注释:
<Realm className="org.apache.catalina.realm.UserDatabaseRealm"
resourceName="UserDatabase"
digest="SHA-1"
digestEncoding="UTF-8"/>
结果
您创建的外部存储库连接将显示在
同步规则视图的
外部存储库连接节点下。