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

Web 服务器配置

插件配置包括配置 Web 服务器以使用 WebSphere® Application Server 提供的二进制插件模块。插件配置还包括更新插件 XML 配置文件,以反映当前应用程序服务器配置。二进制模块使用 XML 文件来帮助路由 Web 客户端请求。

[AIX Solaris HP-UX Linux Windows]在安装受支持的 Web 服务器之后,您必须通过安装 Web 服务器插件为 Web 服务器安装二进制插件模块。插件模块让 Web 服务器与应用程序服务器通信。Web 服务器插件配置工具允许您配置 Web 服务器并在应用程序服务器配置中创建 Web 服务器定义。Web 服务器插件配置工具使用下列文件来配置您选择的 Web 服务器插件:
  • Web 服务器机器上的 Web 服务器配置文件,如 IBM® HTTP Server 的 httpd.conf 文件。
  • Web 服务器机器上的二进制 Web 服务器插件文件
  • 应用程序服务器机器上的插件配置文件 plugin-cfg.xml,即您传播(复制)到 Web 服务器的文件。
  • Web 服务器机器上的缺省(临时)插件配置文件 plugin-cfg.xml
  • 从 Web 服务器机器复制到应用程序服务器的 configureweb_server_name 脚本
[IBM i]插件配置过程使用下列文件来配置您选择的 Web 服务器插件:
  • Web 服务器机器上的 Web 服务器配置文件,如 IBM HTTP Server 的 httpd.conf 文件。
  • Web 服务器机器上的二进制 Web 服务器插件文件
  • 应用程序服务器机器上的插件配置文件 plugin-cfg.xml,即您传播(复制)到 Web 服务器的文件。
  • 用于为远程 HTTP 方案中的应用程序服务器配置 Web 服务器定义的配置脚本

请参阅每个文件的以下描述。

Web 服务器配置文件

Web 服务器配置文件作为 Web 服务器的一部分进行安装。

[AIX Solaris HP-UX Linux Windows]Web 服务器插件配置工具必须为受支持的 Web 服务器重新配置配置文件。

配置由添加用于标识两个文件的位置的伪指令组成:
  • 二进制 Web 服务器插件文件
  • 插件配置文件 plugin-cfg.xml

二进制 Web 服务器插件文件

二进制插件模块的一个示例是 Windows 平台上的 IBM HTTP Server 的 mod_was_ap22_http.dll 文件。

[IBM i]二进制插件模块的另一个示例是 IBM i 平台上的 QSVTAP20 服务程序。

二进制插件文件不会被更改。然而,二进制插件的配置文件是 XML 文件。对 WebSphere Application Server 配置进行了某些特定更改时,应用程序服务器将更改配置文件。

二进制模块读取 XML 文件,以调整设置并将请求路由至应用程序服务器。

插件配置文件 plugin-cfg.xml

插件配置文件是 XML 文件,您可以在管理控制台中调整其设置。该文件列出了在 Web 服务器定义中安装的所有应用程序。二进制模块读取 XML 文件,以调整设置并将请求路由至应用程序服务器。

[AIX Solaris HP-UX Linux Windows]独立应用程序服务器在 profile_root/config/cells/cell_name/nodes/web_server_name_node/servers/web_server_name 目录中重新生成 plugin-cfg.xml 文件。 在影响已部署应用程序的应用程序服务器配置中,只要发生更改就要重新生成此文件。

[AIX Solaris HP-UX Linux Windows]每当应用程序服务器配置中发生影响受管节点上的已部署应用程序的更改时,Deployment Manager 就会在 profile_root/config/cells/cell_name/nodes/node_name/servers/web_server_name 目录中重新生成 plugin-cfg.xml 文件。

[IBM i]在进行会影响已部署应用程序的应用程序服务器配置更改时,重新生成插件配置 XML 文件。

在重新生成该文件之后,将它传播(复制)到 Web 服务器。然后,二进制插件就能够访问它配置文件的最新副本了。

[AIX Solaris HP-UX Linux Windows]某些更改配置的事件发生之后,Web 服务器插件配置服务会自动重新生成 plugin-cfg.xml 文件。在重新生成 plugin-cfg.xml 文件时,配置服务会自动将该文件传播至 IBM HTTP Server 机器。必须手动复制其他 Web 服务器上的该文件。

[IBM i]IBM i 系统上,不会自动生成插件。必须手动重新生成并传播该文件。

[AIX Solaris HP-UX Linux Windows]

