从 V2 手动升级到 3.0.1

本主题描述将 Rational Team Concert™ V2 手动升级到 V3.0.1 的过程。

开始之前

在升级服务器之前,请确保您有 Rational Team Concert V2 存储库数据库的最新有效备份。

请确保所有服务器上的时钟都已使用网络时间协议 (NTP) 进行同步。时间是关键元素,它使一个网络节点上的事件能够映射至另一个网络节点上的相应事件。如果要避免问题,可通过 NTP 服务的企业部署来解决这些问题。有关 NTP 的更多信息,请访问 http://www.ntp.org/。另外,所有服务器必须对其用户使用相同的认证方法。

如果对 Rational Team Concert V2 服务器使用 Derby,请确保已将存储库数据库从 RTC2.X_install_dir/server/repositoryDB 复制到 3.0.1CCM_install_dir/server/conf/jazz/derby 目录。

如果您计划升级多款产品,请参阅升级顺序以帮助您确定首先升级的产品。

过程

  1. 根据需要,查看有关计划部署和升级的部分中的主题。
  2. 验证现有的 V2 teamserver.properties 文件的公用 URL 属性 com.ibm.team.repository.server.webapp.url。

    在 V3.0.1 中,必须使用同一个公用 URL。如果尚未设置公用 URL,请先使用 V2 管理 Web 界面(高级属性)来设置限定主机名 URL (https://hostname.example.com:port),然后再执行升级。

    teamserver.properties 中的公用 URL 行应该类似于:
    com.ibm.team.repository.server.webapp.url=https\://<hostname.example.com>\:9443/jazz
  3. 关闭 V2 服务器。
  4. 如果尚未将 Jazz™ Team Server 以及“更改和配置管理”(CCM) 应用程序安装到磁盘上的新位置,请进行此安装。如果已安装 Jazz Team Server,请安装“更改和配置管理”应用程序。
  5. 在安装期间,选中使用 Rational Team Concert 2.x 上下文根以保留 /jazz 上下文根。
  6. 安装结束时,请为您要启动哪个程序选择无。
  7. 在使用与 V2 数据库相同的参数但使用不同数据库名称的情况下,为 Jazz Team Server 创建另一个数据库。有关如何创建数据库的更多信息,请参阅设置数据库。
    注: 需要一个有别于 CCM 数据库的 Jazz Team Server 数据库。如果您尚未创建新的 Jazz Team Server 数据库,请创建此数据库。
    要点: 请打开不同的命令行窗口来运行 V2 和 V3 repotools 命令。使用不同的命令行窗口可以确保 V2 命令和 V3 命令使用的环境变量之间不会发生冲突。
  8. 浏览到 <3.0.1CCM_install_dir>/server,然后运行以下命令以合并 Jazz 和 Tomcat 配置文件(包括好友)。
    repotools-jazz -migration_ccm_updateConfigurationFiles oldApplicationHome=<2.x_install_dir>/server/conf
    缺省情况下,-migration_ccm_updateConfigurationFiles 命令会同时更新 Jazz 和 Tomcat 配置文件。如果未安装 Tomcat,且您希望只更新 Jazz 配置文件,那么必须指定 updateTomcatFiles=false 参数。
    下列任务是使用 -migration_ccm_updateConfigurationFiles 命令完成的:
    • Jazz 配置文件:
      • teamserver.properties(将 1 个 Rational Team Concert 文件合并到团队服务器和应用程序的两个文件中)
      • friendsconfig.rdf(将 1 个 Rational Team Concert 文件复制到 1 个应用程序文件)
    • Tomcat 文件:
      • tomcat-users.xml(复制)
        切记: (仅限于 Tomcat 用户数据库)将复制 tomcat-users.xml 文件,而不是将其与现有文件合并。如果您正在升级多个使用公共 JTS 的 CLM 应用程序,那么必须以手动方式合并 tomcat-users.xml 文件中的用户和组信息。如果用户包含在不同应用程序中的不同组中,那么用户和组信息将有所不同。例如,userA 在 CCM 中具有 JazzAdmins 角色,但在 QM 中具有 JazzUsers 角色。另外,如果某些用户存在于一个应用程序中,但在另一个应用程序中不存在(反之亦然),那么您必须以手动方式将其添加到 tomcat-users.xml 文件。
      • server.xml(合并)
      • 应用程序 war 文件内包含的 web.xml 文件(将 1 个 Rational Team Concert 文件合并到团队服务器和应用程序的 2 个文件)
    要点: 您可能已在 Rational Team Concert V2 中修改其他文件,例如 log4j.properties 文件。您必须手动合并这些文件。

    有关 repotools 命令的详细信息,请参阅-migration_ccm_updateConfigurationFiles。

    切记: 在以下示例中,teamserver.properties 文件的位置取决于缺省安装。如果您已更改部署的文件布局,请确保您正在使用正确的位置。并且,下列步骤假定部署是在一个服务器上完成。缺省情况下,newJTSHome 参数值派生自 newApplicationHome。如果您将不同的服务器用于 CCM 和 Jazz Team Server,请指定 newJTSHome 参数以指向 Jazz Team Server 位置。这样,将从 Rational Team Concert V2 teamserver.properties 文件合并 LDAP、电子邮件和数据库位置属性。并且,Tomcat 配置文件将复制到 Jazz Team Server 位置。
  9. 确认更新后的属性文件包含以下信息:
    • 从 V2 teamserver.properties 文件复制的属性。
    • 有效的数据库供应商条目(确保 /conf/jts/teamserver.properties 中指定的数据库存在)。有关更多信息,请参阅在升级期间验证配置文件。
    • 确认已将 friendsconfig.rdf 从 <RTC2.X_install_dir>/server/conf/jazz 复制到 <3.0.1CCM_install_dir>/server/conf/jazz。
    • 确认已复制 tomcat-users.xml。
    • 打开 V3 server.xml 文件并确认此文件包含来自 V2 的信息(端口号、LDAP 设置和其他修改)。
    • 打开 V3 web.xml 文件并确认此文件包含来自 V2 的信息(LDAP 设置和其他修改)。
    • 确认 teamserver.properties 文件中存在有效且不重复的公用 URL com.ibm.team.repository.server.webapp.url。(CCM 应用程序的 URL 必须与用于 Rational Team Concert V2 的 URL 相同。)
  10. 打开命令窗口并转至 <3.0.1CCM_install_dir>/server 目录。
  11. 运行以下命令以向数据库添加表:
    repotools-jazz -addTables
  12. 运行以下命令,以便从 Rational Team Concert 数据库中导出用户信息:
    repotools-jazz -migration_exportJTSData toFile=jtsData.tar
    注: 如果您多次执行此过程,请对第二个 TAR 文件使用另一文件名。例如,使用 jtsData2.tar。
  13. 在 Jazz Team Server 所安装在的机器上,运行以下命令将用户信息导入到 Jazz Team Server 数据库中:
    注: 如果您未使用缺省的 Derby 数据库,请确保 conf/jts/teamserver.properties 文件中引用的 Jazz Team Server 数据库是新数据库且已存在。
    repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=rtc-mapping.txt createTables
    注: 如果您多次执行此过程,请对第二个 TAR 文件使用另一文件名。例如,使用 jtsData2.tar。
    注意: 在从 CCM 应用程序的第二个安装版本导入 Jazz Team Server 数据时,请勿使用 createTables 参数。如果 CLM 应用程序已安装在 Jazz Team Server 上并且您使用 createTables 参数,那么您将丢失该 Server 上的用户数据。
  14. 运行以下命令,以便将 Jazz Team Server 用户信息导入到 Rational Team Concert 数据库中:
    repotools-jazz -migration_importUserMapping fromMappingFile=rtc-mapping.txt 
  15. 运行以下命令以重建文本索引:
    repotools-jazz -rebuildTextIndices
  16. 运行以下命令以重建 Lucene 和 RDF 索引:
    repotools-jazz -reindex
  17. 如果 V2 产品使用了非缺省索引位置,并且您希望继续让索引使用定制位置,那么必须修改 V3.0.1 teamserver.properties 文件以添加索引位置。
    1. 将 com.ibm.team.fulltext.indexLocation=conf/jts/indices/workitemindex 的值更改为全文本索引的完整路径位置。例如 com.ibm.team.fulltext.indexLocation=c:/indices/workitemindex。
    2. 将 com.ibm.team.jfs.index.root.directory=indices 的值更改为 JFS 索引根目录的完整路径位置。例如 com.ibm.team.jfs.index.root.directory=c:/indices。
  18. 请验证以下内容:
    • 确保 Jazz Team Server 数据库位置与应用程序数据库位置不同。
    • 确保未在应用程序与 Jazz Team Server 之间共享索引或者其他与文件相关的属性。
    • 确保将 friendconfig.rdf 文件重命名为 friendconfig.rdf.saved。
  19. 如果是使用 Apache Tomcat,请参阅设置 Apache Tomcat。
  20. 如果是使用 WebSphere Application Server,请卸载先前安装的 Web 应用程序并重新部署 V3.0.1 安装版本随附的 jts.war、ccm.war 和 clmhelp.war。有关进一步的详细信息,请参阅设置 WebSphere Application Server 以进行 V3 升级。
  21. 对安装的服务器以及任何 CLM 应用程序进行配置。

    如果您正在随“更改和配置管理”应用程序或任何其他 CLM 应用程序一起升级 Jazz Team Server,请运行服务器设置向导。(请参阅运行设置向导)如果正在将“更改和配置管理”应用程序添加到已建立的 Jazz Team Server,请使用管理 Web 界面。(请参阅向 Jazz Team Server 注册应用程序。)

    注: jazz.net 库中有关升级 Rational Team Concert 的最新条目
父主题: 升级 Rational Team Concert
相关概念:
设置数据库
相关任务:
在升级期间验证配置文件

反馈