此过程描述在缺省概要文件为定制概要文件的机器上安装 Web 服务器及其插件。
开始之前
当存在多个概要文件时,可以选择 Web 服务器插件工具配置的概要文件。有关用来确定如何选择要配置的概要文件的逻辑流的描述,请参阅插件配置。
当存在多个概要文件时,可以选择 Web 服务器插件工具配置的概要文件。有关用来确定如何选择要配置的概要文件的逻辑流的描述,请参阅插件配置。
此过程将在机器 B 上配置定制概要文件,并假定您已在机器 A 上安装 Deployment Manager。
机器 B 上的 WebSphere® Application
Server 节点是您在此过程中创建的定制节点。安装 Web 服务器插件前,此过程将启动 Deployment Manager 并联合定制节点。
启动 Deployment Manager。Deployment Manager 必须运行才能成功联合和配置定制节点。
关于此任务
注: 本主题引用了一个或多个应用程序服务器日志文件。作为另一种建议采用的方法,您可以在分布式系统和 IBM® i 系统上配置服务器以使用高性能可扩展日志记录 (HPEL) 记录和跟踪基础结构,而不使用 SystemOut.log、SystemErr.log、trace.log 和 activity.log 文件。您还可以将 HPEL 与本机 z/OS® 日志记录设施结合使用。如果要使用 HPEL,那么可从服务器概要文件
bin 目录使用 LogViewer 命令行工具来访问所有日志和跟踪信息。有关使用
HPEL 的更多信息,请参阅有关使用 HPEL 对应用程序进行故障诊断的信息。
使用以下过程来安装 Web 服务器插件、配置 Web 服务器并在定制概要文件(定制节点)中创建 Web 服务器定义。
支持的配置: 此工具只在 AIX®、Linux 和 Windows 上受支持。除了使用 Web 服务器插件配置工具之外,还可将 PCT 命令行工具与响应文件配合使用来配置 Web 服务器。有关更多信息,请参阅
使用 pct 工具配置 Web 服务器插件。
sptcfg
过程
- 登录至操作系统。
如果您以非 root 用户或非管理用户的身份进行安装,那么会有一些限制。
![[Windows]](../images/windows.gif)
以管理用户身份在 Windows 操作系统上安装时,会自动创建 Windows 服务来自动启动应用程序服务器。安装程序用户帐户必须具有以下高级用户权限:
例如,在某些 Windows 操作系统上,单击
控制面板 > 管理工具 > 本地安全策略 > 本地策略 > 用户权限分配来设置高级选项。有关更多信息,请参阅 Windows 操作系统文档。
如果打算将应用程序服务器作为 Windows 服务来运行,那么不要使用包含空格的用户标识来进行安装。无法验证带有空格的用户标识。不允许这样的用户标识来继续安装。要解决此限制,请使用不包含空格的用户标识来安装。
- 使用 Installation Manager 在机器 B 上安装下列各项。
- WebSphere Application Server Network Deployment
- WebSphere Application Server 的 Web 服务器插件
- Websphere Customization Toolbox
- 使用 Installation Manager 在机器 B 上安装 IBM HTTP Server 或安装另一个受支持的 Web 服务器。
- 创建定制概要文件作为机器 B 上的第一个概要文件,并在创建概要文件时对节点进行联合。
- 可选: 使用 Deployment Manager 的管理控制台在定制节点上创建应用程序服务器。
单击服务器 > 应用程序服务器 > 新建并按照指示信息创建服务器。
安装插件时可以不需要服务器,但服务器可以让您验证 Web 服务器的功能。
- 可选: 当您在 Deployment Manager 的管理控制台中时在新服务器上安装 DefaultApplication。
DefaultApplication 包含 Snoop servlet。验证步骤将使用 Snoop servlet。
- 在机器 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 服务器插件配置工具可以确定要编辑的正确文件。
- 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 目录中的日志。
更正任何问题并重新进行配置。
- 在机器 A 上创建 Web 服务器定义。
您可以使用 Deployment Manager 的管理控制台在联合节点上创建 Web 服务器定义;或者可以运行 Web 服务器插件配置工具创建的配置脚本。
此脚本已包含当使用管理控制台选项时必须收集的所有信息。
仅限 Domino Web 服务器:设置 WAS_PLUGIN_CONFIG_FILE 环境变量。 在诸如 AIX 或 Linux 之类的平台上,将父 shell 的脚本作为源允许子进程继承导出的变量。在
Windows 系统上,采用运行任何其他命令的方式运行脚本。在
Windows 系统上,会自动将脚本视为源。
- 打开命令窗口。
- 切换至插件安装根目录。
- 对 plugins_root/bin/setupPluginCfg.sh 脚本发出相应的命令:
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
. 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 到单元。如果应用程序不存在,那么跳过此步骤。
- 启动 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”页面。
- 仅对于远程 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\ihs85\bin\htpasswd -cb c:\ws\ihs85\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 未安装 DefaultApplication,那么您可以使用自己的应用程序测试 Web 服务器和定制节点的功能。
- 在 Deployment Manager 的管理控制台中,单击系统管理 >
保存对主存储库所做的更改 > 与节点同步更改 > 保存。
- 要为受管节点创建多个 Web 服务器定义,请使用 Web 服务器插件配置工具来配置每个 Web 服务器。
每次会识别同一受管节点。为每个 Web 服务器指定一个不同的昵称。
结果
此过程在 Web 服务器机器上安装了 WebSphere Application Server 的 Web 服务器插件。Web 服务器插件配置工具在受管节点中创建了 Web 服务器定义。
Web 服务器插件配置工具将 Web 服务器配置为使用受管定制节点中的 plugin-cfg.xml 文件。
只要发生影响 Web 服务器插件配置文件 plugin-cfg.xml 的事件,Deployment Manager 就会重新生成该文件。这种事件包括添加或移除应用程序、服务器或虚拟主机。
创建或移除集群和集群成员也会导致重新生成文件。通过节点同步的自动传播将每次重新生成后的文件复制到定制节点机器上的以下位置:
profile_root
/config/cells/cell_name/nodes/
node_name_of_custom_profile/servers/
web_server_name/plugin-cfg.xml
Web 服务器插件的安装导致创建了
Plugins 目录和多个子目录。例如,下面就是 Linux 系统上创建的那些目录中的某些目录:
- plugins_root/bin/32bits 或 plugins_root/bin/64bits 包含所有受支持的 Web 服务器的二进制插件
- plugins_root/logs 包含日志文件
- plugins_root/properties 包含版本信息
下一步做什么
请参阅插件配置,以获取有关插件配置文件的位置的信息。
有关配置 Web 服务器时所涉及文件的更多信息,请参阅 Web 服务器配置。
有关 Web 服务器插件配置工具如何配置受支持 Web 服务器的信息,请参阅编辑 Web 服务器配置文件。
请参阅配置 Web 服务器插件以获取有关用于安装 Web 服务器插件的其他安装方案的信息。