本主题描述将小型试验部署或完全生产部署重命名的步骤。
开始之前
因为不能自动迁移 LQE,所以应该将其从
Jazz™ Team Server 注册的应用程序列表移除并且应在开始服务器重命名过程之前重新启动 Jazz Team Server。
- 登录 Jazz Team Server 的“管理”页面。使用 Web 浏览器浏览到 https://hostname:port/jts/admin。
- 单击服务器选项卡。
- 在左侧窗格的“配置”部分中,单击已注册的应用程序。
- 将 Lifecycle
Query Engine 作为已注册的应用程序移除。
- 停止 Lifecycle
Query Engine 服务器。
- 重新启动 Jazz Team Server。
注: 完成重命名之后,源服务器必须永久停止运行,以避免污染生产环境。
关于此任务
服务器重命名功能使用映射文件来确定应重命名的 URL。提供了 repotools 命令为您生成初始映射文件。此映射文件中包含 Jazz Team Server 和所有应用程序的“源/目标”对以及这些应用程序提供的任何其他 URL。有关此映射文件的更多详细信息,请参阅用于服务器重命名的映射文件。
过程
- 在实际进行重命名之前并且在服务器仍处于联机状态的情况下,遵循准备映射文件主题中描述的步骤来准备此映射文件并进行复查。
完成准备阶段之后,最终结果是在源 Jazz Team Server 上生成一个映射文件。此映射文件中包含 Jazz Team Server 和所有应用程序的“源/目标”对以及这些应用程序提供的任何其他 URL。
- 备份现有的源环境,并将文本索引和应用程序配置文件复制到新的目标安装。对于分布式系统,请转至适当的服务器以复制这些文件。
注: 如果要执行就地重命名而不移至新硬件,那么需将环境从一个安装复制到同一系统上的另一安装。
- 停止 Jazz Team Server 以及任何已向 Jazz Team Server 注册的分布式应用程序。
此外,请停止任何其他受到服务器重命名影响的应用程序或者任何受影响且受支持的集成。
注: 在服务器已关机的情况下,用户将无法创建或遍历与任何已与要重命名的
Rational® Engineering Lifecycle
Manager 部署进行集成的外部系统的链接。
- 备份源环境的数据库,其中包括
Jazz Team Server 数据库、应用程序的数据库以及数据仓库数据库。如果您正在更改数据库服务器或供应商,请参阅移动数据库以了解其他步骤。
- 将 JFS/text 索引从源安装复制到目标安装。
针对 Linux 服务器的下列示例假定已通过网络安装方式来安装目标生产计算机的驱动器。如果您所在环境不可能通过网络安装方式进行安装,请使用其他文件传输方法来确保已复制文件。
cp -R SourceJazzInstallDir/server/conf/jts/indices TargetJazzInstallDir/server/conf/jts
cp -R SourceJazzInstallDir/server/conf/relm/indices TargetJazzInstallDir/server/conf/relm
- 将应用程序配置文件从源安装复制到目标生产安装。与上一个步骤一样,针对 Linux
服务器的下列示例假定已通过网络安装方式来安装目标生产计算机的驱动器。
cp SourceJazzInstallDir/server/conf/jts/teamserver*.properties TargetJazzInstallDir/server/conf/jts
cp SourceJazzInstallDir/server/conf/relm/teamserver*.properties TargetJazzInstallDir/server/conf/relm
cp SourceJazzInstallDir/server/conf/admin/admin.properties* TargetJazzInstallDir/server/conf/admin
cp SourceJazzInstallDir/server/conf/admin/friends.rdf* TargetJazzInstallDir/server/conf/admin
- 将此映射文件复制到目标生产服务器上的 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"
- 如果您具有分布式部署,但是不允许您重新映射网络驱动器,请继续运行 repotools-jts -importURLMappings 命令(不带 serverConfFile= 参数)。然后,将 server/conf/jts/.mappingEvent 文件复制到远程应用程序配置目录 (server/conf/application_name),即 ccm、qm 和 rm。当您导入映射时就会生成事件文件。您必须在导入映射文件之后(但是要在启动服务器之前)复制 .mappingEvent 文件。
.mappingEvent 文件中包含应用程序在其新位置与 Jazz Team Server 联系时所需要的信息。对于所给定的 Jazz Team Server 及其已注册的应用程序,.mappingEvent 文件的内容相同。
通过检查控制台输出和 JazzInstallDir/server/repotools-jts_importURLMappings.log 文件来确认已成功进行重命名。如果显示了任何错误,或者您认识到自己在映射文件中犯错,请参阅对服务器重命名进行故障诊断以准确找出问题并加以解决。
- 启动
Jazz Team Server 以及任何已安装的分布式应用程序。
此时,应用程序将与 Jazz Team Server 同步,以应用 URL 映射并更新这些应用程序的数据仓库数据。对于小型数据集,完成此操作可能要耗用 5 分钟;而对于非常大的数据集,可能要耗用多达 30 分钟甚至更长时间。
- 登录到 Jazz Team Server (https://new
host:port/jts/serverRenameStatus)。这将开始真正的重命名过程。重命名完成后,您将能够验证重命名并执行任何必要的纠正操作。在验证过程中,Jazz Team Server 和所有应用程序都将置于只读方式,但您将能够浏览数据以及查找中断的链接和未映射的 URL。有关详细信息,请参阅在重命名服务器后验证 URL 和链接。
- 在完成验证过程之前,请确保已执行完成服务器重命名验证过程中描述的所有其他特定于产品的验证。当您确信重命名的数据正确时,单击我已验证服务器重命名... 复选框,然后单击完成。
此时,Jazz Team Server 和所有已注册的应用程序都将退出只读方式,并且正常的产品使用可以恢复。
- 仅适用于完全生产:如果您有第二个
Jazz Team Server 或者其他链接至重命名的 Jazz Team Server 的应用程序,那么必须在该第二个 Jazz Team Server 上运行 repotools-jts -importURLMappings。
为了更新从第二个服务器到重命名的服务器的链接,有必要执行此步骤。
要点: 请勿生成新的映射文件。必须使用先前用于所重命名的第一个服务器的那个映射文件。
- 将经过编辑的映射文件从第一个服务器复制到第二个服务器。
务必包括验证过程中应用的所有纠正映射。
- 复审映射文件,必要时除去您不想应用于第二个服务器的所有“源/目标”对。
- 通过在第二个 Jazz Team Server 上再次执行步骤 3 到
6,在第二个服务器上执行重命名。
下一步做什么
完成此任务中的步骤之后,完成
为 Lifecycle Query Engine 完成服务器重命名中的步骤以重新添加 LQE 并重新生成索引。