升级到 V3.0.1 FP 发行版

按照本主题的描述将 CLM 产品的现有 Rational® 解决方案升级到 V3.0.1 FP 发行版。

开始之前

要点:
  • 在下列示例中,3.0.1 是指 V3.0.1 服务器的安装目录,3.0.1.x 是指新的 V3.0.1 FP(3.0.1.1 或更高版本)服务器的安装目录。
  • 所有示例均适用于 Linux。对于 Windows 或其他操作系统,必须对这些示例进行相应地修改。
  • 从 3.0.1 升级到 3.0.1 FP 发行版时将使用现有 CLM 数据库。addTables 和 createWarehouse 命令会将这些数据库更新为 3.0.1.x 格式。
  • 如果您已将所有 Jazz™ 应用程序都安装在同一应用程序服务器上,那么必须将所有应用程序同时升级到 3.0.1 FP。如果您已将每个应用程序部署到不同的应用程序服务器中,那么可以单独对每个应用程序进行升级。
  • 请勿运行 jts/setup。已经设置了所有对象。请使用 jts/admin 来查看或更改设置。
  • 既提供了有关使用升级包装器脚本的指示信息,也提供了有关手动执行升级的指示信息。
父主题: 升级 Jazz Team Server 和 CLM 应用程序

从 V2 进行升级

关于此任务

有关从 V2 升级到 V3.0.1 FP 发行版的指示信息与有关从 V2 升级到 V3.0.1 的指示信息相同。有关详细信息,请参阅升级到 Rational Solution for CLM。

使用 Tomcat 从 V3.0.1 进行升级

