在WASCE上部署运行RQM(一)
简介： 在这篇教程中，我们会逐步引导您将 IBM Rational Quality Manager（RQM）安装运行于 WebSphere Web Application Server Community Edition（WASCE），并通过使用 Apache 目录服务器进行用户访问的认证和授权和 IBM DB2 Express-C 数据库来储存 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 所需的表之后，需要重启数据库，以使操作生效。
关于 DB2 更详细的配置信息，请参阅“为 RQM 配置 DB2 V9.1”。
如果您需要使用其他数据库如 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 片段
secure/authenticated/identity/secure/authenticated/identity/web/loggedInUser/secure/service/com.ibm.rqm.integration.service .IIntegrationServiceJazzUsersJazzAdminsJazzGuestsJazzDWAdminsCONFIDENTIALJazzAdminsJazzDWAdminsJazzUsersJazzGuests |
连接 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: [email protected] 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 文件。
获取更详细的启动信息，请参阅“如何启动 WASCE”。
点击左边控制台导航的 [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
console.realmJazzSecurityRealm1.0carorg.apache.geronimo.frameworkj2ee-securitycar|-------10--------20--------30--------40--------50--------60--------70--------80--------9| |-------- XML error: The previous line is longer than the max of 90 characters ---------| JazzSecurityRealmServerInfo < log:login-domain-name>JazzSecurityRealm org.apache.geronimo.security.realm.providers. LDAPLoginModulecom.sun.jndi.ldap.LdapCtxFactoryou=users,ou=system(uniqueMember={0})falsesecretsimpleou=groups,ou=systemuid=admin,ou=systemldap://9.186.10.16:10389cnuid={0}false |
如果跳过以上图形界面配置步骤，可以直接修改该 JazzSecurityRealm.xml 文件，根据您实际的 LDAP 配置修改相应参数。然后通过管理控制台或者命令行窗口来直接部署该 realm 文件：java -jar bin\deployer.jar JazzSecurityRealm.xml。
配置 geronimo-web.xml 文件
配置完 LDAP realm 文件，接下来需要为 Jazz 应用程序配置部署计划文件来使用该 LDAP realm 文件。
清单 5. geronimo-web.xml
JazzTeamServerjazz2.1.1.2car/jazzJazzSecurityRealm |
备注 :
JazzSecurityRealm 定义了 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 |
来自 “ ITPUB博客 ” ，链接：http://blog.itpub.net/14780873/viewspace-673745/，如需转载，请注明出处，否则将追究法律责任。
转载于:http://blog.itpub.net/14780873/viewspace-673745/