在 WebSphere Application Server 上从先前版本升级

使用此指导在 IBM® WebSphere® Application Server 上从先前版本的 IBM Rational® Asset Manager 升级。

开始之前

要点:

如果从 Rational Asset Manager V7.1.1.1 或更低版本升级,那么必须安装 IBM Rational Team Concert 和附加的数据库,Rational Team Concert 要求有自己的应用程序服务器实例,无法将其安装到集群。

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

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

还可以配置现有 Rational Team Concert 服务器以使用 Rational Asset Manager。 服务器设置应用程序处理该配置。您必须知道 Rational Team Concert 服务器管理员的用户名和密码。

如果您可以访问因特网,那么可以使用 IBM Installation Manager 直接从 Rational Asset Manager 的 IBM 更新存储库查找并安装更新。

要点: 安装了 Rational Asset Manager 之后,其更新存储库所在的位置会自动嵌入在 Installation Manager 中。要让 Installation Manager 搜索缺省更新存储库,必须在“存储库首选项”页面上选择在安装和更新期间搜索链接的存储库首选项;缺省情况下将选中此首选项。

要从另一存储库位置安装修订包(例如,如果更新位于共享驱动器、HTTP 或 HTTPS 服务器上),请在 Installation Manager 中添加该存储库位置。要添加存储库位置,请参阅在 Installation Manager 中设置安装库首选项

要使用 Installation Manager,必须使用图形用户界面 (GUI)。如果您不能访问 GUI,那么可使用响应文件通过命令行进行静默安装。有关更多信息,请参阅 IBM Installation Manager 联机帮助使用 Installation Manager 进行静默安装

关于此任务

此大纲显示了为升级到最新版本的 Rational Asset Manager 而必须执行的操作:
  1. 通过进行备份和配置应用程序服务器来准备升级:步骤 16
  2. 如果使用的是 WebSphere Application Server Network Deployment 集群并且是从 V7.1.1.1 或更低版本升级,请在集群上为 Rational Team Concert™ 创建独立应用程序服务器实例:步骤 7
  3. 如果使用的是 Oracle,请复制其他 JDBC .jar 文件:步骤 89
  4. 在 WebSphere Application Server 或集群 V7.0 上安装必需临时修订包:步骤 10
  5. 如果使用的是嵌入式 WebSphere Application Server,请停止服务器:步骤 11
  6. 将许可证服务器升级至 Rational Common Licensing V8.1.2:步骤 12
  7. 检索最新版本的 Rational Asset Manager 的应用程序文件并部署服务器设置应用程序:步骤 1314
  8. 使用服务器设置应用程序更新其他 Rational Asset Manager 应用程序:步骤 1518
  9. 如果是从 V7.1.1.1 或更低版本升级并且需要 Rational Team Concert,请将 Rational Team Concert 部署到服务器并创建数据库:步骤 2024
  10. 重新启动应用程序服务器:步骤 26
  11. 如果是从 V7.1.1.1 或更低版本升级,请配置 Rational Team Concert:步骤 27
  12. 登录到 Rational Asset Manager Web 客户机并迁移存储库:步骤 2829
  13. 重新配置 Rational Asset Manager 的一些设置:步骤 3132
  14. 清除帮助应用程序的高速缓存:步骤 33
  15. 更新 Rational Asset Manager Eclipse 应用程序:步骤 34