过程

  1. 安装 CLM 3.0.1.x。请勿运行设置。 对于分布式配置,请安装与您已安装的 3.0.1 应用程序相对应的 CLM 3.0.1.x 应用程序。
    注: 您必须始终先对 Jazz Team Server 进行升级。
  2. 停止 V3.0.1 服务器。
  3. 如果您正在使用 Derby,请将 Derby 数据库从 3.0.1 迁移到 3.0.1.x:
    cp -R <3.0.1_install_dir>/server/conf/jts/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/jts/derby
    cp -R <3.0.1_install_dir>/server/conf/ccm/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/ccm/derby
    cp -R <3.0.1_install_dir>/server/conf/qm/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/qm/derby
  4. 如果您正在使用 DB2®、Oracle 或 SQL Server,请备份此数据库。
  5. 如果您正在使用升级包装器脚本,请跳到步骤 11。
  6. 保留 3.0.1 用户注册表文件。
    1. 如果您正在使用 Tomcat 用户注册表,请保留 V3.0.1 tomcat-users.xml 和 server.xml 文件:
      cp <3.0.1_install_dir>/server/tomcat/conf/tomcat-users.xml  <3.0.1.x_install_dir>/server/tomcat/conf/tomcat-users.xml
      cp <3.0.1_install_dir>/server/tomcat/conf/server.xml <3.0.1.x_install_dir>/server/tomcat/conf/server.xml
    2. 如果您正在使用 LDAP 用户注册表,请在适当的应用程序服务器上保留 3.0.1 server.xml 和 web.xml 文件:
      cp <3.0.1_install_dir>/server/tomcat/conf/server.xml <3.0.1.x_install_dir>/server/tomcat/conf/server.xml
      cp <3.0.1_install_dir>/server/tomcat/webapps/admin/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/admin/WEB-INF/web.xml
      cp <3.0.1_install_dir>/server/tomcat/webapps/jts/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/jts/WEB-INF/web.xml
      cp <3.0.1_install_dir>/server/tomcat/webapps/ccm/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/ccm/WEB-INF/web.xml
      cp <3.0.1_install_dir>/server/tomcat/webapps/qm/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/qm/WEB-INF/web.xml
      cp <3.0.1_install_dir>/server/tomcat/webapps/rm/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/rm/WEB-INF/web.xml
  7. 将 JFS/text 索引从 3.0.1 复制到 3.0.1.x。(对于分布式系统,请转至适当的服务器以复制这些文件。)
    cp -R <3.0.1_install_dir>/server/conf/jts/indices <3.0.1.x_install_dir>/server/conf/jts
    cp -R <3.0.1_install_dir>/server/conf/ccm/indices <3.0.1.x_install_dir>/server/conf/ccm
    cp -R <3.0.1_install_dir>/server/conf/qm/indices <3.0.1.x_install_dir>/server/conf/qm
  8. 将应用程序配置文件从 3.0.1 复制到 3.0.1.x。(对于分布式系统,请转至适当的服务器以复制这些文件。)
    cp <3.0.1_install_dir>/server/conf/jts/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/jts
    cp <3.0.1_install_dir>/server/conf/ccm/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/ccm
    cp <3.0.1_install_dir>/server/conf/qm/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/qm
    cp <3.0.1_install_dir>/server/conf/admin/admin.properties*  <3.0.1.x_install_dir>/server/conf/admin
    cp <3.0.1_install_dir>/server/conf/admin/friends.rdf*  <3.0.1.x_install_dir>/server/conf/admin
    cp <3.0.1_install_dir>/server/conf/rm/fronting.properties  <3.0.1.x_install_dir>/server/conf/rm
    cp <3.0.1_install_dir>/server/conf/rm/friendsconfig.rdf  <3.0.1.x_install_dir>/server/conf/rm
  9. 运行 repotools -addTables 命令以确保数据库中具有正确的表。(对于分布式系统,请转至适当的服务器并运行 repotools 命令。)
    cd <3.0.1.x_install_dir>/server
    ./repotools-jts.sh -addTables noPrompt
    ./repotools-ccm.sh -addTables noPrompt
    ./repotools-qm.sh -addTables noPrompt
  10. 如果您已配置数据仓库,请运行 repotools-jts -createWarehouse 命令以将数据仓库模式更新为 3.0.1.x 的模式。
    cd <3.0.1.x_install_dir>/server
    ./reportools-jts.sh -createWarehouse
  11. 如果您正在使用升级包装器脚本,请通过执行 cd 命令切换到 <3.0.1.x_install_dir>/server 目录。
    upgrade/jts_upgrade.sh -oldJTSHome <3.0.1_install_dir>/server/conf
    upgrade/ccm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
    upgrade/qm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
    upgrade/rm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
  12. 启动服务器。
  13. 必要时,请激活 3.0.1.x 许可证。例如,对于里程碑发行版,您必须激活随里程碑交付的“早期使用许可证”。对于 3.0.1.x 最终发行版,您可以继续使用 3.0.1 许可证。
    1. 以管理员身份登录到 3.0.1.x Jazz Team Server。
    2. 浏览到服务器管理 > 许可证密钥管理页面,并激活许可证。
    注: 您不需要在 3.0.1.x 系统上运行设置,因为已设置了所有对象。

使用 WebSphere Application Server 从 V3.0.1 进行升级

过程

