可以在 Apache Tomcat 的现有安装上手动安装 IBM® Rational® Asset Manager。
开始之前
您必须对已安装并在运行的 Tomcat 服务器具有管理和文件访问权。
必须具有 Tomcat 服务器的安全证书。包含的 Rational Team Concert 版本需要安全连接。
您需要知道 db2jcc_license_cu.jar 文件和 db2jcc.jar 文件的位置,这两个文件使 Tomcat 能够与 IBM DB2 数据库服务器通信。您的数据库服务器供应商应会为您提供这两个文件。
关于此任务
如果要提高 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 文档。
- 验证所有存储库服务器是否都已设置为相同的当前日期、时间和时区。
- 在 Tomcat 和操作系统相应归档上检索 Rational Asset Manager 服务器文件。应用程序文件将位于 /apps/ 文件夹中。
- 将共享库文件解压缩到 <tomcat_install_directory>\shared\lib 文件夹:
- 查找并解压缩 <archive_extract_location>\apps\tomcat\sharedLib.zip 文件。
- 将解压缩的 sharedLib.zip 文件的全部内容复制到 <tomcat_install_directory>\shared\lib 目录。
- 如果要在不同 Tomcat 服务器上安装 Rational Team Concert ,请再次将 sharedLib.zip 文件的解压缩内容复制到其他 Tomcat 服务器上的 <tomcat_for_rtc_install_directory>\shared\lib 目录。
- 从目录 <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
- 要更改应用程序的上下文路径,请重命名 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 |
基于资产的开发和管理流程的文档应用程序 |
- 将 Tomcat server for Rational Asset Manager 配置为 DB2。
- 在文本编辑器中,打开 <tomcat_install_directory>\conf\server.xml 文件。
- 在 server.xml 中查找以 <Connector 开始且包含 port="8080" 或 port="8009" 的所有行:
将这些行的开头更改为 <Connector URIEncoding="UTF-8"。
- 在 server.xml 中的全局 JNDI 资源 <GlobalNamingResources> 和 </GlobalNamingResources> 开头与结束标记之间,对您的版本的 Tomcat 输入以下文本。
注: 对于
<your_username> 和
<your_password> 值,请使用对数据库具有完全管理访问权限的用户标识和密码。
显示的“maxWait”、“maxActive”和“maxIdle”值是样本值,可以根据性能需要进行调整。对于“url”属性,例如可能类似于
jdbc:db2://localhost:50000/RAMDB 之类的“url”属性
输入以下文本:
<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_server_name>:<db2_port_number>/<Rational_Asset_Manager_database_name>"
poolPreparedStatements="true"
maxWait="5000"
maxActive="4"
maxIdle="2"/>
- 将以下 JAR 文件从安装 DB2 的文件夹 <DB2_installaton_location>\java 复制到文件夹 <tomcat_install_directory>\common\lib 中:
- db2jcc_license_cu.jar
- db2jcc.jar
- 在安装介质中查找 <archive_extract_location>/apps/tomcat/RTC-server.zip 文件。
- 将 RTC-server.zip 解压缩到硬盘驱动器上的某个位置,在这些指示信息中称为 <rtc_install_dir>。
- 查找 <rtc_install_dir>/jazz/server/jazz_war.ear 文件并将其解压缩。可以使用免费的实用程序 7-Zip 解压缩.ear 文件。从解压缩的 jazz_war.ear 软件包中,将 jazz.war 文件复制到 <tomcat_for_rtc_install_directory>/webapps/ 目录。
- 在 Tomcat server for Rational Team Concert 上配置安全端口:
- 必须创建标识 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。
- 在 <tomcat_for_rtc_install_directory>\conf\server.xml 文件中,查找具有属性 scheme="https" 的 <Connector> 标记。
缺省文件包括已注释掉端口 8443 的示例 <Connector> 标记。
- 复制并粘贴以下文本:
<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> 是密钥库的协议。大多数情况下,它将为 TLS 或 SSL_TLS;
- <keystore_algorithm> 是密钥库的 X509 算法。根据证书源,大多数情况下它将为 SunX509 或 IbmX509。
- 如果更改端口值以使用 8443 以外的端口,那么对于非 SSL连接(缺省情况下,为端口 8080),请更改 redirectPort 属性的值以与 SSL 连接的端口编号匹配。
有关配置 Tomcat 的 SSL 的更多信息,请参阅 Apache Tomcat 5.5 SSL Configuration HOW-TO 和 Apache Tomcat Configuration reference。
- 配置 Tomcat 启动属性设置:
- 查找 Tomcat 启动文件并在文本编辑器中将其打开。在 Windows® 上,这是 <tomcat_for_rtc_install_directory>\bin\startup.bat。
在 Linux®、AIX® 或 Linux for zSeries®,此为 <tomcat_for_rtc_install_directory>/bin/startup.sh。
- 在启动文件中,输入以下文本,其中 <rtc_install_dir> 是步骤9中解压缩的目录:
在 Windows(将 <rtc_install_dir> 中的空白字符替换为 %20):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 上: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"
- 编辑 Jazz™ 服务器属性文件:
- 在 <rtc_install_dir>/jazz/server/conf/jazz/ 目录中,查找 teamserver.properties 文件,并将其重命名为 teamserver.derby.properties。
- 在 <rtc_install_dir>/jazz/server/conf/jazz/ 目录中,查找 teamserver.db2.win32.properties 文件(对于 Windows)或 teamserver.db2.linux.properties 文件(对于 Linux、AIX, 或 zLinux)并将该文件重命名为 teamserver.properties。
- 在 teamserver.properties 文件中,指定数据库和连接属性:
- 在文本编辑中,打开 teamserver.properties 文件。
- 查找以下行:
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
- 针对生命周期数据库的 DB2 服务器位置和名称,编辑 com.ibm.team.repository.db.jdbc.location 的值:
- 将 localhost:50000 替换为 DB2 数据库的位置和端口。
提示: 在 DB2 命令窗口中,运行命令 db2 get dbm cfg,然后查找包含 SVCENAME 的行,此行指明 DB2 端口名称和地址。如果此命令显示一个数字,请将其用作端口号(代替以上示例中的 50000)。如果该命令返回了一个非数字名称,请确定为此名称分配的端口号并使用该端口号。在 Linux 上,/etc/services 文件包含端口名称与端口号之间的映射;在 Windows 上,C:\windows\system32\drivers\etc\services 文件包含映射。有关更多信息,请咨询您的系统管理员或查阅数据库文档。
- 将 JAZZ 替换为生命周期数据库的名称。
- 将 db2admin 替换为 DB2 数据库的用户名。
注: DB2 用户必须具有创建表和表空间以及修改数据库配置的许可权。DB2 用户由操作系统创建。
- 在属性 com.ibm.team.repository.db.jdbc.password 中指定用户密码。
注: 切勿更改 com.ibm.team.repository.db.jdbc.location 属性中的文本 {password}。
- 将以下属性添加到 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>
- 为 Rational Team Concert创建表:
- 打开命令行窗口并浏览至<rtc_install_dir>/jazz/server/ 目录。
- 运行以下命令:
- 针对用户安全性配置 Tomcat 服务器。如果打算使用 LDAP 安全性,请首先使用基于文件的安全性配置应用程序,那么请在配置应用程序之后切换到 LDAP 认证(有关更多信息,请参阅 为 Tomcat 配置 LDAP 认证):
- 在文本编辑器中,打开 <tomcat_install_directory>\conf\tomcat-users.xml 文件(对于 server for Rational Asset Manager)。
- 添加名为 admin 的用户并为其分配角色 admin 和 manager。
可以在 <tomcat-users> 标记之间复制粘贴以下内容:
<user username="admin" password="" roles="admin,manager" />
此用户必须名为 admin。
- 在文本编辑器中,打开 <tomcat_for_rtc_install_directory>\conf\tomcat-users.xml 文件(对于 server for Rational Team Concert)。 同样,如果要将应用程序安装在相同 Tomcat 服务器上,这将是和步骤 15a 相同的文件。
- 在 <tomcat-users> 标记之间粘贴以下文本:
<role rolename="JazzUsers"/>
<role rolename="JazzAdmins"/>
<role rolename="JazzDWAdmins"/>
<role rolename="JazzGuests"/>
- 添加名为 admin 的用户并为其分配角色 admin、manager 和 JazzAdmins。可以在 <tomcat-users> 标记之间复制粘贴以下内容:
<user username="admin" password="" roles="admin,manager,JazzAdmins" />
如果将应用程序安装到相同服务器上,那么可以将 JazzAdmins 角色添加到在步骤
13b 中创建的用户。
- 重新启动 Tomcat 服务器。
- 为 Rational Team Concert 配置管理用户:
- 在 Web 浏览器中启动 Rational Team Concert 的管理 Web UI,地址为 https://<machine_name>:<secure_port>/jazz/admin/。 请注意 https;它必须为安全连接。
- 使用应用程序服务器管理员的用户标识和密码登录。 如果看到有关“访存服务器状态信息”的错误,请关闭数据库服务器和 Tomcat 服务器,然后重新启动并再次登录。
- 单击用户管理。 忽略关于未配置外部注册表的任何错误。
- 单击创建用户。
- 输入以下详细信息:
- 用户名:Tomcat 服务器管理员的用户标识
- 用户标识:Tomcat 服务器管理员的用户标识
- 电子邮件地址:Tomcat 服务器管理员的有效电子邮件地址
- 在“客户机访问许可证”部分中,选择 Rational Team Concert - 开发者以将开发者许可证分配给该用户。
- 单击保存。
- 注销,然后以应用程序服务器管理员身份登录回管理 Web UI。
- 将生命周期过程模板导入到 Rational Team Concert:
- 在 Rational Team Concert 管理 Web UI 中,单击过程模板管理。 如果无法看到过程模板管理链接,请注销,然后登录回管理 Web UI。
- 单击导入模板然后浏览到 <archive_extract_location>/DatabaseScripts/ 文件夹中的 com.ibm.ram.lifecycle.zip 文件。
然后单击确定。 您将看到 RAM 生命周期模板出现。
- 在 Rational Team Concert 中创建一个新项目区域:
- 在 Rational Team Concert 管理 Web UI,单击项目区域管理。 如果无法看到项目区域管理链接,请注销,然后登录回管理 Web UI。
- 单击创建项目区域。
- 输入有关项目区域的以下详细信息:
- 项目名称:RAM 生命周期
- 摘要:Rational Asset Manager 生命周期控制区域
- 描述:此区域用于管理 Rational Asset Manager 的生命周期
- 单击保存。
- 为项目区域分配相应的成员资格和过程角色:
- 在“项目区域管理”页面中,单击 RAM 生命周期项目区域。
- 在“管理员”部分中,单击添加;然后搜索并选择您已创建的管理员用户。
- 在“成员”部分中,单击添加;然后搜索并选择您已创建的管理员用户。
- 添加管理员后,单击管理员名称旁边的过程角色图标。
- 在“编辑过程角色”对话框中,从可用角色列表中选择管理然后单击添加。
- 单击完成。
- 单击保存。
- 停止 Tomcat 服务器,然后重新启动。
- 在 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 服务器应用程序。