在 WebSphere Web Application Server Community Edition(WASCE) 上部署运行 Rational Quality Manager(RQM)
RQM 和 WASCE 简介
在这篇教程中，我们会逐步引导您将 IBM Rational Quality Manager（以下简称为 RQM）运行于 WebSphere Web Application Server Community Edition（以下简称为 WASCE)，并通过使用 Apache 目录服务器来进行用户访问的认证和授权，使用 IBM DB2 Express-C 数据库来储存 RQM 中的测试资产。
RQM 简介
IBM® Rational® Quality Manager（RQM）是一个协作性的，基于 Web 的工具，它在软件开发的整个生命周期之内，提供了复杂的测试规划与测试构建，测试资产管理方法。它建立在 Jazz™平台的基础之上，并继承了该平台的许多优秀特性，在设计时是给各种规模测试团队使用的，可全面代替 Rational Manual Tester、Rational ClearQuest® Test Manager、和 Rational TestManager。RQM 提供了各种各样的用户角色，例如测试管理员、测试结构师、测试经理、测试人员以及实验室管理员等，还包括测试机构外部的各种角色。
为何将 RQM 部署于 WASCE 上？
IBM WebSphere® Application Server Community Edition（即 WASCE）是 IBM 推出的通过 Java EE 5 认证的轻量级的开源应用服务器，它实现了所有 Java EE 5 中所包含的新技术。WASCE 基于 Apache 软件基金会的开源应用服务器项目 Geronimo，为开发、部署 Java 应用提供了简单灵活的基础平台。
将 RQM 部署于 WASCE 时，可利用 WASCE 管理界面提供的丰富的管理工具，配置用于用户授权和认证的 security realm 信息，同时，可以通过命令行参数快速配置相关 Jazz 平台的属性信息。
WASCE 与 DB2 Express-C 数据库联合使用，可靠保管测试资产，在访问数据库时，WASCE 性能卓越，可大大降低访问时间。
如果您已经使用了 WASCE 来帮助开发和部署应用程序，即可重用已有资产，降低企业成本。随着企业应用需求的增长，可以使用 WASCE 的其他组件模块，来更好的帮助企业发展。
先决条件
java 环境支持
在进行配置之前，请确认已经安装了 JDK 环境。如果您还没有配置 JDK 环境，在下载 WASCE 时，您可以选择包含 IBM Java SDK 的 WASCE Bundle。
Apache 目录服务器 & Apache Directory Studio
本文使用 Apache 的目录服务器来保存 RQM 的用户信息。当试图访问 RQM 时，将连接到 LDAP 服务器来进行用户的认证和授权。
在进行下一步配置之前，请确认已安装了 Apache 的目录服务器（Apahce 目录服务器和 RQM,WASCE 可以不在同一台机器上。为了更好地访问、查看目录服务器，可以安装 Apache Directory Studio 作为访问目录服务器的客户端。
获取更详细的下载安装信息，请参阅“Apache 目录服务器和客户端下载”，下载软件并根据安装向导逐步安装目录服务器和客户端。
数据库的支持
本文中，使用 IBM DB2 Express-C 来保存测试资产，这可以保障您获得更好的数据可靠性和访问性能。
在配置数据库之前，请确认已经安装 DB2 Express-C。RQM，WASCE 和数据库可以不在同一台机器上。
获取更详细的 DB2 Express-C 下载安装信息，请下载 DB2 Express-C 免费版。
安装 WASCE 服务器
如果您还未获取 WASCE 服务器，请下载 WASCE 免费版，获取最新 WASCE 版本。在安装过程中，如果您遇到任何安装问题，请参阅“如何安装 WASCE”获得帮助。
安装基于 TOMCAT 的缺省 RQM
请下载 RQM 试用版。下载 RQM 试用版后，将三个 zip 包解压到同一目录下面，这个目录路径，以下简称为 JAZZInstallDir，解压后我们将得到三个文件目录 RQM_SETUP、RQM、和 RTC。
打开 RQM_SETUP 目录，执行 Windows 平台上的 launchpad.exe 文件或者在 Linux 平台上 launchpad.sh，启动并安装 Installation Manager
根据 Installation Manager 的安装向导提示，安装 RQM。为了确保您能够成功地将 RQM 安装到 WASCE 上，请将 RQM 安装到无空格的目录。
从 RQM 安装文件提取文件
从 Jazz Team Server 文件中提取部分文件，将其拷贝到一个新的安装的目录，这个目录路径以下简称为 JAZZ_HOME。
需要被拷贝到 JAZZ_HOME 目录的文件子集为：
repository 工具：JazzInstallDir/repotools
Java 运行环境：JazzInstallDir/server/jre
Log4j 属性文件：JazzInstallDir/server/log4j.properties
备注 : 缺省的记录 Jazz Team Server 的日志目录为 tomcat/logs/jazz.log。通过修改 log4j.properties 文件，您可以修改日志保存路径。
JazzInstallDir/server/rqm-update-site
JazzInstallDir/server/rqm-license-update-site
JazzInstallDir/server/nl1-update-site
JazzInstallDir/server/update-site.
The file JazzInstallDir/server/conf/jazz/teamserver.db2.properties.
JazzInstallDir/server/conf/jazz/provision_profiles.
JazzInstallDir/server/conf/jazz/friendsconfig.rdf
JazzInstallDir/server/conf/jazz/Services.xml
JazzInstallDir/server/tomcat/webapps/jazz.war.
将以上文件拷贝到新的目录后，修改 JAZZ_HOME/server/provision_profiles/ 目录下的 profile.ini 和 license-profile.ini 文件，将 URL 属性修改为绝对路径。例如，将 url=file:./update-site 修改为 url=file:///D:/JAZZ_HOME/server/update
请注意，JazzInstallDir/server/provision_profiles/ 必须只包括 .ini 文件，如果有自动生成的备份文件，请手动删除。
配置数据库
创建数据库
在命令行窗口运行 db2start，启动 db2 Express-C 数据库。
从开始菜单中，点击 DB2 命令行工具菜单，打开 DB2 命令行窗口，创建名为的 JAZZ 数据库
Windows
db2 create database JAZZ on c: using codeset UTF-8 territory en pagesize 16384
Linux
db2 create database JAZZ using codeset UTF-8 territory en pagesize 16384
备注 :
1. 为能正确识别 Unicode 内容，数据库字符集编码必须设定为 UTF-8
2. 经测试验证，表空间的大小推荐设置为为 16k 以上
配置属性文件
将 JAZZ_HOME/server/conf/jazz/teamserver.db2.properties 文件重命名为 teamserver.properties，并根据数据库详细设置情况修改数据库配置信息。请注意，DB2 用户由操作系统创建，该 DB2 用户必须拥有创建表，表空间，修改数据库配置的权限。
清单 1. 数据库配置信息
com.ibm.team.repository.db.vendor = DB2 com.ibm.team.repository.db.jdbc.location=
//localhost:50000/JAZZ:fullyMaterializeLobData=false;user=db2admin;password={password};
com.ibm.team.repository.db.jdbc.password=db2admin
DB2 服务器 IP : 缺省值为 localhost.
DB2 服务端口 : 缺省值为 50000.
DB2 用户名 : 缺省值为 db2admin.
DB2 密码 : 缺省值为 db2admin.
DB2 数据库表空间位置 : 缺省值为 content_tablespace.
创建数据库表
在命令行窗口执行repotools -createTables 命令，为 Jazz™ repository 一键创建数据库表空间、表、索引。
Windows
repotools.bat -createTables
Linux
repotools.sh -createTables
成功创建 RQM 所需的表之后，需要重启数据库，以使操作生效。
如果您需要使用其他数据库如 oracle，Microsoft sql server 来储存 RQM 资产，请参阅 RQM 配置数据库获取更详细的信息。
配置安全认证
在 Web.xml 文件定义安全角色和权限
RQM 作为一个应用被部署到 WASCE，部署包是 jazz.war。由于 RQM 在软件测试的各个生命周期被使用，它提供了各种各样的用户的测试角色。测试角色权限的设定被定义在部署描述符文件 web.xml 中。如片段所示，我们使用 security-role 元素定义了 JazzAdmins,JazzUsers,JazzGuests,JazzDWAdmins 四类安全角色，使用 security-constraint 标识资源访问的角色限定。
清单 2. web.xml 片段
<security-constraint>
<web-resource-collection>
<web-resource-name>secure</web-resource-name>
<url-pattern>/authenticated/identity</url-pattern>
<url-pattern>/secure/authenticated/identity</url-pattern>
<url-pattern>/web/loggedInUser</url-pattern>
<url-pattern>/secure/service/com.ibm.rqm.integration.service
.IIntegrationService</url-pattern>
</web-resource-collection>
<auth-constraint>
<role-name>JazzUsers</role-name>
<role-name>JazzAdmins</role-name>
<role-name>JazzGuests</role-name>
<role-name>JazzDWAdmins</role-name>
</auth-constraint>
<user-data-constraint>
<transport-guarantee>CONFIDENTIAL</transport-guarantee>
</user-data-constraint>
</security-constraint>
<security-role>
<role-name>JazzAdmins</role-name>
</security-role>
<security-role>
<role-name>JazzDWAdmins</role-name>