WebSphere Application Server 上部署文档构建器

可以在带有 IBM® DB2® 或 Oracle 的 WebSphere® Application Server V8.x 或更高版本上部署 Rational® Publishing Engine 文档构建器。

开始之前

在部署文档构建器之前,必须安装 WebSphere Application Server V8.x 或更高版本以及具有 RPE 文档构建器功能部件的 Rational Publishing Engine
您必须有权访问 RPE_HOME\document-builder 目录中提供的下列文档构建器文件:
  • 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. 对于 DB2:将带有 DB2WebSphere Application Server 配置为数据源
  7. 对于 Oracle:将带有 Oracle 的 WebSphere Application Server 配置为数据源
  8. 在服务器上部署文档构建器
  9. dgaas 应用程序创建共享库
  10. WebSphere Application Server 上的文档构建器配置用户
  11. 使共享库与应用程序相关联
  12. 配置许可证发放变量

设置 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 或 Oracle 作为数据库时,必须设置此环境变量。
    这是 WebSphere Application Server 的管理控制台中“环境条目”页面的截屏。
  8. 单击保存以将更改直接保存至主配置。

重新启动 WebSphere Application Server

关于此任务

重新启动要部署文档构建器的 WebSphere Application Server 概要文件(com.ibm.rpe.web.app.ear 或者 rpeng.wardgaas.war 文件):

过程

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

将带有 DB2WebSphere Application Server 配置为数据源

必须在 WebSphere Application Server 上设置 DB2 数据库并配置与文档构建器的连接

开始之前

必须为 Rational Publishing Engine 文档构建器创建 IBM DB2 数据库。该数据库必须具有 16K 页面和 UTF-8 代码集。例如,要创建一个称为 rpedb2,并且使用 16K 页和 UTF-8 代码集的数据库,请使用以下命令:
db2 CREATE DATABASE rpedb1 AUTOMATIC STORAGE Yes USING CODESET UTF-8
    TERRITORY US COLLATE USING SYSTEM PAGESIZE 16384;
在此示例中,该数据库已命名为 rpedb1。有关创建数据库的信息,请参阅 DB2 产品文档

创建 JDBC 提供程序

过程

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

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

  3. 选择资源 > JDBC > JDBC 提供程序
  4. 将作用域设置为单元。
    单元
  5. 单击新建
  6. 在“创建新 JDBC 提供程序”向导中,选择:
    1. 数据库类型:DB2
    2. 提供程序类型:DB2 通用 JDBC 驱动程序提供程序
    3. 实现类型:XA 数据源
    4. 实现类型:请输入名称,例如 RPE
    “创建新的 JDBC 提供程序”向导
  7. 单击下一步
  8. 在“输入数据库类路径信息”部分中,输入类路径。将 DB2UNIVERSAL_JDBC_DRIVER_PATH 替换为 DB2 .jar 文件所在的目录。
    <DB2UNIVERSAL_JDBC_DRIVER_PATH>/db2jcc.jar
    <DB2UNIVERSAL_JDBC_DRIVER_PATH>/db2jcc_license_cu.jar
    <DB2UNIVERSAL_JDBC_DRIVER_PATH>/db2jcc_license_cisuz.jar
  9. 输入“db2jcc.jar, db2jcc_license_cisuz.jar”文件的目录位置,该位置另存为 WebSphere 变量 ${DB2UNIVERSAL_JDBC_DRIVER_PATH},例如,C:\Program Files\IBM\SQLLIB\java
  10. 输入本机库路径,例如,C:\Program Files\IBM\SQLLIB\java
  11. 单击应用
    输入数据库类路径信息
  12. 确保本机库路径正确,然后单击下一步
    本机库路径
  13. 复查摘要页面,然后单击完成
    本机库路径
  14. 将更改保存至主配置。

rpeng 应用程序创建数据源

过程

  1. 转至您刚创建的 JDBC 提供程序。
    1. 单击数据源
      “数据源”链接
    2. 数据源名称字段中,输入 rpeng
    3. JNDI 名称字段中,输入 RPENG_DB 并单击下一步
      输入基本数据源信息
  2. 输入数据源的特定于数据库的属性,然后单击下一步
    1. 将“驱动程序类型”值设置为 4
    2. 数据库名称字段中,输入数据库名称。
    3. 服务器名称字段中,输入正在运行 DB2 的机器的主机名。
    4. 端口号字段中,输入 DB2 数据库的端口号。
      输入数据源的特定于数据库的属性
  3. 在“设置安全性别名”部分中,单击下一步
  4. 复查摘要页面,然后单击完成
    数据源摘要
  5. 将更改保存至主配置。

