WebSphere Application Server 上部署 Web 应用程序

可以在带有 IBM® DB2®WebSphere® Application Server V8.x 或更高版本上部署 Rational® Publishing Engine Web 应用程序。

开始之前

在部署 Web 应用程序之前,必须安装 WebSphere Application Server V8.x 或更高版本以及具有 RPE 远程服务功能部件的 Rational Publishing Engine
您必须有权访问 RPE_HOME\remote-services 目录中提供的下列 Web 应用程序文件:
  • com.ibm.rpe.web.app.ear(或者 rpeng.wardgaas.war 文件)
切记: com.ibm.rpe.web.app.ear 企业应用程序是由以下两个 Web 应用程序组成的捆绑软件:rpeng.wardgaas.war。您具有以下其中一个部署选项:
  • 部署单个 com.ibm.rpe.web.app.ear 企业应用程序
  • rpeng.wardgaas.war Web 应用程序一起进行部署
部署方案和示例说明如何部署单个 com.ibm.rpe.web.app.ear 企业应用程序。

过程

  1. 设置全局安全性
  2. 设置 JVM
  3. 设置会话管理
  4. 设置环境变量
  5. 重新启动服务器
  6. 在服务器上部署 Web 应用程序
  7. dgaas 应用程序创建共享库
  8. WebSphere Application Server 上为 Web 应用程序配置用户
  9. 使共享库与应用程序相关联
  10. 配置许可证发放变量

设置 WebSphere Application Server 上的全局安全性

