clm_server_rename.pl

此工具用于为 Rational Solution for Collaborative Lifecycle Management (CLM) 更新 Jazz Team Server 公共 URI 工件链接。具体而言,该工具更新存储在 IBM Rational ClearQuest Web 服务器配置文件中的 URI。该工具还更新存储在 ClearQuest 用户数据库内 OSLCLink 记录中的 URI。

摘要

cqperl clm_server_rename.pl -username username -password password [ -dbset dbset ] -dbname dbname –oldprefix oldprefix –newprefix newprefix [ -remapconfigfiles | -preview number | -update ] [ -help ] [ -man ]

描述

从 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 记录中。

对于 Rational Solution for CLM 中的工件,存在多种类型的链接:
  • 结构链接描述资源或工件之间的关系,并且是维护可跟踪性和数据完整性所必需的。
  • 嵌入式链接是可以包含在文本字段或资源节点中的 URI。嵌入式链接可以是锚点链接纯文本链接
    • 锚点链接将作为可导航超链接显示给用户。 例如,在富文本窗口小部件中,这些链接据此进行声明,并且通常存储在诸如 <a href=...> 之类的结构中。
    • 纯文本链接是在文本窗口小部件中输入但未呈现为可导航超链接的 URI。

ClearQuest 提供 clm_server_rename.pl 工具来重新映射存储在 ClearQuest Web 配置文件和 OSLCLink 记录中的 URI 结构链接。使用该工具可以重新映射结构链接的协议、主机名、端口号和应用程序上下文。

运行工具

您必须具有本地管理员特权和 ClearQuest 超级用户特权才能运行 clm_server_rename.pl 工具。

该工具位于该目录的 cqweb.war 文件中:

WAS_profile_home\installedApps\nodecell\TeamEAR.ear\cqweb.war\WEB-INF\classes

cqperl.exe 程序位于 ClearQuest 的安装目录中。

运行 clm_server_rename.pl 工具之前,理想的做法是将 TEMP 环境变量设置为您具有写访问权的目录。否则,请确保您对运行该工具的目录具有写访问权。

您必须多次运行该工具。

请参阅在重命名 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 链接。

选项和自变量

-username username
具有超级用户特权的管理用户的登录名。
-password password
具有超级用户特权的管理用户的密码。
-dbset dbset
数据库连接的名称。
-dbname dbname
用户数据库的名称。
–oldprefix oldprefix
指定现有 URI 字符串。URI 格式必须以 http 开头,并且包含应用程序上下文,后跟斜杠 (/)。
–newprefix newprefix
指定新的 URI 字符串以替换 –oldprefix 选项所指定的现有 URI 字符串。URI 格式必须以 http 开头,并且包含应用程序上下文,后跟斜杠 (/)。
-remapconfigfiles
要点: 使用此选项时,必须在该工具的安装目录中运行该工具。

为 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 工件的以下现有链接将不起作用。

-preview number
显示将对 ClearQuest 数据库中 OSLCLink 记录(包含 oldprefix URI 字符串)的 number 进行的更改的预览。此外,报告包含 oldprefix URI 字符串的 OSLCLink 记录的总数。使用此选项时,未对用户数据库进行任何更改。
-update
为 Rational Solution for CLM 工件更新 Jazz Team Server 公共 URI 链接。具体而言,此选项更新存储在 ClearQuest OSLCLink 记录中的 URI。

在使用此选项的情况下运行该工具时,该工具会在日志文件中捕获对 OSLCLink 记录的更改。如果设置了 TEMP 环境变量,那么会将日志文件写入到指定的目录;否则,将日志文件写入到运行该工具的目录(前提是您具有写访问权)。对于日志文件,使用以下文件命名约定:

clm_server_rename_yyyymmdd_hhmmss.txt

其中:

yyyymmdd
运行该工具的日期,以年、月和日形式指定
hhmmss
运行该工具的时间,以小时、分钟和秒形式指定

例如,clm_server_rename_20120405_211711

示例

  • 对于名为 MyCQWebServer 的服务器,重新映射 ClearQuest Web 服务器配置文件中与下文所指定的 URI 字符串匹配的 Jazz Team Server URI 工件链接。

    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.

  • 预览 ClearQuest 数据库中与下文所指定的 URI 字符串匹配的五个 OSLCLink 记录,以及在应用程序上下文从 jazz 更改为 ccm 的情况下这些记录的外观。

    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

  • 将与下文所指定的 URI 字符串匹配的 ClearQuest OSLCLink 记录内的 URI 中的协议从 http 更改为 https

    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/

  • 将与下文所指定的 URI 字符串匹配的 ClearQuest OSLCLink 记录内的 URI 中的服务器名称从 servername 更改为 newservername

    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/

另请参阅

在重命名 CLM 服务器后重新映射 URI使用服务器重命名更改公共 URI


反馈