过程

  1. 在升级之前,请按照创建 Rational Asset Manager 存储库的备份中的指示信息创建存储库、数据库、资产文件和应用程序服务器设置的完全备份。
  2. 对于 Linux:对于 AIX:对于 Linux for zSeries:在 Linux®、AIX®、或 Linux for zSeries® 上,将进程一次可打开的文件描述符的数量至少增加到 3072:
    1. 要查看当前可一次打开的描述符数量,请在命令行中输入:ulimit -n
    2. 如果限值不是至少为 3072,请使用以下命令增加限值:ulimit -n 3072
  3. 如果已修改了主题或电子邮件消息,那么在更新 Rational Asset Manager 服务器之前,请下载当前主题和邮件消息文件(在管理 > 工具页面上),然后在更新服务器之后,重新应用该主题和消息。有关更多信息,请参阅迁移主题
  4. 对于 WebSphere:WebSphere Application Server 配置应用程序安全性和认证设置:
    1. 在 Web 浏览器中,登录到 WebSphere Application Server 管理控制台。 缺省情况下,这位于:
      • 对于嵌入式 WebSphere Application Serverhttp://localhost:13060/ibm/console。 缺省用户名是 admin,缺省密码是 admin
      • 对于 WebSphere Application Serverhttp://localhost:9060/ibm/console
    2. 单击安全性
    3. 单击全局安全性
    4. 在“管理安全性”部分中,如果已选中了启用管理安全性复选框,请选中启用应用程序安全性复选框。
    5. 在“认证”部分中,单击 Web 和 SIP 安全性
    6. 单击常规设置
    7. 在“Web 认证行为”部分中,选中访问未受保护的 URI 时使用可用认证数据复选框(如果尚未将其选中)。
    8. 单击应用
    9. 在“消息”窗口中,单击直接保存到主配置
    10. 停止然后重新启动服务器。
  5. 如果使用的是 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. 重新启动应用程序服务器。
  6. 验证所有存储库服务器是否都已设置为相同的当前日期、时间和时区。
  7. 对于 WebSphere:如果从 V7.1.1.1 或更低版本升级并使用 WebSphere Application Server 集群,且需要安装 Rational Team Concert,那么您必须在 Rational Team Concert 的集群上创建独立的应用程序服务器实例。 为此,请参阅在 WebSphere Application Server 分布式服务器集群上为 Rational Team Concert 创建应用程序服务器实例 如果未使用集群,那么不必执行此操作;Rational Team ConcertRational Asset Manager 可以安装在相同应用程序服务器上。
  8. 对于 Oracle: 如果使用的是 Oracle,请将附加的 JDBC .jar 文件复制到应用程序服务器的 WebSphere_install_directory/profiles/profile_name/config/cells/cell_name/ram_jdbc 目录:
    • 对于 WebSphere Application Server 7.0ojdbc5.jar
    • 对于 WebSphere Application Server 7ojdbc6.jar
    您可以从 Oracle 下载相应的 .jar 文件;即使您使用的是 Oracle 10g,也请下载 Oracle 11 的软件包以查找相应的 .jar 文件。
  9. 如果使用的是 Oracle,并且使用 AIX、Linux 或 Linux for zSeries,请为新 JDBC .jar 文件设置相应的许可权,如对非 root 用户启用数据库连接(Linux 和 AIX)中所述。 必须为从 Rational Asset Manager 访问 Oracle 数据库的用户提供相应的特权来完成迁移。
    • 如果使用的是 RAMSCHEMA 用户,请向 RAMSCHEMA 用户授予 CREATE VIEW 特权。 示例:GRANT CREATE VIEW TO RAMSCHEMA
    • 如果使用的是其他用户,请向该用户授予 CREATE ANY VIEW 特权。示例:GRANT CREATE ANY VIEW TO User
  10. 如果使用的不是嵌入式 WebSphere Application Server 而是 WebSphere Application Server V7.0,那么必须安装对服务器的临时修订:http://www-01.ibm.com/support/docview.wss?uid=swg24023024 此临时修订防止出现 WebSphere Application Server 无法释放与 Rational Team Concert 的连接这一问题。
  11. 如果您使用嵌入式 WebSphere Application Server,请停止该嵌入式 WebSphere Application Server
    注: 如果使用的是网络部署集群或已安装到现有 WebSphere Application Server,请勿停止服务器。
    如果发出 Rational Asset Manager 停止服务器命令无法停止服务器,请以命令行方式在 Install-directory\ram\ewas\bin 目录下运行 stopServer 命令,并且通过使用 -username-password 选项来指定服务器管理员用户名和密码。
  12. 对于 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。
  13. 检索相应的 Rational Asset Manager 应用程序:
    • 如果使用 WebSphere Application Server,并已使用 Installation Manager 将 Rational Asset Manager 部署到服务器,请将 Installation Manager 用于升级过程。请参阅使用 Installation Manager 来安装 Rational Asset Manager中提供的指示信息并注意下列差别:
      1. 启动 Installation Manager。在 Windows Vista 上,以管理员身份运行 Installation Manager(右键单击程序快捷方式,然后选择以管理员身份运行
      2. Installation Manager 可能需要更新到更高的版本。要配置 Installation Manager 以使它可以检查更新:在“开始”页上,单击文件 > 首选项;然后单击更新。在“更新”页中,选择搜索 Installation Manager 更新
      3. 在 Installation Manager 的“开始”页上,单击更新
      4. 如果有更新版本的 Installation Manager 可用,将出现一个要求您进行更新的窗口。单击。更新过程完成后,单击确定以重新启动 Installation Manager,然后再次单击更新
      5. 在“更新软件包”页上,选择 IBM Rational Asset Manager;然后单击下一步。展开并选择最新版本的 Rational Asset Manager 服务器,然后单击下一步
      6. 遵循更新向导中的指示信息进行操作。
        1. 上下文根页面上,Installation Manager 会检测当前 Rational Asset Manager Web 应用程序的上下文根。请记录 Rational Asset Manager 设置服务器的上下文根,这是因为您需要上下文根来访问服务器设置应用程序。然后单击下一步
        2. 如果启用了应用程序服务器安全性(实际很可能是此情况)或者 WebSphere Application Server 的安全性设置自安装产品以来发生了更改,请在“功能部件”部分的管理安全性页面上选择并输入应用程序服务器管理员的用户名和密码。 然后单击下一步
      7. 完成更新过程之后:
        1. 如果使用嵌入式 WebSphere Application Server,那么嵌入式 WebSphere Application Server 已更新到相应的修订包级别,并且服务器设置应用程序 .ear 文件已更新。启动嵌入式 WebSphere Application Server。 请转至步骤 15
        2. 如果使用现有 WebSphere Application Server,那么服务器设置应用程序 .ear 文件已更新。请转至步骤 15
        3. 如果使用现有 WebSphere Application Server ND 集群,请转至步骤 15。如果要从 V7.5 或更高版本进行升级且该版本是您安装的产品的第一个版本,那么在您初始安装产品时指定的应用程序服务器上已更新了服务器设置应用程序。 如果安装了 V7.5 之前的任何版本,那么在 Deployment Manager 服务器上将针对您的单元对服务器设置应用程序进行更新。
    • 如果已将 Rational Asset Manager .ear.war 文件部署到应用程序服务器,请检索最新版本的 Rational Asset Manager 应用程序文件。有关更多信息,请参阅直接从安装介质中检索服务器应用程序文件。获得应用程序文件后,请转至步骤 14
  14. Rational Asset Manager 服务器设置应用程序部署到应用程序服务器:
    • 如果使用的是 WebSphere Application Server 集群并且已将服务器设置应用程序部署到部署管理器服务器(这描述了 V7.5 之前集群上的大多数环境),那么必须使用脚本来卸载现有服务器设置应用程序,然后安装最新的服务器设置应用程序。 有关使用 deployClusterSetup.pyUninstallSetup.py 脚本的更多信息,请参阅将服务器设置应用程序部署到 WebSphere Application Server 集群上的 Deployment Manager。或者,也可以将服务器设置应用程序部署到集群而不是直接部署到部署管理器;如果通过此方式部署应用程序,那么无需运行 Jython 脚本。将服务器设置应用程序部署到 Deployment Manager 后,请转至步骤 15
    • 如果已将 Rational Asset Manager 服务器设置应用程序直接部署到应用程序服务器,请将 com.ibm.ram.repository.setup.web.ear 更新为检索到的最新版本:
      1. 启动 WebSphere Application Server 管理控制台并以管理员身份登录。
      2. 更新 Rational Asset Manager 服务器设置应用程序:
        1. 单击应用程序 > 应用程序类型
        2. 单击 WebSphere 企业应用程序
        3. 选择 com.ibm.ram.repository.setup.web.ear;然后单击更新
        4. 浏览至 Rational Asset Manager 服务器设置企业归档文件(com.ibm.ram.repository.setup.web.ear),或者直接输入此文件的路径和文件名。
        5. 在后三个页面上,单击下一步
        6. 在“摘要”页面上,单击完成
        7. 安装了 com.ibm.ram.repository.setup.web.ear 文件之后,单击保存到主配置。现在即已更新并且部署了服务器设置应用程序。使用服务器设置应用程序以更新所有其他应用程序。请转至步骤 15
      注: 如果使用 Rational Asset Manager 7.1.0.1 或更早版本,那么服务器设置应用程序的缺省上下文根已从 com.ibm.ram.repository.setup.web 更改为 ram.setup。 如果已将服务器设置应用程序加入到书签,那么在您更新服务器设置应用程序后书签可能会不起作用。有关更多信息,请参阅有关 Web 模块的上下文根的 WebSphere Application Server 文档
    • 如果使用 WebSphere Application Server 并且未部署服务器设置应用程序 (com.ibm.ram.repository.setup.web.ear),请通过完成将服务器设置应用程序部署到 WebSphere Application Server 中的指示信息来部署 com.ibm.ram.repository.setup.web.ear 应用程序。 如果正在部署到集群,请参阅将服务器设置应用程序部署到 WebSphere Application Server 集群使用服务器设置应用程序以更新所有其他应用程序。部署服务器设置应用程序后,请转至步骤 15
  15. 部署了最新版本的服务器设置应用程序后,在 Web 浏览器中,通过使用以下 URL 打开服务器设置应用程序:http://host:port/setup-server-context-root。 服务器设置应用程序的缺省上下文根为 ram.setup。 如果已在应用程序服务器上启用安全性,请输入应用程序服务器管理员的用户标识和密码。 对于嵌入式 WebSphere Application Server,缺省用户标识和密码均为 adminadmin
  16. 在步骤 1 中:找到“安装文件”部分,单击提供服务器上文件的位置并输入在运行服务器设置应用程序的服务器上文件系统中新 Web 应用程序文件所在的目录。
    如果已使用 Installation Manager 中的“更新”向导,那么这些文件位于 package_group_location\ram\apps\was 目录中。 以下文件必须位于该目录中:
    • com.ibm.ram.repository.web_runtime.ear
    • RTC-Server.zip
    • rlsclients_rlsibmratl_812.zip
    • ramhelp_war.ear
    • rmcabdgovernprocess_war.ear

    如果已将服务器设置应用程序部署到属于集群一部分的应用程序服务器,并且要访问该应用程序服务器以将文件上载到运行服务器设置应用程序的服务器,请单击将文件上载到服务器;然后单击浏览并选择各必需文件。

  17. 要验证是否所有必需应用程序文件都在目录中,或者要将其上载到服务器,请单击验证位置 如果已上载应用程序文件,那么服务器设置应用程序会将其保存到临时目录。 此时将出现一条消息,验证是否存在所有必需文件。
  18. 单击更新 服务器设置应用程序将所有其他 Rational Asset Manager 应用程序文件更新到最新版本并保留其上下文根,此过程可能需要几分钟时间。
  19. 下一步:
    • 如果是从 V7.1.1.1 或更低版本升级,那么将打开“简介”页面;继续执行步骤 20
    • 如果是从 V7.2 或更高版本升级,那么将打开“摘要”页面;继续执行步骤 28
  20. Rational Team Concert 是增强的生命周期过程所必需的。下一步:
    • 如果需要 Rational Team ConcertRational Asset Manager 包含可安装的受限版本。
      1. 在“介绍”页面上,从是否安装 Rational Team Concert?列表,选择是,安装新的 RTC 服务器
      2. 单击下一步
      3. 转至步骤 21
    • 如果您已具有 Rational Team Concert 并希望将其配置为与 Rational Asset Manager 一起使用,请执行以下操作:
      1. 在“介绍”页面上,从是否安装 Rational Team Concert?列表,选择否,使用现有 RTC 服务器
      2. 请继续到步骤 25
  21. 在“部署 Rational Asset Manager”页面上:
    1. 在“部署 Rational Team Concert”部分中,在服务器列表中确认应用程序服务器(您不能将 Rational Team Concert 部署到集群)然后单击部署应用程序 部署 Rational Team Concert 的操作可能需要几分钟时间。 该过程完成后将重新打开“部署 Rational Asset Manager”页面。
    2. 操作完成后,单击下一步
  22. Rational Team Concert 的资产生命周期创建数据库
    • 对于 DB2: 对于 DB2®:服务器设置应用程序可为您创建数据库:
      1. 在“为 Rational Asset Manager 创建或查找数据库”页面上,单击您需要创建生命周期数据库然后单击下一步
      2. 如果在安装新的 Rational Team Concert,请在创建生命周期管理的数据库字段中,输入生命周期管理数据库的名称(例如,RTCDB)。 如果在使用现有 Rational Team Concert,那么不必新建数据库。
      3. 单击创建数据库
    • 对于 Oracle:对于 SQL Server: 对于 Oracle 或 SQL Server:要手动创建数据库,请参阅创建资产生命周期数据库。 创建数据库后,选择您已创建了同时两个数据库并希望修改设置然后单击下一步
  23. 在“配置数据库”页面上,输入并测试生命周期管理数据库的连接:
    1. 生命周期的数据库名称字段中,输入在步骤22中创建的数据库的名称。
    2. 要测试连接,请单击测试连接
    3. 如果连接成功,请单击下一步
  24. 配置 Rational Team Concert 数据库。 在第 6 步下:配置 Rational Asset Manager 生命周期数据库:
    1. 单击填充数据库
    2. 将有一条消息要求您验证您要配置生命周期数据库。单击确定
    3. 该过程完成后,单击下一步
  25. 继续服务器设置应用程序以配置或调整数据库和应用程序服务器设置,直到您到达“第 4 部分:配置生命周期管理设置”为止。
  26. 在“第 4 部分:配置生命周期管理设置”的页面上,单击重新启动服务器 必须输入应用程序服务器管理员的用户标识和密码。 服务器已停止并重新启动后,“配置生命周期管理设置”页面将打开。
  27. 在“配置生命周期管理设置”页面中,输入 Rational Team Concert 应用程序的路径和登录信息:
    1. 在步骤 1 中,在 Rational Team Concert 服务器字段中,输入 Rational Team Concert 位置的路径。 必须使用安全 (https://) 连接。 缺省情况下,此值是:
      • 对于嵌入式 WebSphere Application Serverhttps://localhost:13443/ramjazz
      • 对于现有 WebSphere Application Serverhttps://localhost:9443/ramjazz
      • 对于外部 Rational Team Concert 服务器:https://url:port/jazz
    2. 在步骤 2 中,在 Jazz 管理员标识字段中,输入 Rational Team Concert 服务器的管理员用户标识(缺省值为 admin);然后,在密码字段中,输入该用户的密码(缺省情况下,其值为 admin)。 如果刚才使用服务器设置应用程序安装了 Rational Team Concert,那么请输入应用程序服务器管理员的用户名和密码。
    3. 在步骤 3 中,在项目区域名称字段中,输入将为生命周期创建的项目区域的描述性名称(例如,Rational Asset Manager lifecycles)。 然后,在项目区域管理员标识字段中,输入您希望成为项目区域管理员的用户的用户标识。然后,输入该用户的密码 如果使用的是外部 Rational Team Concert 服务器,那么项目区域管理员可以不同于 Jazz 服务器管理员的其他用户。如果安装的是新 Rational Team Concert,那么服务器设置应用程序将建议使用 Jazz 管理员标识作为项目区域管理员标识。
    4. 单击配置服务器 该过程可能需要几分钟。 配置后,将会出现“摘要”页面。
  28. 在“摘要”页面上,单击使用 Rational Asset Manager 启动。 或单击完成 此时将打开 Web 客户机。
  29. 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. 完成迁移过程之后,单击主页
  30. 迁移存储库之后,停止应用程序服务器,然后将其重新启动。
  31. 要升级,必须请求获取新的许可证密钥。必须获取新的服务器许可证和新的用户授权许可证。 请转至 Rational License Key Center:http://www-01.ibm.com/software/rational/support/licensing/ 如果发现有关 Rational License Server 的错误,请调整许可证配置:
    1. 单击管理
    2. 在“管理”页面上,单击配置
    3. 在“许可证和版本”部分中,要选择此存储库使用的服务器许可证类型,请选择标准版企业版
    4. 在页面底部,单击保存
    5. 您可能会再次看到“许可证服务器”错误。 单击重试连接到许可证服务器
  32. 配置完成后,手动将先前版本的 Rational Asset Manager 的共享库引用重新映射到 RAM1WebApplication(例如,对于与 IBM Rational ClearQuest® 的集成,必须在升级到新 Rational Asset Manager 服务器后再次运行集成步骤)。
  33. 如果打开帮助应用程序时显示的是旧版本的帮助或出现错误,那么请清除 Rational Asset Manager 帮助应用程序的高速缓存。请参阅应用程序服务器的文档以了解有关清除高速缓存的指示信息。在集群上,必须停止每台应用程序服务器并清除集群中每个节点和服务器的高速缓存。 对于嵌入式 WebSphere Application Server,要清除高速缓存,请执行下列操作:
    1. 停止服务器。
    2. 删除以下目录:Rational_Asset_Manager_install_location/ram/ewas/profiles/profile1/temp/node_name/server_name/ramhelp_war/
    3. 重新启动服务器。
  34. 更新 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 中单击帮助 > 软件更新 > 管理配置


反馈