dgaas 应用程序创建数据源

过程

重复为 rpeng 应用程序创建数据源中的步骤,并将 DGAAS 设置为数据源名称,将 DGAAS_DB 设置为 JNDI 名称
输入基本数据源信息

创建认证数据项

过程

  1. 转至 RPE JDBC 提供程序,并单击数据源
  2. 在“数据源”页面上,单击 rpeng 数据源。
  3. 在“相关项”部分中,单击 JAAS-J2C 认证数据
  4. 单击新建
  5. 输入数据库的认证详细信息:
    • 对于 DB2:输入 DB2 别名、用户标识和密码,然后单击确定
      新的认证数据
    • 对于 Oracle:输入 Oracle 别名、用户标识和密码,然后单击确定
      新的认证数据
  6. 将更改保存至主配置。
  7. 返回到 rpeng 数据源。
  8. 在“安全设置”中,对下列选项选择 rpedb1 数据库:
    1. 用于 XA 恢复的认证别名
    2. 组件管理的认证别名
    3. 容器管理的认证别名
    安全设置
  9. 单击确定并进行保存。
  10. 再次转至 rpeng 数据源,然后单击测试连接以测试该数据源。
    测试连接已成功
  11. 对于 dgaas 数据源,重复执行步骤 7-10。

将带有 Oracle 的 WebSphere Application Server 配置为数据源

必须在 WebSphere Application Server 上设置 Oracle 数据库并配置与文档构建器的连接

开始之前

  • 要创建并设置 Oracle 数据库,准备此数据库的用户必须对此数据库具有数据库管理权限,并且此数据库、表空间存储器和相应存储配置由具有系统管理权限的用户创建。
  • 根据您使用的 Oracle 版本,必需的 Java 数据库连接 (JDBC) 驱动程序为 ojdbc7.jar
  • 要生成受支持的数据库版本和 JDBC 驱动程序的列表,请参阅http://www.ibm.com/software/reports/compatibility/clarity/softwareReqsForProduct.html
  • 本主题中使用的配置参数和表空间选项是示例,可能并不完全适用于您的环境。例如,如果您无法使用 AUTOEXTEND 设置,那么文件必须足够大以允许内容增加。或者,如果无法对数据库用户使用 UNLIMITED 大小配额,请确保有足够的空间以备数据库快速增大。
  • 您为“文档构建器”应用程序创建的数据库的格式必须设置为使用 UTF-8 作为字符集。缺省情况下,Oracle 不创建使用 UTF-8 字符集的数据库。您创建新数据库时,请确保在 Oracle 数据库设置中选择 AL32UTF8

创建数据库和表空间

