使用生产数据设置测试登台环境

本主题描述如何使用服务器重命名功能通过实际生产数据来准备登台环境。登台环境是与生产环境隔离的测试沙箱。可以使用登台环境利用实际数据来试用新的功能特性或功能,而不会影响生产数据库。

关于此任务

要点: 无法使用此过程将您所在环境从更低发行版进行升级。只有在 V4 和更高发行版中才支持服务器重命名功能,因此,必须至少升级到 V4 才能使用服务器重命名功能来设置登台环境。

服务器重命名功能使用映射文件来确定应重命名的 URL。提供了 repotools 命令为您生成初始映射文件。此映射文件包含 Jazz™ Team Server 和所有应用程序的“源/目标”对以及应用程序提供的任何其他 URL。有关此映射文件的更多详细信息,请参阅了解服务器重命名所使用的映射文件。请参阅用于设置测试登台环境的拓扑和映射文件,以获取样本拓扑图和映射文件。

规划登台环境时,您需要特别谨慎,请勿破坏生产数据,反之亦然。这可以通过两种方式来实现:一种方式是将条目添加至 hosts 文件(如果您所在环境允许这样做);另一种方式是创建映射以屏蔽您的登台环境中不存在的服务器。务必将任何其他可能已连接至生产服务器的 CLM 服务器或者非 CLM 产品包括在此映射中。有关详细信息,请参阅步骤 3.c 以及登台环境的伪映射。

例如,您可能在一个生产服务器中安装了“变更和配置管理”(CCM) 应用程序,此应用程序链接至另一个生产服务器中的 CCM,并且还链接至另一个生产服务器中的“质量管理”(QM)。此外,您可能与非 CLM 产品(例如,Rational® ClearQuest®)进行了集成。在这种情况下,您首先应屏蔽另外的 CCM 服务器和 QM 服务器的 URL,并确保还要屏蔽 Rational ClearQuest 的 URL 或者将此 URL 映射至已登台的 Rational ClearQuest 网关服务器。

要点: 请勿将 Rational Team Concert 客户机连接至生产存储库,也不要连接至登台存储库。始终使用登台工作空间来连接至登台服务器。

下图显示使用服务器重命名来设置登台环境时需要执行的主要步骤。假定已经安装了最新版本的 CLM (V4) 和 RRDI (V2)。

从生产环境到登台环境的方案

