WebSphere® Application
Server 提供 Web 服务器插件,可配置该插件以与特定品牌的 Web 服务器进行通信。了解如何在同一机器上安装 Web 服务器及 WebSphere Application
Server 的 Web 服务器插件以及应用程序服务器。
开始之前
当存在多个概要文件时,可以选择 Web 服务器插件工具配置的概要文件。有关用来确定如何选择要配置的概要文件的逻辑流的描述,请参阅插件配置。
当存在多个概要文件时,可以选择 Web 服务器插件工具配置的概要文件。有关用来确定如何选择要配置的概要文件的逻辑流的描述,请参阅插件配置。
如果 WebSphere
Application Server 产品系列支持特定品牌的 Web 服务器(如 IBM®
HTTP Server 或 Microsoft Internet 信息服务 (IIS)),那么 WebSphere Application Server 产品提供您必须安装的 Web 服务器的二进制插件。
如果 WebSphere Application Server 产品系列没有为特定品牌的 Web 服务器提供二进制插件,那么该 Web 服务器不受支持。二进制插件的目的是提供 Web 服务器和应用程序服务器间的通信协议。
假设您创建新的概要文件,并且您还要使用 Web 服务器。您必须为新的概要文件安装新的 Web 服务器,安装 Web 服务器插件,并使用 Web 服务器插件配置工具来配置 Web 服务器以及应用程序服务器。
如果还没有安装 Web 服务器,那么您仍可以安装 Web 服务器插件以备以后使用。
此过程配置应用程序服务器概要文件,该文件是机器上的缺省概要文件。
Web 服务器和应用程序服务器之间存在一对一的关系。
但是,对于独立应用程序服务器概要文件和受管概要文件,可以为其定义多个 Web 服务器,并且每个 Web 服务器都在不同的 Web 服务器定义中定义。
本文描述如何创建以下拓扑:

注: 只有当应用程序服务器也由同一非 root 用户安装时,才支持对插件组件执行非 root 用户安装。否则,将无法对应用程序服务器安装运行 Web 服务器配置脚本。
关于此任务
注: 本主题引用了一个或多个应用程序服务器日志文件。作为另一种建议采用的方法,您可以在分布式系统和 IBM i 系统上配置服务器以使用高性能可扩展日志记录 (HPEL) 记录和跟踪基础结构,而不使用 SystemOut.log、SystemErr.log、trace.log 和 activity.log 文件。您还可以将 HPEL 与本机 z/OS® 日志记录设施结合使用。如果要使用 HPEL,那么可从服务器概要文件
bin 目录使用 LogViewer 命令行工具来访问所有日志和跟踪信息。有关使用
HPEL 的更多信息,请参阅有关使用 HPEL 对应用程序进行故障诊断的信息。
Web 服务器插件配置工具通过创建指向二进制插件模块和插件配置文件的位置的伪指令来编辑 Web 服务器的一个或多个配置文件。
Web 服务器的类型不同,二进制插件模块的名称也不同。插件配置文件
总是 plugin-cfg.xml 文件。
除非 Web 服务器定义已存在,否则 Web 服务器插件配置工具将在应用程序服务器的配置中创建此定义。
您可以使用管理控制台来管理此 Web 服务器配置。
例如,在应用程序服务器上安装应用程序时,您还可选择在 Web 服务器定义上安装该应用程序。如果这样,已更新的 plugin-cfg.xml 文件会显示新应用程序
可用。读取更新后的插件配置文件时,Web 服务器将了解到它可以提供给 Web 客户机的新应用程序。
如果您选择不在 Web 服务器定义上安装新应用程序,那么不会将应用程序添加到插件配置文件。
Web 服务器不会了解到此应用程序,也无法将它提供给 Web 客户机。
支持的配置: 此工具只在 AIX®、Linux 和 Windows 上受支持。除了使用 Web 服务器插件配置工具之外,还可将 PCT 命令行工具与响应文件配合使用来配置 Web 服务器。请阅读
使用 pct 工具配置 Web 服务器插件以了解更多信息。
sptcfg
使用此过程安装 Web 服务器插件、配置 Web 服务器以及在缺省应用程序服务器概要文件中创建 Web 服务器定义。
过程
- 配置独立应用程序服务器。
- 登录至操作系统。
如果您以非 root 用户或非管理用户的身份进行安装,那么会有一些限制。
![[AIX]](../images/aixlogo.gif)
![[Linux]](../images/linux.gif)
另外,选择一个允许所有者读/写文件的 umask,并允许其他用户按照主要的系统策略来访问这些文件。对于 root 用户,建议选择 umask 022。对于非 root 用户,可以根据用户是否共享组而使用 umask 002 或 022。要验证 umask 设置,发出以下命令:
umask
要将 umask 设置设置为 022,发出以下命令:
umask 022
![[Windows]](../images/windows.gif)
以管理用户身份在 Windows 操作系统上安装时,会自动创建 Windows 服务来自动启动应用程序服务器。安装程序用户帐户必须具有以下高级用户权限:
例如,在某些 Windows 操作系统上,单击
控制面板 > 管理工具 > 本地安全策略 > 本地策略 > 用户权限指定来设置高级选项。有关更多信息,请参阅 Windows 操作系统文档。
如果打算将应用程序服务器作为 Windows 服务来运行,那么不要使用包含空格的用户标识来进行安装。无法验证带有空格的用户标识。不允许这样的用户标识来继续安装。要解决此限制,请使用不包含空格的用户标识来安装。
- 安装 Installation Manager。
- 使用 Installation Manager 来安装下列各项:
- WebSphere Application ServerNetwork Deployment
- WebSphere Application Server 的 Web 服务器插件
- Websphere Customization Toolbox
- 使用 Installation Manager 安装 IBM HTTP Server 或安装另一个受支持的 Web 服务器。
- 打开 Websphere Customization Toolbox 并启动 Web 服务器插件配置工具。
- 选择 Web 服务器插件运行时位置。
如果要使用的位置(先前安装的 Web 服务器插件的位置)不在列表中,请执行下列操作以将该位置添加到您的工作集:
- 单击添加。
- 输入 Web 服务器插件位置的名称。
- 请执行下列其中一项操作:
- 单击创建。
- 选择您要配置的 Web 服务器的类型,然后单击下一步。
- 选择已安装的目标 Web 服务器的体系结构(64 位或 32 位),然后在系统询问时单击下一步。
- 单击浏览以选择 Web 服务器的配置文件、验证 Web 服务器端口是否正确,然后完成时单击下一步。
选择文件而不仅仅是文件的目录。某些 Web 服务器有两个配置文件并且需要您浏览每个文件。
以下列表显示了支持的 Web 服务器的配置文件:
- Apache HTTP Server
- apache_root/config/httpd.conf
- Domino® Web Server
- names.nsf 和 Notes.jar
向导会提示 notes.jar 文件。实际名称为 Notes.jar。
Web 服务器插件配置工具将验证文件是否存在,但是该工具不会验证其中任何一个文件。
- IBM HTTP Server
IHS_root/conf/httpd.conf
IHS_profile_root/conf/httpd.conf
- Microsoft Internet
Information Services (IIS)
- Web 服务器插件配置工具可以确定要编辑的正确文件。
- Sun Java™ System Web Server(以前称为
Sun ONE Web Server 和 iPlanet Web Server)V6.0 和更高版本
- obj.conf 和 magnus.conf
- 如果要配置 IBM HTTP Web 服务器插件,请执行下列操作。
- (可选)设置管理服务器配置以管理 Web 服务器。
注意: 使用 Web 服务器插件配置工具来配置 IBM HTTP Server 管理服务器时,必须以具有管理员/root 用户特权的“本地”帐户运行 Websphere Customization Toolbox。
- 选择设置 IBM HTTP Server 管理服务器。
- 指定 IBM HTTP 管理服务器将用于通信的端口号。
- (可选)选择创建用于 IBM Server 管理服务器认证的用户标识,并输入用户标识和密码以通过管理控制台向 IBM HTTP Server 管理服务器进行认证。
- 单击下一步。
![[AIX]](../images/aixlogo.gif)
指定对 IBM HTTP Server、IBM HTTP Server 管理服务器以及 Web 服务器插件配置文件具有写许可权的系统用户标识和组。必要时选择使用凭证创建新的唯一系统用户标识和组。
限制: 用户标识名称或组名长度的平台限制通常为 8 个字符,但有时也可以进行配置。如果您指定的新用户标识名称或组名的长度超过了此限制,那么配置可能会失败。
(可选)对 IBM HTTP Server 管理服务器进行设置,以使其作为 Windows 服务运行。- 选择将 IBM HTTP Server 管理服务器作为 Windows 服务运行。
- 请执行下列其中一项操作:
- 选择以本地系统帐户登录。
- 选择以指定用户帐户登录,并输入该帐户的用户标识和密码。
- 选择启动类型将为自动还是手动。
- 单击下一步。
- 指定 Web 服务器定义的唯一名称,然后单击下一步。
- 选择配置方案。
- 选择本地方案。
- 请执行下列其中一项操作:
- 输入 WebSphere Application Server 的安装位置 (app_server_root)。
- 单击浏览,并查找 WebSphere Application Server 的安装位置 (app_server_root),然后单击确定。
- 单击下一步。
- 选择要使用当前 Web 服务器插件进行配置的概要文件,然后单击下一步。
- 复审摘要信息,然后单击配置以开始配置 Web 服务器、Web 服务器插件和应用程序服务器概要文件。
- 在摘要面板中验证安装是否成功,然后单击完成。
如果出现问题并且安装未成功,那么检查
plugins_root/logs 目录中的日志。
更正任何问题并重新进行配置。
- 仅适用于 Domino Web 服务器:设置 WAS_PLUGIN_CONFIG_FILE 环境变量。
在诸如 AIX 或 Linux 之类的平台上,将父 shell 的脚本作为源允许子进程继承导出的变量。在
Windows 系统上,采用运行任何其他命令的方式运行脚本。在
Windows 系统上,会自动将脚本视为源。
- 打开命令窗口。
- 切换至插件安装根目录。
- 对 plugins_root/bin/setupPluginCfg.sh 脚本发出相应的命令:
. plugins_root/bin/setupPluginCfg.sh(注意,句点与安装根目录之间存在空格。)
source plugins_root/bin/setupPluginCfg.sh
在诸如 AIX 或
Linux 之类的操作系统上,脚本还位于 lotus_root/notesdata 目录中。
启动 Domino Web
Server 之前,对脚本发出相应的命令。
- 启动 Snoop servlet 以验证 Web 服务器从 Application Server 检索应用程序的能力。
通过启动应用程序服务器和 Web 服务器并通过 IP 地址使用 Snoop servlet 来测试您的环境。
- 启动应用程序服务器。在 Network Deployment 环境中,仅在将 Application Server 添加到单元时包括 DefaultApplication 的情况下,才能在单元中使用 Snoop Servlet。addNode 命令的 -includeapps 选项将 DefaultApplication 迁移到单元。如果应用程序不存在,那么跳过此步骤。
切换至
profile_root/bin
目录并运行
startServer 命令:
![[AIX]](../images/aixlogo.gif)
./startServer.sh server1
startServer server1
startServer server1
- 启动 IBM HTTP
Server 或者您正在使用的 Web 服务器。
使用 2001 页或者使用 STRTCPSVR
SERVER(*HTTP) HTTPSVR(instance_name ) 命令来启动 IBM HTTP Server。
使用命令窗口将目录切换至 IBM HTTP Server 安装映像,或者切换至 Web 服务器的安装映像。发出相应的命令以启动
Web 服务器,如对于 IBM HTTP Server 发出这些命令:
要从命令行启动 IBM HTTP Server,请执行以下操作:
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
访问
IBMHttpServer/bin 目录中的
apache 和
apachectl 命令。
- 将浏览器指向 http://localhost:9080/snoop,以测试应用程序服务器提供的内部 HTTP 传输。将浏览器指向 http://Host_name_of_Web_server_machine/snoop 以测试 Web 服务器插件。
缺省情况下,HTTP 传输端口是 9080,并且对于每个概要文件必须唯一。该端口与名为 default_host
的虚拟主机相关联,此虚拟主机配置为托管已安装的 DefaultApplication。Snoop servlet 是 DefaultApplication 的一部分。更改端口以与实际的 HTTP 传输端口匹配。
- 验证该 Snoop 是否正在运行。
任一 Web 地址都应该显示“Snoop Servlet - Request/Client Information”页面。
提示: 如果验证失败并显示 HTTP 错误代码 500,请转至 IIS 管理器 > 缺省 Web 站点 > sePlugins。单击鼠标右键,然后选择编辑许可权。单击共享选项卡,并选择与每个人进行共享(许可权级别:读/写)。
- 仅对于远程 IBM HTTP Server:
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
使用以下步骤来验证自动传播功能是否能在远程 IBM HTTP Server 上运行。对于本地 Web 服务器,此过程不是必需的。
- 在 IHS_root /conf/admin.passwd 文件中创建用户 adminUser 和密码 adminPassword。例如:c:\ws\ihs80\bin\htpasswd -cb c:\ws\ihs80\conf\admin.passwd
adminUser adminPassword
- 使用 Deployment Manager 或应用程序服务器的管理控制台来输入您为 IBM HTTP Server 的管理用户创建的用户标识和密码信息。转至服务器
> Web 服务器 > web_server_definition > 远程 Web 服务器管理。设置下列值:管理端口 = 8008,用户标识 = adminUser,密码 = adminPassword。
- 设置对 httpd.conf 文件和 plugin-cfg.xml 文件的正确读/写许可权。请参阅 IHS_root /logs/admin_ERROR.LOG 文件以获取更多信息。
要自动传播插件配置文件,将要求 IBM HTTP 管理服务器已启动并且正在运行。如果使用 WebSphere
Application Server 管理控制台来管理 IBM HTTP Server,那么可能会显示以下错误:
"Could not connect to IHS Administration server error"
执行以下过程来更改该错误:
- 验证 IBM HTTP Server 管理服务器是否正在运行。
- 验证在 WebSphere Application Server 管理控制台中定义的 Web 服务器主机名和端口是否与
IBM HTTP Server 管理主机名和端口相匹配。
- 验证防火墙是否不妨碍您从 WebSphere Application
Server 管理控制台访问 IBM HTTP Server 管理服务器。
- 验证是否在 admin.passwd 文件中使用 htpasswd 命令创建了 WebSphere Application Server 管理控制台中指定的受远程管理的用户标识和密码。
- 如果尝试安全连接,那么验证您是否将 IBM
HTTP Server 管理服务器密钥数据库个人证书作为签署者证书导出到 WebSphere Application Server 密钥数据库中。
此密钥数据库是由正在运行管理控制台的概要文件中的 sas.client.props 文件中的 com.ibm.ssl.trustStore 伪指令指定的。主要是自签名证书应考虑此方面。
- 如果仍然存在问题,请检查 IBM HTTP Server admin_ERROR.LOG 文件和 WebSphere Application Server 日志(trace.log 文件)以确定问题原因。
- 配置联合到 Deployment Manager 单元的应用程序服务器。
注: 以下过程描述在两台机器上安装插件。但是,您可以在一台机器上执行此过程。
以下拓扑被认为是本地分布式拓扑,这
是因为它包括单元:

过程的此部分假定您在两台机器上都已安装 Installation Manager 和 Network Deployment 产品。而且假定您已在机器 A 上配置了
Deployment Manager 概要文件,而在机器 B 上配置了应用程序服务器概要文件。
如果您计划将应用程序服务器节点添加到 Deployment Manager 单元,但是还没有执行该操作,那么在配置插件之前,启动 Deployment Manager 并联合该节点。您无法将应用程序服务器和 Web 服务器定义添加到 Deployment Manager 单元。
联合应用程序服务器上的 Web 服务器定义与应用程序服务器安装在同一受管节点上。存在一个节点,但其中有两个服务器进程,即应用程序服务器和 Web 服务器定义。
如果您正在安装供联合应用程序服务器使用的插件,那么启动 Deployment
Manager。验证受管节点上的节点代理程序进程是否也在运行。Deployment Manager 和节点代理程序都必须在运行以成功配置受管节点。
- 使用 Installation Manager 在机器 B 上安装下列各项。
- WebSphere Application Server 的 Web 服务器插件
- Websphere Customization Toolbox
- 使用 Installation Manager 在机器 B 上安装 IBM HTTP Server 或安装另一个受支持的 Web 服务器。
- 在机器 B 上打开 WebSphere Customization Toolbox 并启动 Web 服务器插件配置工具。
- 选择 Web 服务器插件运行时位置。
如果要使用的位置(先前安装的 Web 服务器插件的位置)不在列表中,请执行下列操作以将该位置添加到您的工作集:
- 单击添加。
- 输入 Web 服务器插件位置的名称。
- 请执行下列其中一项操作:
- 单击创建。
- 选择您要配置的 Web 服务器的类型,然后单击下一步。
- 选择已安装的目标 Web 服务器的体系结构(64 位或 32 位),然后单击下一步。
- 单击浏览以选择 Web 服务器的配置文件、验证 Web 服务器端口是否正确,然后完成时单击下一步。
选择文件而不仅仅是文件的目录。某些 Web 服务器有两个配置文件并且需要您浏览每个文件。
以下列表显示了支持的 Web 服务器的配置文件:
- Apache HTTP Server
- apache_root/config/httpd.conf
- Domino Web Server
- names.nsf 和 Notes.jar
向导会提示 notes.jar 文件。实际名称为 Notes.jar。
Web 服务器插件配置工具将验证文件是否存在,但是该工具不会验证其中任何一个文件。
- IBM HTTP Server
IHS_root/conf/httpd.conf
IHS_profile_root/conf/httpd.conf
- Microsoft Internet
Information Services (IIS)
- Web 服务器插件配置工具可以确定要编辑的正确文件。
注: 最佳实践是在 IIS 7 上使用 32 位插件。
- Sun Java System Web Server(以前称为
Sun ONE Web Server 和 iPlanet Web Server)V6.0 和更高版本
- obj.conf 和 magnus.conf
- 指定 Web 服务器定义的唯一名称,然后单击下一步。
- 选择配置方案。
- 选择本地方案。
- 请执行下列其中一项操作:
- 输入 WebSphere Application Server 的安装位置 (app_server_root)。
- 单击浏览,并查找 WebSphere Application Server 的安装位置 (app_server_root),然后单击确定。
- 单击下一步。
- 选择要使用当前 Web 服务器插件进行配置的概要文件,然后单击下一步。
- 复审摘要信息,然后单击配置以开始配置 Web 服务器、Web 服务器插件和应用程序服务器概要文件。
- 在摘要面板中验证安装是否成功,然后单击完成。
如果出现问题并且安装未成功,那么检查
plugins_root/logs 目录中的日志。
更正任何问题并重新进行配置。
- 复制 configureweb_server_name
脚本以粘贴到机器 A。
- 在机器 A 上创建 Web 服务器定义。
您可以使用 Deployment Manager 的管理控制台在联合节点上创建 Web 服务器定义;或者可以运行 Web 服务器插件配置工具创建的配置脚本。
此脚本已包含当使用管理控制台选项时必须收集的所有信息。
- 在 Deployment Manager 的管理控制台中,单击系统管理 > 保存对主存储库所做的更改 > 与节点同步更改 > 保存。
- 仅适用于 Domino Web 服务器:设置 WAS_PLUGIN_CONFIG_FILE 环境变量。
在诸如 AIX 或 Linux 之类的平台上,将父 shell 的脚本作为源允许子进程继承导出的变量。在
Windows 系统上,采用运行任何其他命令的方式运行脚本。在
Windows 系统上,会自动将脚本视为源。
- 启动 Snoop servlet。
请参阅独立应用程序服务器的 Snoop 过程以了解完整过程。
结果
Web 服务器插件的安装导致创建了
Plugins 目录和多个子目录。例如,下面就是 Linux 系统上创建的那些目录中的某些目录:
- plugins_root/bin/32bits 或 plugins_root/bin/64bits 包含所有受支持的 Web 服务器的二进制插件
- plugins_root/logs 包含日志文件
- plugins_root/properties 包含版本信息
除非 Web 服务器定义已存在,否则 Web 服务器插件配置工具会在应用程序服务器概要文件中创建此定义。
Web 服务器插件配置工具将 Web 服务器配置为使用 profile_root/plugin-cfg.xml 文件。
只要发生影响 Web 服务器插件配置文件
plugin-cfg.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_of_AppServer/servers/
web_server_name/plugin-cfg.xml
下一步做什么
您可以在配置本地 Web 服务器的插件后立即启动独立应用程序服务器和 Web 服务器。启动服务器并保存已更改的配置后,打开应用程序服务器的管理控制台。
配置本地 Web 服务器的插件后,您可以在运行用于完成配置的脚本后启动联合应用程序服务器和 Web 服务器。打开 Deployment Manager 的管理控制台。等待发生节点同步。保存包含新的 Web 服务器定义的已更改配置。
有关安装过程的概述,请参阅选择 Web 服务器拓扑图和路线图。
请参阅插件配置,以获取有关插件配置文件的位置的信息。
请参阅 Web 服务器配置以获取有关配置 Web 服务器时所涉及的文件的信息。
有关 Web 服务器插件配置工具如何配置受支持 Web 服务器的信息,请参阅编辑 Web 服务器配置文件。
请参阅配置 Web 服务器插件以获取有关用于安装 Web 服务器插件的其他安装方案的信息。