IBM Web Application Bridge 入门

门户网站管理员收集有关内容提供方及其应用程序的信息，然后完成基本配置步骤以启用 Web Application Bridge。

过程

  1. This information applies to CF09 and later启用 Web Application Bridge 所需的步骤取决于是否移除了门户网站上下文根。有关如何除去门户网站上下文根的信息，请转至“配置向导指示信息：修改站点 URL 用于搜索引擎优化”。
    • 如果已除去门户网站上下文根，请完成以下步骤：
      1. 运行以下任务为 Web Application Bridge 创建虚拟主机。此任务自动在新创建的虚拟主机上部署逆向代理 servlet (RPS) 并将 RPS 上下文根设置为 /。
        • AIX® HP-UX Linux Solaris:./ConfigEngine.sh deploy-wab-virtual-host -DVirtualHostName=virtualHostName -DVirtualHostAlias=virtualHostAlias -DPortalAdminPwd=password -DPortalAdminId=PortalAdminId -DWasUserid=WasUserid -DWasPassword=password
        • Windows: ConfigEngine.bat deploy-wab-virtual-host -DVirtualHostName=virtualHostName -DVirtualHostAlias=virtualHostAlias -DPortalAdminPwd=password -DPortalAdminId=PortalAdminId -DWasUserid=WasUserid -DWasPassword=password
        • IBM® i: ConfigEngine.sh deploy-wab-virtual-host -DVirtualHostName=virtualHostName -DVirtualHostAlias=virtualHostAlias -DPortalAdminPwd=password -DPortalAdminId=PortalAdminId -DWasUserid=WasUserid -DWasPassword=password

        virtualHostName 是虚拟主机的名称，例如，wab_host。virtualHostAlias 是 DNS 别名，用于访问虚拟主机上的应用程序；例如， wab.portal.com。如果 virtualHostName 和 virtualHostAlias 退出，使用现有值。任务将 virtualHostAlias 映射在相同的 URI 方案（http 或 https）上或部署了门户网站的端口上。

        或者，使用文本编辑器打开 wp_profile_root /configEngine/properties 目录中的 wkplc.properties 文件。然后，确保以下参数有正确的值：
        • WasUserID
        • WasPassword
        • PortalAdminId
        • PortalAdminPwd
        现在，您可以运行如下命令：
        • AIX HP-UX Linux Solaris:./ConfigEngine.sh deploy-wab-virtual-host -DVirtualHostName=virtualHostName -DVirtualHostAlias=virtualHostAlias
        • Windows: ConfigEngine.bat deploy-wab-virtual-host -DVirtualHostName=virtualHostName -DVirtualHostAlias=virtualHostAlias
        • IBM i: ConfigEngine.sh deploy-wab-virtual-host -DVirtualHostName=virtualHostName -DVirtualHostAlias=virtualHostAlias
      2. 完成以下步骤以在门户网站和虚拟主机别名（创建于上一个步骤）之间配置 单点登录。
        • 登录 WebSphere® Integrated Solutions Console。
        • 转至安全性 > 全局安全性 > Web 和 SIP 安全性 > 单点登录 (SSO)。
        • 输入域名。例如，如果门户网站主机是 portal.domain.ibm.com，并且 VHA 是 wab.domain.ibm.com，那么域值是 domain.ibm.com。
        • 重新启动 WebSphere_Portal 服务器。
      3. 输入虚拟主机别名以配置 DNS 服务器，以确保能够从用户工作站获取此 VHA。VHA 必须能够从访问门户网站服务器的所有工作站进行访问。如果门户网站是通过 https 模式进行访问，请确保已经为主机 myhost1.servername.domain.ibm.com 和 myhost2.servername.domain.ibm.com 安装了有效的 SSL 证书。要安装 SSL 证书，请登录到 WebSphere Integrated Solutions Console。 然后，转至 SSL 证书和密钥管理 > 密钥库和证书 > NodeDefaultKeyStore > 个人证书。 有关信息，请阅读个人证书集合。如果证书在这些主机中不可用，那么您必须接受浏览器中的安全性异常。在单独的浏览器窗口中打开 Web Dock iFrame URL。 接着，刷新门户网站页面以使其生效并呈现集成应用程序。否则，应用程序可能不会开始工作。
    • 如果未移除门户网站上下文根，请完成以下步骤：
      1. 设置 wp.vwat.servlet.ear 应用程序的上下文根：
        1. 登录到 WebSphere Integrated Solutions Console。
        2. 转到应用程序 > 应用程序类型 > WebSphere 企业应用程序。
        3. 找到并单击 wp.vwat.servlet.ear 应用程序链接。
        4. 在 Web 模块属性标题下，单击 Web 模块的上下文根。
        5. 将上下文根更改为 /。此步骤可能会引起名称冲突。请添加重写规则以避免发生这些冲突。有关更多信息，请参阅“Apache 模块 mod_rewrite”和“提供简短虚 URL”。
        6. 单击确定。
        7. 单击保存以便将更改保存到主配置。
        8. 停止 wp.vwat.servlet.ear 应用程序，然后将其重新启动。
      2. 如果您已配置 Web 服务器，请完成下列步骤：
        1. 登录 WebSphere Integrated Solutions Console。
        2. 转至应用程序 > 应用程序类型 > WebSphere 企业应用程序 > wp.vwat.servlet.ear > 管理模块。
        3. 完成以下步骤以将 wp.vwat.servlet.ear 应用程序映射至 Web 服务器：有关更多信息，请转至 WebSphere Integrated Solutions Console 中的有关此页面的更多信息链接。
          1. 选中虚拟 Web 应用程序 Servlet 应用程序对应的选择复选框。
          2. 选择集群和服务器框中的 Web 服务器。
          3. 单击应用。
        4. 选择下列其中一个选项以更新插件配置：
          1. 完成下列步骤以更新 WebSphere Application Server 中所有应用程序的插件配置：
            • 转至服务器 > 服务器类型 > Web 服务器 > webserver1 > 插件属性。
            • 确保以下两个复选框处于选中状态：
              • 自动生成插件配置文件
              • 自动传播插件配置文件
            • 单击应用以保存更改。
          2. 完成下列步骤，以便仅为 wp.vwat.servlet.ear 应用程序更新插件配置：
            • 转至 Deployment Manager 概要文件中的 wp_profile_root/config/cells/cell_name/nodes/node_name/servers/web_server_name 目录。
            • 生成 plugin-cfg.xml 文件的备份副本。
            • 打开 plugin-cfg.xml 文件。
            • 将类似于以下示例的行添加到集群的 UriGroup 中：
              <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/*"/>
            • 将更新后的 plugin-cfg.xml 文件复制到 Web 服务器主目录中的 Web 服务器。
      3. 重新启动所有服务器。
  2. 系统管理员登录到 IBM WebSphere Portal。
  3. 系统管理员单击工具栏中的管理菜单图标。然后，单击 Portlet 管理 > 虚拟 Web 应用程序管理器。
    警告： 请不要向任何文本框中输入 < 或 >。
  4. 系统管理员单击内容提供方概要文件，然后选择创建内容提供方概要文件。
  5. 系统管理员创建内容提供方概要文件。
  6. 系统管理员转到已创建的概要文件，然后单击添加策略以创建策略。
    提示： 系统管理员必须为内容提供方概要文件至少创建一个策略。
  7. 系统管理员单击 Web Dock 应用程序，然后选择创建 Web Dock 应用程序。
  8. 系统管理员创建 Web Dock 应用程序。
  9. 系统管理员转至创建的应用程序。
  10. 系统管理员选择下列其中一个选项卡，然后单击编辑以配置 Web Dock 设置：
    注： 如果系统管理员更改内容提供方概要文件中的主机或端口信息，那么必须编辑 Web Dock 应用程序并重新选择此概要文件。否则，Web Dock 应用程序不会获取这些更改。
    • Web Dock 显示设置
    • Web Dock 的客户机端 IPC
    • Web Dock 的服务器端 IPC
    • 插件
  11. 内容作者登录到 WebSphere Portal。
  12. 内容作者访问站点工具栏，并执行下列其中一项操作：
    • 创建页面并将 Web Dock 应用程序 Portlet 添加到此页面。
    • 编辑现有页面并将 Web Dock 应用程序 Portlet 添加到此页面。
    提示： 要在某个页面上呈示 Web Dock 应用程序，该页面必须具有 Web Dock 概要文件或者具有包含 wp_webdock 模块的概要文件。请编辑页面属性并更改概要文件，或者向应用于页面的概要文件添加 wp_webdock 模块：

    从 CF03 开始，Web Dock 概要文件不再存在。 如果您打算使用用于 Portlet 的资源聚集器，那么无需执行任何其他步骤。如果您不打算使用用于 Portlet 的资源聚集器，请将 wp_webdock 模块添加到页面上的现有概要文件中。

    1. 通过 fs-type1 连接功能连接到主题存储库。
    2. 转至您的主题。
    3. 打开 /profiles 目录中的概要文件。
    4. 备份此概要文件并为其指定唯一的名称。
    5. 编辑 .json 文件并添加 wp_webdock 模块标识。
    6. 将创建的概要文件复制到 /profiles 目录。
    7. 使资源聚集器高速缓存失效以集成您所作的更改。单击工具栏中的管理菜单图标。然后， 单击主题分析器 > 实用程序 > 控制中心 > 使高速缓存失效。自动失效功能可自动识别您对基于 WebDAV 的主题所做的更改。无需进一步操作。有关更多信息，请参阅实用程序。
  13. 如果内容作者在查看 Web Dock 应用程序时遇到问题，请完成以下步骤来更新用户角色：
    1. 以管理员身份登录到 WebSphere Portal。
    2. 单击工具栏中的管理菜单图标。然后，单击访问权 > 资源许可权。
    3. 搜索包含 Web Dock 应用程序的页面。
    4. 为内容作者提供正确的页面许可权。
    5. 如果将内容提供方策略设置为使用基本认证或基于表单的认证，请完成以下步骤：
      • 转至 Web Dock 应用程序，然后为内容用户提供正确许可权。
      • 转至用于认证的凭证保险库。为内容用户提供正确的凭证保险库许可权。