缺省插件配置文件 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]

配置 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 服务器定义。

使用 IBM HTTP Server 时,还要配置 IBM HTTP 管理服务器。IBM HTTP Administration Server 使用管理控制台来管理 Web 服务器定义。同样,使用管理控制台通过远程 Web 服务器管理选项来更新您的 Web 服务器定义。单击服务器 > 服务器类型 > Web 服务器 > web_server_name 以查看配置选项。例如,单击远程 Web 服务器管理来更改如下的属性:
  • 主机名
  • 管理端口
  • 用户标识
  • 密码
要点: 总是在运行此脚本之前打开新的命令窗口。可通过这样做来避免潜在问题。

此问题是 shell 环境变量、WAS_USER_SCRIPT 环境变量和实际缺省概要文件之间的可能存在的冲突。此脚本总是会使用缺省概要文件。但是,如果设置了 WAS_USER_SCRIPT 环境变量,由于此脚本会尝试使用该变量指定的概要文件,所以就会发生冲突。

此变量很容易被意外设置。从任何概要文件的 profile_root/bin 目录发出任何命令,该变量将设置为该概要文件。

如果在您的系统上有多个概要文件,那么有可能缺省概要文件与变量识别的概要文件是不同的概要文件。如果这样,就会出现冲突,那么此脚本可能不会在正确的概要文件中创建 Web 服务器定义,或者根本不会创建 Web 服务器定义。

按以下两种方法重置变量:
  • 关闭设置变量的命令窗口并打开一个新的命令窗口。
  • 切换至缺省概要文件的 profile_root/bin 目录并获取 setupCmdLine.sh 脚本:
    [Windows]
    1. 打开命令提示符窗口。
    2. 切换至 app_server_root\bin 目录。
    3. 发出 setupCmdLine.bat 命令。
    [AIX][HP-UX][Linux][Solaris]
    1. 打开命令 shell 窗口。
    2. 切换至 app_server_root/bin 目录。
    3. 发出 . ./setupCmdLine.sh 命令。注意句点之间的空格。此命令的特殊格式会让命令对从命令 shell 启动的所有进程激活设置。

如果独立应用程序服务器的 Web 服务器定义已存在,那么运行此脚本不会添加新的 Web 服务器定义。每个独立应用程序服务器只能有一个 Web 服务器定义。

不能使用独立应用程序服务器的管理控制台来添加或删除 Web 服务器定义。然而,您可以使用管理脚本接口来完成这两个任务:
  • 使用 configureweb_server_name 脚本通过 wsadmin 工具来添加 Web 服务器定义。此脚本使用名为 configureWebserverDefintion.jacl 的 Java™ 命令语言 (Jacl) 脚本来创建并配置 Web 服务器定义。
  • 使用 wsadmin 命令删除 Web 服务器定义。在以下示例中,Web 服务器被命名为 webserver1:
     set webserverName webserver1
     set webserverNodeSuffix _node
     set webserverNodeName   $webserverName$webserverNodeSuffix
     $AdminConfig remove [$AdminConfig getid /Node:$webserverNodeName/Server:$webserverName]
     $AdminConfig remove [$AdminConfig getid /Node:$webserverNodeName]
     $AdminConfig save

另一方面,受管节点可能具有多个 Web 服务器定义。除非 Web 服务器名是相同的,否则此脚本会创建新的 Web 服务器定义。

[IBM i]

Web 服务器定义的配置脚本

使用 configureOs400WebserverDefinition 脚本或使用 IBM i 管理 GUI 配置 Web 服务器将在 Web 服务器机器的 plugins_root/bin 目录中创建 configureweb_server_name 脚本。此脚本是专门为远程安装方案创建的。

将该脚本从 Web 服务器机器复制到 IBM i 分区中的 app_server_root/bin 目录。运行此脚本以在应用程序服务器配置中创建 Web 服务器定义。

IBM i 管理 GUI 包含允许管理控制台管理 IBM HTTP Server 的插件。将管理控制台与远程 Web 服务器管理选项配合使用来更新 Web 服务器定义。单击服务器 > 服务器类型 > Web 服务器 > web_server_name以查看配置选项。例如,单击远程 Web 服务器管理来更改如下的属性:
  • 主机名
  • 管理端口
  • 用户标识
  • 密码

如果独立应用程序服务器的 Web 服务器定义已存在,那么运行此脚本不会添加新的 Web 服务器定义。每个独立应用程序服务器只能有一个 Web 服务器定义。

