[AIX Solaris HP-UX Linux Windows][IBM i]

插件配置

Web 服务器插件配置工具将 Web 服务器类型配置为应用程序服务器,并在应用程序服务器配置中创建 Web 服务器定义。熟悉 Web 服务器插件配置工具可以使用的不同处理路径。

本文描述了 Web 服务器插件配置工具可以配置 Web 服务器及创建 plugin-cfg.xml 文件(插件配置文件)的两种方法。

支持的配置 支持的配置: 此工具只在 AIX®、Linux 和 Windows 上受支持。除了使用 Web 服务器插件配置工具之外,还可将 PCT 命令行工具与响应文件配合使用来配置 Web 服务器。有关更多信息,请阅读“使用 pct 工具配置 Web 服务器插件”。sptcfg
在您开始之前: 会在配置插件期间更新插件和 Web 服务器配置文件。如果您要以非 root 用户身份使用 Web 服务器插件配置工具或 PCT 命令行工具,—尤其当您不是 Web 服务器插件配置文件以及 Web 服务器(例如,IHS)配置文件的所有者时,那么在开始配置之前,请先验证您是否具有更新这些文件的适当特权。
注意: 使用 Web 服务器插件配置工具来配置 IBM® HTTP Server 管理服务器时,必须以具有管理员/root 用户特权的“本地”帐户运行 Websphere Customization Toolbox。

此外,缺省 httpd.conf 配置文件必须保留在 <IHS_HOME>/conf 目录内,并且您必须在管理配置之后手动运行 setupadm。

支持的配置 支持的配置: Web 服务器插件配置工具旨在与完整的 WebSphere® Application Server 概要文件配合使用;在为 Liberty 概要文件生成 Web 服务器插件时不要求也不支持使用该工具。有关为 Liberty 概要文件生成 Web 服务器插件的信息,请参阅“配置 Liberty 概要文件以使用 Web 服务器插件”。sptcfg

配置流

Web 服务器插件配置工具将 Web 服务器和 WebSphere Application Server 的所有配置解析为两种方案:远程插件配置或本地插件配置。下图显示的是在确定适用于配置的方案时实现的逻辑。

设计逻辑的插件流

图注:
安装类型?
安装类型为远程或本地。

如果 Web 服务器和应用程序服务器不在同一台计算机上,请选择远程方案。如果 Web 服务器和应用程序服务器在同一台计算机上,请选择本地方案。

概要文件?
如果产品已安装,但概要文件不小心删除或丢失,那么方案将考虑使用远程安装。在运行脚本之前创建概要文件。
带有 Web 服务器定义的独立应用程序服务器?
如果概要文件具有现有的 Web 服务器定义,那么安装将视为远程插件配置。您不能在独立应用程序服务器中拥有多个 Web 服务器定义。

方案 A. 本地独立插件配置

在此方案中,Web 服务器插件配置工具在应用程序服务器概要文件中直接创建 Web 服务器定义,而无需使用脚本。

Web 服务器插件配置工具将 Web 服务器配置为使用应用程序服务器概要文件中的 plugin-cfg.xml文件。应用程序服务器在 profile_root/config/cells/ cell_name/nodes/ web_server_name_node/servers/ web_server_name 目录中重新生成 plugin-cfg.xml 文件。在影响已部署应用程序的应用程序服务器配置中,只要发生更改就要重新生成此文件。

在为本地 Web 服务器配置应用程序服务器之后,您就可以立即启动应用程序服务器和 Web 服务器。
表 1. 可用于本地应用程序服务器方案的配置.    
概要文件类型 自动创建 Web 服务器定义? 已在 Application Server 配置中定义了 Web 服务器?
应用程序服务器 是 否

应该将具有现有 Web 服务器定义的应用程序服务器概要文件作为远程插件配置来处理。一个应用程序服务器只能有一个 Web 服务器定义。

请参阅方案 B 以获取关于此类型节点的描述。