过程

  1. 作为系统管理员,请为文档构建器创建使用 UTF-8 编码的数据库,例如,rpedb
    1. 启动“数据库配置助手”向导,在“欢迎”页面上单击下一步
    2. 在“操作”页面上,选择创建数据库,然后单击下一步
    3. 在“模板”页面上,选择定制数据库,然后单击下一步
    4. 全局数据库名称SID 字段中,输入内容存储器数据库的名称;例如,CLMDB。单击下一步
    5. 要配置数据库控制,请输入警报通知的必需信息,还可以选择启用日常磁盘备份调度。要在不具备数据库控制配置的情况下继续,请取消选中配置 Enterprise Manager 旁边的复选框,然后单击下一步
    6. 在“数据库凭证”页面上,为用户帐户选择一个选项,然后单击下一步
      注: Oracle 密码复杂性策略要求密码长度至少为 8 个字符。此外,密码必须至少包含一个大写字符、一个小写字符和一个数字。
    7. 在下一页上,选择数据库文件的存储类型和位置。单击下一步
    8. 在下一页上,选择数据库的恢复选项,然后单击下一步
    9. 在下一页上,指定是否向数据库添加样本模式。单击下一步
    10. 在下一页上,单击“字符集”选项卡,然后选择使用 Unicode (AL32UTF8)。单击下一步
      注: 将字符集设置为 Unicode (AL32UTF8) 使您能够存储多个语言组。
    11. 在“数据库存储器”页面上,验证或更改数据库对象,然后单击下一步
    12. 在下一页上,单击完成以创建数据库。
    13. 在打开的“确认”窗口中,可以选择将页面另存为 HTML 文件,然后单击确定 会显示进度条,以显示数据库的创建进度。
  2. 打开 SQL *Plus 窗口,以 SYSTEMSYSDBA 身份登录。
  3. 浏览到 [OracleInstallDir]/dbhome_1/bin,例如,/u01/app/oracle/product/12.1.0/dbhome_1/bin,然后输入以下命令,其中 password 是您的密码:
    ./sqlplus sys/[password]@RPEDB as sysdba
    登录到 Oracle
  4. Rational Publishing Engine 创建表空间

    Rational Publishing Engine 创建表空间,请输入以下命令。将 RPE 替换为表空间名称,将 ORACLE_BASE 替换为已安装 Oracle 的绝对路径,将 RPEDB 替换为您在步骤 1 中所创建的数据库名称,将 RPE.DBF 替换为您想要创建的数据文件名称。

    CREATE TABLESPACE RPE 
    DATAFILE 'ORACLE_BASE/oradata/RPEDB/RPE.DBF' 
    SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
    例如:
    CREATE TABLESPACE RPEDB_TS DATAFILE '/u01/app/oracle/oradata/RPEDB/RPEDB_TS.dbf' SIZE 1G
            AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
  5. Rational Publishing Engine 创建临时表空间 要为 Rational Publishing Engine 创建临时表空间,请输入以下命令。将 RPE_TEMP 替换为临时表空间名称,将 ORACLE_BASE 替换为已安装 Oracle 的绝对路径,将 RPEDB 替换为您在步骤 1 中所创建的数据库名称,将 RPE_TEMP.DBF 替换为您想要创建的临时文件名。
    CREATE TEMPORARY TABLESPACE RPE_TEMP 
    TEMPFILE 'ORACLE_BASE/oradata/RPEDB/RPE_TEMP.DBF' 
    SIZE 20M AUTOEXTEND ON EXTENT MANAGEMENT LOCAL UNIFORM SIZE 1M;
    例如:
    CREATE TEMPORARY TABLESPACE RPEDB_TEMP TEMPFILE
            '/u01/app/oracle/oradata/RPEDB/RPEDB_TEMP.DBF' SIZE 20M AUTOEXTEND ON EXTENT MANAGEMENT
            LOCAL UNIFORM SIZE 1M
  6. 以 sys 用户身份登录到 Oracle Enterprise Manager Database Control 门户网站。单击存储器 > 表空间,验证您所创建的表空间是否已显示并且可访问。
    Oracle Enterprise Manager
  7. 创建表空间之后,必须为每个应用程序创建特殊 Oracle 用户以使用 Oracle 数据库。在此示例中,创建了一个称为 RPE_USER 的用户,并为其授予了许可权。Oracle 数据库用户必须能够在其表空间(无限制或者具有空间配额)中创建数据库对象,并且具备创建会话、表、过程和视图的特权。要为每个新的表空间创建 Oracle 数据库用户,请输入以下命令。将 USER_NAME 替换为您想要创建的用户,将 PASSWORD 替换为该用户的密码,将 RPEDB_TS 替换为您在步骤 4 中所创建的表空间名称,将 RPEDB_TEMP 替换为您想要创建的临时表空间。
    CREATE USER  USER_NAME IDENTIFIED BY PASSWORD DEFAULT TABLESPACE RPEDB_TS QUOTA UNLIMITED ON
          RPEDB_TS TEMPORARY TABLESPACE RPEDB_TEMP;
    例如:
    CREATE USER  RPE_USER IDENTIFIED BY RPEt3st123 DEFAULT TABLESPACE RPEDB_TS QUOTA UNLIMITED
            ON RPEDB_TS TEMPORARY TABLESPACE RPEDB_TEMP;
  8. 要授予对于表空间的必需许可权,请输入以下命令:
    GRANT CREATE PROCEDURE, CREATE SESSION, CREATE TABLE, CREATE VIEW TO RPE_USER
  9. 现在,使用 RPE_USER 登录到 SQL *Plus 编辑器,并确保您可以成功认证,例如:
    ./sqlplus.sh rpe_user/RPEt3st123@RPEDB

创建 JDBC 提供程序

过程

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

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

  3. 选择资源 > JDBC > JDBC 提供程序
  4. 将作用域设置为单元。
    单元
  5. 单击新建
  6. 在“创建新 JDBC 提供程序”向导中,选择:
    1. 数据库类型:Oracle
    2. 提供程序类型:Oracle JDBC 驱动程序
    3. 实现类型:XA 数据源
    4. 实现类型:输入名称,例如,RPE_Oracle
    “创建新的 JDBC 提供程序”向导
  7. 单击下一步
  8. 在“输入数据库类路径信息”部分,请确保类路径部分指向 ojdbc7.jar 位置。如果它显示 ojdbc6.jar,那么将其更新为 ojdbc7.jar,然后单击应用。例如:
    ${ORACLE_JDBC_DRIVER_PATH}/odjbc7.jar 
  9. 输入“ojdbc7.jar”文件的目录位置,该位置另存为 WebSphere 变量 ${ORACLE_JDBC_DRIVER_PATH},例如,/oracle_jdbc
    输入数据库类路径信息
  10. 复查摘要页面,然后单击完成
    本机库路径
  11. 将更改保存至主配置。

