在 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)，在 WebSphere Web Applic

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>　
　</security-role>　
<security-role>　
　<role-name>JazzUsers</role-name>　
</security-role>　
<security-role>　
　<role-name>JazzGuests</role-name>　
</security-role>　

连接 LDAP 服务器

使用 Apache Directory Studio 连接到 Apache 目录服务器，向服务器添加用户和组信息。

打开 Apache Directory Studio，点击 [LDAP]->[New Connection]…，您将会看到如下对话框，输入连接名 [connection name]，指定主机名 [hostname] 和端口号 [port]，建立对已存在的 LDAP 服务器的连接。

图 1. LDAP 连接参数

点击下一步 [Next]，选择 simple authentication 为认证方法，然后输入绑定用户名和密码。缺省用户名： uid=admin，ou=system ；密码：secret。

图 2. LDAP 连接参数 2

准备 LDIF 文件

LDIF（LDAP Data Interchange Format）是一种用于传递与 LDAP 兼容的目录中的信息的数据格式标准。LDIF 文件中的每个条目包含了用户和组的具体信息。示例的 LDIF 文件如下，您可以从附件中下载。

清单 3. LDIF 文件片段

#User　Information　
dn:　uid=ben,ou=users,ou=system　
objectClass:　organizationalPerson　
objectClass:　person　
objectClass:　inetOrgPerson　
objectClass:　top　
cn:　Ben　Liang　
givenname:　Ben　
l:　ShangHai　
mail:　ben@ibm.com　
ou:　WASCE　
ou:　CDL　
sn:　Liang　
uid:　ben　
userpassword::　YWRtaW5sZGFw　
　
#Group　Information　
dn:　cn=WASCEJazzAdmins,ou=groups,ou=system　
objectClass:　groupOfUniqueNames　
objectClass:　top　
cn:　WASCEJazzAdmins　
uniquemember:　uid=root,ou=users,ou=system　
uniquemember:　uid=jessy,ou=users,ou=system　
uniquemember:　uid=forrest,ou=users,ou=system　
uniquemember:　uid=ben,ou=users,ou=system　

将 LDIF 文件导入 Apache 目录服务器

点击 [File] -> [Import…]，指定 LDIF 文件的位置和 LDAP 服务器连接，将 LDIF 文件导入目录服务器中。

图 3. 导入 LDIF


图 4. 指定 LDIF 文件位置

查看原图（大图）

导入 LDIF 文件后，可以看到用户和组信息出现在 LDAP 服务器中。

图 5. 查看用户和组信息

在 LDIF 文件中，我们创建了如下四类角色的用户。

表 1. 目录服务器中的用户和组

组	用户
WASCEJazzAdmins	root,forrest,jessy,ben
WASCEJazzDWAdmins	viola,bin,root,forrest
WASCEJazzUsers	Shiny,testUser
WASCEJazzGuests	Shiny

生成 LDAP realm 文件

在 WASCE 中，通过配置相应的 LDAP realm 文件，并在服务器范围内或应用程序范围内部署此计划，就可使用 LDAP 来进行用户认证和授权。

首先第一步，启动 WASCE，打开 WASCE 安装目录下的 bin 目录，在 windows 平台，运行 startup.bat 或 start-server.bat 文件；在 Linux 平台，请运行 startup.sh 或 start-serer.sh 文件。

点击左边控制台导航的 [Security Realms] 链接，进入 Security realm 配置页面

图 6. Security Realm 链接

点击 [Add new security realm]，添加新的 Security Realm 文件。

图 7. 添加新的 security realm

配置 security realm

输入 security realm 文件名如 JazzSecurityRealm 和 realm 文件类型 LDAP Realm

图 8. Realm 名字和类型

查看原图（大图）

根据具体的 LDAP 信息，设置 Security realm 配置参数，参照下图例子。

图 9. LDAP 参数

查看原图（大图）

图 10. LDAP 参数 2

查看原图（大图）

图 11. LDAP 参数 3

查看原图（大图）

