在 Tomcat 上从先前版本升级

使用此指导在 Apache Tomcat 上从早期版本的 IBM® Rational® Asset Manager 升级。

开始之前

要点: 如果从 Rational Asset Manager V7.1.1.1 或更低版本升级,那么必须安装 IBM Rational Team Concert,它需要一个附加数据库和一个安全证书用于 Tomcat 服务器。

您必须升级许可证服务器并请求获取已更新的许可证密钥。有关 Rational License Server 必需版本的更多信息,请参阅安装 Rational License Key Server

您可能还必须停止并重新启动应用程序服务器几次。

可以通过将 Rational Asset Manager 的 Web 应用程序和包含的 IBM Rational Team Concert 的应用程序文件安装在单独的 Tomcat 服务器上来改善 Rational Asset Manager 的性能和稳定性。在本文档中,Rational Asset Manager 的 Tomcat 服务器的安装目录为 tomcat_install_directoryRational Team Concert 的 Tomcat 服务器的安装目录为 tomcat_for_rtc_install_directory。 如果将所有 Web 应用程序安装在同一 Tomcat 服务器上,那么目录相同。

关于此任务

此大纲显示为升级到 Rational Asset Manager 的最新版本必须执行的操作:
  1. 准备升级并备份重要文件和数据库:步骤 14
  2. 检索最新版本的 Rational Asset Manager 的应用程序文件:步骤 5
  3. 如果是从 V7.1.1.1 或更早版本升级,请另外创建一个数据库:步骤 6
  4. 关闭 Tomcat 服务器:步骤 7
  5. 将许可证服务器升级至 Rational Common Licensing 8.1.2:步骤 8
  6. 为 Rational Asset Manager 和 Rational Common Licensing 8.1.2 复制新共享库文件,并相应修改 Tomcat 服务器启动文件:步骤 911
  7. 配置 Tomcat 服务器以实现单点登录:步骤 12
  8. 检索包含的 Rational Team Concert 的当前应用程序文件:步骤 1314
  9. 如果是从 V7.1.1.1 或更早版本升级并且需要 Rational Team Concert,请在应用程序服务器上安装 Rational Team Concert:步骤 1724
  10. 如果是从 V7.1.1.1 或更早版本升级,请配置 Rational Team Concert:步骤 2531
  11. 如果是从 V7.2 或更高版本升级,请升级包含的 Rational Team Concert:步骤 33
  12. 除去 Rational Asset Manager 的现有应用程序文件并安装新版本的应用程序:步骤 3439
  13. 登录到 Rational Asset Manager 并迁移存储库:步骤 40
  14. 如果是从 V7.1.1.1 或更早版本升级,请将 Rational Asset Manager 配置为连接到 Rational Team Concert:步骤 42
  15. 将设置修改为连接到新 Rational Common Licensing 服务器:步骤 43
  16. 升级任何 Eclipse 客户机:步骤 44

