实现 Web 服务器插件

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

有关此任务

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

在插件安装过程中，会执行下列步骤。 请参阅“插件安装指南”，以了解其他信息。

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

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

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

配置插件时，将自动创建该插件的配置文件。 您可以更改或调整此配置文件中缺省属性设置。 如果更改了任何设置，那么必须重新生成该文件，这样更改才会生效。

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

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

1. 使用管理控制台来更改插件配置文件中的设置。
   设置 Web 服务器插件时，您必须决定是否要自动生成配置以响应配置更改。 启用 Web 服务器插件配置服务并且发生任意以下情况时，自动生成插件配置文件：

   • 创建或保存 Web 服务器时
   • 安装应用程序时
   • 卸载应用程序时
   • 更新虚拟主机定义时

   避免麻烦: 首次生成插件配置文件时，它不会在虚拟主机列表中包含 admin_host。 关于允许 Web 服务器访问管理控制台的信息描述了如何将其添加到列表中。

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

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

   1. 选择 服务器 > 服务器类型 > Web 服务器 > web_server_name > 插件属性。
   2. 选择 自动生成插件配置文件，或者单击以下一个或多个主题以手动配置 plugin-cfg.xml 文件:
      避免麻烦: 请勿手动更新 plugin-cfg.xml 文件。 每当为 Web 服务器重新生成 plugin-cfg.xml 文件时，都将覆盖您对该 Web 服务器所作的任何手动更新。
   3. 单击确定。
   4. 传播插件配置。
      要从管理控制台传播插件配置，请单击 服务器 > 服务器类型 > 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 指定的权限。

      如果权限不正确，请发出以下 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. 调整 Web 服务器。
   有关更多信息，请参阅关于调整 Web 服务器的页面。
3. 传播插件配置。
   如果启用了 Web 服务器插件配置服务，并且符合下列其中一个条件，那么插件配置文件 plugin-cfg.xml 将自动传播至 Web 服务器：

   • Web 服务器是本地 Web 服务器，这意味着 Web 服务器与应用程序服务器在同一工作站上。
   • Web 服务器是远程 IBM HTTP Server V 7 ，它具有正在运行的 IBM HTTP Server 管理服务器。

   如果这两个条件都不成立，则必须手动将 plugin-cfg.xml 文件复制到远程网络服务器的安装位置。 将 <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® FTP 功能不会保留文件属性。 因此，如果需要从 AIX 操作系统手动复制 plugin-cfg.xml ，那么可能要使用 AIX RCP 函数而不是 FTP 函数来复制文件。

4. 将密钥库文件复制到 Web 服务器上的密钥库目录。
   避免麻烦: 要使 Web 服务器正常运行，需要执行此步骤。

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