[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

Network Deployment 产品的配置流

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

设计逻辑的插件流

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

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

概要文件?
如果已安装产品,但Profile Management Tool尚未创建概要文件,那么方案将考虑使用远程安装。
带有 Web 服务器定义的独立应用程序服务器?
如果缺省概要文件是具有现有 Web 服务器定义的应用程序服务器,那么安装将考虑使用远程安装。
Profile_type
Web 服务器插件配置工具每次只能配置一个概要文件。这三种路径显示了不同类型概要文件的不同处理方式。
联合?
如果已联合应用程序服务器节点,那么 Web 服务器插件配置工具会在受管节点上配置 Web 服务器定义。这样做有很多好处。假设 Web 服务器和受管节点是在不同的机器上。在同步节点期间,plugin-cfg.xml 文件被自动传播到远程节点,这是因为 Web 服务器定义是节点配置的一部分。
分布式概要文件?
如果 Deployment Manager 具有联合的定制节点(定制概要文件),那么 Web 服务器插件配置工具会在受管节点上配置 Web 服务器定义。这样做有很多好处。假设 Web 服务器和受管节点是在不同的机器上。在同步节点期间,plugin-cfg.xml 文件被自动传播到远程节点,这是因为 Web 服务器定义是节点配置的一部分。

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 服务器。

假设您在独立应用程序服务器上创建 Web 服务器定义并且随后联合节点。Web 服务器定义未联合到单元中,因为在独立应用程序服务器中 Web 服务器定义被定义为单独节点。必须在受管节点上重新创建 Web 服务器定义。请参阅方案 2
表 1. 可用于本地独立应用程序服务器方案的配置.    
概要文件类型 联合状态 自动创建 Web 服务器定义? 已在 Application Server 配置中定义了 Web 服务器?
应用程序服务器 未联合

应该将具有现有 Web 服务器定义的未联合独立应用程序服务器作为远程插件配置来处理。

独立应用程序服务器上的现有 Web 服务器定义要求 Web 服务器插件配置工具遵循远程安装路径。一个独立应用程序服务器只能有一个 Web 服务器定义。

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

应该将联合的独立应用程序服务器作为本地分布式插件配置来处理。请参阅方案 2 以获取关于此类型节点的描述。

以下概述显示了验证 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 服务器定义。该工具将改为在 plugins_root/bin 目录中创建 configureweb_server_name 脚本。

Web 服务器插件配置工具将 Web 服务器配置为使用 plugin-cfg.xml文件,将在您运行脚本时在应用程序服务器概要文件中创建该文件。Deployment Manager 在 profile_root/config/cells/cell_name/nodes/node_name/servers/web_server_name 目录中重新生成 plugin-cfg.xml 文件。在受管节点上影响已部署应用程序的应用程序服务器配置中,只要发生更改就要重新生成此文件。

为本地 Web 服务器安装二进制插件之后,您必须运行此脚本,然后才可以启动 Web 服务器。已将 Web 服务器配置为使用应用程序服务器配置中的 plugin-cfg.xml 文件。直到您运行 configureweb_server_name 脚本,此文件才存在。
表 2. 可用于本地分布式应用程序服务器方案的配置.    
概要文件类型 联合状态 创建 Web 服务器定义? 已在 Application Server 配置中定义了 Web 服务器?
应用程序服务器概要文件 联合 用脚本 不适用
定制概要文件 未联合 用脚本 不适用
定制概要文件 联合 用脚本 不适用
具有受管节点的 Deployment Manager 概要文件(分布式概要文件) 不适用 用脚本 不适用

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

  1. 启动 Deployment Manager。
  2. 如果您打算将应用程序服务器节点添加到 Deployment Manager 单元,但尚未这样做,请在安装插件之前联合此节点。如果在您联合此节点时 Web 服务器定义已经存在,那么说明在您进行联合时 Web 服务器定义已丢失。
  3. 在应用程序服务器中创建 Web 服务器定义。您具有两个选项:
    • 使用 Deployment Manager 的管理控制台为受管节点创建 Web 服务器定义。单击服务器 > Web 服务器 > 新建,然后使用“创建新的 Web 服务器条目”向导来创建 Web 服务器定义。
    • 运行此脚本以在 Deployment Manager 的配置中手动创建 Web 服务器定义。从 plugins_root/bin 目录运行脚本。 此脚本可能涉及同一台机器上的 Deployment Manager。
      打开命令窗口以运行相应的脚本:
      • [AIX][HP-UX][Linux][Solaris]./configureweb_server_name.sh
      • [Windows]configureweb_server_name.bat
      注: 脚本中的 webserverNodeName 值是为 Web 服务器选择的别名和后缀 -node 的并置。它在安装插件期间自动创建,不能更改。例如,如果在安装插件期间将 Web 服务器命名为 myserver,那么运行该脚本后创建的关联 Web 服务器定义的值将是 myserver-node

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

  4. 使用适用于您的 Web 服务器的过程来启动 Web 服务器。
    例如,从命令行启动 IBM HTTP Server:
    • [AIX][HP-UX][Linux][Solaris]./IHS_root/bin/apachectl start
    • [Windows]IHS_root\bin\apache
  5. 启动应用程序服务器。
    切换至 profile_root/bin 目录并运行 startServer 命令:
    • [AIX][HP-UX][Linux][Solaris]./profile_root/bin/startServer.sh server1
    • [Windows]profile_root\bin\startServer server1
  6. 打开 Deployment Manager 的管理控制台。等待发生节点同步,然后保存包含新的 Web 服务器定义的已更改配置。
  7. 将浏览器指向 http://localhost:9080/snoop,以测试应用程序服务器提供的内部 HTTP 传输。将浏览器指向 http://Host_name_of_Web_server_machine/snoop 以测试 Web 服务器插件。
  8. 验证两个 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 服务器定义的好处。
表 3. 可用于远程应用程序服务器方案的配置.    
概要文件类型 联合状态 创建 Web 服务器定义? 已在 Application Server 配置中定义了 Web 服务器?
如果您在 Web 服务器插件配置工具中选择了远程安装类型,那么任何位置的任何概要文件都适用 不适用 用脚本 不适用
无概要文件 不适用 用脚本 不适用
具有现有 Web 服务器定义的未联合独立应用程序服务器概要文件 未联合 用脚本
没有受管节点的 Deployment Manager 概要文件 不适用 用脚本 不适用

以下概述显示了验证临时 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. 如果您要配置 Deployment Manager 或受管节点,那么启动 Deployment Manager。
  2. 如果您打算在某个时刻联合远程应用程序服务器节点或定制节点,那么现在就联合此节点。如果在您联合此节点时 Web 服务器定义已经存在,那么说明此定义已丢失。
  3. 在应用程序服务器中创建 Web 服务器定义。有两个选项用于受管节点。在没有受管节点的情况下,使用脚本选项以用于 Deployment Manager 节点。
    • 使用 Deployment Manager 的管理控制台为受管节点创建 Web 服务器定义。单击服务器 > Web 服务器 > 新建,然后使用“创建新的 Web 服务器条目”向导来创建 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
      注: 脚本中的 webserverNodeName 值是为 Web 服务器选择的别名和后缀 -node 的并置。它在安装插件期间自动创建,不能更改。例如,如果在安装插件期间将 Web 服务器命名为 myserver,那么运行该脚本后创建的关联 Web 服务器定义的值将是 myserver-node

      如果您已经启用了安全性或更改了缺省 Java™ 管理扩展 (JMX) 连接器类型,请编辑脚本并包含相应的参数。

  4. 如果联合了节点,那么打开 Deployment Manager 的管理控制台。等待在受管节点上发生节点同步,然后保存包含新的 Web 服务器定义的已更改配置。如果未联合远程节点,请打开应用程序服务器的管理控制台,并保存已更改的配置。
  5. 复制 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 服务器。
  6. 使用适用于您的 Web 服务器的过程来启动 Web 服务器。
  7. 将浏览器指向 http://localhost:9080/snoop,以测试应用程序服务器提供的内部 HTTP 传输。将浏览器指向 http://Host_name_of_Web_server_machine/snoop 以测试 Web 服务器插件。
  8. 验证两个 Web 地址都显示了“Snoop Servlet - Request/Client Information”页面。

总之,三种方案都存在于 Web 服务器插件中。每一种方案都涉及到插件配置文件 plugin-cfg.xml 的唯一位置。应用程序服务器生成插件配置文件。此文件用于发布与 Web 服务器相关的所有应用程序服务器元素的位置。例如,此类元素包含应用程序、为应用程序提供服务的虚拟主机、集群和集群成员。

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

在每一个本地方案中,Web 服务器可以访问 plugin-cfg.xml 文件,这是因为它与此文件在同一台机器上。由于本地 plugin-cfg.xml 文件有两个明确的位置,因此存在两个本地方案。

WebSphere Application Server 的配置方案将插件配置文件放置在位于 Web 服务器节点或受管节点中的 Web 服务器定义中。在本文中,节点的类型是方案 2方案 1之间的差异。方案 2 的所有配置都要求 Web 服务器定义存在于受管的应用程序服务器节点中。方案 1 的所有配置在其自己的 Web 服务器节点中都有 Web 服务器定义。

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

下表显示在本文中描述的每个配置的 plugin-cfg.xml 文件的位置:
表 4. 插件配置文件位置. 此表描述插件配置文件的位置。
方案 概要文件类型 plugin-cfg.xml 文件的位置
plugins_root profile_root:在受管节点中 profile_root:在 Web 服务器节点中
1 应用程序服务器概要文件     X
2 应用程序服务器概要文件   X  
定制概要文件   X  
具有受管节点的 Deployment Manager 概要文件(分布式概要文件)   X  
3 如果您在 Web 服务器插件配置工具中选择了远程安装类型,那么任何位置的任何概要文件都适用 X    
无概要文件 X    
具有现有 Web 服务器定义的未联合(独立)应用程序服务器概要文件 X    
没有受管节点的 Deployment Manager 概要文件 X    
图注:
plugins_root
plugins_root
/config/web_server_name/plugin-cfg.xml
profile_root:在受管节点中
profile_root/config/cells/cell_name/nodes/node_name_of_AppServer/servers/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-nd-mp&topic=cins_webplugins
文件名:cins_webplugins.html