点击下一步，可配置其他高级属性。

图 12. 其他高级属性

查看原图（大图）

在使用 RQM 之前，我们必须确保所设定的 LDAP 配置信息是正确的，这样才能对 RQM 用户进行正确的认证和授权。单击 [Test a Login] 连接到 LDAP 服务器进行测试。

图 13. 测试 LDAP 连接

查看原图（大图）

点击 [Next] 查看登录测试结果。如果用户名和密码信息正确的话，则会出现 "Login succeeded with * principles " 的测试结果，点击 [Deploy Realm]，部署 Realm 文件，如果登录失败，请点击 [Edit Realm]，重新审查编辑 Realm 文件。

图 14. 部署 realm 文件

查看原图（大图）

点击 [Show Plan]，查看 Realm 文件。

清单 4. security realm 部署文件 -JazzSecurityRealm.xml

<module　xmlns="http://geronimo.apache.org/xml/ns/deployment-1.2">　
　<environment>　
　<moduleId>　
　<groupId>console.realm</groupId>　
　<artifactId>JazzSecurityRealm</artifactId>　
　<version>1.0</version>　
　<type>car</type>　
</moduleId>　
　<dependencies>　
　<dependency>　
　<groupId>org.apache.geronimo.framework</groupId>　
　<artifactId>j2ee-security</artifactId>　
　<type>car</type>　
　</dependency>　
　</dependencies>　
　</environment>　
　<gbean　name="JazzSecurityRealm"　class="org.apache.geronimo.security　
　　.realm.GenericSecurityRealm"　xsi:type="dep:gbeanType"　
　　xmlns:dep="http://geronimo.apache.org/xml/ns/deployment-1.2"　xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">　
|-------10--------20--------30--------40--------50--------60--------70--------80--------9|　
|--------　XML　error:　The　previous　line　is　longer　than　the　max　of　90　characters　---------|　
　<attribute　name="realmName">JazzSecurityRealm</attribute>　
　<reference　name="ServerInfo"><name>ServerInfo</name></reference>　
　<xml-reference　name="LoginModuleConfiguration">　
　<log:login-config　xmlns:log="http://geronimo.apache.org/xml/ns/loginconfig-2.0">　
<log:login-module　control-flag="REQUIRED"　wrap-principals="false">　
<　log:login-domain-name>JazzSecurityRealm</log:login-domain-name>　
<log:login-module-class>org.apache.geronimo.security.realm.providers.　
LDAPLoginModule</log:login-module-class>　
　<log:option　name="initialContextFactory">com.sun.jndi.ldap.LdapCtxFactory</log:option>　
　<log:option　name="userBase">ou=users,ou=system</log:option>　
　<log:option　name="roleSearchMatching">(uniqueMember={0})</log:option>　
　<log:option　name="userSearchSubtree">false</log:option>　
　<log:option　name="connectionPassword">secret</log:option>　
　<log:option　name="authentication">simple</log:option>　
　<log:option　name="roleBase">ou=groups,ou=system</log:option>　
　<log:option　name="connectionUsername">uid=admin,ou=system</log:option>　
　<log:option　name="connectionURL">ldap://9.186.10.16:10389</log:option>　
　<log:option　name="roleName">cn</log:option>　
　<log:option　name="userSearchMatching">uid={0}</log:option>　
　<log:option　name="roleSearchSubtree">false</log:option>　
　</log:login-module>　
　</log:login-config>　
　</xml-reference>　
　</gbean>　
</module>　

如果跳过以上图形界面配置步骤，可以直接修改该 JazzSecurityRealm.xml 文件，根据您实际的 LDAP 配置修改相应参数。然后通过管理控制台或者命令行窗口来直接部署该 realm 文件：java -jar bin\deployer.jar JazzSecurityRealm.xml。

配置 geronimo-web.xml 文件

配置完 LDAP realm 文件，接下来需要为 Jazz 应用程序配置部署计划文件来使用该 LDAP realm 文件。

