Rational Asset Manager 服务器应用程序部署在 Tomcat 5.5 上

可以在安装 Apache Tomcat 时手动安装 IBM® Rational® Asset Manager

开始之前

您必须对已安装并在运行的 Tomcat 服务器具有管理和文件访问权。

执行此任务之前,请完成以下任务:
  1. 检索应用程序文件
  2. 创建资产数据库
  3. 创建数据库的数据库
您必须了解数据库服务器的以下 JDBC .jar 文件的位置:
  • 对于 IBM DB2:db2jcc_license_cu.jardb2jcc.jar
  • 对于 Oracle:ojdbc5.jar。如果使用的是 Oracle 10,请仍然使用适用于 Oracle 11 的 ojdbc5.jar 文件。您可以从 Oracle 下载文件。
  • 对于 Microsoft SQL Server:sqljdbc.jar。 您可以从 Microsoft 下载文件。

关于此任务

可以通过将 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 和包含的 Rational Team Concert 部署到同一机器上的不同 Tomcat 服务器应用程序中,请确保您配置了不同的 Tomcat 服务器以使用不同的安全和非安全端口,从而避免冲突。有关 Tomcat 5.5 中端口的更多信息,请参阅 Apache Tomcat 文档。

过程

  1. 验证所有存储库服务器是否都已设置为相同的当前日期、时间和时区。
  2. Tomcat 和您操作系统的相应归档上检索应用程序文件。应用程序文件在 archive_extract_location/apps/tomcat/ 文件夹中。
  3. 将共享库文件解压缩到 tomcat_install_directory\shared\lib 文件夹:
    1. 查找并解压缩 archive_extract_location\apps\tomcat\sharedLib.zip 文件。
    2. 将解压缩的 sharedLib.zip 文件的全部内容复制到 tomcat_install_directory\shared\lib 目录。
    3. 如果将 Rational Team Concert 安装在不同的 Tomcat 服务器上,请将 sharedLib.zip 文件的解压缩内容复制到其他 Tomcat 服务器的 tomcat_for_rtc_install_directory\shared\lib 目录中。
  4. 对于 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 目录。
  5. 对于 Windows: 对于 Linux:对于 AIX: 修改 Rational Asset Manager 的 Tomcat 服务器的启动脚本:
    要点: 如果要在 Linux for zSeries 上进行安装,那么请勿完成此步骤
    1. 查找 Tomcat 启动文件并在文本编辑器中将其打开。在 Windows® 上,该文件是 tomcat_install_directory\bin\startup.bat。 在 Linux、AIX® 或 Linux for zSeries,此为 tomcat_install_directory/bin/startup.sh
    2. 在启动文件中,输入以下文本:
      • 对于 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"
  6. 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
  7. 要更改应用程序的上下文路径,请重命名 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 基于资产的开发和管理流程的文档应用程序
  8. 配置 Rational Asset Manager 的 Tomcat 服务器以访问数据库:
    1. 在文本编辑器中,打开 tomcat_install_directory\conf\server.xml 文件。
    2. server.xml 中查找以 <Connector 开始且包含 port="8080"port="8009" 的所有行: 将这些行的开头更改为 <Connector URIEncoding="UTF-8"
    3. 在全局 JNDI 资源的左标记和右标记(<GlobalNamingResources></GlobalNamingResources>)之间,针对您的 Tomcat 版本输入以下文本。
      注: 对于 your_usernameyour_password 值,请使用对数据库具有完全管理访问权的用户标识和密码。例如,“url”属性可能类似 jdbc:db2://localhost:50000/RAMDB
    为数据库服务器输入该文本,替换以下变量:
    • usernamepassword 属性中,将 your_usernameyour_password 替换为具有数据库服务器的完全管理访问权的用户标识和密码。
    • url 属性中,将 fully_qualified_database_server_namedatabase_port_number 替换为数据库的服务器地址和端口号,并将 Rational_Asset_Manager_database_name 替换为资产的数据库的名称。例如,对于 DB2,url 属性可能类似 jdbc:db2://localhost:50000/RAMDB
    • maxWaitmaxActivemaxIdle 属性显示的值是样本值,可以根据您的性能需求予以调整。
    • 对于 IBM DB2:
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="com.ibm.db2.jcc.DB2Driver"
      username="your_username"
      password="your_password"
      url="jdbc:db2://fully_qualified_database_server_name:database_port_number/Rational_Asset_Manager_database_name"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
    • 对于 Oracle:
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="oracle.jdbc.driver.OracleDriver"
      username="your_username"
      password="your_password"
      url="jdbc:oracle:thin:@fully_qualified_database_server_name:database_port_number:Rational_Asset_Manager_database_name"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
    • 对于 Microsoft SQL Server:
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="com.microsoft.jdbc.sqlserver.SQLServerDriver"
      username="your_username"
      password="your_password"
      url="jdbc:microsoft:sqlserver://fully_qualified_database_server_name:database_port_number:Rational_Asset_Manager_database_name"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
  9. 配置 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" />
  10. 将以下 JAR 文件复制到 tomcat_install_directory\common\lib 文件夹:
    • 对于 IBM DB2:
      • db2jcc_license_cu.jar
      • db2jcc.jar
    • 对于 Oracle:
      • ojdbc5.jar(您可以从 Oracle 下载此文件)。如果使用的是 Oracle 10,请下载 Oracle 11 软件包以查找 ojdbc5.jar 文件。)
    • 对于 Microsoft SQL Server:
    这些文件由数据库供应商提供,最可能在数据库安装的 /java/ 文件夹中。
  11. 配置 Tomcat 服务器以实现用户安全性。如果您意图使用 LDAP 安全性,请首先使用基于文件的安全性来配置应用程序,并在配置应用程序后,切换到 LDAP 认证。有关更多信息,请参阅为 Tomcat 配置 LDAP 认证
    1. 在文本编辑器中,打开 tomcat_install_directory\conf\tomcat-users.xml 文件。
    2. 添加名为 admin 的用户并向该用户分配 adminmanager 角色。 要添加该用户,可以复制并粘贴 <tomcat-users> 标记之间的以下文本:
      <user username="admin" password="" roles="admin,manager" />

      此用户必须名为 admin

  12. 根据您的设置,部署或配置 Rational Team Concert

反馈