本主题描述了将小型试验 CLM 部署移至生产环境时更改服务器 URL 所需要执行的步骤。
开始之前
在继续进行重命名之前,请检查您所在环境是否满足“从试验到生产”方案的条件。有关详细信息,请参阅受支持的方案。
要点: 要执行服务器重命名,Jazz™ Team Server 和所有 CLM 应用程序的版本都必须为 V4 或更高版本。
下图说明了进行重命名的一般流程。

关于此任务
在此过程中,您要将数据和配置文件从试验服务器复制到生产服务器。因为您要移动数据库而不是复制数据库,所以试验环境必须永久停止运行,以避免污染生产环境。
服务器重命名功能使用映射文件来确定应将其重命名的 URL。提供了 repotools 命令为您生成初始映射文件。此映射文件中包含 JTS 和所有应用程序的“源/目标”对以及这些应用程序提供的任何其他 URL。有关此映射文件的更多详细信息,请参阅了解服务器重命名所使用的映射文件。请参阅“从试验到生产”方案的拓扑和映射文件,以获取样本拓扑图和映射文件。
过程
- 在实际进行重命名之前并且在服务器仍处于联机状态的情况下,遵循准备映射文件主题中描述的步骤来准备此映射文件并进行复查。
如果您要将部署移至新的计算机,请在新计算机上执行安装。如果您要在同一台计算机上更改 URL,请在与现有安装版本不同的目录中执行安装。如果您还要更改上下文根,请参阅更改上下文根。
完成准备阶段之后,最终结果是在试验 Jazz Team Server 上生成一个映射文件。此映射文件中包含 Jazz Team Server 和所有应用程序的“源/目标”对以及这些应用程序提供的任何其他 URL。
- 备份 V4 试验环境,并将文本索引和应用程序配置文件复制到新的安装版本中。
- 停止 Jazz Team Server 以及任何已向 Jazz Team Server 注册的分布式 CLM 应用程序。
此外,请停止任何其他受到服务器重命名影响的应用程序(例如,Jazz Build Engine)或者任何受影响且受支持的集成(例如,Rational Reporting for Development Intelligence (RRDI)、Rational® ClearCase® 或 Rational ClearQuest®)。
注: 在服务器已当机的情况下,用户将无法创建或遍历与任何已与要重命名的 CLM 部署进行集成的外部系统的链接。
- 如果您正在使用 RRDI,请备份 CLM 4.0 试验环境中的数据库(其中包括 Jazz Team Server 数据库、CCM 和 QM 应用程序的数据库、数据仓库数据库以及 RRDI 内容存储库数据库)。如果您正在更改数据库服务器或供应商,请参阅移动 CLM 数据库以了解其他步骤。
- 将 JFS/text 索引从源试验服务器复制到目标生产服务器。(对于分布式系统,请转至适当的服务器以复制这些文件。)
针对 Linux 服务器提供了下列示例,并且假定已通过网络安装方式来安装生产计算机的驱动器。如果您所在环境不可能通过网络安装方式进行安装,请使用其他文件传输方法来确保已复制文件。
cp -R SourceJazzInstallDir/server/conf/jts/indices TargetJazzInstallDir/server/conf/jts
cp -R SourceJazzInstallDir/server/conf/ccm/indices TargetJazzInstallDir/server/conf/ccm
cp -R SourceJazzInstallDir/server/conf/qm/indices TargetJazzInstallDir/server/conf/qm
- 将应用程序配置文件从源试验服务器复制到目标生产服务器。(对于分布式系统,请转至适当的服务器以复制这些文件。)与前一步骤一样,针对 Linux 服务器提供了下列示例,并且假定已通过网络安装方式来安装生产计算机的驱动器。
cp SourceJazzInstallDir/server/conf/jts/teamserver*.properties TargetJazzInstallDir/server/conf/jts
cp SourceJazzInstallDir/server/conf/ccm/teamserver*.properties TargetJazzInstallDir/server/conf/ccm
cp SourceJazzInstallDir/server/conf/qm/teamserver*.properties TargetJazzInstallDir/server/conf/qm
cp SourceJazzInstallDir/server/conf/admin/admin.properties* TargetJazzInstallDir/server/conf/admin
cp SourceJazzInstallDir/server/conf/admin/friends.rdf* TargetJazzInstallDir/server/conf/admin
cp SourceJazzInstallDir/server/conf/rm/fronting.properties TargetJazzInstallDir/server/conf/rm
cp SourceJazzInstallDir/server/conf/rm/friendsconfig.rdf TargetJazzInstallDir/server/conf/rm
- 将此映射文件复制到生产服务器上的 TargetJazzInstallDir\server 目录。有关此映射文件的详细信息,请参阅准备映射文件。
- 通过使用 repotools-jts -importURLMappings 命令将此映射文件导入到目标生产 Jazz Team Server 中来执行服务器重命名的脱机部分步骤。
- 如果您具有一体式部署,请使用 repotools-jts -importURLMappings 命令按如下所示导入此映射文件:
repotools-jts.bat -importURLMappings
fromFile=".\mappings.txt"
./repotools-jts.sh -importURLMappings
fromFile="./mappings.txt"
重新启动服务器之前,在 Jazz Team Server 上将开始以脱机方式进行重命名。
- 如果您具有分布式部署,并且允许您映射网络驱动器,请将 Jazz Team Server 主机中的网络驱动器映射至每个应用程序主机。然后,按以下格式创建一个包含部署中的远程 server/conf 目录列表的文件(例如,serverConfFile.txt):
# Remote CCM server
x:/JazzTeamServer/server/conf
# Remote QM server
y:/JazzTeamServer/server/conf
# Remote RM server
z:/JazzTeamServer/server/conf
最后,按如下所示在添加 serverConfFile= 参数的情况下继续运行 repotools-jts -importURLMappings 命令。
repotools-jts.bat -importURLMappings
fromFile=".\mappings.txt" serverConfFile=".\serverConf.txt"
./repotools-jts.sh -importURLMappings
fromFile="./mappings.txt" serverConfFile="./serverConf.txt"
- 如果您具有分布式 CLM 部署,但是不允许您重新映射网络驱动器,那么继续运行 repotools-jts -importURLMappings 命令(不附带 serverConfFile= 参数)。然后,将 server/conf/jts/.mappingEvent 文件复制到远程应用程序配置目录 (server/conf/application_name),即 ccm、qm 和 rm。当您导入映射时就会生成事件文件。您必须在导入映射文件之后(但是要在启动服务器之前)复制 .mappingEvent 文件。
.mappingEvent 文件中包含应用程序在其新位置与 Jazz Team Server 联系时所需要的信息。对于所给定的 Jazz Team Server 及其已注册的应用程序,.mappingEvent 文件的内容相同。
注: 对于在 z/OS® 上运行的服务器,应使用样本 JCL 成员 HLQ.SBLZSAMP(BLZRENAM) 将其重命名。请参阅 BLZRENAM 的注释头以了解详细的定制指示信息。
通过检查控制台输出和 JazzInstallDir/server/repotools-jts_importURLMappings.log 文件来确认已成功进行重命名。如果显示了任何错误,或者您认识到自己在映射文件中犯错,请参阅对服务器重命名进行故障诊断以准确找出问题并加以解决。
- 启动 Jazz Team Server 以及任何已安装的分布式 CLM 应用程序。
此时,CLM 应用程序将与 Jazz Team Server 同步,以应用 URL 映射并更新这些 CLM 应用程序的数据仓库数据。对于小型数据集,完成此操作可能要耗用 5 分钟;而对于非常大的数据集,可能要耗用多达 30 分钟甚至更长时间。
- 登录到 Jazz Team Server(https://hostname:port/jts/serverRenameStatus,例如 https://clmhost.production.example.org:9443/jts/serverRenameStatus)以跟踪重命名的进度。此页面将自动刷新,直到完成重命名为止。
如果显示了任何错误,请参阅对服务器重命名进行故障诊断以准确找出问题并加以解决。
注: 完成重命名之前,只要尝试登录到任何 CLM 应用程序的 Web UI,都会将您重定向到此状态页面。
- 执行验证服务器重命名中所描述的服务器重命名验证步骤。
- 可选:请执行下列步骤以在生产环境中配置 Rational Reporting for Development Intelligence (RRDI):
- 从试验环境备份以下数据库并将它们复原到新的数据库服务器上以用于生产环境中 RRDI 的新安装:
- 内容存储库数据库(例如,RICM,如果尚未对其进行备份和复原)
- 数据仓库(例如,RIDW,如果尚未对其进行备份和复原)。
- 在生产环境中安装 Rational Reporting for Development Intelligence V2.0。有关详细信息,请参阅使用 Installation Manager 安装 Rational Reporting for Development Intelligence。
- 通过运行“RRDI 安装”应用程序来配置报告服务器。有关详细信息,请参阅安装后任务。请记住执行下列操作:
- 在配置内容存储库数据库页面中,指定您在步骤 7.a 中已复原的内容存储库数据库(例如,RICM)的连接属性。
- 在配置数据仓库页面中,指定您在步骤 7.a 中已复原的数据仓库数据库(例如,RIDW)的连接属性。
- 登录到 Jazz Team Server,并确认存储在 Jazz Team Server 的“高级属性”以及 CCM 和 QM“管理”页面中的报告服务器 URL 指向生产 RRDI 报告服务器。如果它们未指向生产系统,请对它们进行相应地更新。
注: 如果映射文件包含报告服务器 URL 的映射,那么应该已经自动更新这些映射。
- 请确认先前从试验 RRDI 报告服务器中导入的所有报告继续有效。
- 在进行 CLM 服务器重命名之后,将操作设置为查看最新报告的任何 Cognos 报告或报告视图都必须重新运行,以便更新已高速缓存的 HTML 报告。
- 登录到 RRDI 报告服务器。
- 查找具有已高速缓存的输出版本的报告或报告视图。
注: 如果某个报告或报告视图存在已高速缓存的输出版本,那么您可以对此报告单击查看输出版本以查看已高速缓存的报告。如果报告或报告视图在进行 CLM 服务器重命名之前就已生成,那么必须重新运行这些报告或报告视图以对其进行更新。否则,运行这些报告或报告视图的用户仍将看到指向旧的 CLM 服务器的旧链接。
- 单击使用选项来运行以重新运行这些报告或报告视图。
- 在报告查看器中,单击,以更新与这些报告或报告视图相关联并且已高速缓存的输出版本。
- 从生产 RRDI 报告服务器中导入新报告。请确认已成功导入,并且已导入的报告在运行时未发生任何问题。
- 如果您在 RRDI 中已配置 Rational Quality Manager 实时报告,请遵循相应的步骤以对新服务器生成 xdc 文件并在 32 位 ODBC 管理器中配置此文件。有关详细信息,请参阅设置实时报告。
- 执行与其他组件和产品(例如,Jazz Build Engine、Rational Reporting、Rational Team Concert 客户机、Rational ClearQuest 或 Rational ClearCase)进行集成时需要执行的任何其他服务器重命名后的步骤。有关详细信息,请参阅限制和其他信息。