将包含的 Rational Team Concert 服务器应用程序部署在 Tomcat 上

IBM® Rational® Asset Manager 需要 IBM Rational Team Concert,它控制可用于管理资产开发的生命周期功能。如果您尚未拥有 Rational Team Concert,将包含该产品的有限版本,可以将其部署到 Tomcat 服务器。

开始之前

如果已经部署并配置了 Rational Team Concert 服务器应用程序,那么可以使用现有应用程序,而不是安装新的应用程序。要配置 Rational Team Concert 来与 Rational Asset Manager 协作,请参阅配置 Rational Team Concert 服务器来与 Rational Asset Manager 协作

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

执行此任务之前,请完成以下任务:
  1. 检索应用程序文件
  2. 创建数据库的数据库

必须具有 Tomcat 服务器的安全证书。包含的 Rational Team Concert 版本需要安全连接。

关于此任务

可以通过将 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 服务器上,那么目录相同。

过程

  1. 验证所有存储库服务器是否都已设置为相同的当前日期、时间和时区。
  2. Tomcat 和您操作系统的相应归档上检索应用程序文件。应用程序文件在 archive_extract_location/apps/tomcat/ 文件夹中。
  3. 对于 Windows: 对于 Linux:对于 AIX: 将 Rational Licensing Key Server V8.1.2 的库文件解压缩到 tomcat_for_rtc_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_for_rtc_install_directory\shared\lib 目录。
    如果在同一应用程序服务器上安装 Rational Asset ManagerRational Team Concert,那么您已经完成该步骤。
  4. 在安装介质上,查找 archive_extract_location/apps/tomcat/RTC-server.zip 文件。
  5. RTC-server.zip 解压缩到硬盘驱动器上的位置,在这些指示信息中,此位置为 rtc_install_dir
  6. 查找 rtc_install_dir/jazz/server/ramjazz_war.ear 文件并将其解压缩。要解压缩 .ear 文件,您可以使用免费实用程序(例如 7-Zip)。从解压缩的 ramjazz_war.ear 软件包中,将 ramjazz.war 文件复制到 tomcat_for_rtc_install_directory/webapps/ 目录。
  7. 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

  8. 对于 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 文件夹):
  9. 配置 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 选项。
  10. 查找并重命名相应的 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
  11. 在文本编辑器中,打开 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
  12. 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
  13. 配置 Tomcat 服务器以实现用户安全性。如果您意图使用 LDAP 安全性,请首先使用基于文件的安全性来配置应用程序,并在配置应用程序后,切换到 LDAP 认证。有关更多信息,请参阅为 Tomcat 配置 LDAP 认证
    1. 在文本编辑器中,打开 tomcat_for_rtc_install_directory\conf\tomcat-users.xml 文件。同上,如果将应用程序安装到同一 Tomcat 服务器上,那么该文件是您在其中修改了 Rational Asset Manager 应用程序的用户安全性设置的同一文件。
    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 角色添加到在您修改 Rational Asset Manager 应用程序的用户安全性设置时创建的用户。

  14. 启动 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
  15. 配置 Rational Team Concert 来与 Rational Asset Manager 协作。 您必须配置管理权限并在 Rational Team Concert 中创建项目区域。

反馈