清单 5. geronimo-web.xml

<web-app　xmlns="http://geronimo.apache.org/xml/ns/j2ee/web-2.0.1"　
　xmlns:sec="http://geronimo.apache.org/xml/ns/security-1.2"　
　xmlns:dep="http://geronimo.apache.org/xml/ns/deployment-1.2">　
　<dep:environment>　
　<dep:moduleId>　
　<dep:groupId>JazzTeamServer</dep:groupId>　
　<dep:artifactId>jazz</dep:artifactId>　
　<dep:version>2.1.1.2</dep:version>　
　<dep:type>car</dep:type>　
　</dep:moduleId>　
　<dep:hidden-classes/>　
　<dep:non-overridable-classes/>　
　</dep:environment>　
　<context-root>/jazz</context-root>　
<security-realm-name>JazzSecurityRealm</security-realm-name>　
　<security>　
　<default-principal　realm-name="ldap-realm">　
　<principal　class="org.apache.geronimo.security.realm.providers.GeronimoUserPrincipal"　
　name="anonymous"/>　
　</default-principal>　
　<role-mappings>　
　<role　role-name="JazzAdmins">　
　<realm　realm-name="ldap-realm">　
　<principal　class="org.apache.geronimo.security.realm.providers.GeronimoGroupPrincipal"　
　name="WASCEJazzAdmins"　designated-run-as="true"/>　
　</realm>　
　</role>　
　<role　role-name="JazzDWAdmins">　
　<realm　realm-name="ldap-realm">　
　<principal　class="org.apache.geronimo.security.realm.providers.GeronimoGroupPrincipal"　
　name="WASCEJazzDWAdmins"　designated-run-as="true"/>　
　</realm>　
　</role>　
　<role　role-name="JazzUsers">　
　<realm　realm-name="ldap-realm">　
　<principal　class="org.apache.geronimo.security.realm.providers.GeronimoGroupPrincipal"　
　name="WASCEJazzUsers"　designated-run-as="true"/>　
　</realm>　
　</role>　
<role　role-name="JazzGuests">　
<realm　realm-name="ldap-realm">　
<principal　class="org.apache.geronimo.security.realm.providers.GeronimoGroupPrincipal"　
　name="WASCEJazzGuests"　designated-run-as="true"/>　
　</realm>　
　</role>　
　</role-mappings>　
　</security>　
</web-app>　

备注 :

<security-realm-name>JazzSecurityRealm</security-realm-name> 定义了 Jazz 应用程序所使用的 LDAP realm 部署文件。

RQM 中有 4 个用户组，JazzAdmins、JassDWAdmins、JazzUsers 和 JazzGuests。在 LDAP 服务器中，我们建立 4 个相应的用户组与之对应。通过 role-mapping 属性，我们可以配置这两组用户组直接的对应关系。

表 2. RQM 用户和目录服务器中用户的映射关系

Jazz Role Groups	Groups In LDAP server
JazzAdmins	WASCEJazzAdmins
JazzDWAdmins	WASCEJazzDWAdmins
JazzUsers	WASCEJazzUsers
JazzGuests	WASCEJazzGuests

安装 RQM

重启 WASCE 服务器

将 WASCE 服务器的安装目录简称为 WASCE_HOME，打开命令窗口，切换工作目录到 wasce_Home/bin，在启动服务器之前，必须设置 GERONIMO_OPTS 变量，在不同平台，分别输入如下命令：

清单 6. 设置 geronimo_opts 参数

Windows

set　GERONIMO_OPTS=-Xmx1000M　-XX:MaxPermSize=128m　
-Dcom.ibm.team.repository.provision.profile　=file:///JAZZ_HOME/server/conf/jazz　
/provision_profiles　
-Dcom.ibm.team.server.configURL=file:///JAZZ_HOME/server/conf/jazz/　
teamserver.properties　
-Dlog4j.configuration=file:///JAZZ_HOME/server/log4j.properties　
-Djava.awt.headless=true　
-Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true　
-Dcom.ibm.team.repository.discovery.document.location=　
　file:///JAZZ_HOME/server/conf/jazz/services.xml　
-Dcom.ibm.team.repository.friends.config.location=　
　file:///JAZZ_HOME/server/conf/jazz/friendsconfig.rdf　

