设置 WebSphere Application Server

本主题描述如何将 IBM® Rational® Quality Manager 设置为与 WebSphere® Application Server 一起工作。此设置假设您在 Websphere Application Server 所在的机器上安装 Jazz™ 服务器。

规划配置

开始这些步骤之前,您应先完成下列操作:

配置 WebSphere Application Server

要配置 WebSphere Application Server,请执行以下操作:

  1. 如果 WebSphere Application Server 服务还未运行,请将其启动。
  2. 浏览到 WebSphere Application Server 管理控制台。
  3. 将服务器作为管理资源进行认证。
    注: 安装了 WebSphere 软件的人员在安装时便已指定管理资源的用户标识和密码。
  4. 认证后,依次单击服务器 > 应用程序服务器 > server1
  5. 找到 server1 配置页面的服务器基础结构部分,展开 Java 和进程管理,然后单击进程定义
  6. 在“进程定义”页面上,转至“其他属性”部分并单击 Java 虚拟机
  7. 将“最大堆大小”增大到 1000 并单击应用
  8. 在“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 参数。
  9. 在“其他属性”下,单击定制属性
  10. 单击新建并添加下列值:
    • 名称:JAZZ_HOME :file:///RQM_install_dir/server/conf/
    • 名称:log4j.configuration :file:///RQM_install_dir/server/log4j.properties
    • 名称:java.awt.headless :true
    • 名称:org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin :true

      例如,按以下方式添加指定值:RQM_install_dir = C:/IBM/RQM20

  11. 保存对主配置文件的更改。
  12. 关闭 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 安全设置:

在 WebSphere Application Server 上配置 Rational Quality Manager 产品和帮助

要在 WebSphere Application Server 环境中配置 IBM Rational Quality Manager 产品和帮助,请执行以下操作:

  1. 启动 WebSphere 管理控制台界面并使用 WebSphere Application Server 管理用户标识来向服务器认证。
  2. 展开“应用程序”并单击安装新应用程序
  3. 新应用程序路径下,浏览到本地文件系统上 jazz.war 文件的所在位置并选择此文件。
  4. 将上下文根输入为 /jazz,然后单击下一步
    注: 您可以在以下位置找到 jazz.war 文件:RQM_install_dir\server\tomcat\webapps\jazz.war
  5. 继续单击下一步直至出现“摘要”屏幕为止,然后单击完成以安装新应用程序。
  6. 验证是否已安装 jazz_war 应用程序,并且单击保存以保存对主配置文件的更改。
  7. 返回到安装新应用程序页面。
  8. 浏览到本地文件系统上 help.war 文件所在的位置并选择此文件。将上下文根输入为 /help 并单击下一步
    注: 您可以在以下位置找到 help.war 文件:RQM_install_dir\server\tomcat\webapps\help.war
  9. 继续单击下一步直至出现“摘要”屏幕为止,然后单击完成以安装新应用程序。
  10. 验证是否已安装 help_war 应用程序,并且单击保存以保存对主配置文件的更改。
  11. 展开“应用程序”选项中的企业应用程序部分。
  12. 选择 jazz_war 并单击启动
  13. 选择 help_ war 并单击启动

针对 Rational Quality Manager 在 WebSphere Application Server 上配置 LDAP