过程

  1. 在升级之前,请按照创建 Rational Asset Manager 存储库的备份中的指示信息创建存储库、数据库、资产文件和应用程序服务器设置的完全备份。
  2. 如果已修改了主题或电子邮件消息,那么在更新 Rational Asset Manager 服务器之前,请下载当前主题和邮件消息文件(在管理 > 工具页面上),然后在更新服务器之后,重新应用该主题和消息。有关更多信息,请参阅迁移主题
  3. 验证所有存储库服务器是否都已设置为相同的当前日期、时间和时区。
  4. 如果使用的是 Rational Asset Manager V7.0.0.2 或更低版本,请验证是否已启用作业服务器。 启用作业服务器:
    1. 作为存储库管理员登录 Rational Asset Manager Web 客户机。
    2. 单击管理
    3. 在“存储库管理”边栏中,单击工具
    4. 在浏览器的地址栏中,将 tools.faces 替换为 advancedConfiguration.faces 然后转到该地址。例如,http://example.com:9080/com.ibm.ram.repository.web/admin/repository/advancedConfiguration.faces
    5. 在“高级设置”页面的“作业选项”部分中,选择启用作业服务器
    6. 单击保存
    7. 重新启动应用程序服务器。
  5. Tomcat 和您操作系统的相应归档上检索应用程序文件。应用程序文件在 archive_extract_location/apps/tomcat/ 文件夹中。
  6. 如果是从 V7.1.1.1 或更低版本升级:创建用于资产生命周期的数据库:
  7. 停止一台或多台 Tomcat 服务器。 您的存储库以及服务器上的任何其他应用程序都将脱机。
  8. 对于 Windows:对于 Linux:对于 AIX: 将 Rational Licensing Server 迁移至 Rational Common Licensing V8.1.2 或更高版本。 有关更多信息,请参阅 Migrating from Rational Licensing Server v7.1.x or earlier to Rational Common Licensing

    Rational License Key Server 包含在 Rational Asset Manager 安装介质中。您还可以通过您的 Passport Advantage 帐户或通过 Rational 下载中心来检索 Rational License Server 的最新版本。

    此过程要求您关闭使用 Rational Licensing Server 的所有应用程序,卸载现有 Rational Licensing Server,更新许可证文件以及安装 Rational Common Licensing 服务器。对于 Windows®,请参阅 Configuring a license server for Windows;对于 AIX® 或 Linux®,请参阅 Configuring a license server for UNIX®

    对于 Linux for zSeries®,请继续使用 Rational License Server for UNIX and Linux 7.0.0.1。
  9. 将共享库文件解压缩到 Tomcat 服务器的 \shared\lib 文件夹:
    1. 查找并解压缩 archive_extract_location\apps\tomcat\sharedLib.zip 文件。
    2. 将解压缩的 sharedLib.zip 文件的全部内容复制到 tomcat_install_directory\shared\lib 目录。
  10. 对于 Windows: 对于 Linux:对于 AIX: 将 Rational Licensing Key Server V8.1.2 的库文件解压缩到 tomcat_install_directory\shared\lib 文件夹:
    要点: 如果要在 Linux for zSeries 上进行安装,那么请勿完成此步骤
    1. 找到并解压缩 archive_extract_location\sharedLibs\rlsclients_rlsibmratl_812.zip 文件。
    2. 从已解压的 .zip 文件中,找到与您的操作系统和体系结构对应的文件 rlsibmratl812.zip。例如,32 位 Windows 的文件位于 win32 目录中。
    3. 解压缩相应的 rlsibmratl812.zip 文件的内容。
    4. 将解压缩的 rlsibmratl812.zip 文件的全部内容复制到 tomcat_install_directory\shared\lib 目录。
  11. 对于 Windows:对于 Linux:对于 AIX: 修改 Rational Asset Manager 的 Tomcat 服务器的启动脚本
    1. 查找 Tomcat 启动文件并在文本编辑器中将其打开。在 Windows 上,该文件是 tomcat_install_directory\bin\startup.bat。 在 Linux、AIX 或 Linux for zSeries,此为 tomcat_install_directory/bin/startup.sh
    2. 搜索包含 JAVA_OPTS= 的行。
      • 如果已经设置 JAVA_OPTS 环境变量,请添加以下选项和值:
        • 对于 Windows:
          -Djava.library.path="tomcat_install_directory\shared\lib"
        • 对于 Linux:对于 AIX:
          -Djava.library.path=tomcat_install_directory/shared/lib
      • 如果未设置 JAVA_OPTS 环境变量,请输入以下文本:
        • 对于 Windows:
          set JAVA_OPTS=-Djava.library.path="tomcat_install_directory\shared\lib"
        • 对于 Linux:对于 AIX:
          export JAVA_OPTS="-Djava.library.path=tomcat_install_directory/shared/lib"
  12. 配置 Tomcat 服务器以实现对所有应用程序的单点登录:
    1. 在文本编辑器中,打开 tomcat_install_directory\conf\server.xml 文件。
    2. 搜索以下文本:
      <!--
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
      -->
    3. <Valve> 元素取消注释:
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
  13. 在安装介质上,查找 archive_extract_location/apps/tomcat/RTC-server.zip 文件。
  14. RTC-server.zip 解压缩到硬盘驱动器上的位置,在这些指示信息中,此位置为 rtc_install_dir
  15. 根据您的情境,安装并配置 Rational Team Concert,或者将其更新:
    • 如果从 V7.1.1.1 或更低版本升级:安装并配置所包含的 Rational Team Concert。 请继续到步骤 16
    • 如果从 V7.2 或更高版本升级:更新包含的 Rational Team Concert。 请继续到步骤 33
  16. 根据您的情境,安装并配置 Rational Team Concert,或者仅对其进行配置:
    • 如果需要安装并配置 Rational Team Concert:继续执行步骤 17
    • 如果您具有现有 Rational Team Concert 应用程序并希望将其配置为与 Rational Asset Manager 一起使用:继续执行步骤 25
  17. 查找 rtc_install_dir/jazz/server/ramjazz_war.ear 文件并将其解压缩。要解压缩 .ear 文件,您可以使用免费实用程序(例如 7-Zip)。从解压缩的 ramjazz_war.ear 软件包中,将 ramjazz.war 文件复制到 tomcat_for_rtc_install_directory/webapps/ 目录。
  18. Rational Team Concert 的 Tomcat 服务器上配置安全端口:
    1. 创建安全性证书,此证书为 SSL 连接的 Rational Team Concert 标识 Tomcat 服务器。可以使用 Java™ JDK keytool 命令来创建自签名证书。或者,可以请求由可信的认证中心签署的证书。
      有关以 keytool 命令创建自签名证书的更多信息,请参阅 Oracle Java 文档。 可以用以下示例 keytool 命令创建自签名证书:
      keytool -genkey -alias tomcat -keystore tomcat_for_rtc_install_directory/.keystore

      运行该命令时,将提示您输入密钥库文件的密码。缺省密码为 changeit,但是您应该指定不同的密码。您必须记住该密码,在以后将其输入 server.xml 文件。

      如果在使用 IBM JRE,那么许多版本将 IBM 工具 ikeyman 包含在 IBM_Java_JRE_install_location/jre/bin/ 目录中。 可以使用此工具在服务器上创建和管理安全证书。有关使用 iKeyman 工具的更多信息,请参阅 iKeyman User's Guide

      此外,在 rtc_install_dir/jazz/server/ 文件夹中还包含简单证书;证书文件为 ibm-team-ssl.keystore

    2. tomcat_for_rtc_install_directory\conf\server.xml 文件中,查找带有属性 scheme="https"<Connector> 标记。 缺省文件包括已注释掉的端口 8443 的示例 <Connector> 标记。
    3. 复制并粘贴以下文本:
      <Connector port="8443"
           maxHttpHeaderSize="8192" 
           maxThreads="150"
           minSpareThreads="25" 
           maxSpareThreads="75"
           enableLookups="false"
           disableUploadTimeout="true" 
      connectionTimeout="20000"
           acceptCount="100"
           scheme="https"
           secure="true" 
           clientAuth="false"
           keystoreFile="keystore_file"
           keystorePass="keystore_password"
           sslProtocol="keystore_protocol"
           algorithm="keystore_algorithm"
           URIEncoding="UTF-8"
      />
      其中:
      • keystore_file 是密钥库文件的文件名。它可以是绝对路径,也可以是相对于 Tomcat 服务器根目录 (tomcat_for_rtc_install_directory) 的相对路径。如果使用了以上的简单命令,这将是 .keystore。如果使用包含的证书,那么这将是 rtc_install_dir/jazz/server/ibm-team-ssl.keystore
      • keystore_password 是密钥库文件的密码。如果使用包含的密钥库文件,那么这是 ibm-team
      • keystore_protocol 是密钥库的协议。它最可能是 TLSSSL_TLS。如果使用包含的密钥库文件,那么这是 SSL_TLS
      • keystore_algorithm 是密钥库的 X509 算法。它最可能是 SunX509IbmX509,取决于证书来源。如果使用包含的密钥库文件,那么这是 IbmX509
    4. 可以更改端口值以将 8443 以外的端口用于非 SSL 连接器(缺省情况下,为端口 8080)。如果更改端口值,请更改 redirectPort 属性的值以匹配 SSL 连接器的端口号。

    有关为 Tomcat 配置 SSL 的更多信息,请参阅 Apache Tomcat 5.5 SSL Configuration HOW-TOApache Tomcat Configuration reference

  19. 对于 Oracle:对于 Microsoft SQL Server: 复制来自数据库供应商的相应 .jar 文件:
    • 对于 Oracle:ojdbc14.jar 文件复制到 rtc_install_dir/jazz/server/oracle 文件夹(您可能需要创建 oracle 文件夹)。

      您可以从 Oracle 下载该文件。如果使用的是 Oracle 11,请下载 Oracle 10g 软件包以查找 ojdbc14.jar 文件。

    • 对于 Microsoft SQL Server: 将以下文件复制到 rtc_install_dir/jazz/server/sqlserver 文件夹(您可能需要创建 sqlserver 文件夹):
  20. 配置 Tomcat 启动属性设置:
    1. 查找 Tomcat 启动文件并在文本编辑器中将其打开。在 Windows 上,该文件是 tomcat_for_rtc_install_directory\bin\startup.bat。 在 Linux、AIX 或 Linux for zSeries 上,该文件为 tomcat_for_rtc_install_directory/bin/startup.sh
    2. 在启动文件中,输入以下文本:
      • 对于 Windows:rtc_install_dir 中的每个空格字符替换为 %20
        set ORACLE_JDBC=oracle_jar_dir
        set SQLSERVER_JDBC=sqlServer_jar_dir
        set JAZZ_INSTALL_DIR=rtc_install_dir
        set JAVA_OPTS=-Djava.awt.headless=true -Djava.library.path="tomcat_for_rtc_install_directory\shared\lib" -DSQLSERVER_JDBC="%SQLSERVER_JDBC%" -DORACLE_JDBC="%ORACLE_JDBC%" -DDB2I_JDBC="%DB2I_JDBC%" -DDB2Z_JDBC="%DB2Z_JDBC%" -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -DJAZZ_HOME=file:///%JAZZ_INSTALL_DIR%\jazz\server\conf -Dcom.ibm.team.repository.tempDir=%TEMP% -Xmx700M
      • 对于 Linux:对于 AIX:对于 Linux for zSeries:
        ORACLE_JDBC=oracle_jar_dir
        SQLSERVER_JDBC=sqlServer_jar_dir
        JAZZ_INSTALL_DIR=rtc_install_dir
        export JAVA_OPTS="-Djava.awt.headless=true -Djava.library.path=tomcat_for_rtc_install_directory/shared/lib -DSQLSERVER_JDBC=$SQLSERVER_JDBC -DORACLE_JDBC=$ORACLE_JDBC -DDB2I_JDBC=$DB2I_JDBC -DDB2Z_JDBC=$DB2Z_JDBC -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -DJAZZ_HOME=file://"$JAZZ_INSTALL_DIR"/jazz/server/conf -Dcom.ibm.team.repository.tempDir=$TEMP_DIR -Xmx700M"
      其中:
      • rtc_install_dirRTC-server.zip 文件的解压缩目录。 在 Windows 上,将 rtc_install_dir 中的每个空格字符替换为 %20
      • 对于 Oracle: oracle_jar_dirojdbc14.jar 文件的目录 (rtc_install_dir/jazz/server/oracle)
      • 对于 Microsoft SQL Server: sqlServer_jar_dirsqljdbc.jar 文件的目录 (rtc_install_dir/jazz/server/sqlserver)
      • tomcat_for_rtc_install_directory 是 Tomcat 服务器的安装目录
      • 对于 Windows: 对于 Linux:对于 AIX: 如果在同一应用程序服务器上安装 Rational Asset ManagerRational Team Concert,请使用此 JAVA_OPTS 系统变量来替换在配置 Rational Asset Manager 的 Tomcat 服务器的启动脚本时创建的系统变量;该声明仍然包含 -Djava.library.path 选项。
  21. 查找并重命名相应的 Jazz™ 服务器属性文件:
    1. rtc_install_dir/jazz/server/conf/ramjazz/ 目录中,查找 teamserver.properties 文件并将其重命名为 teamserver.derby.properties
    2. 查找适用于您的数据库服务器的文件:
      • 对于 DB2:对于 Windows:对于 Windows 上的 DB2:teamserver.db2.win32.properties
      • 对于 DB2:对于 Linux:对于 AIX:对于 Linux for zSeries:对于 Linux、AIX 或 Linux for zSeries 上的 DB2:teamserver.db2.linux.properties
      • 对于 Oracle: teamserver.oracle.properties
      • 对于 SQL Server: teamserver.sqlserver.properties
    3. 将文件重命名为 teamserver.properties
  22. 在文本编辑器中,打开 teamserver.properties 文件,然后按以下方式进行修改(对于数据库供应商):
    • 对于 DB2:
      1. 查找以下行:
        com.ibm.team.repository.db.vendor = DB2
        com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
        com.ibm.team.repository.db.jdbc.password=db2admin
      2. 针对生命周期数据库的 DB2 服务器位置和名称,编辑 com.ibm.team.repository.db.jdbc.location 的值:
        1. localhost:50000 替换为 DB2 数据库的位置和端口。
          提示: 在 DB2 命令窗口中,输入 db2 get dbm cfg,然后查找包含 SVCENAME(它指示 DB2 端口名称或端口号)的行。如果该命令显示数字,请将其用作端口号(替换较早示例中的 50000)。如果该命令返回了一个非数字名称,请确定为此名称分配的端口号并使用该端口号。在 Linux 上,/etc/services 文件包含端口名称与端口号之间的映射;在 Windows 上,C:\windows\system32\drivers\etc\services 文件包含映射。有关更多信息,请咨询您的系统管理员或查阅数据库文档。
        2. 将 JAZZ 替换为生命周期的数据库的名称。
        3. 将 db2admin 替换为 DB2 数据库的用户名。
          注: DB2 用户必须具有创建表和表空间以及修改数据库配置的许可权。DB2 用户由操作系统创建。
      3. com.ibm.team.repository.db.jdbc.password 属性中,指定用户密码。
        注: 切勿更改 com.ibm.team.repository.db.jdbc.location 属性中的文本 {password}
      4. teamserver.properties 文件中,添加以下属性:
        其中:
        • unsecure_port 是 Tomcat 服务器的非安全端口(缺省情况下为 8080)
        • secure_port 是 Tomcat 服务器的安全端口号(缺省情况下为 8443)
        • team_temp_dir 是用于存储临时文件的目录的绝对路径
        com.ibm.team.scm.tmpdir=team_temp_dir
        com.ibm.team.repository.server.repourl.port.http=unsecure_port
        com.ibm.team.repository.user.registry.type=UNSUPPORTED
        com.ibm.team.repository.ws.allow.admin.access=false
        com.ibm.team.repository.server.repourl.port.https=secure_port
    • 对于 Oracle:
      1. 查找以下行:
        com.ibm.team.repository.db.vendor = ORACLE
        com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
        com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      2. 针对生命周期数据库的 Oracle 服务器位置和名称,编辑 com.ibm.team.repository.db.jdbc.location 的值:
        1. jazzDBUser 替换为 Oracle 数据库的用户名(例如,RAMSCHEMA)。
        2. @localhost:1521 替换为 Oracle 数据库的位置和端口。如果位置不是 localhost,那么必须将位置替换为两个正斜杠(//);例如,@//oracleserver.example.com:1521
        3. ORCL 替换为生命周期数据库的名称;例如,rtcdb
      3. com.ibm.team.repository.db.jdbc.password 属性中,将 JazzDBpswd 替换为您先前指定的 Oracle 用户的密码。
        注: 请勿更改 com.ibm.team.repository.db.jdbc.location 属性中的 {password} 文本。
      4. teamserver.properties 文件中,添加以下属性:
        其中:
        • unsecure_port 是 Tomcat 服务器的非安全端口(缺省情况下为 8080)
        • secure_port 是 Tomcat 服务器的安全端口号(缺省情况下为 8443)
        • team_temp_dir 是用于存储临时文件的目录的绝对路径
        com.ibm.team.scm.tmpdir=team_temp_dir
        com.ibm.team.repository.server.repourl.port.http=unsecure_port
        com.ibm.team.repository.user.registry.type=UNSUPPORTED
        com.ibm.team.repository.ws.allow.admin.access=false
        com.ibm.team.repository.server.repourl.port.https=secure_port
      5. 如果使用的是 Oracle 11:请在 teamserver.properties 文件中添加以下属性:
        com.ibm.team.repository.db.override.versioncheck=true
    • 对于 Microsoft SQL Server:
      1. 查找以下行:
        com.ibm.team.repository.db.vendor = SQLSERVER
        com.ibm.team.repository.db.jdbc.location=//localhost:1433;databaseName=jazz;user=jazzDBuser;password={password}
        com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      2. 针对生命周期数据库的 SQL Server 位置和名称,编辑 com.ibm.team.repository.db.jdbc.location 的值:
        1. @localhost:1433 替换为 SQL Server 数据库的位置和端口。
        2. jazz 替换为生命周期数据库的名称;例如,RTCDB
        3. jazzDBUser 替换为 SQL Server 数据库的用户名。
      3. com.ibm.team.repository.db.jdbc.password 属性中,将 JazzDBpswd 替换为您先前指定的 SQL Server 用户的密码。
        注: 请勿更改 com.ibm.team.repository.db.jdbc.location 属性中的 {password} 文本。
      4. teamserver.properties 文件中,添加以下属性:
        其中:
        • unsecure_port 是 Tomcat 服务器的非安全端口(缺省情况下为 8080)
        • secure_port 是 Tomcat 服务器的安全端口号(缺省情况下为 8443)
        • team_temp_dir 是用于存储临时文件的目录的绝对路径
        com.ibm.team.scm.tmpdir=team_temp_dir
        com.ibm.team.repository.server.repourl.port.http=unsecure_port
        com.ibm.team.repository.user.registry.type=UNSUPPORTED
        com.ibm.team.repository.ws.allow.admin.access=false
        com.ibm.team.repository.server.repourl.port.https=secure_port
  23. Rational Team Concert 创建表:
    1. 打开命令行窗口,然后浏览至 rtc_install_dir/jazz/server/ 目录。
    2. 输入以下命令:
      • 对于 Windows:
        repotools.bat -createTables teamserver.properties=conf\jazz\teamserver.properties
      • 对于 Linux:对于 AIX:对于 Linux for zSeries:
        ./repotools.sh -createTables teamserver.properties=conf/jazz/teamserver.properties
  24. 为包含的 Rational Team Concert 配置用户权限。
    • 对于基于文件的安全性:
      1. 在文本编辑器中,打开 tomcat_for_rtc_install_directory\conf\tomcat-users.xml 文件。
      2. <tomcat-users> 标记之间,粘贴以下文本:
        <role rolename="JazzUsers"/>
        <role rolename="JazzAdmins"/>
        <role rolename="JazzDWAdmins"/>
        <role rolename="JazzGuests"/>
      3. 添加名为 admin 的用户并向该用户分配 admin、manager 和 JazzAdmins 角色。要添加该用户,可以在 <tomcat-users> 标记之间复制并粘贴以下文本:
        <user username="admin" password="" roles="admin,manager,JazzAdmins" />

        如果在同一 Tomcat 服务器上安装应用程序,请将 JazzAdmins 角色添加到现有 admin 用户。

    • 对于 LDAP 认证:为 LDAP 认证配置 Tomcat 服务器,然后使用与先前提及的四个角色相同的名称来配置四个 LDAP 组。或者,也可以如技术提示 TN0030: User Management in Tomcat 中所述,将现有 LDAP 组与 Jazz 服务器角色关联。 遵循主题 将 Tomcat 上的 Rational Team Concert 配置为使用 LDAP 部分中的步骤 2-3
  25. 启动 Rational Team Concert 的 Tomcat 服务器。
    要启动 Tomcat,请运行以下文件:
    • 对于 Windows:tomcat_for_rtc_install_directory\bin\startup.bat
    • 对于 Linux:对于 AIX:对于 Linux for zSeries:tomcat_for_rtc_install_directory/bin/startup.sh
  26. 在 Web 浏览器中启动 Rational Team Concert 的管理 Web 界面,地址如下:https://machine_name:secure_port/jazz/admin/ 请注意 https;连接必须安全。
  27. Rational Team Concert 的管理员用户标识和密码登录。 如果之前没有人登录 Rational Team Concert,请使用应用程序服务器的管理员用户标识和密码。
  28. 如果在处理 Rational Team Concert 的新安装:配置 Rational Team Concert 的管理用户:
    1. 如果您看到有关“正在访存服务器状态信息”的错误,请关闭并重新启动数据库服务器和应用程序服务器,然后再次登录。
    2. Rational Team Concert 管理 Web 界面中,单击用户管理 忽略关于未配置外部注册表的任何错误。
    3. 单击创建用户
    4. 输入以下详细信息:
      1. 用户名:应用程序服务器管理员的用户标识
      2. 用户标识:应用程序服务器管理员的用户标识
      3. 电子邮件地址:应用程序服务器管理员的有效、电子邮件地址
    5. 在“客户机访问许可证”部分中,选择 Rational Team Concert - 开发者以将开发者许可证分配给该用户。
    6. 单击保存
    7. 注销,然后作为应用程序服务器的管理员再登录回管理 Web 界面。
  29. 将生命周期过程模板导入到 Rational Team Concert
    1. Rational Team Concert 管理 Web 界面中,单击过程模板管理 如果看不到过程模板管理链接,请注销,然后再登录回管理 web 界面。
    2. 单击导入模板然后浏览到 archive_extract_location/DatabaseScripts/ 文件夹中的 com.ibm.ram.lifecycle.zip 文件。 然后单击确定 将显示 RAM 生命周期模板。
  30. Rational Team Concert 中创建项目区域:
    1. Rational Team Concert 管理 Web 界面,单击项目区域管理 如果看不到项目区域管理链接,请注销,然后再登录回管理 web 界面。
    2. 单击创建项目区域
    3. 输入有关项目区域的以下详细信息:
      • 项目名称RAM 生命周期
      • 摘要Rational Asset Manager 生命周期控制区域
      • 描述此区域用于管理 Rational Asset Manager 的生命周期
    4. 单击保存
  31. 为项目区域分配相应的成员资格和过程角色:
    1. 在“项目区域管理”页面中,单击 RAM 生命周期项目区域。
    2. 在“管理员”部分中,单击添加。 搜索并选择您创建的管理员用户。如果在使用现有 Rational Team Concert 应用程序,那么还可以选择其他用户作为该项目区域的管理员。
    3. 在“成员”部分中,单击添加,然后搜索并选择您选为该项目区域管理员的用户。
    4. 添加管理员后,单击管理员名称旁边的过程角色图标。
    5. 在“编辑过程角色”窗口中,从可用角色列表,选择管理,然后单击添加
    6. 单击完成
    7. 单击保存
  32. 如果从 V7.1.1.1 或更低版本升级:请继续到步骤 34
  33. 如果从 V7.2 或更高版本升级,升级包含的 Rational Team Concert
    1. 从安装介质将 RTC-Server.zip 文件解压到硬盘驱动器上的新位置,在这些指示信息中,该位置是指 new_rtc_install_dir
    2. 从较旧的 rtc_install_dir/jazz/server/conf/jazz/ 文件夹中,将文件 teamserver.properties 复制到新的 new_rtc_install_dir/jazz/server/conf/jazz/ 文件夹。

      您可以在 Tomcat 启动文件中找到现有的 rtc_install_dir 位置。在启动文件中,搜索包含 JAZZ_INSTALL_DIR= 的行;JAZZ_INSTALL_DIR 变量的值是当前 Rational Team Concert 文件的位置。

    3. 查找 Tomcat 启动文件并在文本编辑器中将其打开。在 Windows 上,该文件是 tomcat_for_rtc_install_directory\bin\startup.bat。 在 Linux、AIX 或 Linux for zSeries 上,该文件为 tomcat_for_rtc_install_directory/bin/startup.sh
    4. 在 Tomcat 启动文件中,搜索包含 JAZZ_INSTALL_DIR= 的行。在以下情况下编辑值:其中 new_rtc_install_dir 是步骤 33.a 中解压缩的目录:
      • 对于 Windows:(将 new_rtc_install_dir 中的空格字符替换为 %20):
        set JAZZ_INSTALL_DIR=new_rtc_install_dir
      • 对于 Linux:对于 AIX:对于 Linux for zSeries::
        JAZZ_INSTALL_DIR=new_rtc_install_dir
    5. 启动 Tomcat 服务器。
    6. 在 Web 浏览器中,输入以下 URL:https://host:secure_port/jazz/admin?internal,其中 host 是 IP 地址或服务器名称,secure_port 是 Tomcat 服务器的安全端口。
    7. 以应用程序服务器管理员身份登录。
    8. 在侧栏中的内部工具下,单击服务器复位
    9. 单击请求服务器复位
    10. 停止 Tomcat 服务器,然后将其重新启动。 将更新包含的 Rational Team Concert 应用程序。
  34. 停止 Rational Asset Manager 的 Tomcat 服务器。
  35. 除去在 Tomcat 上安装的旧的 Rational Asset Manager .war Web 应用程序文件:
    1. 浏览至 tomcat_install_directory/webapps/ 目录。
    2. 请记录任何 Rational Asset Manager Web 应用程序的文件夹和文件名。Rational Asset Manager 的先前版本中,为这些文件夹(换言之,应用程序的上下文路径)建议了以下名称:
      • /com.ibm.ram.repository.web.tomcat_runtime
      • /com.ibm.ram.repository.web.ws.tomcat_runtime
      • /help/
      • /abdprocess/
    3. 删除以下应用程序文件:
      • com.ibm.ram.repository.web.tomcat_runtime.war
      • com.ibm.ram.repository.web.ws.tomcat_runtime.war
      • ramhelp.war
      • rmcabdgovernprocess.war
      文件名可能不同于列表中的名称,具体取决于您如何将应用程序安装在服务器上。
    4. 删除这些应用程序的关联文件夹。
  36. archive_extract_location/apps/tomcat/ 目录,将以下文件复制到 tomcat_install_directory/webapps/ 目录:
    • com.ibm.ram.repository.web.tomcat_runtime.war
    • com.ibm.ram.repository.web.ws.tomcat_runtime.war
    • ramhelp.war
    • rmcabdgovernprocess.war
  37. 要更改应用程序的上下文路径,请重命名 WAR 应用程序文件。 使用您以前用过的相同上下文路径。新安装的文件名和上下文路径如下:
    表 1. Rational Asset Manager Web 应用程序文件的上下文路径
    原始文件名 新文件名 产生的上下文路径 它是什么?
    com.ibm.ram.repository.web.tomcat_runtime.war ram.war ram Tomcat 的 Rational Asset Manager 主 Web 应用程序
    com.ibm.ram.repository.web.ws.tomcat_runtime.war ram.ws.war ram.ws Tomcat 的 Rational Asset Manager Web service 应用程序
    ramhelp.war ram.help.war ram.help Rational Asset Manager 帮助和用户辅助应用程序
    rmcabdgovernprocess.war ram.process.war ram.process 基于资产的开发和管理流程的文档应用程序
  38. 清除 Tomcat 服务器的高速缓存。删除 tomcat_install_directory/work/ 目录。
  39. 重新启动 Rational Asset Manager 的 Tomcat 服务器。
  40. Rational Asset Manager 存储库迁移到最新版本:
    1. 在 Web 浏览器中,打开 Rational Asset Manager Web 客户机。 当您在升级之后首次打开 Web 客户端时,将显示一条消息来指出您必须迁移存储库。
    2. 如有必要,使用具有存储库管理员权限的用户标识进行登录。
      注: 对于 SQL Server,如果现有 Rational Asset Manager 数据库未将整理设置为以 _BIN2 结尾的序列(例如 Latin1_General_BIN2),那么会出现“需要手动配置”页面,其中包含一条消息。可以重新创建数据库并将整理选项设置为区分大小写,以与 Rational Asset Manager 正常协作,也可以接受可能存在意外的大小写敏感性冲突的情况。
    3. 单击迁移 在大型存储库上,迁移可能需要几分钟时间;在迁移完成之前,有关存储库的一些信息可能不可用。
    4. 完成迁移过程之后,单击主页
  41. 迁移存储库之后,停止应用程序服务器,然后将其重新启动。
  42. 如果从 V7.1.1.1 或更低版本升级:配置设置以从 Rational Asset Manager 连接到 Rational Team Concert
    1. Rational Asset Manager Web 客户机中,单击管理
    2. 单击配置
    3. 在“内部 Rational Team Concert 路径”部分中,输入以下信息:
      1. 路径:到您已配置的 Rational Team Concert 服务器的安全 URL。例如,https://localhost:9443/ramjazz。 请记录 https 连接和安全端口号。
      2. 用户Rational Team Concert 中作为“RAM 生命周期”项目区域管理员的用户的用户名。
      3. 密码:作为“RAM 生命周期”项目区域管理员的用户的密码。
      4. 超时:允许 Rational Asset Manager 连接到 Rational Team Concert 的时间量(以秒为单位)。 缺省值为 120
  43. 要升级,必须请求获取新的许可证密钥。必须获取新的服务器许可证和新的用户授权许可证。 请转至 Rational License Key Center:http://www-01.ibm.com/software/rational/support/licensing/ 如果发现有关 Rational License Server 的错误,请调整许可证配置:
    1. 单击管理
    2. 在“管理”页面上,单击配置
    3. 在“许可证和版本”部分中,要选择此存储库使用的服务器许可证类型,请选择标准版企业版
    4. 在页面底部,单击保存
    5. 您可能会再次看到“许可证服务器”错误。 单击重试连接到许可证服务器
  44. 更新 Rational Asset Manager Eclipse 应用程序,其方法与安装它的方法相同。 有关安装 Eclipse 客户机的更多信息,请参阅安装 Rational Asset Manager Eclipse 客户机
    注: 在安装最新版本的 Rational Asset Manager Eclipse 客户机之前,请卸载 Rational Asset Manager Eclipse 客户机插件。

    如果您已使用 Installation Manager 将 Rational Asset Manager V7.0.0.2 Eclipse 客户机安装到现有的 Eclipse V3.3 应用程序中,那么使用 Installation Manager 来卸载该客户机。不能使用“Eclipse 配置管理器”从 Eclipse 客户机中卸载 Rational Asset Manager

    如果您已使用 Eclipse 更新管理器安装了 Rational Asset Manager Eclipse 客户机插件,那么在安装最新版本的 Rational Asset Manager 之前,请使用 Eclipse 配置管理器来除去名为 Rational Asset Manager 的任何功能部件。要使用 Eclipse 配置管理器,在 Eclipse 中单击帮助 > 软件更新 > 管理配置


反馈