不能使用独立应用程序服务器的管理控制台来添加或删除 Web 服务器定义。然而,您可以使用管理脚本接口来完成这两个任务:
  • 使用 configureweb_server_name 脚本通过 wsadmin 工具来添加 Web 服务器定义。此脚本使用名为 configureWebserverDefintion.jacl 的 Java 命令语言 (Jacl) 脚本来创建并配置 Web 服务器定义。
  • 使用 wsadmin 命令删除 Web 服务器定义。在以下示例中,Web 服务器被命名为 webserver1:
    set webserverName webserver1
    set webserverNodeSuffix _node
    set webserverNodeName 
    $webserverName$webserverNodeSuffix
    $AdminConfig remove 
      [$AdminConfig getid 
        /Node:$webserverNodeName/Server:$webserverName]
    $AdminConfig remove 
      [$AdminConfig getid /Node:$webserverNodeName]
    $AdminConfig save

或者,可使用 configureOs400WebServerDefinitionremoveOs400WebServerDefinition 脚本来执行这些任务。

另一方面,受管节点可能具有多个 Web 服务器定义。除非 Web 服务器名是相同的,否则此脚本会创建新的 Web 服务器定义。

用 Web 服务器定义(传播)的文件来替换缺省插件配置文件

缺省文件使用固定参数值,这些参数值可能不匹配应用程序服务器的实际文件中的那些参数值。缺省文件仅是一个占位符。

该文件无法反映在应用程序服务器配置中发生的更改。该文件也无法反映可能在应用程序服务器上有效的非缺省值。

[AIX Solaris HP-UX Linux Windows]应用程序服务器必须在实际 plugin-cfg.xml 文件中具有以下值。如果这样的话,缺省文件可以成功配置二进制插件模块。接着,插件模块可以成功与 Web 服务器和应用程序服务器通信。

[AIX Solaris HP-UX Linux Windows]假设应用程序服务器在实际 plugin-cfg.xml 文件中不具有以下值。在这种情况下,缺省文件会不正确地配置二进制插件模块。此插件模块总是可以与 Web 服务器通信。但是使用了不正确的配置文件,此插件模块无法与应用程序服务器成功地通信。

[AIX Solaris HP-UX Linux Windows]以下是临时插件配置文件中的固定参数值。
  • 虚拟主机名称

    缺省值:default_host

    将此虚拟主机配置为提供 DefaultApplication。此值可能与实际 plugin-cfg.xml 文件中的值相同。然而,假设您创建了另一个提供应用程序的虚拟主机,并将 DefaultApplication 安装在它上面。如果这样的话,那么重新生成实际 plugin-cfg.xml 文件。Web 服务器无法访问 DefaultApplication。(此应用程序包含了 snoop Servlet 和 hitcount Servlet。)

    要访问新的虚拟主机上的应用程序,那么传播实际 plugin-cfg.xml 文件。传播正在将应用程序服务器机器上的已更新文件复制到 Web 服务器机器上。

  • HTTP 传输端口

    缺省值:9080

    9080 是 default_host 虚拟主机的 HTTP 传输端口的缺省值。此值可能与更新文件中的值相同。然而,此值随应用程序服务器上的每一个概要文件而更改。每一个应用程序服务器的 HTTP 传输端口值必须唯一。

    要通过另一个端口来通信,传播实际 plugin-cfg.xml 文件。

  • Web 服务器侦听端口

    缺省值:80

    80 是控制与 Web 服务器通信的端口的缺省值。然而,每一个应用程序服务器概要文件都必须具有用于与 Web 服务器通信的唯一端口值。实际端口值可能是 81 或其他数字。

    要通过另一个端口来通信,传播实际 plugin-cfg.xml 文件。

  • HTTPS 传输端口

    缺省值:9443

    9443 是 default_host 虚拟主机的 HTTPS(安全)传输端口的缺省值。此值可能与更新文件中的值相同。然而,此值随应用程序服务器上的每一个概要文件而更改。每一个应用程序服务器的 HTTPS 传输端口值必须唯一。

    要通过另一个安全端口来通信,传播实际 plugin-cfg.xml 文件。

  • server1 应用程序服务器上安装的应用程序

    缺省文件中包含所有的缺省 Servlet 和应用程序。

    传播实际 plugin-cfg.xml 文件,以服务使用 Web 服务器开发的应用程序。


指示主题类型的图标 概念主题



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