# Web Application Server Network Deployment 的 Web 服务器插件安装路线图

入门
插件安装路线图：

1. 独立应用程序服务器的 Web 服务器插件安装
2. 分布式环境的 Web 服务器插件安装

## 独立应用程序服务器的 Web 服务器插件安装

| 远程安装方案 | 本地安装方案
## 典型环境 | # 生产（建议） | # 开发
## 安装和配置 |
安装应用程序服务器：
（机器 A）
1. | 安装 IBM Installation Manager。
2. | 使用 Installation Manager 来安装 WebSphere Application Server Network Deployment 产品。
3. | 创建独立应用程序服务器。
安装 Web 服务器和 Web 服务器插件：
（机器 B）
4. | 安装 IBM Installation Manager。
5. | 使用 Installation Manager 来安装 IBM HTTP Server 或安装其他受支持的 Web 服务器。
6. | 使用 Installation Manager 来安装 WebSphere Application Server 的 Web 服务器插件。
Web 服务器插件的配置：
（机器 B）
7. | 使用 Installation Manager 来安装 WebSphere Customization Tools。
8. | 打开 WebSphere Customization Tools，然后启动 Web Server Plug-ins Configuration Tool 以配置 Web 服务器插件。 将在 plugins_root`/bin` 目录中创建用于创建和配置Web 服务器的脚本。
9. | 复制 configureWeb_server_name 脚本以粘贴到机器 A 上。 有关在以下情况下运行配置脚本的更多信息，请参阅此文档的“跨平台注意事项”部分： 一台机器正在运行 Windows，而另一台机器正在运行 Linux 或 UNIX。 一台机器正在运行其他文件编码。
创建 Web 服务器定义：
（机器 A）
10. | 将 `configureWeb_server_name` 脚本从机器 B 粘贴到机器 A 上的 app_server_root`/bin` 目录
11. | 启动机器 A 上的应用程序服务器。
12. | 在机器 A 上运行该脚本。
验证：
（机器 A）
13. | 验证应用程序服务器是否正在运行。
（机器 B）
14. | 启动 IBM HTTP Server 或其他其他受支持的 Web 服务器。
15. | 运行 Snoop servlet。
| 要使用您自己的应用程序进行验证，请在配置（安装）该应用程序之后重新生成并传播 `plugin-cfg.xml` 文件。
安装应用程序服务器：
（机器 A）
1. | 安装 IBM Installation Manager。
2. | 使用 Installation Manager 来安装 WebSphere Application Server Network Deployment 产品。
3. | 创建独立应用程序服务器。
安装 Web 服务器和 Web 服务器插件：
（机器 A）
4. | 使用 Installation Manager 来安装 IBM HTTP Server 或安装其他受支持的 Web 服务器。
5. | 使用 Installation Manager 来安装 WebSphere Application Server 的 Web 服务器插件。
配置 Web 服务器插件和创建 Web 服务器插件定义：
（机器 A）
6. | 使用 Installation Manager 来安装 WebSphere Customization Tools。
7. | 打开 WebSphere Customization Tools，然后启动 Web Server Plug-ins Configuration Tool 以配置 Web 服务器插件和创建 Web 服务器定义。
8. | 启动应用程序服务器。
验证：
（机器 A）
9. | 验证应用程序服务器是否正在运行。
10. | 启动 IBM HTTP Server 或其他其他受支持的 Web 服务器。
11. | 运行 Snoop servlet。
## 重新生成 `plugin-cfg.xml` 文件 | 在配置期间，临时 `plugin-cfg.xml` 文件将安装在机器 B 上的plugins_root`/config/Web_server_name` 目录中。 Web 服务器插件配置服务将自动重新生成 `plugin-cfg.xml` 文件。 要从应用程序服务器使用实际 `plugin-cfg.xml` 文件，如下一部分中描述的传播 `plugin-cfg.xml` 文件。 | Web 服务器插件配置服务将自动重新生成 `plugin-cfg.xml` 文件。 创建 Web 服务器定义时，将在 profile_root `/config/cells/cell_name/nodes/node_name/servers/Web_server_name` 位置生成 `plugin-cfg.xml` 文件。
## 传播 `plugin-cfg.xml` 文件 | Web 服务器插件配置服务仅对 IBM HTTP Server 自动传播 `plugin-cfg.xml` 文件。要启用自动传播，请执行一次性设置。 对于所有其他 Web 服务器，可通过手动将 `plugin-cfg.xml`文件从机器 A 上的 profile_root `/config/cells/cell_name/nodes/node_name/servers/ web_server_name` 目录复制到机器 B 上的 `plugins_root/config/web_server_name` 目录来传播该插件配置文件。 | 使用该传播选项将 `plugin-cfg.xml` 文件从 profile_root/config/cells/cell_name /nodes/node_name/servers/Web_server_name 目录移动到 plugins_root/config/web_server_name 目录。

