准备映射文件

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

开始之前

要点: 要启用服务器重命名,您必须从 IBM® 软件支持机构获取功能密钥文件。联系 IBM 支持机构时,请说明您要请求“服务器重命名功能部件密钥文件”。

关于此任务

在真正将服务器重命名之前,您需要执行若干步骤。在很大程度上,这涉及到准备和复查您将用来执行重命名操作的映射文件。映射文件将列示部署中的现有源 URL 以及重命名之后的目标 URL。这些 URL 包括 Jazz Team Server、Jazz 应用程序以及任何其他受影响的应用程序的 URL。

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

过程

  1. 在升级 Jazz Team Server (JTS) 和所有 Jazz 应用程序之后,启动 Jazz Team Server 并验证这些应用程序是否已向服务器正确注册。
    1. 登录 Jazz Team Server 的“管理”页面。使用 Web 浏览器浏览到 https://hostname:port/jts/admin
    2. 单击服务器选项卡。
    3. 在左侧窗格的“配置”部分中,单击已注册的应用程序
    4. 验证是否注册了所有应用程序。如果没有,请全部注册。
    5. 如果您在先前步骤中已注册了所有应用程序,请重新启动 Jazz Team Server
  2. 在安装了 Jazz Team Server 的计算机上,打开命令提示符并切换到 JazzInstallDir\server 目录。
    注: 即使您将移到新硬件,也请确保在原始 Jazz Team Server 上执行此步骤和下列步骤。
  3. 使用 repotools-jts -generateURLMappings 命令按如下所示生成用作模板的初始映射文件,以便进一步编辑。如果您已经运行了此命令或者此文件已存在,请添加 overwrite=true 参数。
    • Windows:repotools-jts.bat -generateURLMappings toFile=mappings.txt adminUserId=<adminId> adminPassword=<adminPassword> additionalURLFile=additionalurl.txt
    • Linux:./repotools-jts.sh -generateURLMappings toFile=mappings.txt adminUserId=<adminId> adminPassword=<adminPassword> additionalURLFile=additionalurl.txt

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

    另外,还创建了另一个文件,该文件包含所有需要进行映射或者引用了可能需要考虑的第三方集成的 URL 的列表。您可以将这些 URL 添加到映射文件中。对于简单部署,此文件通常未包含其他 URL。如果您包含了 additionalURLFile=additionalurl.txt 参数,那么可以对此文件指定另一个名称。有关此参数的更多详细信息,请参阅用于生成服务器重命名映射文件的存储库工具命令

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

  4. 请仔细复审和编辑所生成的映射文件。请查看主机名、端口或根上下文中是否存在输入错误。服务器重命名工具无法检测到其中某些输入错误,这些错误可能会导致产品无法运行。要熟悉映射文件的结构,请参阅用于服务器重命名的映射文件
    1. 请确认帮助 WAR 文件以及要将其重命名的每个应用程序都存在一对“源/目标”。
    2. 将您要重命名的条目的 target= urls 编辑为正确的目标。
      注: 如果您要将 JTS 或者任何应用程序的端口号重命名,那么您需要在进行重命名之后(但是在重新启动服务器之前)更新应用程序服务器中的端口信息。如果您要将 JTS 或任何应用程序的上下文根重命名,请参阅更改上下文根
    3. 使用“#”将您不想重命名的任何 URL 的“源 -> 目标”对注释掉。
    4. 复审受影响的 URL 列表。虽然该命令会在部署中搜索所有已知的 URL,但可能会错过某些 URL。如果需要对其中任何受影响的 URL 进行映射,请将受影响 URL 的源/目标对取消注释,并提供新的目标 URL。如果对环境有任何疑问,请先和管理员谈一谈,然后再继续重命名。
    5. 查看 additionalurls 文件。有关详细信息,请参阅用于生成服务器重命名映射文件的存储库工具命令
    注: 在您继续真正进行重命名之前,如果对部署进行了任何配置更改,其中包括注册其他应用程序,那么您将需要重新生成此映射文件。
  5. 使用 repotools-jts -verifyURLMappings 命令来验证映射文件。
    • repotools-jts.bat -verifyURLMappings mappingFile=mappings.txt repositoryURL=<serverURL> adminUserId=<adminId> adminPassword=<adminPassword>
    • ./repotools-jts.sh -verifyURLMappings mappingFile=mappings.txt repositoryURL=<serverURL> adminUserId=<adminId> adminPassword=<adminPassword>

    有关此命令所执行的验证类型的更多详细信息,请参阅用于验证映射文件的存储库工具命令

  6. 如果您所处的情况涉及到新的硬件,请在新的计算机上安装 Rational Engineering Lifecycle Manager请勿运行 Jazz 设置向导或者启动 Jazz Team Server

下一步做什么

继续重命名服务器。有关详细信息,请参阅通过将服务器重命名来移动试验部署或完全生产部署

反馈