在连接至 SQL Server 2005 的 Apache Tomcat V5.5 上部署 Rational Asset Manager

可以在 Apache Tomcat 的现有安装上手动安装 IBM® Rational® Asset Manager
开始之前

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

您将需要 sqljdbc.jar 文件,该文件使 Tomcat 能够与 Microsoft® SQL Server 进行通信。您的数据库服务器供应商应会为您提供这两个文件。

关于此任务

如果要提高 Rational Asset Manager 的性能和稳定性,那么您可以在单独的 Tomcat 服务器上安装 Rational Asset Manager Web 应用程序和包含的 Rational Team Concert 的应用程序文件。在整个此文档中,Tomcat server for Rational Asset Manager 的安装目录将被称为 <tomcat_install_directory>,Tomcat server for Rational Team Concert 的安装目录将被称为 <tomcat_for_rtc_install_directory>。 如果将所有 Web 应用程序安装在相同服务器上,那么目录将相同。

注: 如果打算在相同机器的不同 Tomcat 服务器应用程序部署 Rational Asset Manager 和包含的 Rational Team Concert,请确保您已配置了不同 Tomcat 服务器以使用不同的安全和非安全端口,以避免冲突。有关 Tomcat 5.5 中端口的更多信息,请参阅 Apache Tomcat 文档。
  1. 验证所有存储库服务器是否都已设置为相同的当前日期、时间和时区。
  2. Tomcat 和操作系统相应归档上检索 Rational Asset Manager 服务器文件。应用程序文件将位于 <archive_extract_location>/apps/ 文件夹中。
  3. 将共享库文件解压缩到 <tomcat_install_directory>\shared\lib 文件夹:
    1. 查找并解压缩 <archive_extract_location>\apps\tomcat\sharedLib.zip 文件。
    2. 将解压缩的 sharedLib.zip 文件的全部内容复制到 <tomcat_install_directory>\shared\lib 目录。
    3. 如果要在不同 Tomcat 服务器上安装 Rational Team Concert ,请再次将 sharedLib.zip 文件的解压缩内容复制到其他 Tomcat 服务器上的 <tomcat_for_rtc_install_directory>\shared\lib 目录。
  4. 从目录 <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
    • iehs.war
    • rmcabdgovernprocess.war
  5. 要更改应用程序的上下文路径,请重命名 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 应用程序
    iehs.war ram.help.war ram.help Rational Asset Manager 帮助和用户帮助应用程序
    rmcabdgovernprocess.war ram.process.war ram.process 基于资产的开发和管理流程的文档应用程序
  6. 将 Tomcat server for Rational Asset Manager 配置为访问 SQL Server。
    1. 在文本编辑器中,打开 <tomcat_install_directory>\conf\server.xml 文件。
    2. server.xml 中查找以 <Connector 开始且包含 port="8080"port="8009" 的所有行: 将这些行的开头更改为 <Connector URIEncoding="UTF-8"
    3. server.xml 中的全局 JNDI 资源 <GlobalNamingResources></GlobalNamingResources> 开头与结束标记之间,对您的版本的 Tomcat 输入以下文本。
      注: 对于 <your_username><your_password> 值,请使用对数据库具有完全管理访问权的用户标识和密码。显示的“maxWait”、“maxActive”和“maxIdle”值是样本值,可以根据性能需要进行调整。
    输入以下文本:
    <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_server_name>:<SQLServer_port_number>:<Rational_Asset_Manager_database_name>"
    poolPreparedStatements="true"
    maxWait="5000"
    maxActive="4"
    maxIdle="2"/>
  7. 将以下 JAR 文件添加到 <tomcat_install_directory>\common\lib 文件夹:
    • sqljdbc.jar
    此文件可由数据库应用程序提供者提供。
  8. 在安装介质中查找 <archive_extract_location>/apps/tomcat/RTC-server.zip 文件。
  9. RTC-server.zip 解压缩到硬盘驱动器上的某个位置,在这些指示信息中称为 <rtc_install_dir>
  10. 查找 <rtc_install_dir>/jazz/server/jazz_war.ear 文件并将其解压缩。可以使用免费的实用程序 7-Zip 解压缩.ear 文件。从解压缩的 jazz_war.ear 软件包中,将 jazz.war 文件复制到 <tomcat_for_rtc_install_directory>/webapps/ 目录。
  11. 在 Tomcat server for Rational Team Concert 上配置安全端口:
    1. 必须创建标识 Tomcat server for Rational Team Concert 的安全证书以进行 SSL 连接。可以使用 Java JDK keytool 命令创建自签名证书或请求信任认证中心签署的证书。

      有关使用 keytool 命令创建自签名证书的更多信息,请参阅 Sun Java documentation。通过 keytool 命令,可以使用以下示例命名创建自签名证书:keytool -genkey -alias tomcat -keystore <tomcat_for_rtc_install_directory>/.keystore

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

    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" 
           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_password> 是密钥库文件的密码;
      • <keystore_protocol> 是密钥库的协议。大多数情况下,它将为 TLSSSL_TLS
      • <keystore_algorithm> 是密钥库的 X509 算法。根据证书源,大多数情况下它将为 SunX509IbmX509
    4. 如果更改端口值以使用 8443 以外的端口,那么对于非 SSL连接(缺省情况下,为端口 8080),请更改 redirectPort 属性的值以与 SSL 连接的端口编号匹配。

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

  12. 配置 Tomcat 启动属性设置:
    1. 将以下 .jar 文件从数据库提供者复制到 <rtc_install_dir>/jazz/server/sqlserver 文件夹(可能必须创建 sqlserver 文件夹):
      • sqljdbc.jar
    2. 查找 Tomcat 启动文件并在文本编辑器中将其打开。在 Windows® 上,这是 <tomcat_for_rtc_install_directory>\bin\startup.bat。 在 Linux®、AIX® 或 Linux for zSeries®,此为 <tomcat_for_rtc_install_directory>/bin/startup.sh
    3. 在启动文件中,输入以下文本,其中 <rtc_install_dir> 是步骤 9 中解压缩的目录,<sqlServer_jar_dir>是步骤 12.a中 SQL Server .jar 文件的位置:
      • 对于 Windows: (将 <rtc_install_dir><sqlServer_jar_dir> 中的空格字符替换为 %20):
        set SQLSERVER_JDBC=<sqlServer_jar_dir>
        set JAZZ_INSTALL_DIR=<rtc_install_dir>
        set JAVA_OPTS=-Djava.awt.headless=true -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::
        SQLSERVER_JDBC=<sqlServer_jar_dir>
        JAZZ_INSTALL_DIR=<rtc_install_dir>
        export JAVA_OPTS="-Djava.awt.headless=true -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"
  13. 编辑 Jazz™ 服务器属性文件:
    1. <rtc_install_dir>/jazz/server/conf/jazz/ 目录中,查找 teamserver.properties 文件,并将其重命名为 teamserver.derby.properties
    2. <rtc_install_dir>/jazz/server/conf/jazz/ 目录中,查找 teamserver.sqlserver.properties 文件,并将其重命名为 teamserver.properties
    3. teamserver.properties 文件中,指定数据库和连接属性:
      1. 在文本编辑器中,打开 teamserver.properties 文件。
      2. 查找以下行:
        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
      3. 针对生命周期数据库的 SQL Server 位置和名称,编辑 com.ibm.team.repository.db.jdbc.location 的值:
        1. @localhost:1433 替换为 SQL Server 数据库的位置和端口。
        2. jazz 替换为生命周期数据库的名称;例如,RTCDB
        3. jazzDBUser 替换为 SQL Server 数据库的用户名。
      4. com.ibm.team.repository.db.jdbc.password 属性中,将 JazzDBpswd 替换为您以上指定的 SQL Server 用户的密码。
        注: 切勿更改 com.ibm.team.repository.db.jdbc.location 属性中的文本 {password}
      5. 将以下属性添加到 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>
  14. 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
  15. 针对用户安全性配置 Tomcat 服务器。如果打算使用 LDAP 安全性,请首先使用基于文件的安全性配置应用程序,那么请在配置应用程序之后切换到 LDAP 认证(有关更多信息,请参阅 为 Tomcat 配置 LDAP 认证):
    1. 在文本编辑器中,打开 <tomcat_install_directory>\conf\tomcat-users.xml 文件(对于 server for Rational Asset Manager)。
    2. 添加名为 admin 的用户并为其分配角色 adminmanager。 可以在 <tomcat-users> 标记之间复制粘贴以下内容:
      <user username="admin" password="" roles="admin,manager" />

      此用户必须名为 admin

    3. 在文本编辑器中,打开 <tomcat_for_rtc_install_directory>\conf\tomcat-users.xml 文件(对于 server for Rational Team Concert)。 同样,如果要将应用程序安装在相同 Tomcat 服务器上,这将是和步骤 15a 相同的文件。
    4. <tomcat-users> 标记之间粘贴以下文本:
      <role rolename="JazzUsers"/>
      <role rolename="JazzAdmins"/>
      <role rolename="JazzDWAdmins"/>
      <role rolename="JazzGuests"/>
    5. 添加名为 admin 的用户并为其分配角色 adminmanagerJazzAdmins。可以在 <tomcat-users> 标记之间复制粘贴以下内容:
      <user username="admin" password="" roles="admin,manager,JazzAdmins" />

      如果将应用程序安装到相同服务器上,那么可以将 JazzAdmins 角色添加到在步骤 13b 中创建的用户。

  16. 重新启动 Tomcat 服务器。
  17. Rational Team Concert 配置管理用户:
    1. 在 Web 浏览器中启动 Rational Team Concert 的管理 Web UI,地址为 https://<machine_name>:<secure_port>/jazz/admin/ 请注意 https;它必须为安全连接。
    2. 使用应用程序服务器管理员的用户标识密码登录。 如果看到有关“访存服务器状态信息”的错误,请关闭数据库服务器和 Tomcat 服务器,然后重新启动并再次登录。
    3. 单击用户管理 忽略关于未配置外部注册表的任何错误。
    4. 单击创建用户
    5. 输入以下详细信息:
      1. 用户名:Tomcat 服务器管理员的用户标识
      2. 用户标识:Tomcat 服务器管理员的用户标识
      3. 电子邮件地址:Tomcat 服务器管理员的有效电子邮件地址
    6. 在“客户机访问许可证”部分中,选择 Rational Team Concert - 开发者以将开发者许可证分配给该用户。
    7. 单击保存
    8. 注销,然后以应用程序服务器管理员身份登录回管理 Web UI。
  18. 将生命周期过程模板导入到 Rational Team Concert
    1. Rational Team Concert 管理 Web UI 中,单击过程模板管理 如果无法看到过程模板管理链接,请注销,然后登录回管理 Web UI。
    2. 单击导入模板然后浏览到 <archive_extract_location>/DatabaseScripts/ 文件夹中的 com.ibm.ram.lifecycle.zip 文件。 然后单击确定 您将看到 RAM 生命周期模板出现。
  19. Rational Team Concert 中创建一个新项目区域:
    1. Rational Team Concert 管理 Web UI,单击项目区域管理 如果无法看到项目区域管理链接,请注销,然后登录回管理 Web UI。
    2. 单击创建项目区域
    3. 输入有关项目区域的以下详细信息:
      • 项目名称RAM 生命周期
      • 摘要Rational Asset Manager 生命周期控制区域
      • 描述此区域用于管理 Rational Asset Manager 的生命周期
    4. 单击保存
  20. 为项目区域分配相应的成员资格和过程角色:
    1. 在“项目区域管理”页面中,单击 RAM 生命周期项目区域。
    2. 在“管理员”部分中,单击添加;然后搜索并选择您已创建的管理员用户。
    3. 在“成员”部分中,单击添加;然后搜索并选择您已创建的管理员用户。
    4. 添加管理员后,单击管理员名称旁边的过程角色图标。
    5. 在“编辑过程角色”对话框中,从可用角色列表中选择管理然后单击添加
    6. 单击完成
    7. 单击保存
  21. 停止 Tomcat 服务器,然后重新启动。
  22. 在 Web 浏览器中,打开 Rational Asset Manager。 如果对应用程序文件使用建议名称,那么 URL 将是 http://localhost:8080/ram/home.faces,或者通过 Web 服务器,URL 将是 http://<Web_server_address>:<port>/ram/home.faces 将打开 Rational Asset Manager Web 客户机。
下一步做什么
接下来,配置 Rational Asset Manager Web 应用程序。有关更多信息,请参阅配置 Rational Asset Manager 服务器应用程序

反馈