### 远程拓扑 | ### 本地拓扑

# 分布式环境（单元）的 Web 服务器插件安装
| 远程分布式安装方案 | 本地分布式安装方案
## 典型环境 | # 生产（建议） | # 开发
## 安装和配置 |
安装 Deployment Manager
（机器 A）
1. | 安装 IBM Installation Manager。
2. | 使用 Installation Manager 来安装 WebSphere Application Server Network Deployment 产品。
3. | 插件 Deployment Manger 概要文件。
4. | 验证 Deployment Manager 是否正在运行，以允许节点同步更改的配置文件。
安装应用程序服务器：
（机器 B）
5. | 安装 IBM Installation Manager。
6. | 使用 Installation Manager 来安装 WebSphere Application Server Network Deployment 产品。
7. | 创建独立应用程序服务器。
8. | 将节点添加到 Deployment Manager 单元中以启动节点代理程序进程。在现有受管节点上启动节点代理程序。Deployment Manager 和节点代理程序必须正在运行，才能在节点间同步更改的配置文件。
安装 Web 服务器和 Web 服务器插件：
（机器 C）
9. | 安装 IBM Installation Manager。
10. | 使用 Installation Manager 来安装 IBM HTTP Server 或安装其他受支持的 Web 服务器。
11. | 使用 Installation Manager 来安装 WebSphere Application Server 的 Web 服务器插件。
配置 Web 服务器插件：
（机器 C）
12. | 使用 Installation Manager 来安装 WebSphere Customization Tools。
13. | 打开 WebSphere Customization Tools，然后启动 Web Server Plug-ins Configuration Tool 以配置 Web 服务器插件。 将在 plugins_root`/bin` 目录中创建用于创建和配置Web 服务器的脚本。
14. | 复制 configureWeb_server_name 脚本以粘贴到机器 A 上。 有关在以下情况下运行配置脚本的更多信息，请参阅此文档的“跨平台注意事项”部分： 一台机器正在运行 Windows，而另一台机器正在运行 Linux 或 UNIX。 一台机器正在运行其他文件编码。
创建 Web 服务器定义：
（机器 A）
15. | 将 configureWeb_server_name 脚本从机器 C 复制到机器 A 上的 app_server_root `/bin` 目录。
16. | 从命令行运行脚本。 此步骤要求 Deployment Manager 和节点代理程序正在运行。 如果您已启用安全性或更改了缺省 JMX 连接器类型，那么编辑此脚本并包括适当的参数。
验证：
（机器 A 和 B）
17. | 使用机器 A 上 Deployment Manager 的管理控制台启动机器 B 上的应用程序服务器。
（机器 C）
18. | 启动 IBM HTTP Server 或其他其他受支持的 Web 服务器。
19. | 运行 Snoop servlet。
注意：以下过程描述如何在两台机器上安装插件。但是，您也可以在单台机器上执行此过程。
安装 Deployment Manager：
（机器 A）
1. | 安装 IBM Installation Manager。
2. | 使用 Installation Manager 来安装 WebSphere Application Server Network Deployment 产品。
3. | 创建 Deployment Manger 概要文件。
4. | 验证 Deployment Manager 是否正在运行，以允许在节点间同步更改的配置文件。
安装应用程序服务器：
（机器 B）
5. | 安装 IBM Installation Manager。
6. | 使用 Installation Manager 来安装 WebSphere Application Server Network Deployment 产品。
7. | 创建独立应用程序服务器。
8. | 将节点添加到 Deployment Manager 单元中以启动节点代理程序进程。在现有受管节点上启动节点代理程序。Deployment Manager 和节点代理程序必须正在运行，才能在节点间同步更改的配置文件。
安装 Web 服务器和 Web 服务器插件：
（机器 B）
9. | 使用 Installation Manager 来安装 IBM HTTP Server 或安装其他受支持的 Web 服务器。
10. | 使用 Installation Manager 来安装 WebSphere Application Server 的 Web 服务器插件。
配置 Web 服务器插件：
（机器 B）
11. | 使用 Installation Manager 来安装 WebSphere Customization Tools。
12. | 打开 WebSphere Customization Tools，然后启动 Web Server Plug-ins Configuration Tool 以配置 Web 服务器插件和创建 Web 服务器定义。 将在 plugins_root`/bin` 目录中创建用于创建和配置Web 服务器的脚本。
13. | 复制 configureWeb_server_name 脚本以粘贴到机器 A 上。 有关在以下情况下运行配置脚本的更多信息，请参阅此文档的“跨平台注意事项”部分： 一台机器正在运行 Windows，而另一台机器正在运行 Linux 或 UNIX。 一台机器正在运行其他文件编码。
创建 Web 服务器定义：
（机器 A）
14. | 将 configureWeb_server_name 脚本从机器 B 复制到机器 A 上的 app_server_root `/bin` 目录。
15. | 从命令行运行脚本。 此步骤要求 Deployment Manager 和节点代理程序正在运行。 如果您已启用安全性或更改了缺省 JMX 连接器类型，那么编辑此脚本并包括适当的参数。
验证：
（机器 A 和 B）
16. | 使用机器 A 上 Deployment Manager 的管理控制台启动机器 B 上的应用程序服务器。
17. | 启动 IBM HTTP Server 或其他其他受支持的 Web 服务器。 在 Linux 或 UNIX 系统上启动 Domino WebServer 之前，请找到 plug-ins_root`/setupPluginCfg.sh` 脚本。
18. | 运行 Snoop servlet。
## 重新生成 `plugin-cfg.xml` 文件 | 在配置期间，临时 `plugin-cfg.xml` 文件将安装在机器 C 上的plugins_root`/config/Web_server_name` 目录中。 Web 服务器插件配置服务将自动重新生成 `plugin-cfg.xml` 文件。 要从应用程序服务器使用实际 `plugin-cfg.xml` 文件，如下一部分中描述的传播 `plugin-cfg.xml` 文件。 | 创建 Web 服务器定义时，将在 profile_root `/config/cells/cell_name/nodes/node_name/servers/Web_server_name` 目录生成 `plugin-cfg.xml` 文件。 每当配置更改时，在应用程序服务器中的 Web 服务器定义中重新生成 `plugin-cfg.xml` 文件。每当重新生成该文件之后，Web 服务器可以立即访问该文件。 在机器 A 上启用 Web 服务器插件配置服务（一种管理服务）时，将为所有 Web 服务器自动生成 `plugin-cfg.xml` 文件。
## 传播 `plugin-cfg.xml` 文件 | Web 服务器插件配置服务仅对 IBM HTTP Server 自动传播 `plugin-cfg.xml` 文件。要启用自动传播，请执行此路线图的最后一部分中所述的一次性设置。 对于所有其他 Web 服务器，可通过手动将 `plugin-cfg.xml` 文件从机器 A 上的 profile_root `/config/cells/cell_name/nodes/node_name/servers/ Web_server_name` 目录复制到机器 C 上的 plugins_root`/config/Web_server_name` 目录来传播该插件配置文件。 | 使用该传播选项将 `plugin-cfg.xml` 文件从 profile_root/config/cells/cell_name/nodes/node_name/servers/Web_server_name 目录移动到 plugins_root/config/web_server_name目录。