过程

  1. 请遵循准备映射文件主题中所描述的步骤来准备进行重命名。

    务必为此映射文件中任何受影响的 URL 创建伪映射。这样做是为了避免登台环境与生产环境之间进行交叉链接。有关详细信息,请参阅登台环境的伪映射。

    完成准备阶段之后,最终结果是在原始的源 Jazz Team Server 上生成一个映射文件。在仔细复查和编辑此映射文件之后,将其复制到登台环境中的目标 Jazz Team Server 上的 JazzInstallDir\server 目录。

  2. 备份 V4 生产环境,并将文本索引和应用程序配置文件复制到目标登台服务器。

    因为您在执行这些步骤时需要停止生产服务器,所以务必选择在方便的时间执行备份,在设置登台环境之前可能更合适。在您继续真正进行重命名之前,如果对生产环境进行了任何更改,那么您在将此映射文件导入到登台服务器之前需要重新生成此映射文件。在服务器已当机的情况下,用户将无法创建或遍历与任何已与要重命名的 CLM 部署进行集成的外部系统的链接。

    1. 停止生产环境中的 Jazz Team Server 以及任何已向 Jazz Team Server 注册的分布式 CLM 应用程序。
    2. 备份 CLM 4.0 生产环境中的所有数据库,其中包括 Jazz Team Server 数据库、CCM 和 QM 应用程序的数据库、数据仓库数据库以及 RRDI 内容存储库数据库。遵循移动 CLM 数据库中的步骤将数据库从生产环境复制到登台环境。
    3. 将 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
    4. 将应用程序配置文件从源生产服务器复制到目标登台服务器。(对于分布式系统,请转至适当的服务器以复制这些文件。)与前一步骤一样,针对 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
    5. 将此映射文件复制到生产服务器上的 TargetJazzInstallDir\server 目录。有关此映射文件的详细信息,请参阅准备映射文件。
      注: 在您执行下一步骤之前,如果对 CLM 部署进行了任何配置更改,那么您将需要重新生成此映射文件。
    6. 重新启动所有 CLM 服务器,并允许用户继续使用此生产环境。其余步骤全部适用于登台测试环境。
  3. 在登台测试环境中执行下列步骤:
    1. 将数据库备份从生产环境恢复到登台环境。建议您在登台环境中使用单独的数据库服务器,以避免增大生产数据库服务器的压力。
    2. 请替换 JazzInstallDir/server/conf/applicationName/teamserver.properties 文件中的数据库连接参数,以使它们指向测试环境中的数据库登台副本的连接参数。这些参数包括 jts 数据库、ccm 和 qm 应用程序数据库、数据仓库数据库以及更新后的密码的条目。
    3. 作为对于映射文件中的伪映射的另外一项预防措施,如果您所在环境允许采取此预防措施,请更新 hosts 文件以阻止访问生产系统 URL,还可以阻止意外编辑生产服务器中的工件。

      此处的目标是将主机名解析为生产环境中的任何 CLM 服务器都未使用的假 IP 地址。因此,如果登台环境中的服务器试图与生产服务器建立连接,那么连接将失败。

      生成映射文件中出现的所有相异主机名的列表。这些主机名可能是源 URL,也可能是受影响的 URL。对于每个单独的主机名,请在 hosts 文件中创建一个将此主机名映射至某个假 IP 地址的条目。您需要编辑登台环境中的所有服务器(其中包括第三方服务器和客户机工作站)的 hosts 文件。以下 hosts 文件显示了登台服务器的样本条目:

       # 10.10.10.10 refers to an IP address that does not host a clm application. 
        10.10.10.10   ProductionServerP1
        10.10.10.10   ProductionServerP2
        10.10.10.10   ProductionServerP3
    4. 在 JazzInstallDir\server 目录中打开命令提示符,使用 repotools-jts -importURLMappings 命令将此映射文件导入到目标 Jazz Team Server 中。
      • 如果您具有一体式部署,请使用 repotools-jts -importURLMappings 命令按如下所示导入此映射文件:

        For Windows operating system repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="opt/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 命令。

        For Windows operating system repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt" serverConfFile="C:\serverConf.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="/opt/mappings.txt" serverConfFile="/opt/serverConf.txt"

      • 如果您具有分布式 CLM 部署,但是不允许您重新映射网络驱动器,那么按如下所示继续运行 repotools-jts -importURLMappings 命令:

        For Windows operating system repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="opt/mappings.txt"

        然后,将 server/conf/jts/.mappingEvent 文件复制到远程应用程序配置目录 (server/conf/application_name),即 ccm、qm 和 rm。您必须在导入映射文件之后(但是要在启动服务器之前)复制 .mappingEvent 文件。

        .mappingEvent 文件中包含应用程序在其新位置与 Jazz Team Server 联系时所需要的信息。对于所给定的 Jazz Team Server 及其已注册的应用程序,.mappingEvent 文件的内容相同。

      通过检查控制台输出和 server/repotools-jts_importURLMappings.log 文件来确认已成功进行重命名。如果显示了任何错误,或者您认识到自己在映射文件中犯错,请参阅对服务器重命名进行故障诊断以准确找出问题并加以解决。

      注: 对于在 z/OS® 上运行的服务器,应使用样本 JCL 成员 HLQ.SBLZSAMP(BLZRENAM) 将其重命名。请参阅 BLZRENAM 的注释头以了解详细的定制指示信息。
  4. 启动 Jazz Team Server 以及任何已向 Jazz Team Server 注册的分布式 CLM 应用程序。

    此时,CLM 应用程序将与 Jazz Team Server 同步,以应用 URL 映射并更新这些 CLM 应用程序的数据仓库数据。对于小型数据集,完成此操作可能要耗用 5 分钟;而对于非常大的数据集,可能要耗用多达 30 分钟甚至更长时间。

  5. 登录到 Jazz Team Server (https://new host:port/jts/serverRenameStatus) 以验证重命名操作的状态。

    一直等到所有应用程序重命名都已完成,并且“完成服务器重命名”步骤也已完成。请确认显示了以下消息:已成功完成服务器重命名。Jazz Team Server 和应用程序完全可运行。您可以立即开始使用服务器,无需重新启动。

    如果显示了任何错误,请参阅对服务器重命名进行故障诊断以准确找出问题并加以解决。

    注: 完成重命名之前,只要尝试登录到任何 CLM 应用程序的 Web UI,都会将您重定向到此状态页面。
  6. 执行验证服务器重命名中所描述的服务器重命名验证步骤。
    注: 如果您引入了伪映射来保护生产环境,那么您在已登台服务器上的“应用程序诊断”页面的应用程序和好友部分应当看到有关这些 URL 的错误。
  7. 可选:请执行下列步骤以在登台环境中配置 Rational Reporting for Development Intelligence (RRDI):
    1. 从生产环境中备份下列数据库,然后在新的数据库服务器上将它们复原,以便在登台环境中新安装 RRDI:
      • 内容存储库数据库(例如,RICM)
      • 数据仓库(例如,RIDW,如果尚未对其进行备份和复原)。
    2. 在登台环境中安装 Rational Reporting for Development Intelligence V2.0。有关详细信息,请参阅使用 Installation Manager 安装 Rational Reporting for Development Intelligence。
    3. 通过运行“RRDI 安装”应用程序来配置报告服务器。有关详细信息,请参阅安装后任务。请记住执行下列操作:
      • 在配置内容存储库数据库页面中,指定您在步骤 7.a 中已复原的内容存储库数据库(例如,RICM)的连接属性。
      • 在配置数据仓库页面中,指定您在步骤 7.a 中已复原的数据仓库数据库(例如,RIDW)的连接属性。
    4. 登录到 Jazz Team Server,并将存储在 Jazz Team Server 的高级属性以及 CCM 和 QM“管理”页面中的报告服务器 URL 更新为指向已登台的 RRDI 报告服务器。
      注: 仅当映射文件中缺少 RRDI 的 URL 时才需要执行此步骤。
    5. 请确认先前从生产 RRDI 报告服务器中导入的所有报告继续有效。
    6. 在进行 CLM 服务器重命名之后,将操作设置为查看最新报告的任何 Cognos 报告或报告视图都必须重新运行,以便更新已高速缓存的 HTML 报告。
      1. 登录到 RRDI 报告服务器。
      2. 查找具有已高速缓存的输出版本的报告或报告视图。
        注: 如果某个报告或报告视图存在已高速缓存的输出版本,那么您可以对此报告单击查看输出版本以查看已高速缓存的报告。如果报告或报告视图在进行 CLM 服务器重命名之前就已生成,那么必须重新运行这些报告或报告视图以对其进行更新。否则,运行这些报告或报告视图的用户仍将看到指向旧的 CLM 服务器的旧链接。
      3. 单击使用选项来运行以重新运行这些报告或报告视图。
      4. 在报告查看器中,单击保持此版本 > 保存报告,以更新与这些报告或报告视图相关联并且已高速缓存的输出版本。
    7. 从已登台的 RRDI 报告服务器中导入新报告。请确认已成功导入,并且已导入的报告在运行时未发生任何问题。
    8. 如果您在 RRDI 中已配置 Rational Quality Manager 实时报告,请遵循相应的步骤以对新服务器生成 xdc 文件并在 32 位 ODBC 管理器中配置此文件。有关详细信息,请参阅设置实时报告。
  8. 如果您要在登台环境中包括其他组件(例如,Jazz Build Engine、Rational Team Concert 客户机、Rational ClearQuest 或 Rational ClearCase),请执行任何其他必需的步骤。有关详细信息,请参阅限制和其他信息。

反馈