本主题描述如何实现 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
如果要使用产品附带提供的 IBM HTTP Server,请参阅有关安装 IBM HTTP Server
的信息。否则,请参阅随 Web 服务器提供的安装信息。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
确保已经在 Web 服务器上安装了适当的插件文件并已运行 configureweb_server_name 脚本,以便为此 Web 服务器创建并配置 Web 服务器定义。
如果正在使用分布式平台
Web 服务器,请使用“Web 服务器插件配置工具”将适当的插件文件安装到该 web 服务器上。然后运行该工具创建的
configureweb_server_name 脚本,以便在
WebSphere 配置库中创建并配置
Web 服务器定义。
如果要使用产品附带提供的 IBM HTTP Server for z/OS®(基于 Apache),请参阅有关在 z/OS 上为
the plug-in for IBM HTTP Server
for WebSphere Application Server 安装并配置插件的信息。
如果要使用 z/OS 基本操作系统附带提供的
IBM HTTP Server V5.3,请参阅有关为 IBM HTTP Server for z/OS V5.3
安装并配置 Web 服务器插件的信息。
如果要将分布式平台 Web 服务器与正在 z/OS 操作系统上运行的产品版本配合使用,请使用 FTP 连接将此插件发送至 Web 服务器并使用“插件安装向导”将适当的插件文件安装至 Web 服务器。
如果您要同时进行一系列更改,例如,安装很多应用程序,那么您可能需要在最后一个更改完成之前禁用配置服务。缺省情况下,启用 Web 服务器插件配置服务。要禁用此服务,请在管理控制台中单击,然后取消选中选项。
避免故障: 如果您的安装使用防火墙,请确保将 Web 服务器插件配置为使用已打开的端口。有关如何获取已打开端口的信息,请咨询安全性管理员。
gotcha
关于此任务
已安装适当的插件文件。另外,还创建了 http 概要文件 (/QIBM/UserData/WebSphere/Plugins/V85/webserver/profiles/http)。
http 概要文件可方便创建 Web 服务器定义。请参阅有关选择 Web 服务器拓扑图和路线图的主题,以获取关于如何配置 IBM HTTP Server for IBM i 以便与应用程序服务器进行通信的指示信息。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
在插件安装过程中,会执行下列步骤。请参阅“插件安装指南”,以了解其他信息。
节点将创建。当 Web 服务器不在应用程序服务器所在的计算机上时,将创建非受管节点。非受管节点是未运行 Node Agent 的节点。通过使用非受管节点,产品可以代表其配置拓扑中的那些并非应用程序服务器的服务器。此代表使您能够维护那些服务器与应用程序服务器之间的连接信息。有关更多信息,请参阅有关添加、管理和移除节点的主题。
- Web 服务器定义将创建。
也可以使用管理控制台或 ConfigurewebServerDefinition.jacl 脚本来创建 Web 服务器定义。
- 将应用程序或模块映射到 Web 服务器。如果已经安装要使用此 Web 服务器的应用程序,那么应用程序自动映射到该 Web 服务器。如果未安装应用程序,那么请在应用程序安装过程的“将模块映射到服务器”步骤期间选择此 Web 服务器。
- 更新并保存主存储库。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
配置插件时,将自动创建该插件的配置文件。您可以更改或调整此配置文件中缺省属性设置。如果更改了任何设置,那么必须重新生成该文件,这样更改才会生效。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
生成或重新生成配置文件可能要花上一点时间才能完成。完成后,管理单元中的所有对象都将使用
Web 服务器可访问的最新设置。如果应用程序服务器与 Web 服务器在同一物理工作站上,那么重新生成操作通常需要 30 到 60 秒的时间才能完成。如果应用程序服务器与 Web 服务器在不同工作站上,那么重新生成操作需要更长时间完成。
以下过程描述了有关更新插件配置文件的步骤,其中包括配置以调整 SSL 和 Web 服务器的步骤。
过程
- 使用管理控制台来更改插件配置文件中的设置。
设置 Web 服务器插件时,您必须决定是否要自动生成配置以响应配置更改。启用 Web 服务器插件配置服务并且发生任意以下情况时,自动生成插件配置文件:
- 创建或保存 Web 服务器时
- 安装应用程序时
- 卸载应用程序时
- 更新虚拟主机定义时
避免故障: 第一次生成插件配置文件时,它的虚拟主机列表中未包含 admin_host。关于允许
Web 服务器访问管理控制台的信息描述了如何将其添加到列表中。
gotcha
可使用管理控制台或发出 GenPluginCfg 命令以重新生成 plugin-cfg.xml 文件。
通过使用管理控制台完成以下步骤以重新生成 plugin-cfg.xml 文件:
- 选择。
- 选择自动生成插件配置文件,或者单击下列其中一个或多个主题以手动配置 plugin-cfg.xml 文件:
避免故障: 不要手动更新
plugin-cfg.xml 文件。每当为 Web 服务器重新生成
plugin-cfg.xml 文件时,都将覆盖您对该 Web 服务器所作的任何手动更新。
gotcha
- 单击确定。
传播插件配置。 要从管理控制台中传播插件配置,请单击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 文件时指定的位置。
- 可能必须停止并重新启动应用程序服务器,Web
服务器才能找到 plugin-cfg.xml 文件。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
调整 Web 服务器。 有关更多信息,请参阅关于调整 Web 服务器的页面。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
传播插件配置。 如果启用了 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® FTP 功能不保留文件属性。因此,如果需要从
AIX 操作系统手动复制
plugin-cfg.xml,那么可以使用 AIX RCP 功能代替 FTP 功能来复制文件。
远程 Web 服务器安装位置是您在为此 Web 服务器创建节点时指定的位置。
- 将密钥库文件复制到 Web 服务器上的密钥库目录。
避免故障: 必须执行本步骤,Web 服务器才能正常工作。
gotcha
有关复制密钥库文件的详细指示信息,请阅读有关为安全套接字层配置 Web 服务器插件的主题。
结果
配置完成。要激活配置,停止 Web 服务器,然后重新启动。如果您在重新启动 Web 服务器时遇到问题,请检查
http_plugin.log 文件以获取有关
plugin-cfg.xml 文件的哪个部分包含错误的信息。此日志文件表明发生错误的行号,以及可能有助于您诊断无法启动 Web 服务器的原因的其他详细信息。然后,您可以使用管理控制台更新
plugin-cfg.xml 文件。
如果很少安装或卸载应用程序(在生产环境中经常就是这种情况),或者如果每次执行任意上面列示的操作时,您要忍受生成和分发插件配置文件对性能产生的影响,那么应该考虑启用配置服务。