准备映射文件

本主题描述如何准备稍后将在实际重命名 CLM 服务器时所使用的映射文件。可以在进行实际重命名前服务器仍然联机时准备和复审映射文件。

开始之前

要点: CLM V4 的一项功能就是能够重命名服务器。因此,必须先将 Jazz™ Team Server 和所有 CLM 应用程序升级到 V4,才能执行服务器重命名。

关于此任务

在真正将服务器重命名之前,您需要执行若干步骤。在很大程度上,这涉及到准备和复查您将用来执行重命名操作的映射文件。映射文件将列示部署中的现有源 URL 以及重命名之后的目标 URL。这包括 Jazz Team Server 的 URL、CLM 应用程序、CLM 帮助 WAR 文件以及任何其他受影响的应用程序。请参阅用于设置测试登台环境的拓扑和映射文件,以获取样本拓扑图和映射文件。

可以在一体化 CLM 部署中执行这些步骤(在这种情况下,Jazz Team Server 和 CLM 应用程序全部安装在同一台计算机上),也可以在分布式部署中执行这些步骤(在这种情况下,CLM 应用程序安装在其他计算机上)。可以在各种情况下使用这些准备步骤,例如,将计算机移到新的物理位置时、在新计算机上设置测试沙箱,或者数据中心合并(涉及新计算机上已重命名的环境)的情况。

For z/OS operating system 注: z/OS® 上支持对服务器进行重命名,但创建映射文件的过程存在若干差异。有关详细信息,请参阅在 z/OS 上进行服务器重命名。

过程

  1. 将涉及重命名的所有服务器都升级到 V4 之后,启动 Jazz Team Server (JTS) 并验证是否已正确地向服务器注册这些应用程序。
    1. 登录 Jazz Team Server 的“管理”页面。使用 Web 浏览器浏览到 https://hostname:port/jts/admin。
    2. 单击服务器选项卡。
    3. 在左侧窗格的“配置”部分中,单击已注册的应用程序。
    4. 验证是否注册了所有应用程序。

    有关进一步的详细信息,请参阅向 Jazz Team Server 注册应用程序。

  2. 在安装了 Jazz Team Server 的计算机上,打开命令提示符并切换到 JazzInstallDir\server 目录。
    注: 即使您将移到新硬件,也请确保在原始 Jazz Team Server 上执行此步骤和下列步骤。
  3. 使用 repotools-jts -generateURLMappings 命令按如下所示生成用作模板的初始映射文件,以便进一步编辑。如果您已经运行了此命令或者此文件已存在,请添加 overwrite=true 参数。
    注: 对 UNIX 显示的任何示例对于 Linux 也有效。
    • For Windows operating system repotools-jts.bat -generateURLMappings toFile=mappings.txt adminUserId=<adminId> adminPassword=<adminPassword>
    • For Unix operating systems ./repotools-jts.sh -generateURLMappings toFile=mappings.txt adminUserId=<adminId> adminPassword=<adminPassword>

    此命令的输出是一个映射文件,此文件列示 Jazz Team Server 以及每个已向 Jazz Team Server 注册的 CLM 应用程序(CCM、QM 和 RM)的现有源公用 URL 和缺省目标 URL。它还标识 CLM 帮助 WAR 文件以及任何受影响的已知外部系统的源 URL 和目标 URL。

    请确认 JazzInstallDir/server/repotools-jts_generateURLMappings.log 处的日志文件中不存在任何错误。

  4. 请仔细复审和编辑所生成的映射文件。请查看主机名、端口或根上下文中是否存在输入错误。服务器重命名工具无法检测到其中某些输入错误,这些错误可能会导致产品无法运行。

    通过复审了解服务器重命名所使用的映射文件主题来熟悉映射文件的结构。请仔细复审和编辑所生成的映射文件。

    1. 请确认 CLM 帮助 WAR 文件以及要将其重命名的每个应用程序都存在一对“源/目标”。
    2. 将您要重命名的条目的 target= urls 编辑为正确的目标。
      注: 如果您要将 JTS 或者任何应用程序的端口号重命名,那么您需要在进行重命名之后(但是在重新启动服务器之前)更新应用程序服务器中的端口信息。有关详细信息,请参阅更改应用程序服务器的端口号。如果您要将 JTS 或任何应用程序的上下文根重命名,请参阅更改上下文根。
    3. 使用“#”将您不想重命名的任何 URL 的“源 -> 目标”对注释掉。
    4. 复审受影响的 URL 列表。虽然该命令会在部署中搜索所有已知的 URL,但可能会错过某些 URL。如果对环境有任何疑问,请先和管理员谈一谈,然后再继续重命名。
    注: 在您继续真正进行重命名之前,如果对 CLM 部署进行了任何配置更改,那么您将需要重新生成此映射文件。
  5. 如果您所处的情况涉及到新的硬件,请在新的计算机上安装 CLM V4。请勿运行 Jazz 设置向导或者启动 Jazz Team Server。请参阅安装 Jazz Team Server 和 Rational solution for Collaborative Lifecycle Management 应用程序。

下一步做什么

继续重命名服务器。有关详细信息,请参阅使用服务器重命名将试验部署移至生产环境或者使用生产数据设置测试登台环境

反馈