实现 Web 服务器插件

本主题描述如何实现 Web 服务器插件。产品使用 Web 服务器来路由从 Web 应用程序发出的动态内容(例如 Servlet)的请求。要将流量从浏览器定向到运行于应用程序服务器中的应用程序,web 服务器是必需的。Web 服务器插件使用 XML 配置文件来确定请求是否涉及应用程序服务器。

开始之前

  • 请参阅有关为 WebSphere® Application Server 拓扑选择前端的信息。本主题帮助您确定是设置 Web 服务器插件、代理服务器还是安全代理服务器,以便为 WebSphere Application Server 拓扑提供会话亲缘关系、故障转移支持和工作负载均衡功能。如果还未安装 Web 服务器,请安装。
    避免故障 避免故障: IBM® i 附带提供的 Web 服务器已安装在产品 5761-DG1(对于 IBM i V6R1)或 5770-DG1(对于 IBM i V7R1)下。IBM i Web 服务器又称为 IBM HTTP Server for IBM i。此 Web 服务器不同于 WebSphere Application Server 附带的 IBM HTTP Server,后者不在 IBM i 上运行。gotcha

    [AIX Solaris HP-UX Linux Windows]如果要使用产品附带提供的 IBM HTTP Server,请参阅有关安装 IBM HTTP Server 的信息。否则,请参阅随 Web 服务器提供的安装信息。

  • [AIX Solaris HP-UX Linux Windows][z/OS]确保已经在 Web 服务器上安装了适当的插件文件并已运行 configureweb_server_name 脚本,以便为此 Web 服务器创建并配置 Web 服务器定义。

    [AIX Solaris HP-UX Linux Windows]如果正在使用分布式平台 Web 服务器,请使用“Web 服务器插件配置工具”将适当的插件文件安装到该 web 服务器上。然后运行该工具创建的 configureweb_server_name 脚本,以便在 WebSphere 配置库中创建并配置 Web 服务器定义。

    [z/OS]如果要使用产品附带提供的 IBM HTTP Server for z/OS®(基于 Apache),请参阅有关在 z/OS 上为 the plug-in for IBM HTTP Server for WebSphere Application Server 安装并配置插件的信息。

    [z/OS]如果要使用 z/OS 基本操作系统附带提供的 IBM HTTP Server V5.3,请参阅有关为 IBM HTTP Server for z/OS V5.3 安装并配置 Web 服务器插件的信息。

    [z/OS]如果要将分布式平台 Web 服务器与正在 z/OS 操作系统上运行的产品版本配合使用,请使用 FTP 连接将此插件发送至 Web 服务器并使用“插件安装向导”将适当的插件文件安装至 Web 服务器。

如果您要同时进行一系列更改,例如,安装很多应用程序,那么您可能需要在最后一个更改完成之前禁用配置服务。缺省情况下,启用 Web 服务器插件配置服务。要禁用此服务,请在管理控制台中单击服务器 > 服务器类型 > WebSphere 应用程序服务器 > server_name > 管理服务 > Web 服务器插件配置服务,然后取消选中启用自动 Web 服务器配置处理选项。

避免故障 避免故障: 如果您的安装使用防火墙,请确保将 Web 服务器插件配置为使用已打开的端口。有关如何获取已打开端口的信息,请咨询安全性管理员。gotcha

关于此任务

[IBM i]已安装适当的插件文件。另外,还创建了 http 概要文件 (/QIBM/UserData/WebSphere/Plugins/V85/webserver/profiles/http)。 http 概要文件可方便创建 Web 服务器定义。请参阅有关选择 Web 服务器拓扑图和路线图的主题,以获取关于如何配置 IBM HTTP Server for IBM i 以便与应用程序服务器进行通信的指示信息。

[AIX Solaris HP-UX Linux Windows][z/OS]在插件安装过程中,会执行下列步骤。请参阅“插件安装指南”,以了解其他信息。
  1. [AIX Solaris HP-UX Linux Windows]节点将创建。

    当 Web 服务器不在应用程序服务器所在的计算机上时,将创建非受管节点。非受管节点是未运行 Node Agent 的节点。通过使用非受管节点,产品可以代表其配置拓扑中的那些并非应用程序服务器的服务器。此代表使您能够维护那些服务器与应用程序服务器之间的连接信息。有关更多信息,请参阅有关添加、管理和移除节点的主题。

  2. Web 服务器定义将创建。

    也可以使用管理控制台或 ConfigurewebServerDefinition.jacl 脚本来创建 Web 服务器定义。

  3. 将应用程序或模块映射到 Web 服务器。如果已经安装要使用此 Web 服务器的应用程序,那么应用程序自动映射到该 Web 服务器。如果未安装应用程序,那么请在应用程序安装过程的“将模块映射到服务器”步骤期间选择此 Web 服务器。
  4. 更新并保存主存储库。

[AIX Solaris HP-UX Linux Windows][z/OS]配置插件时,将自动创建该插件的配置文件。您可以更改或调整此配置文件中缺省属性设置。如果更改了任何设置,那么必须重新生成该文件,这样更改才会生效。

[AIX Solaris HP-UX Linux Windows][z/OS]生成或重新生成配置文件可能要花上一点时间才能完成。完成后,管理单元中的所有对象都将使用 Web 服务器可访问的最新设置。如果应用程序服务器与 Web 服务器在同一物理工作站上,那么重新生成操作通常需要 30 到 60 秒的时间才能完成。如果应用程序服务器与 Web 服务器在不同工作站上,那么重新生成操作需要更长时间完成。

以下过程描述了有关更新插件配置文件的步骤,其中包括配置以调整 SSL 和 Web 服务器的步骤。