rpeng 应用程序创建数据源

过程

  1. 转至您刚创建的 JDBC 提供程序。
    1. 单击数据源
      “数据源”链接
    2. 数据源名称字段中,输入 rpeng
    3. JNDI 名称字段中,输入 RPENG_DB,然后单击下一步
      输入基本数据源信息
  2. 输入数据源的特定于数据库的属性,然后单击下一步
    1. URL 字段中输入 Oracle 数据库的 URL,例如,jdbc:oracle:thin:@[server]:1521/RPEDB
    2. 取消选中在容器管理的持久性 (CMP) 中使用此数据源复选框,然后单击下一步
      输入数据源的特定于数据库的属性
  3. 在“设置安全性别名”部分中,单击下一步
  4. 复查摘要页面,然后单击完成
    数据源摘要
  5. 将更改保存至主配置。

dgaas 应用程序创建数据源

过程

重复为 rpeng 应用程序创建数据源中的步骤,并将 DGAAS 设置为数据源名称,将 DGAAS_DB 设置为 JNDI 名称
输入基本数据源信息

创建认证数据项

过程

  1. 转至 RPE JDBC 提供程序,并单击数据源
  2. 在“数据源”页面上,单击 rpeng 数据源。
  3. 在“相关项”部分中,单击 JAAS-J2C 认证数据
  4. 单击新建
  5. 输入 Oracle 别名、用户标识和密码,然后单击确定
    新的认证数据
  6. 将更改保存至主配置。
  7. 返回到 rpeng 数据源。
  8. 在“安全设置”中,对下列选项选择 rpedb 数据库:
    1. 用于 XA 恢复的认证别名
    2. 组件管理的认证别名
    3. 容器管理的认证别名
    安全设置
  9. 单击确定并进行保存。
  10. 再次转至 rpeng 数据源,然后单击测试连接以测试该数据源。
    测试连接已成功
  11. 对于 dgaas 数据源,重复执行步骤 7-10。

WebSphere Application Server 上部署文档构建器

开始之前

验证是否已创建下列资产:
  • DB2 或 Oracle 中 Rational Publishing Engine 的数据库
  • 具有 JNDI 名称 RPENG_DBrpeng 数据源
  • 具有 JNDI 名称 DGAAS_DBDGAAS 数据源

过程

  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\document-builder\com.ibm.rpe.web.app.ear 中。
  5. 单击下一步
  6. 选择快速路径 - 仅当需要其他信息时才提示,然后单击下一步
  7. 在“选择这些安装选项”页面中,接受缺省设置,然后单击下一步
    这是 WebSphere Application Server 的管理控制台中“选择这些安装选项”页面的截屏
  8. 在“将模块映射至服务器”页面中,选择 Rational Publishing EngineDGaaS 模块,然后单击下一步
  9. 在“将资源引用映射至资源”页面中,必须指定 Rational Publishing EngineDGaaS 模块的数据源。
    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. 要确认是否已将文档构建器成功部署在服务器上,请搜索进程日志中显示的以下输出消息:
    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. 在服务器上启动文档构建器
    1. 选中 com.ibm.rpe.web.app 复选框,然后单击启动
    2. 如果文档构建器在服务器上成功启动,那么会显示以下消息:
      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 上为文档构建器配置用户

关于此任务

要完成此任务,必须完成在 WebSphere Application Server 上为文档构建器配置用户中的步骤

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 环境变量。 例如,可以在“环境条目”页面上为 WebSphere Application Server 中的许可证文件创建环境变量:
    添加 Telelogic 环境变量
    对于 Linux,可在 TELELOGIC_LICENSE_FILE$HOME/.flexlmrc 中找到注册表。
  2. 重新启动 WebSphere Application Server

结果

可以通过在浏览器中打开以下 URL 来确认是否已部署文档构建器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 应用程序主页

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

Web 应用程序主页

下一步做什么

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

配置 http://server:port/rpeng/ 页面上所列示的 Rational Publishing Engine 文档构建器。请参阅文档构建器 URL,以获取每个 URL 的用法说明以及用于配置每项功能部件的任务。