简介: 在这篇教程中,我们会逐步引导您将 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 中的测试资产。
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 的其他组件模块,来更好的帮助企业发展。
先决条件
- 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”获得帮助。
请下载 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 用户必须拥有创建表,表空间,修改数据库配置的权限。
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 配置数据库获取更详细的信息。
配置安全认证
RQM 作为一个应用被部署到 WASCE,部署包是 jazz.war。由于 RQM 在软件测试的各个生命周期被使用,它提供了各种各样的用户的测试角色。测试角色权限的设定被定义在部署描述符文件 web.xml 中。如片段所示,我们使用 security-role 元素定义了 JazzAdmins,JazzUsers,JazzGuests,JazzDWAdmins 四类安全角色,使用 security-constraint 标识资源访问的角色限定。
secure/authenticated/identity/secure/authenticated/identity/web/loggedInUser/secure/service/com.ibm.rqm.integration.service .IIntegrationServiceJazzUsersJazzAdminsJazzGuestsJazzDWAdminsCONFIDENTIALJazzAdminsJazzDWAdminsJazzUsersJazzGuests |
使用 Apache Directory Studio 连接到 Apache 目录服务器,向服务器添加用户和组信息。
打开 Apache Directory Studio,点击 [LDAP]->[New Connection]…,您将会看到如下对话框,输入连接名 [connection name],指定主机名 [hostname] 和端口号 [port],建立对已存在的 LDAP 服务器的连接。
点击下一步 [Next],选择 simple authentication 为认证方法,然后输入绑定用户名和密码。缺省用户名: uid=admin,ou=system ;密码:secret。
LDIF(LDAP Data Interchange Format)是一种用于传递与 LDAP 兼容的目录中的信息的数据格式标准。LDIF 文件中的每个条目包含了用户和组的具体信息。示例的 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
图 4. 指定 LDIF 文件位置
导入 LDIF 文件后,可以看到用户和组信息出现在 LDAP 服务器中。
在 LDIF 文件中,我们创建了如下四类角色的用户。
组 | 用户 |
---|---|
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 配置页面
点击 [Add new security realm],添加新的 Security Realm 文件。
输入 security realm 文件名如 JazzSecurityRealm 和 realm 文件类型 LDAP Realm
根据具体的 LDAP 信息,设置 Security realm 配置参数,参照下图例子。
图 9. LDAP 参数
图 10. LDAP 参数 2
图 11. LDAP 参数 3
点击下一步,可配置其他高级属性。
在使用 RQM 之前,我们必须确保所设定的 LDAP 配置信息是正确的,这样才能对 RQM 用户进行正确的认证和授权。单击 [Test a Login] 连接到 LDAP 服务器进行测试。
点击 [Next] 查看登录测试结果。如果用户名和密码信息正确的话,则会出现 "Login succeeded with * principles " 的测试结果,点击 [Deploy Realm],部署 Realm 文件,如果登录失败,请点击 [Edit Realm],重新审查编辑 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 文件。
JazzTeamServerjazz2.1.1.2car/jazzJazzSecurityRealm |
备注 :
JazzSecurityRealm 定义了 Jazz 应用程序所使用的 LDAP realm 部署文件。
RQM 中有 4 个用户组,JazzAdmins、JassDWAdmins、JazzUsers 和 JazzGuests。在 LDAP 服务器中,我们建立 4 个相应的用户组与之对应。通过 role-mapping 属性,我们可以配置这两组用户组直接的对应关系。
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/