### 远程拓扑 | ### 本地拓扑

# 设置用于自动传播的过程并对其进行故障诊断 Web 服务器插件配置服务仅对 IBM HTTP Server 自动传播 `plugin-cfg.xml` 文件。要启用自动传播，请执行以下一次性设置： 在 IHS_root`/conf/admin.passwd` 文件中创建：用户=adminUser，密码=adminPassword。例如：c:\ws\ihs85\bin\htpasswd -cb c:\ws\ihs85\conf\admin.passwd adminUser adminPassword 在管理控制台中，单击服务器 > Web 服务器 > webserver1 > 远程 Web 服务器管理。设置以下值：管理端口 = 8008，用户标识 = adminUser，密码 = adminPassword。 设置对 `httpd.conf` 文件和 `plugin-cfg.xml` 文件的正确读/写许可权。有关更多信息，请参阅 IHS_root`/logs/admin_error.log` 文件。 要自动传播插件配置文件，将要求 IBM HTTP 管理服务器已启动并且正在运行。如果您正在使用 WebSphere Application Server 管理控制台管理 IBM HTTP Server，那么可能会显示以下错误：
    “未能连接至 IHS 管理服务器错误”
执行以下过程： 验证 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` 文件）以确定问题原因。

- # 运行配置脚本的跨平台注意事项 配置远程 Web 服务器时，在操作系统和机器平台方面可能存在多个差异： 一台机器正在运行 Windows，而另一台机器正在运行 Linux 或 UNIX。 一台机器正在运行不同于其他机器的缺省编码。 一台机器正在运行 Windows，而另一台机器正在运行 Linux 或 UNIX 如果一台机器正在运行 Linux 或 UNIX，而另一台机器正在运行 Windows，请使用在 `plugins_root/bin/crossPlatformScripts` 目录中创建的脚本。 一台机器正在运行不同于其他机器的缺省编码 如果两台机器的缺省文件编码不同，那么 `configureWeb_server_name.bat` 脚本或 `configure Web_server_name.sh` 脚本的内容可能已损坏。当为一台机器设置了双字节字符集 (DBCS) 语言环境，但没有为另一台机器设置该语言环境时，可能就会发生这种情况。 确定每台机器的文件编码并使用以下其中一个过程作为变通方法。要确定缺省文件编码，请允许相应的命令： Windows 系统：
      CHCP
- Linux 和 UNIX 系统：
      locale
在每台机器上将此命令的结果用作以下其中一个过程中的 web_server_machine_encoding 变量和 application_server_machine_encoding 变量的值。 用于更正编码差异的过程 假定 Web 服务器正在 Linux 机器上运行，而 Network Deployment 正在 Windows 机器上运行。 Web 服务器正在 Linux 机器上运行 在将用于配置 Web 服务器定义的脚本文件以二进制方式通过 FTP 传输到 Windows 机器上之前，在 Linux 或 UNIX 系统上运行以下命令以对该脚本文件进行编码：
    iconv -f web_server_machine_encoding \
          -t application_server_machine_encoding \
             configureWeb_server_name.bat
如果在一行中输入该命令，请省略 Linux 和 UNIX 连续字符 (\)。 要点：脚本文件名称中使用 Web 服务器的名称（昵称）。如果您打算将 IBM HTTP Server 设置为进行自动传播，那么该名称不能包含双字节字符集 (DBCS) 中的字符。 现在假设 Web 服务器正在 Windows 机器上运行，而 Network Deployment 正在 Linux 或 UNIX 机器上运行。 Web 服务器正在 Windows 机器上运行 在将用于配置 Web 服务器定义的脚本文件以二进制方式通过 FTP 传输之后，在 Linux 或 UNIX 系统上运行以下命令以对该脚本文件进行编码：
    iconv -f web_server_machine_encoding \
          -t application_server_machine_encoding \
             configureWeb_server_name.sh
如果在一行中输入该命令，请省略 Linux 和 UNIX 连续字符 (\)。 如果您所在系统上的 iconv 命令不支持转换映射，那么将 Web 服务器配置脚本的内容复制到一个剪贴板，然后将它粘贴到正在运行应用程序服务器的机器上。