过程

  1. 使用管理控制台来更改插件配置文件中的设置。
    设置 Web 服务器插件时,您必须决定是否要自动生成配置以响应配置更改。启用 Web 服务器插件配置服务并且发生任意以下情况时,自动生成插件配置文件:
    • 创建或保存 Web 服务器时
    • 安装应用程序时
    • 卸载应用程序时
    • 更新虚拟主机定义时
    避免故障 避免故障: 第一次生成插件配置文件时,它的虚拟主机列表中未包含 admin_host。关于允许 Web 服务器访问管理控制台的信息描述了如何将其添加到列表中。gotcha

    可使用管理控制台或发出 GenPluginCfg 命令以重新生成 plugin-cfg.xml 文件。

    通过使用管理控制台完成以下步骤以重新生成 plugin-cfg.xml 文件:

    1. 选择服务器 > 服务器类型 > Web 服务器 > web_server_name > 插件属性
    2. 选择自动生成插件配置文件,或者单击下列其中一个或多个主题以手动配置 plugin-cfg.xml 文件:
      避免故障 避免故障: 不要手动更新 plugin-cfg.xml 文件。每当为 Web 服务器重新生成 plugin-cfg.xml 文件时,都将覆盖您对该 Web 服务器所作的任何手动更新。gotcha
    3. 单击确定
    4. [IBM i]传播插件配置。 要从管理控制台中传播插件配置,请单击服务器 > 服务器类型 > Web 服务器web_server_name传播插件

      传播插件配置的另一方法是运行 GenPluginCfg 命令。有关更多信息,请参阅 GenPluginCfg 命令文档。

      如果 Web 服务器位于关联的独立产品版本所在的机器上,那么不必传播此插件配置。如果对插件配置的传播由于未知原因而失败,那么必须将 plugin-cfg.xml 文件手动复制到远程 Web 服务器的安装位置。

      避免故障 避免故障: 如果使用 FTP 功能来执行复制,但无法重新装入配置,请检查 plugin-cfg.xml 文件的文件权限并确保用户 QTMHHTTP、QNOTES 和 QEJBSVR 具有 RWX 权限。如果权限不正确,那么 Web 服务器无法访问新版本的文件,从而导致无法重新装入配置。要检查权限,请运行以下 IBM i 命令:
      wrklnk 'plug_in_folder_location/plugin-cfg.xml' 
      然后,选择选项 9 以查看对用户 QTMHHTTP、QNOTES 和 QEJBSVR 指定的权限。gotcha
      如果权限不正确,请发出以下 IBM i 命令,以便将文件权限更改为适当的设置:
      CHGAUT USER(QEJBSVR QTMHHTTP QNOTES) OBJ('plug_in_folder_location/plugin-cfg.xml') DTAAUT(*RWX)
      plug_in_folder_location 是您传输 plugin-cfg.xml 文件时指定的位置。
    5. 可能必须停止并重新启动应用程序服务器,Web 服务器才能找到 plugin-cfg.xml 文件。
  2. [AIX Solaris HP-UX Linux Windows][IBM i]调整 Web 服务器。 有关更多信息,请参阅关于调整 Web 服务器的页面。
  3. [AIX Solaris HP-UX Linux Windows][z/OS]传播插件配置。 如果启用了 Web 服务器插件配置服务,并且符合下列其中一个条件,那么插件配置文件 plugin-cfg.xml 将自动传播至 Web 服务器:
    • Web 服务器是本地 Web 服务器,这意味着 Web 服务器与应用程序服务器在同一工作站上。
    • Web 服务器是正在运行 IBM HTTP Server 管理服务器的远程 IBM HTTP Server V7。

    如果两个条件都不符合,那么必须将 plugin-cfg.xml 文件手动复制到远程 Web 服务器的安装位置。将 <app_server_root>/profiles/<profilename>/config/cells/../../nodes/../servers/<webservername> 中的 plugin-cfg.xml 文件复制到 Web 服务器主机位置,即 <PluginInstallRoot>/config/<webservername>/

    要点: 如果使用 FTP 功能来复制该文件,并且配置重新装入操作失败,请检查针对 plugin-cfg.xml 文件的文件许可权并确保他们设置为 rw-r--r--。如果文件许可权不正确,Web 服务器就无法访问新版本的文件,这将导致无法重新装入配置。
    如果文件许可权不正确,请发出以下命令以将文件许可权更改为适当的设置:
    chmod 644 plugin-cfg.xml

    [AIX]AIX® FTP 功能不保留文件属性。因此,如果需要从 AIX 操作系统手动复制 plugin-cfg.xml,那么可以使用 AIX RCP 功能代替 FTP 功能来复制文件。

    远程 Web 服务器安装位置是您在为此 Web 服务器创建节点时指定的位置。

  4. 将密钥库文件复制到 Web 服务器上的密钥库目录。
    避免故障 避免故障: 必须执行本步骤,Web 服务器才能正常工作。gotcha

    有关复制密钥库文件的详细指示信息,请阅读有关为安全套接字层配置 Web 服务器插件的主题。

结果

配置完成。要激活配置,停止 Web 服务器,然后重新启动。如果您在重新启动 Web 服务器时遇到问题,请检查 http_plugin.log 文件以获取有关 plugin-cfg.xml 文件的哪个部分包含错误的信息。此日志文件表明发生错误的行号,以及可能有助于您诊断无法启动 Web 服务器的原因的其他详细信息。然后,您可以使用管理控制台更新 plugin-cfg.xml 文件。

如果很少安装或卸载应用程序(在生产环境中经常就是这种情况),或者如果每次执行任意上面列示的操作时,您要忍受生成和分发插件配置文件对性能产生的影响,那么应该考虑启用配置服务。


指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twsv_plugin
文件名:twsv_plugin.html