从 Rational Solution for Collaborative Lifecycle Management (CLM) 的 V4.0 产品开始,管理员可以通过使用服务器重命名操作在部署后更改 Jazz Team Server 或 Rational Solution for CLM 应用程序的公共 URI。此类更改要求对基于 URI 的 Rational Solution for CLM 资源进行对应的更新。对于 ClearQuest Bridge,Rational Solution for CLM 产品资源(IBM Rational Team Concert、IBM Rational Quality Manager 和 IBM Rational Requirements Composer)的这些工件链接存储在 ClearQuest Web 服务器配置文件中以及 ClearQuest 用户数据库内的 OSLCLink 记录中。
ClearQuest 提供 clm_server_rename.pl 工具来重新映射存储在 ClearQuest Web 配置文件和 OSLCLink 记录中的 URI 结构链接。使用该工具可以重新映射结构链接的协议、主机名、端口号和应用程序上下文。
运行工具
您必须具有本地管理员特权和 ClearQuest 超级用户特权才能运行 clm_server_rename.pl 工具。
该工具位于该目录的 cqweb.war 文件中:
cqperl.exe 程序位于 ClearQuest 的安装目录中。
运行 clm_server_rename.pl 工具之前,理想的做法是将 TEMP 环境变量设置为您具有写访问权的目录。否则,请确保您对运行该工具的目录具有写访问权。
您必须多次运行该工具。
例如,如果 ClearQuest 与 IBM Rational Team Concert 和 IBM Rational Quality Manager 集成,并且 Jazz Team Server for Rational Team Concert 和 Rational Quality Manager 服务器均已重命名,那么必须在使用 -remapconfigfiles 选项的情况下运行该工具两次:一次用于重新映射 Rational Team Concert 工件链接的 URI,一次用于重新映射 Rational Quality Manager 工件链接的 URI。
例如,如果 ClearQuest 与 IBM Rational Team Concert 和 IBM Rational Quality Manager 集成,并且 Jazz Team Server for Rational Team Concert 和 Rational Quality Manager 服务器均已重命名,那么必须在使用 -update 选项的情况下运行该工具两次:一次用于重新映射 Rational Team Concert 工件链接的 URI,一次用于重新映射 Rational Quality Manager 工件链接的 URI。
请参阅在重命名 CLM 服务器后重新映射 URI 以获取完整的过程详细信息。
请参阅选项和自变量部分以获取命令行选项的描述。
clm_server_rename.pl 工具仅重新映射存储在 ClearQuest Web 服务器配置文件和 OSLCLink 记录中的结构链接。该工具不重新映射存储在 ClearQuest 记录中的嵌入式链接。此类嵌入式锚点链接可以包含在记录附件或字段(如描述或备注)中。根据模式,在提交后或添加备注后,这些字段可能会变为只读。这意味着在运行该工具后嵌入式锚点链接将保持断开状态。如果需要,可以编写代码来修订这些链接。
在运行该工具后保持断开状态的嵌入式锚点链接的示例包括 Rational ClearQuest 和 Rational Quality Manager 之间的 Rational Solution for CLM 集成。当 Rational Quality Manager 工件链接到 ClearQuest 记录时,Rational Quality Manager 会在记录描述字段中插入指向该工件的 URI 链接。
为 Rational Solution for CLM 应用程序重新映射 Jazz Team Server 公共 URI 工件链接。具体而言,此选项重新映射存储在 ClearQuest Web 服务器配置文件中的 URI。该工具在重新映射 URI 之前会生成配置文件的副本。
在使用此选项的情况下运行该工具后,必须重新启动 ClearQuest Web 服务器。然后,会重新配置 Web 服务器上的跨服务器通信,并且用户可以创建指向 Rational Solution for CLM 工件的新 URI 链接。但是,在使用 -update 选项的情况下再次运行该工具之前,指向 Rational Solution for CLM 工件的以下现有链接将不起作用。
在使用此选项的情况下运行该工具时,该工具会在日志文件中捕获对 OSLCLink 记录的更改。如果设置了 TEMP 环境变量,那么会将日志文件写入到指定的目录;否则,将日志文件写入到运行该工具的目录(前提是您具有写访问权)。对于日志文件,使用以下文件命名约定:
其中:
例如,clm_server_rename_20120405_211711。
C:\was_profiles\MyCQWebServer\installedApps\Node02Cell\TeamEAR.ear\cqweb.war\WEB-INF\classes>cqperl clm_server_rename.pl -username admin -password secret -dbset 7.0.0 -dbname SAMPL -oldprefix https://clm7.mycompany.com/ccm/ -newprefix https://clm7.mycompany.com/jazz/ -remapconfigfiles
Started: Remapping URIs in config file friendsconfig.rdf.
Completed: Remapping URIs in config file friendsconfig.rdf.
Started: Remapping URIs in config file project-area-links.rdf.
Completed: Remapping URIs in config file project-area-links.rdf.
Started: Remapping URIs in config file oauth-consumers.rdf.
Completed: Remapping URIs in config file oauth-consumers.rdf.
cqperl clm_server_rename.pl -username admin -password secret -dbset 8.0.0 -dbname SAMPL -oldprefix https://servername.com:9443/jazz/ -newprefix https://servername.com:9443/ccm/ -preview 5
cqperl clm_server_rename.pl -username admin -password secret -dbset 8.0.0 -dbname SAMPL -oldprefix http://servername.com:9443/jazz/ -newprefix https://servername.com:9443/jazz/
cqperl clm_server_rename.pl -username admin -password secret -dbset 7.0.0 -dbname SAMPL -oldprefix http://servername.com:9443/jazz/ -newprefix https://newservername.com:9443/jazz/