以下概述显示了验证 Web 服务器配置的过程:

  1. 使用适用于您的 Web 服务器的过程来启动 Web 服务器。
    例如,从命令行启动 IBM HTTP Server:
    • [AIX][HP-UX][Linux][Solaris]./IHS_root/bin/apachectl start
    • [Windows]IHS_root\bin\apache
  2. 启动应用程序服务器。
    切换至 profile_root/bin 目录并运行 startServer 命令:
    • [AIX][HP-UX][Linux][Solaris]./profile_root/bin/startServer.sh server1
    • [Windows]profile_root\bin\startServer server1
    打开管理控制台并保存已更改的配置。
  3. 将浏览器指向 http://localhost:9080/snoop,以测试应用程序服务器提供的内部 HTTP 传输。将浏览器指向 http://Host_name_of_Web_server_machine/snoop 以测试 Web 服务器插件。
  4. 验证两个 Web 地址都显示了“Snoop Servlet - Request/Client Information”页面。

Web 服务器插件配置工具不会在远程机器上的分布式概要文件中自动创建 Web 服务器定义。该工具将改为创建 configureweb_server_name 脚本。

Web 服务器插件配置工具将 Web 服务器配置为使用 plugins_root/config/web_server_name 目录中的 plugin-cfg.xml 文件,会在 Web 服务器机器上对此文件进行维护。此文件需要定期传播。传播是指从应用程序服务器复制当前的 plugin-cfg.xml 文件,以替换 plugins_root/config/web_server_name/plugin-cfg.xml 文件。

为本地 Web 服务器安装二进制插件之后,您不必在可以启动应用程序服务器和 Web 服务器之前运行脚本。然而,直到运行脚本,您才可以享受到应用程序服务器节点中 Web 服务器定义的好处。
表 2. 可用于远程应用程序服务器方案的配置.    
概要文件类型 创建 Web 服务器定义? 已在 Application Server 配置中定义了 Web 服务器?
如果您在 Web 服务器插件配置工具中选择了远程安装类型,那么任何位置的任何概要文件都适用 用脚本 不适用
无概要文件 用脚本 不适用
具有现有 Web 服务器定义的独立应用程序服务器概要文件 用脚本 是

以下概述显示了验证临时 plugins_root/config/web_server_name/plugin-cfg.xml 文件的过程。

Web 服务器使用临时 plugin-cfg.xml 文件与远程应用程序服务器通信。

如果应用程序服务器的 HTTP 传输端口分配不是 9080,那么测试不成功。继续到下一个部分,在应用程序服务器中创建 Web 服务器定义并完成对配置的测试。

  1. 使用适用于您的 Web 服务器的过程来启动 Web 服务器。
    例如,从命令行启动 IBM HTTP Server:
    • [AIX][HP-UX][Linux][Solaris]./IHS_root/bin/apachectl start
    • [Windows]IHS_root\bin\apache
  2. 在远程机器上启动应用程序服务器。
    切换至 profile_root/bin 目录并运行 startServer 命令:
    • [AIX][HP-UX][Linux][Solaris]./profile_root/bin/startServer.sh server1
    • [Windows]profile_root\bin\startServer server1
  3. 将浏览器指向 http://localhost:9080/snoop,以测试应用程序服务器提供的内部 HTTP 传输。将浏览器指向 http://Host_name_of_Web_server_machine/snoop 以测试 Web 服务器插件。
  4. 验证两个 Web 地址都显示了“Snoop Servlet - Request/Client Information”页面。