AIX / Linux / Solaris

　export　GERONIMO_OPTS=”-Xmx1000M　-XX:MaxPermSize=128m　
-Dcom.ibm.team.repository.provision.profile　=file:///JAZZ_HOME/server/conf/jazz　
/provision_profiles　
-Dcom.ibm.team.server.configURL=file:///JAZZ_HOME/server/conf/jazz/teamserver.properties　
-Dlog4j.configuration=file:///JAZZ_HOME/server/log4j.properties　
-Djava.awt.headless=true　
-Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true　
-Dcom.ibm.team.repository.discovery.document.location=　
　file:///JAZZ_HOME/server/conf/jazz/services.xml　
-Dcom.ibm.team.repository.friends.config.location=　
　file:///JAZZ_HOME/server/conf/jazz/friendsconfig.rdf　

备注 :

此处 JAZZ_HOME 是指所拷贝的 JAZZ 安装文件子集的路径。

命令必须在同一行，每个 -D 选项之间以空格隔开。

每次启动 RQM 之前，都必须设置 GERONIMO_OPTS 环境变量，如果您想永久性地记录这些属性，可以修改 WASCE_HOME/bin 目录下的 startup.bat(sh）脚本。

在启动过程中可能会出现如下错误，并不影响 RQM 的运行，可以忽略。{[ExtensionRegistryEventDispatcher]ERRORx.internal.javascript.JavaScriptDependencyAnalyzer - Locale path [../com/ibm/team/dashboard/web/ui/internal/nls] is not found } .

打开命令窗口，切换到工作目录 wasce_Home/bin，其中 wasceHome 是服务器的安装目录。调用服务器的 startup 脚本

Windows

　startup.bat　

Linux

　startup.sh　

备注 :

尽管 WASCE 服务器有多种启动的方式，推荐通过在命令行输入 startup.bat(sh)，这样可以确保 GERONIMO_OPTS 参数在 WASCE 启动时被读入。

为了检查您是否正确配置了这些 GERONIMO_OPTS 参数，可以通过在浏览器访问 http://localhost:8080/console/portal/Server/Java%20System%20Info 查看 WASCE 的系统信息，使用以下信息登录：缺省用户名为 system，缺省密码为 manager，在 Etc 标签窗口下，您可以看到刚刚配置的一些 RQM 参数，如下图所示：

图 15. 查看 Geronimo_OPTS 参数

查看原图（大图）

部署 jazz 应用程序

通过在浏览器访问 http://localhost:8080/console/portal 登录 WASCE 服务器。

在登录页面上，通过输入授权访问管理控制台的用户名和密码来登录到管理控制台。默认用户名为 system，默认密码为 manager，在管理控制台页面上，找到 Console Navigation，然后在 Applications 标签下，选择 Deploy New。在 Archive 这一栏，选择 JAZZ_HOME/server/tomcat/webapps 目录下的 jazz.war，在 Plan 这一栏，选择刚刚创建的 geronimo-web.xml 文件，单击 [Install], 开始部署 RQM 应用。

访问配置 RQM

登录到 RQM 的管理控制台

在浏览器访问 https://localhost:8443/jazz/admin，进入 RQM 的登录界面，根据权限设定，只有隶属于 JazzAdmin 和 JazzDWAdmin 的用户才有权限进入，所以我们要使用在 LDAP 服务器总配置好的 JazzAdmins 和 JazzDWAdmin 用户登录。

图 16. RQM 登录界面

查看原图（大图）

如果使用 JazzUsers 或 JazzGuests 组的用户登录，会出现 The user testUser is not authorized to access Jazz Team Server Admin UI 的错误提醒。

图 17. 用户认证失败

查看原图（大图）

配置 RQM 高级属性 .

单击 Configure 下的 [Advanced Properties]，在屏幕右方会出现所有的配置属性。

图 18. 高级属性链接

在本文中，我们使用 DB2 Express-C 来保存测试资产，单击 [Database Connection]，对数据库连接信息进行详细配置。

图 19. 数据库连接属性

查看原图（大图）

DB Type 填写 JDBC，默认值为 JDBC

JDBC Vendor 填写 DB2，默认值为 Derby

JDBC Location 填写 //DB2_Server_IP:port/JAZZ:user=db2admin;password={password};

DB2_Server_IP,port,user 根据您的实际配置填写。

JDBC Password 填写连接到数据库的密码。

在 "User Registry Type" 一栏中选择 LDAP，以完成 RQM 与 LDAP 的集成。

图 20. 选择注册类型

查看原图（大图）

配置 RQM

在浏览器访问 https://localhost:8443/jazz/setup 进入用户配置界面，进一步配置 RQM 使用的数据库的连接信息，邮件通知功能和用户注册信息。

RQM 提供了两种配置方式 Fast Path Setup 和 Custom Setup，如果您采用 RQM 的默认设置，可使用 Fast Path Setup。本文中对数据库连接信息和用户注册信息需进行详细的设定，推荐使用 Custom Setup 的配置方式，它会引导您进行详细的 RQM 设置。

数据库连接信息配置

在上一步配置 RQM 高级属性时，已经对数据库连接信息进行了设定，在这里只需检测确保上一步配置的信息和实际情况相同。

图 21. 配置数据库和连接类型

查看原图（大图）

图 22. 数据库位置和密码信息

查看原图（大图）

E-mail 通知

如果您想追踪 RQM 中任何的工作项目的变化，在 E-Mail Notification 一栏中选择 Enabled，然后对 SMTP 服务器进行正确的参数设置，这样就可以开通电子邮件通知，每当项目信息发生变化，您将会收到一份邮件通知。

如果您对邮件通知功能不感兴趣，在 E-Mail Notification 一栏中选择 Disabled。

图 23. 设置邮件通知

查看原图（大图）

用户注册信息

在“Select the type of user registry you will use”域中选择 LDAP，开始设置 RQM 和 LDAP 的连接。

图 24. 选择用户注册类型

查看原图（大图）

下一步，在 LDAP Registry Location 域填写 LDAP 服务器的位置：格式为：ldap://ldap_server_ip:port，在 User Name 和 Password 域，填写访问 LDAP 的用户信息，如果您打算匿名访问 LDAP 服务器，这两处可以不填。

图 25. 配置 LDAP 连接信息

查看原图（大图）

在 Base User DN 域中，设定 LDAP 中 RQM 用户的 Base DN。

在 User property Names Mapping 中，对 RQM 用户的属性和 LDAP 服务器中的属性进行匹配映射。

图 26. 设置 base DN 和用户属性映射

查看原图（大图）

在 Base Group DN 域中，设定 LDAP 中 RQM 用户组的 Base DN。

在 Jazz to LDAP Mapping 中，对 RQM 用户组属性和 LDAP 服务器中的用户组属性进行匹配映射。

图 27. 设置 Group DN 和组属性映射

查看原图（大图）

在 Group Name Property 域中，填写 LDAP 服务器中 RQM 用户组的名字，默认值为 cn。

在 Group Member Property 域中，填写代表属于 LDAP 服务器某个组成员的属性，默认值为 members。

图 28. 组名和代表组成员的属性

查看原图（大图）

创建缺省项目域

正确配置完以上数据后，您就可以开始您的第一个 RQM 管理项目了。

图 29. 创建缺省项目

查看原图（大图）

总结

通过以上配置，您可以成功地将 RQM 运行于 WASCE 服务器上，运用 LDAP 目录服务器中注册的用户登录 RQM，体验新一代测试管理和质量管理平台。它会从业务需求到测试计划，设计和执行过程进行跟踪，来帮助您有效控制软件质量。