过程

  1. 启动 WebSphere Application Server
  2. 在浏览器中打开管理控制台(网址为 https://server:port/ibm/console

    例如:https://localhost:9043/ibm/console

  3. 展开安全性,然后单击全局安全性
  4. 在“应用程序安全性”部分中,验证是否选中了启用应用程序安全性复选框。
  5. 在“Java™ 2 安全性”部分中,取消选择所有选项。 如果授予应用程序定制许可权时发出警告选项已选中但无法编辑,请执行下列操作:
    1. 选择使用 Java 2 安全性来限制应用程序对本地资源的访问选项。 此时,会启用授予应用程序定制许可权时发出警告
    2. 取消选择授予应用程序定制许可权时发出警告选项。
    3. 取消选择使用 Java 2 安全性来限制应用程序对本地资源的访问选项。
  6. 单击应用
  7. 单击保存以将更改直接保存至主配置。

结果

这是 WebSphere Application Server 中“全局安全性”页面的截屏

设置 JVM

关于此任务

在应用程序服务器的定制属性中定义下列 Java 虚拟机 (JVM) 设置:
  • com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine=true
  • org.eclipse.emf.common.util.URI.archiveSchemes=wsjar wszip jar zip

过程

  1. 在浏览器中打开管理控制台(网址为 https://server:port/ibm/console

    例如:https://localhost:9043/ibm/console

  2. 展开服务器 > 服务器类型,然后单击 WebSphere 应用程序服务器
  3. 在“应用程序服务器”部分中,单击服务器链接,例如,server1
  4. 在“配置”选项卡中的服务器基础结构部分下,展开 Java 和进程管理,然后单击进程定义链接。
  5. 在“其他属性”部分下,单击 Java 虚拟机链接。
  6. 在“其他属性”部分下,单击定制属性链接。
  7. 在“定制属性”表中,单击新建
  8. 在“常规属性”部分下,为每个条目指定下列值,然后单击确定
    表 1. WebSphere Application Server 的定制 JVM 属性
    名称 描述
    com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine true 禁用 IBM JAXRS
    org.eclipse.emf.common.util.URI.archiveSchemes wsjar wszip jar zip  
  9. 单击保存以将更改直接保存至主配置。

结果

这是 WebSphere Application Server 的管理控制台中“定制属性”页面的截屏

设置会话管理

关于此任务

在应用程序服务器的定制属性中定义下列“会话管理”设置:
  • InvalidateOnUnauthorizedSessionRequestException=true

过程

  1. 在浏览器中打开管理控制台(网址为 https://server:port/ibm/console

    例如:https://localhost:9043/ibm/console

  2. 展开服务器 > 服务器类型,然后单击 WebSphere 应用程序服务器
  3. 在“应用程序服务器”部分中,单击服务器链接,例如,server1
  4. 在“配置”选项卡中的容器设置部分,单击会话管理链接。
  5. 在“其他属性”部分下,单击定制属性链接。
  6. 在“定制属性”表中,单击新建
  7. 在“常规属性”部分,指定以下值,然后单击确定
    表 2. WebSphere Application Server 的定制“会话管理”属性
    名称 描述
    InvalidateOnUnauthorizedSessionRequestException true 针对未授权的请求作出响应,会话管理器将使会话失效,而不发出 UnauthorizedSessionRequestException 错误消息。
  8. 单击保存以将更改直接保存至主配置。

结果

这是 WebSphere Application Server 的管理控制台中“会话管理属性”页面的截屏

设置环境变量

过程

  1. 在浏览器中打开管理控制台(网址为 https://server:port/ibm/console

    例如:https://localhost:9043/ibm/console

  2. 展开服务器 > 服务器类型,然后单击 WebSphere 应用程序服务器
  3. 在“应用程序服务器”部分中,单击服务器链接,例如,server1
  4. 在“配置”选项卡中的服务器基础结构部分下,展开 Java 和进程管理,然后单击进程定义链接。
  5. 在“配置”选项卡上的其他属性部分,单击环境条目链接。
  6. 在“环境条目”表中,单击新建
  7. 在“常规属性”部分,为每个条目指定下列值,然后单击确定
    表 3. WebSphere Application Server 的环境变量属性
    名称 描述
    DGAAS_URL http://<server IP>:<port>/dgaas/ 文档生成服务环境变量
    VCAP_SERVICES {"sqldb": [{}]} 使用 DB2 作为数据库时,必须设置此环境变量。
    这是 WebSphere Application Server 的管理控制台中“环境条目”页面的截屏。
  8. 单击保存以将更改直接保存至主配置。

重新启动 WebSphere Application Server

关于此任务

重新启动要部署 Web 应用程序(com.ibm.rpe.web.app.ear 或者 rpeng.wardgaas.war 文件)的 WebSphere Application Server 概要文件:

过程

  1. 停止 WebSphere Application Server
  2. 启动 WebSphere Application Server

WebSphere Application Server 上部署 Web 应用程序

开始之前

  • DB2 中的 Rational Publishing Engine 创建数据库
  • 创建具有以下 JNDI 名称的 rpeng 数据源:RPENG_DB
  • 创建具有以下 JNDI 名称的 DGAAS 数据源:DGAAS_DB
有关详细信息,请参阅将带有 DB2 的 WebSphere Application Server 配置为数据源

过程

  1. 在浏览器中打开管理控制台(网址为 https://server:port/ibm/console

    例如:https://localhost:9043/ibm/console

  2. 展开应用程序,然后单击新建应用程序
  3. 单击新建企业应用程序
  4. 在“准备应用程序安装”窗口中,指定 com.ibm.rpe.web.app.ear 在本地或远程文件系统上的路径:
    • 如果是使用本地文件,请选择本地文件系统
    • 如果是使用远程文件,请选择远程文件系统
    输入或单击浏览,以指定 com.ibm.rpe.web.app.ear 文件的路径。缺省情况下,该归档文件位于 RPE_HOME\remote-services\com.ibm.rpe.web.app.ear
  5. 单击下一步
  6. 选择快速路径 - 仅当需要其他信息时才提示,然后单击下一步
  7. 在“选择这些安装选项”页面中,接受缺省设置,然后单击下一步
    这是 WebSphere Application Server 的管理控制台中“选择这些安装选项”页面的截屏
  8. 在“将模块映射至服务器”页面中,选择 Rational Publishing EngineDGaaS 模块,然后单击下一步
  9. 在“将资源引用映射至资源”页面中,必须指定 Rational Publishing EngineDGaaS 模块的数据源。
    提示: 要继续执行此步骤,必须完成将带有 DB2 的 WebSphere Application Server 配置为数据源主题中的步骤。
    1. 对于 Rational Publishing Engine 模块条目,在目标资源 JNDI 名称列中单击浏览
      这是 WebSphere Application Server 的管理控制台中“将资源引用映射至资源”页面的截屏。
    2. 在“新建应用程序”页面中,选择 rpeng 选项并将 JNDI 名称设置为 RPENG_DB
      这是 WebSphere Application Server 的管理控制台中“新建应用程序”页面的截屏。
    3. 单击应用
    4. DGaaS 模块条目以类似方式重复这些步骤,然后在目标资源 JNDI 名称列中单击浏览
    5. 在“新建应用程序”页面中,选择 DGAAS 选项并将 JNDI 名称设置为 DGAAS_DB
    6. 单击应用
    7. 单击下一步
    这是 WebSphere Application Server 的管理控制台中“将资源引用映射至资源”页面的截屏。
  10. 在“映射 Web 模块的虚拟主机”页面中,选择 Rational Publishing EngineDGaaS,然后单击下一步
  11. 复查“摘要”,然后单击完成
    这是 WebSphere Application Server 的管理控制台中“摘要”页面的截屏。
  12. 要确认已将 Web 应用程序成功部署在服务器上,请搜索进程日志中显示的以下输出消息:
    Application com.ibm.rpe.web.app installed successfully.
  13. 单击保存以将更改直接保存至主配置。
    这是 WebSphere Application Server 的管理控制台中“进程日志”页面的截屏。
  14. 展开应用程序 > 应用程序类型,然后单击 WebSphere 企业应用程序 将以您输入的应用程序名称列示您添加的 com.ibm.rpe.web.app 应用程序。
  15. 在“名称”列中,单击 com.ibm.rpe.web.app 链接。
    这是 WebSphere Application Server 的管理控制台中“企业应用程序”页面的截屏。
  16. 在“详细信息属性”部分中,单击类装入和更新检测链接。
  17. 在“类装入器顺序”部分中,选择首先使用本地类装入器来装入类(最后使用父类装入器),然后单击确定
    这是 WebSphere Application Server 的管理控制台中“类装入器”页面的截屏。
  18. 验证 com.ibm.rpe.web.app 应用程序的上下文根:
    1. 在“Web 模块属性”部分下,单击 Web 模块的上下文根
    2. 验证对 Web 模块指定的上下文根是否与下列值匹配,然后单击确定
      表 4. 验证 com.ibm.rpe.web.app 应用程序的上下文根:
      Web 模块 URI 上下文根
      Rational Publishing Engine com.ibm.rpe.web.ui.war, WEB-INF/web.xml rpeng
      DGaaS com.ibm.rpe.web.service.docgen.war, WEB-INF/web.xml dgaas
      这是 WebSphere Application Server 的管理控制台中“上下文根”页面的截屏。
    3. 在“配置”选项卡上,单击确定
  19. 单击保存以将更改直接保存至主配置。
  20. 在服务器上启动 Web 应用程序:
    1. 选中 com.ibm.rpe.web.app 复选框,然后单击启动
    2. 如果 Web 应用程序在服务器上成功启动,那么会显示以下消息:
      Application com.ibm.rpe.web.app on server server_name and node node_name started succesfully.  The collection may need to be refreshed to show the current status.
      这是 WebSphere Application Server 的管理控制台中“企业应用程序”页面的截屏。

WebSphere Application Server 上配置 Web 应用程序的用户

关于此任务

要完成此任务,必须完成在 WebSphere Application Server 上配置 Web 应用程序的用户中的步骤

dgaas 应用程序创建共享库

过程

  1. 转至“共享库”页面
  2. 在控制台导航树中单击环境 > 共享库
  3. 选择共享库作用域。更改集合表的作用域,以查看哪些共享库位于特定单元、节点或服务器中。选择节点服务器选项。
    “共享库作用域”页面
  4. 单击新建
  5. 指定名称,例如,dgaas.ear
  6. 指定下列 HTTP .jar 文件的类路径:
    <WAS_HOME>\profiles\AppSrv01\installedApps\<cell Name>\com.ibm.rpe.web.app.ear\dgaas.war\WEB-INF\lib\org.apache.httpcomponents.httpclient_<version>.jar
    <WAS_HOME>\profiles\AppSrv01\installedApps\<cell Name>\com.ibm.rpe.web.app.ear\dgaas.war\WEB-INF\lib\org.apache.httpcomponents.httpcore_<version>.jar
  7. 选择将隔离的类装入器用于此共享库类装入选项,然后单击确定
    容器范围的共享库的“共享库”页面
  8. 单击保存以更新对主配置所作的更改。

下一步做什么

提示:Rational Publishing Engine V2.0.1 开始,您不再需要创建另外的共享库 rpe.lib 即可使用许可证。现在,该产品将自动完成此任务。

使共享库与应用程序相关联

过程

  1. 单击应用程序 > 应用程序类型 > WebSphere 企业应用程序 > com.ibm.rpe.web.app > 共享库引用,以访问“共享库引用”页面。
    rpe.lib 的“共享库引用”页面
  2. 在“共享库引用”页面上,选择您要使其与共享库相关联的应用程序,在此情况下,选择 com.ibm.rpe.web.app
  3. 单击引用共享库
    “共享库引用”页面
  4. 在“共享库映射”页面上,选择应用程序或模块使用的 dgaas.ear 共享库。
  5. 单击 >> 以将库从可用库列表移至所选库列表。
    “共享库映射”页面
  6. 在“共享库引用”页面上,单击确定
  7. 将更改保存至主配置。

配置许可证发放变量

过程

  1. 验证 TELELOGIC_LICENSE_FILE 环境变量。
  2. 重新启动 WebSphere Application Server

结果

通过在浏览器中打开以下 URL,可以确认已部署 Web 应用程序:http://server:port/rpeng/
提示: 在 Web 浏览器中您可能会遇到以下错误消息:
Error 500: com.ibm.websphere.servlet.session.UnauthorizedSessionRequestException:
    SESN0008E: A user authenticated as anonymous has attempted to access a session owned by
    user:defaultWIMFileBasedRealm/uid=rpe_designer,o=defaultWIMFileBasedRealm.
要解决此错误消息,请验证您在 WebSphere Application Server 的定制属性中将 InvalidateOnUnauthorizedSessionRequestException 会话管理属性设置为 true。有关更多详细信息,请参阅本主题的设置会话管理部分。

可以通过以下方式进行登录:提供相应用户(例如,rpe_adminrpe_designerrpe_user)的用户名和密码,然后单击登录

这是 Web 应用程序登录屏幕的截屏。

以下 Rational Publishing Engine Web 应用程序应显示在浏览器中:

Web 应用程序主页

通过在浏览器中输入 http://server:port/dgaas/debug,可以验证文档生成服务的状态。

Web 应用程序主页

下一步做什么

(可选)可以部署和运行使用文档生成服务技术来生成文档的 Newskeeper 样本应用程序,并为文档生成服务资产和文档提供存储器接口。有关更多详细信息,请参阅运行 Newskeeper 样本

配置 Rational Publishing Engine Web 应用程序,该 Web 应用程序列示在 http://server:port/rpeng/ 页面上。请参阅Web 应用程序 URL,以获取每个 URL 的用法说明以及用于配置每项功能部件的任务。