要配置 LDAP,请执行以下操作:

  1. 从 Websphere 管理控制台,依次单击安全 > 安全管理、应用程序和基础结构
  2. 按如下所示更新安全设置:
    • 启用管理安全:打开
    • 启用应用程序安全:打开
    • 用户帐户存储库/可用域定义:独立 LDAP 注册表
    • 在“用户帐户存储库”部分中,单击配置并提供一般属性。
      • 主管理用户名 - 您的用户标识
      • 服务器用户标识 - 自动生成的服务器标识
      • LDAP 服务器类型 - 定制
      • 搜索超时 - 120 秒
  3. 单击应用并保存更改。
  4. 在“配置”部分中,单击测试连接
  5. 在“其他属性”部分中,单击高级轻量级目录访问协议(LDAP)
  6. 按如下所示指定“一般属性”字段:
    • 用户过滤器:
      (&(emailaddress=%v)(objectclass=ePerson)) 
    • 组过滤器:
      (&(cn=%v)(|(objectclass=groupOfNames)(objectclass=groupOfUniqueNames))) 
    • 用户标识映射:
       *:emailaddress
    • 组成员标识映射:(将 ibm 替换为您自己的标识)
      ibm-allGroups:member;ibm-allGroups:uniqueMember 
    • 证书映射方式:
      EXACT_DN
  7. 完成时单击应用并保存更改。
  8. 针对各屏幕单击应用保存以确认各项设置。
    注: 在最后一页上,确保将当前域定义设置为独立 LDAP 注册表
  9. 停止 WebSphere Application Server 然后将其重新启动。
  10. 在 WebSphere Application Server 重新启动后,通过登录到管理控制台来验证更改。
  11. 要将用户组映射到特定应用程序,请依次单击应用程序 > 企业应用程序
  12. 在企业应用程序列表中,选择 jazz_war 应用程序并单击停止
  13. 当应用程序停止时,单击 jazz_war 应用程序以将其打开进行编辑。
  14. 在“详细属性”部分中,单击安全角色到用户/组映射
  15. 选择特定组(如 JazzAdmins 和 JazzUsers)并单击查找组

    这些组与每个 Jazz 实施相关联,并且必须映射到包含授权用户的特定 LDAP 组。在执行此映射之前,需要在 LDAP 服务器上对这些组进行设置。

  16. 输入搜索字符串以从 LDAP 服务器中返回组名。单击搜索以运行查询。
  17. 从返回的可用组列表中,选择特定组并将其移至选定列。
  18. 单击确定以将 LDAP 组映射到 Jazz 组。
  19. 为以下所有 Jazz 组映射相应的 LDAP 组:
    • JazzAdmins
    • JazzDWAdmins
    • JazzUsers
    • JazzGuests
    注: 请勿启用全部已认证?选项。
  20. 保存更改并重新启动 jazz_war 应用程序。
  21. 从管理控制台中注销并关闭浏览器窗口。

设置 WebSphere Application Server 定制注册表

注: 在评估 Rational Quality Manager 时,您可以使用此部分中的指示信息。 如果您使用的是 LDAP,那么这些指示信息在实际生产环境中没有作用。

要使用 WebSphere Application Server 定制注册表来设置用户凭证,请执行以下操作:

  1. 在选定位置创建名为 WAS_Security 的目录并向其添加 users.props 和 groups.props 文件。

    有关这些文件格式的信息,请参阅 user.propsgroups.props

  2. 依次单击安全 > 安全管理、应用程序和基础结构并从用户帐户存储库部分中选择独立定制注册表;然后单击安全配置向导按钮。
  3. 安全配置向导的步骤 1 中,选择启用应用程序安全
  4. 在步骤 2 中,选择独立定制注册表
  5. 在步骤 3 的配置用户资源库中,添加主管理用户名,并为 usersFile(users.props)和 groupsFile(groups.props)添加名称和值:
    安全配置向导的步骤 3 显示管理用户名以及 usersFile 和 groupsFile 所在位置对应的字段已填写
  6. 在步骤 4 中,复审摘要,然后单击完成
  7. 通过单击直接保存到主配置来保存更改。从应用程序 > 企业应用程序中,选择 jazz.war,然后单击停止(除非如红色 x 所指示已停止)。
  8. 选择 jazz.war 链接,然后选择安全角色到用户/组映射
  9. 选择 JazzAdmins,然后单击查找组
    安全角色到用户/组映射
  10. 单击查找组,然后从可用列表中选择管理员
  11. 添加到选定列表。针对 JazzDWAdmins 重复步骤 9 和 10,从而再次选择管理员
  12. 对于 JazzUsers 和 JazzGuests,遵循步骤 9 和 10,但是为角色选择用户
  13. 通过单击直接保存到主配置来保存更改。
  14. 要完成 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 共享。


反馈