本主题描述如何将 IBM® Rational® Quality Manager 设置为与 WebSphere® Application Server 一起工作。此设置假设您在 Websphere Application Server 所在的机器上安装 Jazz™ 服务器。
规划配置
开始这些步骤之前,您应先完成下列操作:
- Jazz Team Server 需要已应用 IBM Java™ SDK 1.5 SR5 或更高版本累积修订的 WebSphere® Application Server V6.1,或者已至少安装 7.0.0.3 的 WebSphere Application Server V7.0。
IBM Java SDK
1.5 SR6 SDK 更新可从 http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492 获取。
如果使用 WebSphere 6.1 和 GA IBM Java SDK 但没有此修订程序,那么在一定数量的操作后,Jazz 将开始报告“代理错误”。
您必须针对 IBM Java SDK 1.5 SR9 或 IBM Java SDK 1.6 SR4 的修订程序获取对应的 WebSphere Application Server i-fix,必需这些修订程序以使 IBM Rational Team Concert™ 2.0 正确运行。否则,服务器中的部分服务可能不会正确启动。i-fix 可在其对应的 WebSphere Application Server APAR 下获取。对于 IBM Java SDK 1.5/WebSphere Application Server 6.1,APAR 为 PK85942,并且您可以从 ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/ 卸载文件。
安装 JRE i-fix 之前,先至少安装 WebSphere Application Server 6.1 修订包 19。对于 IBM Java SDK
1.6/WebSphere Application Server 7.0,APAR 为 PK 86771,并且您可以从 ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/ 下载文件。
- teamserver.properties 文件会通过数据库设置进行更新。
- 参见 WebSphere 文档以获取有关安全设置的信息并关闭不区分大小写的属性。
- 应关闭“Java 2 安全”选项。如果在 WebSphere Application Server 中打开了此选项,将会导致 jazz.war 启动失败。
- 确保选中 WAS 安全设置“在访问未受保护的 URI 时使用可用认证数据”。要在 WAS 集成解决方案控制台中完成此步骤,请执行以下操作:
- 在 V6.1 中,转至安全 -> 安全管理、应用程序和基础结构 -> Web 安全 - 一般设置。在 V7 中,转至安全 -> 全局安全 -> Web 和 SIP 安全 -> 一般设置。
- 选中“在访问未受保护的 URI 时使用可用认证数据”复选框。
配置 WebSphere Application Server
要配置 WebSphere Application Server,请执行以下操作:
- 如果 WebSphere Application Server 服务还未运行,请将其启动。
- 浏览到 WebSphere Application Server 管理控制台。
- 将服务器作为管理资源进行认证。
注: 安装了 WebSphere 软件的人员在安装时便已指定管理资源的用户标识和密码。
- 认证后,依次单击。
- 找到 server1 配置页面的服务器基础结构部分,展开 Java 和进程管理,然后单击进程定义。
- 在“进程定义”页面上,转至“其他属性”部分并单击 Java 虚拟机。
- 将“最大堆大小”增大到 1000 并单击应用。
- 在“Java 虚拟机”页面上的“通用 JVM 参数”部分中,包含下列 JVM 参数。确保在某一行上添加此 JVM 参数。
Windows® 示例:
-Dcom.ibm.team.server.configURL=file:///D:/RQM20/server/conf/jazz/teamserver.properties -Dlog4j.configuration=file:///D:/RQM20/server/log4j.properties -Djava.awt.headless=true -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -Xmx1000M -Dcom.ibm.team.repository.provision.profile=///D:/RQM20/server/conf/jazz/provision_profiles -Dcom.ibm.team.repository.discovery.document.location=file:///D:/RQM20/server/conf/jazz/services.xml -Dcom.ibm.team.repository.friends.config.location=file:///D:/RQM20/server/conf/jazz/friendsconfig.rdf -Dcom.ibm.rqm.create.samples=false -Xss768k
Linux® 示例:
-Dcom.ibm.team.server.configURL=file:///opt/IBM/RQM20/server/conf/jazz/teamserver.properties -Dlog4j.configuration=file:///opt/IBM/RQM20/server/log4j.properties -Djava.awt.headless=true -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -Xmx1000M -Dcom.ibm.team.repository.provision.profile=///opt/IBM/RQM20/server/conf/jazz/provision_profiles -Dcom.ibm.team.repository.discovery.document.location=file:///opt/IBM/RQM20/server/conf/jazz/services.xml -Dcom.ibm.team.repository.friends.config.location=file:///opt/IBM/RQM20/server/conf/jazz/friendsconfig.rdf -Dcom.ibm.rqm.create.samples=false -Xss768k
其中 D:/RQM20 是 Windows 上的安装目录,opt/IBM/RQM20 是 Linux 上的安装目录。
这些值必须进行编码,这要求文件路径中的任何空格都应替换为
%20。例如,
C:\Program Files 会变为
C:\Program%20Files。
如果 JVM 参数值输入不正确,那么 WebSphere Application Server 将不会启动。
如果发生此情况,那么不能使用 WebSphere Application Server Web 用户界面来对此进行纠正;您必须找到 server.xml 文件,对其进行编辑,然后启动 WebSphere Application Server。此文件通常位于以下位置:
c:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\config\cells\qwin268Node01Cell\nodes\qwin268Node01\servers\server1\server.xml
注: 在 Rational Team Concert 帮助中提及的 JVM 参数不包含正确部署 Rational Quality Manager 所需的完整 JVM 参数。
- 在“其他属性”下,单击定制属性。
- 单击新建并添加下列值:
- 保存对主配置文件的更改。
- 关闭 WebSphere Application Server 然后将其重新启动。
注: 如果服务器没有重新启动,请手动检查通用 JVM 参数。这些参数保留在 server.xml 文件中,此文件在典型安装中位于以下位置:
C:\Program Files\ibm\WebSphere\AppServer\profiles\AppSrv01\config\cells\enable01
Node01Cell\nodes\enable01Node01\servers\server1\server.xml
WebSphere Application Server 安全设置
要改进对 Oauth(使用 WebSphere Application Server 的安装)的支持,必须使用以下 Web 安全设置:
- 使用 WAS 集成解决方案控制台浏览到。
- 验证是否已选中在访问未受保护的 URI 时使用可用认证数据。
在 WebSphere Application Server 上配置 Rational Quality Manager 产品和帮助
要在 WebSphere Application Server 环境中配置 IBM Rational Quality Manager 产品和帮助,请执行以下操作:
- 启动 WebSphere 管理控制台界面并使用 WebSphere Application Server 管理用户标识来向服务器认证。
- 展开“应用程序”并单击安装新应用程序。
- 在新应用程序路径下,浏览到本地文件系统上 jazz.war 文件的所在位置并选择此文件。
- 将上下文根输入为 /jazz,然后单击下一步。
注: 您可以在以下位置找到 jazz.war 文件:RQM_install_dir\server\tomcat\webapps\jazz.war。
- 继续单击下一步直至出现“摘要”屏幕为止,然后单击完成以安装新应用程序。
- 验证是否已安装 jazz_war 应用程序,并且单击保存以保存对主配置文件的更改。
- 返回到安装新应用程序页面。
- 浏览到本地文件系统上 help.war 文件所在的位置并选择此文件。将上下文根输入为 /help 并单击下一步。
注: 您可以在以下位置找到 help.war 文件:RQM_install_dir\server\tomcat\webapps\help.war。
- 继续单击下一步直至出现“摘要”屏幕为止,然后单击完成以安装新应用程序。
- 验证是否已安装 help_war 应用程序,并且单击保存以保存对主配置文件的更改。
- 展开“应用程序”选项中的企业应用程序部分。
- 选择 jazz_war 并单击启动。
- 选择 help_ war 并单击启动。
针对 Rational Quality Manager 在 WebSphere Application Server 上配置 LDAP
要配置 LDAP,请执行以下操作:
- 从 Websphere 管理控制台,依次单击。
- 按如下所示更新安全设置:
- 启用管理安全:打开
- 启用应用程序安全:打开
- 用户帐户存储库/可用域定义:独立 LDAP 注册表
- 在“用户帐户存储库”部分中,单击配置并提供一般属性。
- 主管理用户名 - 您的用户标识
- 服务器用户标识 - 自动生成的服务器标识
- LDAP 服务器类型 - 定制
- 搜索超时 - 120 秒
- 单击应用并保存更改。
- 在“配置”部分中,单击测试连接。
- 在“其他属性”部分中,单击高级轻量级目录访问协议(LDAP)。
- 按如下所示指定“一般属性”字段:
- 用户过滤器:
(&(emailaddress=%v)(objectclass=ePerson))
- 组过滤器:
(&(cn=%v)(|(objectclass=groupOfNames)(objectclass=groupOfUniqueNames)))
- 用户标识映射:
*:emailaddress
- 组成员标识映射:(将 ibm 替换为您自己的标识)
ibm-allGroups:member;ibm-allGroups:uniqueMember
- 证书映射方式:
EXACT_DN
- 完成时单击应用并保存更改。
- 针对各屏幕单击应用和保存以确认各项设置。
注: 在最后一页上,确保将当前域定义设置为独立 LDAP 注册表。
- 停止 WebSphere Application Server 然后将其重新启动。
- 在 WebSphere Application
Server 重新启动后,通过登录到管理控制台来验证更改。
- 要将用户组映射到特定应用程序,请依次单击。
- 在企业应用程序列表中,选择 jazz_war 应用程序并单击停止。
- 当应用程序停止时,单击 jazz_war 应用程序以将其打开进行编辑。
- 在“详细属性”部分中,单击安全角色到用户/组映射。
- 选择特定组(如 JazzAdmins 和 JazzUsers)并单击查找组。
这些组与每个 Jazz 实施相关联,并且必须映射到包含授权用户的特定 LDAP 组。在执行此映射之前,需要在 LDAP 服务器上对这些组进行设置。
- 输入搜索字符串以从 LDAP 服务器中返回组名。单击搜索以运行查询。
- 从返回的可用组列表中,选择特定组并将其移至选定列。
- 单击确定以将 LDAP 组映射到 Jazz 组。
- 为以下所有 Jazz 组映射相应的 LDAP 组:
- JazzAdmins
- JazzDWAdmins
- JazzUsers
- JazzGuests
注: 请勿启用全部已认证?选项。
- 保存更改并重新启动 jazz_war 应用程序。
- 从管理控制台中注销并关闭浏览器窗口。
设置 WebSphere Application Server 定制注册表
注: 在评估 Rational Quality Manager 时,您可以使用此部分中的指示信息。
如果您使用的是 LDAP,那么这些指示信息在实际生产环境中没有作用。
要使用 WebSphere Application Server 定制注册表来设置用户凭证,请执行以下操作:
- 在选定位置创建名为 WAS_Security 的目录并向其添加 users.props 和 groups.props 文件。
有关这些文件格式的信息,请参阅 user.props 和 groups.props。
- 依次单击并从用户帐户存储库部分中选择独立定制注册表;然后单击安全配置向导按钮。
- 在安全配置向导的步骤 1 中,选择启用应用程序安全。
- 在步骤 2 中,选择独立定制注册表。
- 在步骤 3 的配置用户资源库中,添加主管理用户名,并为 usersFile(users.props)和 groupsFile(groups.props)添加名称和值:
- 在步骤 4 中,复审摘要,然后单击完成。
- 通过单击直接保存到主配置来保存更改。从中,选择 jazz.war,然后单击停止(除非如红色 x 所指示已停止)。
- 选择 jazz.war 链接,然后选择安全角色到用户/组映射。
- 选择 JazzAdmins,然后单击查找组:
- 单击查找组,然后从可用列表中选择管理员。
- 添加到选定列表。针对 JazzDWAdmins 重复步骤 9 和 10,从而再次选择管理员。
- 对于 JazzUsers 和 JazzGuests,遵循步骤 9 和 10,但是为角色选择用户。
- 通过单击直接保存到主配置来保存更改。
- 要完成 WebSphere Application Server 配置,请重新启动 WebSphere Application Server。
将 WebSphere Application Server 作为 Windows 服务启动
通过 Rational Quality Manager,您可以创建测试脚本,这些脚本能引用通过其他测试工具创建的自动测试。这些自动测试可以保存在本地测试机器或共享网络位置上。保存在共享网络位置上的测试通过通用命名约定(Universal Naming Convention,UNC)共享来进行访问。
缺省情况下,当 WebSphere Application Server 作为 Windows 服务运行时,它以本地系统帐户登录。在此情况下,Rational Quality Manager 可能将无法访问 UNC 共享,因为本地系统帐户缺少安全凭证。因此,请确保将 WebSphere Application Server Windows 服务设置为以具有安全凭证的特定用户帐户登录。这使服务能够连接到任何与该用户帐户的安全凭证匹配的 UNC 共享。