在WASCE上部署运行RQM(一)

夏铭, 软件工程师, IBM
 
姜璐, 实习生, 南京大学
 

简介:  在这篇教程中,我们会逐步引导您将 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 提供了各种各样的用户角色,例如测试管理员、测试结构师、测试经理、测试人员以及实验室管理员等,还包括测试机构外部的各种角色。

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 的其他组件模块,来更好的帮助企业发展。

先决条件

  1. java 环境支持

在进行配置之前,请确认已经安装了 JDK 环境。如果您还没有配置 JDK 环境,在下载 WASCE 时,您可以选择包含 IBM Java SDK 的 WASCE Bundle。

  1. Apache 目录服务器 & Apache Directory Studio

本文使用 Apache 的目录服务器来保存 RQM 的用户信息。当试图访问 RQM 时,将连接到 LDAP 服务器来进行用户的认证和授权。

在进行下一步配置之前,请确认已安装了 Apache 的目录服务器(Apahce 目录服务器和 RQM,WASCE 可以不在同一台机器上。为了更好地访问、查看目录服务器,可以安装 Apache Directory Studio 作为访问目录服务器的客户端。

获取更详细的下载安装信息,请参阅“Apache 目录服务器和客户端下载”,下载软件并根据安装向导逐步安装目录服务器和客户端。

  1. 数据库的支持

本文中,使用 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

  1. DB2 服务器 IP : 缺省值为 localhost.
  2. DB2 服务端口 : 缺省值为 50000.
  3. DB2 用户名 : 缺省值为 db2admin.
  4. DB2 密码 : 缺省值为 db2admin.
  5. 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 连接参数
图 1. LDAP 连接参数

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


图 2. LDAP 连接参数 2
图 2. LDAP 连接参数 2

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

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


图 3. 导入 LDIF
图 3. 导入 LDIF

图 4. 指定 LDIF 文件位置
图 4. 指定 LDIF 文件位置

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


图 5. 查看用户和组信息
图 5. 查看用户和组信息

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


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

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

在 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 链接
图 6. Security Realm 链接

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


图 7. 添加新的 security realm
图 7. 添加新的 security realm

 

配置 security realm

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


图 8. Realm 名字和类型
图 8. Realm 名字和类型

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


图 9. LDAP 参数
图 9. LDAP 参数

图 10. LDAP 参数 2
图 10. LDAP 参数 2

图 11. LDAP 参数 3
图 11. LDAP 参数 3

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


图 12. 其他高级属性
图 12. 其他高级属性

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


图 13. 测试 LDAP 连接
图 13. 测试 LDAP 连接

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


图 14. 部署 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

配置完 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/

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值