注: 如果您所在的环境(例如 AIX 或 Solaris)不支持转换器,那么必须在专用转换器上安装 3.0.1.x 版本的 converter.war。有关详细信息,请参阅 Rational Requirements Composer 转换器应用程序安装。

  1. 安装 CLM 3.0.1.x。请勿运行设置。 对于分布式配置,请安装与您已安装的 3.0.1 应用程序相对应的 CLM 3.0.1.x 应用程序。
    注: 您必须始终先对 Jazz Team Server 进行升级。
  2. 备份 WebSphere® Application Server 概要文件。
    1. 打开命令提示符,并切换到 <WAS_Install>/bin 目录。例如,/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin。
    2. 请运行以下命令:
      ./backupConfig <path to a new compressed file to create back up of profile> (for example ./backupConfig /root/was_backups/clm_301_profile.zip)
      注: 如果需要,可以通过运行 ./restoreConfig 命令来复原已备份的概要文件。例如,./restoreConfig /root/was_backups/clm_301_profile.zip。
  3. 从 WebSphere Application Server 中卸载 V3.0.1 应用程序。
    1. 登录到 WebSphere Application Server Integrated Solutions Console (https://<host name>:9043/ibm/console/logon.jsp)。
    2. 单击应用程序 > 应用程序类型 > WebSphere 企业应用程序。
    3. 记下 3.0.1 应用程序 jts_war、ccm_war 和 qm_war 的安全角色映射,以帮助您在步骤 16 中为 3.0.1.x 等效件重新映射这些安全角色。
    4. 停止下列 V3.0.1 应用程序并将其卸载:jts_war、admin_war、ccm_war、qm_war、rm_war、clmhelp_war 和 converter_war。
    5. 当系统提示您时,将更改保存到主配置。
  4. 更新定制属性 JAZZ_HOME 和 log4j.configuration。
    1. 登录到 WebSphere Application Server Integrated Solutions Console (https://<host name>:9043/ibm/console/logon.jsp)。
    2. 单击服务器 > 服务器类型 > WebSphere Application Server。
    3. 单击服务器名称以将其打开。缺省服务器名称为 server1。
    4. 在“服务器基础结构”一节中,单击 Java 和过程管理 > 过程定义。
    5. 在“其他属性”下,单击 Java 虚拟机。
    6. 在“其他属性”下,单击定制属性。
    7. 单击 JAZZ_HOME 并将其值更新为 file:///<3.0.1.x_install_dir>/server/conf。例如,file:///opt/IBM/JazzTeamServer_3.0.1.x/server/conf。
    8. 单击 log4j.configuration 并将其值更新为 file:///<3.0.1.x_install_dir>/server/conf/startup_log4j.properties。例如,file:///opt/IBM/JazzTeamServer_3.0.1.x/server/conf/log4j.properties。
    9. 如果您要连接至 Oracle 或 SQL Server 数据库,请确保 ORACLE_JDBC_DRIVER_FILE 或 SQLSERVER_JDBC_DRIVER_FILE 指向正确的 JDBC 驱动程序文件。
    10. 当系统提示您时,将更改保存到主配置。
      注: 有关详细信息,请参阅设置 WebSphere Application Server。
  5. 停止 WebSphere Application Server。
  6. 从概要文件中的 wstemp 和 temp 目录下除去与 CLM 相关的内容。根据先前已安装的应用程序不同,概要文件下可能存在下列目录,可以除去这些目录:jts_war、admin_war、ccm_war、qm_war、rm_war、clmhelp_war 和 converter_war。
    <profile directory>/wstemp(例如,/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/wstemp)
    <profile directory>/temp(例如,/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)
  7. 从概要文件中的 logs 目录下除去与 CLM 相关的日志。
    <profile directory>/logs(例如,/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs)
  8. 为 CLM 3.0.1.x 应用程序准备数据库。
    1. 如果您正在使用 Derby,请将 Derby 数据库从 3.0.1 迁移到 3.0.1.x:
      cp -R <3.0.1_install_dir>/server/conf/jts/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/jts/derby
      cp -R <3.0.1_install_dir>/server/conf/ccm/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/ccm/derby
      cp -R <3.0.1_install_dir>/server/conf/qm/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/qm/derby
    2. 如果您正在使用 DB2、Oracle 或 SQL Server,请备份此数据库。
  9. 如果您正在使用升级包装器脚本,请跳到步骤 14。
  10. 将 JFS/text 索引从 3.0.1 复制到 3.0.1.x。(对于分布式系统,请转至适当的服务器以复制这些文件。)
    cp -R <3.0.1_install_dir>/server/conf/jts/indices <3.0.1.x_install_dir>/server/conf/jts
    cp -R <3.0.1_install_dir>/server/conf/ccm/indices <3.0.1.x_install_dir>/server/conf/ccm
    cp -R <3.0.1_install_dir>/server/conf/qm/indices <3.0.1.x_install_dir>/server/conf/qm
  11. 将应用程序配置文件从 V3.0.1 复制到 V3.0.1.1。(对于分布式系统,请转至适当的服务器以复制这些文件。)
    cp <3.0.1_install_dir>/server/conf/jts/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/jts
    cp <3.0.1_install_dir>/server/conf/ccm/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/ccm
    cp <3.0.1_install_dir>/server/conf/qm/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/qm
    cp <3.0.1_install_dir>/server/conf/admin/admin.properties*  <3.0.1.x_install_dir>/server/conf/admin
    cp <3.0.1_install_dir>/server/conf/admin/friends.rdf*  <3.0.1.x_install_dir>/server/conf/admin
    cp <3.0.1_install_dir>/server/conf/rm/fronting.properties  <3.0.1.x_install_dir>/server/conf/rm
    cp <3.0.1_install_dir>/server/conf/rm/friendsconfig.rdf  <3.0.1.x_install_dir>/server/conf/rm
  12. 运行 repotools -addTables 命令以确保数据库中具有正确的表。(对于分布式系统,请转至适当的服务器并运行 repotools 命令。)
    cd <3.0.1.x_install_dir>/server
    ./repotools-jts.sh -addTables noPrompt
    ./repotools-ccm.sh -addTables noPrompt
    ./repotools-qm.sh -addTables noPrompt
  13. 如果您已配置数据仓库,请运行 repotools-jts -createWarehouse 命令以将数据仓库模式更新为 3.0.1.x 的模式。
    cd <3.0.1.x_install_dir>/server
    ./reportools-jts.sh -createWarehouse
  14. 如果您正在使用升级包装器脚本,请通过执行 cd 命令切换到 <3.0.1.x_install_dir>/server 目录。
    upgrade/jts_upgrade.sh -oldJTSHome <3.0.1_install_dir>/server/conf
    upgrade/ccm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
    upgrade/qm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf)
    upgrade/rm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
  15. 启动 WebSphere Application Server。
  16. 将 3.0.1.x WAR 文件部署在 WebSphere Application Server 中。
    1. 登录到 WebSphere Application Server Integrated Solutions Console (https://<host name>:9043/ibm/console/logon.jsp)。
    2. 单击应用程序 > 应用程序类型 > WebSphere 企业应用程序。
    3. 安装 jts_war、admin_war、ccm_war、qm_war、rm_war、clmhelp_war 和 converter_war 文件。
    4. 适当地为下列应用程序映射安全角色:jts_war、ccm_war 和 qm_war。
      注: 有关详细信息,请参阅在 WebSphere Application Server 上部署 CLM 应用程序。
  17. 在“企业应用程序”页面中,启动下列应用程序:jts_war、admin_war、ccm_war、qm_war、rm_war、clmhelp_war 和 converter_war。
  18. 对 JTS、CCM 和 QM 执行服务器重置:
    https://jts_server.mydomain.com:9443/jts/admin#action=com.ibm.team.repository.admin.serverReset
    https://ccm_server.mydomain.com:9443/ccm/admin#action=com.ibm.team.repository.admin.serverReset
    https://rqm_server.mydomain.com:9443/qm/admin#action=com.ibm.team.repository.admin.serverReset
    注: 您必须重新启动服务器以使服务器重置生效。
  19. 必要时,请激活 3.0.1.x 许可证。例如,对于里程碑发行版,您必须激活随里程碑交付的“早期使用许可证”。对于 3.0.1.x 最终发行版,您可以继续使用 3.0.1 许可证。
    1. 以管理员身份登录到 3.0.1.x Jazz Team Server。
    2. 浏览到服务器管理 > 许可证密钥管理页面,并激活许可证。
    注: 您不需要在 3.0.1.x 系统上运行设置,因为已设置了所有对象。
    注: 有关升级过程的最新信息,请参阅 CLM 升级知识收集。

反馈