![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
Web 服务器配置
插件配置包括配置 Web 服务器以使用 WebSphere® Application Server 提供的二进制插件模块。插件配置还包括更新插件 XML 配置文件,以反映当前应用程序服务器配置。二进制模块使用 XML 文件来帮助路由 Web 客户端请求。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
请参阅每个文件的以下描述。
Web 服务器配置文件
Web 服务器配置文件作为 Web 服务器的一部分进行安装。
Web 服务器插件配置工具必须为受支持的 Web 服务器重新配置配置文件。
二进制 Web 服务器插件文件
二进制插件模块的一个示例是 Windows 平台上的 IBM HTTP Server 的 mod_was_ap22_http.dll 文件。
二进制插件模块的另一个示例是 IBM i 平台上的
QSVTAP20 服务程序。
二进制插件文件不会被更改。然而,二进制插件的配置文件是 XML 文件。对 WebSphere Application Server 配置进行了某些特定更改时,应用程序服务器将更改配置文件。
二进制模块读取 XML 文件,以调整设置并将请求路由至应用程序服务器。
插件配置文件 plugin-cfg.xml
插件配置文件是 XML 文件,您可以在管理控制台中调整其设置。该文件列出了在 Web 服务器定义中安装的所有应用程序。二进制模块读取 XML 文件,以调整设置并将请求路由至应用程序服务器。
独立应用程序服务器在 profile_root/config/cells/cell_name/nodes/web_server_name_node/servers/web_server_name 目录中重新生成 plugin-cfg.xml 文件。
在影响已部署应用程序的应用程序服务器配置中,只要发生更改就要重新生成此文件。
每当应用程序服务器配置中发生影响受管节点上的已部署应用程序的更改时,Deployment Manager
就会在 profile_root/config/cells/cell_name/nodes/node_name/servers/web_server_name
目录中重新生成 plugin-cfg.xml 文件。
在进行会影响已部署应用程序的应用程序服务器配置更改时,重新生成插件配置
XML 文件。
在重新生成该文件之后,将它传播(复制)到 Web 服务器。然后,二进制插件就能够访问它配置文件的最新副本了。
某些更改配置的事件发生之后,Web 服务器插件配置服务会自动重新生成 plugin-cfg.xml 文件。在重新生成 plugin-cfg.xml 文件时,配置服务会自动将该文件传播至 IBM HTTP
Server 机器。必须手动复制其他 Web 服务器上的该文件。
在 IBM i 系统上,不会自动生成插件。必须手动重新生成并传播该文件。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
缺省插件配置文件 plugin-cfg.xml
Web 服务器插件配置工具将在 plugins_root/config/web_server_name 目录中创建临时 plugin-cfg.xml 文件。此工具为每个远程安装方案创建该文件。
缺省文件是占位符,您必须用应用程序服务器上 Web 服务器定义中的 plugin-cfg.xml 文件将其替换。缺省文件是应用程序服务器为缺省独立应用程序服务器创建的文件的副本。
对于远程安装,从应用程序服务器机器的 app_server_root/bin 目录中运行 configureweb_server_name 脚本;对于本地安装,直接从 plugins_root/bin 目录运行该脚本。此脚本在缺省概要文件的配置文件中创建 Web 服务器定义。要配置与缺省概要文件不同的概要文件,请编辑 configureweb_server_name 脚本。使用 -profileName 参数来找到非缺省概要文件。
创建 Web 服务器定义之后,应用程序服务器中的 Web 服务器插件配置服务会在应用程序服务器机器上的 Web 服务器定义中创建首个 plugin-cfg.xml 文件。如果您安装应用程序、创建虚拟主机或对配置进行更改,则必须将应用程序服务器机器上的已更新 plugin-cfg.xml 文件传播到 Web 服务器机器上以替换缺省文件。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
配置 Web 服务器定义的 web_server_name 脚本
Web 服务器插件配置工具将在 Web 服务器机器上的 plugins_root/bin 目录中创建 configureweb_server_name 脚本。如果远程方案中的一台机器在 AIX® 或 Linux 之类的操作系统下运行,而另一台机器在 Windows 下运行,请使用在 plugins_root/bin/crossPlatformScripts 目录中创建的脚本。 此脚本是专门为远程安装方案创建的。
将该脚本从 Web 服务器机器复制到远程应用程序服务器机器上的 app_server_root/bin 目录。您不必为本地安装复制此脚本。运行此脚本以在应用程序服务器配置中创建 Web 服务器定义。
此问题是 shell 环境变量、WAS_USER_SCRIPT 环境变量和实际缺省概要文件之间的可能存在的冲突。此脚本总是会使用缺省概要文件。但是,如果设置了 WAS_USER_SCRIPT 环境变量,由于此脚本会尝试使用该变量指定的概要文件,所以就会发生冲突。
此变量很容易被意外设置。从任何概要文件的 profile_root/bin 目录发出任何命令,该变量将设置为该概要文件。
如果在您的系统上有多个概要文件,那么有可能缺省概要文件与变量识别的概要文件是不同的概要文件。如果这样,就会出现冲突,那么此脚本可能不会在正确的概要文件中创建 Web 服务器定义,或者根本不会创建 Web 服务器定义。
如果独立应用程序服务器的 Web 服务器定义已存在,那么运行此脚本不会添加新的 Web 服务器定义。每个独立应用程序服务器只能有一个 Web 服务器定义。
另一方面,受管节点可能具有多个 Web 服务器定义。除非 Web 服务器名是相同的,否则此脚本会创建新的 Web 服务器定义。
![[IBM i]](../images/iseries.gif)
Web 服务器定义的配置脚本
使用 configureOs400WebserverDefinition 脚本或使用 IBM i 管理 GUI 配置 Web 服务器将在 Web 服务器机器的 plugins_root/bin 目录中创建 configureweb_server_name 脚本。此脚本是专门为远程安装方案创建的。
将该脚本从 Web 服务器机器复制到 IBM i 分区中的 app_server_root/bin 目录。运行此脚本以在应用程序服务器配置中创建 Web 服务器定义。
如果独立应用程序服务器的 Web 服务器定义已存在,那么运行此脚本不会添加新的 Web 服务器定义。每个独立应用程序服务器只能有一个 Web 服务器定义。
或者,可使用 configureOs400WebServerDefinition 和 removeOs400WebServerDefinition 脚本来执行这些任务。
另一方面,受管节点可能具有多个 Web 服务器定义。除非 Web 服务器名是相同的,否则此脚本会创建新的 Web 服务器定义。
用 Web 服务器定义(传播)的文件来替换缺省插件配置文件
缺省文件使用固定参数值,这些参数值可能不匹配应用程序服务器的实际文件中的那些参数值。缺省文件仅是一个占位符。
该文件无法反映在应用程序服务器配置中发生的更改。该文件也无法反映可能在应用程序服务器上有效的非缺省值。
应用程序服务器必须在实际 plugin-cfg.xml 文件中具有以下值。如果这样的话,缺省文件可以成功配置二进制插件模块。接着,插件模块可以成功与 Web 服务器和应用程序服务器通信。
假设应用程序服务器在实际 plugin-cfg.xml 文件中不具有以下值。在这种情况下,缺省文件会不正确地配置二进制插件模块。此插件模块总是可以与 Web 服务器通信。但是使用了不正确的配置文件,此插件模块无法与应用程序服务器成功地通信。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)