以下概述显示了完成配置的过程。直到 Web 服务器定义在应用程序服务器节点的配置中存在时,才算完成配置。Web 服务器定义是在重新生成有效插件配置文件 plugin-cfg.xml 时的主要元素。
  1. 在应用程序服务器中创建 Web 服务器定义。
    运行此脚本以在应用程序服务器节点的配置中手动创建 web 服务器定义:
    1. 将脚本从 plugins_root/bin 目录复制到远程 app_server_root/bin 目录。
    2. 打开命令窗口并运行脚本:
      • [AIX][HP-UX][Linux][Solaris]./configureweb_server_name.sh
      • [Windows]configureweb_server_name.bat
    configureweb_server_name 脚本可采用下列三个参数:profile_name、Admin_Console_Username 和 Admin_Console_Password。
    • profile_name 指示用于创建 Web 服务器定义的概要文件的名称。
    • Admin_Console_Username 指示管理控制台的用户名。部署了管理控制台的概要文件必须将管理控制台安全性设置为开。如果 profile_name 都为空白,那么不能使用此参数。
    • Admin_Console_Password 指示对应于用户名的密码。如果 profile_name 和 Admin_Console_Username 都为空白,那么不能使用此参数。
    注: 脚本中的 webserverNodeName 值是为 Web 服务器选择的别名和后缀 -node 的并置。它在配置插件期间自动创建的,不能进行更改。例如,如果在配置插件期间将 Web 服务器命名为 myserver,那么运行该脚本后创建的关联 Web 服务器定义的值将是 myserver-node。

    如果已启用安全性或更改了缺省 JMX 连接器类型,请编辑此脚本并包括适当的参数。

  2. 复制 profile_root/config/cells/cell_name/nodes/web_server_name_node/servers/web_server_name 目录中的当前插件配置文件 plugin-cfg.xml。在 Web 服务器机器上粘贴该文件以替换临时 plugins_root/ config/ web_server_name/plugin-cfg.xml 文件。IBM HTTP Server 支持自动传播。需要手动传播其他 Web 服务器。
  3. 使用适用于您的 Web 服务器的过程来启动 Web 服务器。打开管理控制台并保存已更改的配置。
  4. 将浏览器指向 http://localhost:9080/snoop,以测试应用程序服务器提供的内部 HTTP 传输。将浏览器指向 http://Host_name_of_Web_server_machine/snoop 以测试 Web 服务器插件。
  5. 验证两个 Web 地址都显示了“Snoop Servlet - Request/Client Information”页面。

总之,两种方案都存在于 Web 服务器插件中。每一种方案都涉及到插件配置文件 plugin-cfg.xml 的唯一位置。

应用程序服务器生成插件配置文件。此文件的用途是:发布与 Web 服务器相关的所有应用程序服务器对象的位置,并控制二进制插件配置选项。例如,此文件用于识别为应用程序提供服务的对象(如应用程序和虚拟主机)。

如果 Web 服务器无法访问应用程序服务器机器中的文件,那么您必须将此文件复制到 Web 服务器。此过程称为传播。为远程插件配置方案(本文中的方案 B)保留传播。

在本地方案中,Web 服务器可以访问 plugin-cfg.xml 文件,这是因为它与此文件在同一台机器上。

方案 A 的所有配置在其自己的 Web 服务器节点中都有 Web 服务器定义。

受限制的管理选项不允许您在独立应用程序服务器的管理控制台中创建或删除 Web 服务器定义。独立应用程序服务器无法创建 Web 服务器定义,这是 Web 服务器插件配置工具创建的配置脚本的基础。没有这些脚本,您就无法轻松地在独立应用程序服务器节点上创建 Web 服务器定义。

下表显示在本文中描述的每个配置的 plugin-cfg.xml 文件的位置:
表 3. 插件配置文件位置. 此表描述插件配置文件的位置。
方案 概要文件类型 plugin-cfg.xml 文件的位置
plugins_root profile_root:在 Web 服务器节点中
A 应用程序服务器概要文件   X
B 如果您在 Web 服务器插件配置工具中选择了远程安装类型,那么任何位置的任何概要文件都适用 X  
无概要文件 X  
具有现有 Web 服务器定义的应用程序服务器概要文件 X  
图注:
plugins_root
plugins_root/config/web_server_name/plugin-cfg.xml
profile_root:在 Web 服务器节点中
profile_root/config/cells/cell_name/nodes/web_server_name_node/servers/web_server_name/plugin-cfg.xml

指示主题类型的图标 参考主题



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