安装并配置 HTTP Server for z/OS V5.3 插件

z/OS® 的 HTTP Server 插件是 WebSphere® Application Server for z/OS的 Web 服务器插件组件的一部分。要使用此插件，必须将 V 5.3 HTTP Server for z/OS 配置为 z/OS 系统的一部分。

有关此任务

注: 在 WebSphere Application Server for z/OS V 7 和更低版本中， IBM® HTTP Server (IHS/390) 的 Web 服务器插件位于 WebSphere Application Server for z/OS 基本产品的 bin 目录中。在 V8.0 及更高版本中，此插件位于 Web 服务器插件产品文件系统的 bin 目录中，并且它已从 ihs390WAS70Plugin_http.so 重命名为 ihs390WASPlugin_http.so。

z/OS 基本操作系统随附 V 5.3 HTTP Server for z/OS 。 HTTP Server for z/OS 不是基于 Apache的服务器。 HTTP Server for z/OS 不支持 64 位体系结构，不支持 IPv6。

此过程概述了如何安装和配置 HTTP Server for z/OS的插件。

过程

确保在 z/OS 系统上安装了 V 5.3 HTTP Server for z/OS 。
安装 Web 服务器插件。
使用 IBM Installation Manager 来安装 WebSphere Application Server for z/OS的 Web 服务器插件，并在目标 z/OS 系统上安装产品文件系统。缺省情况下，这些插件位于 /usr/lpp/WebSphere/Plugins/V9R0 目录中。
如果 HTTP Server 无权访问 Web 服务器插件产品文件系统，请执行以下步骤以二进制格式将 HTTP Server for z/OS 插件和 plugin-cfg.xml 文件从运行应用程序服务器的 LPAR 下载到安装了 HTTP Server 的 LPAR。
下载插件的目录必须能被执行HTTP Server的 MVS ID 读取。
1. 使用 FTP 或其他文件传输机制，以二进制格式将 z/OS 的 HTTP Server 插件从安装目录下载到 HTTP Server的系统，并下载到可供 HTTP Server 正在执行。
  ihs390WASPlugin_http.so DLL 位于 Web 服务器插件的 /bin/ 目录中；例如：
```
/usr/lpp/WebSphere/Plugins/V9R0/bin 
```
2. 对插件的 ihs390WASPlugin_http.so 文件设置许可权 (755 +p)。
  使用授权的 z/OS 用户标识，从 OMVS 命令行提示符发出以下命令，以在 z/OS 的 HTTP Server 插件现在所在的 HFS 中打开 "p" 位:
```
chmod 755 ihs390WASPlugin_http.so
extattr +p ihs390WASPlugin_http.so
```
  检查结果extattr命令，发出以下命令:
```
ls -E  ihs390WASPlugin_http.so
```
  然后在扩展属性中查找“ps”。例如：
```
-rwxr-xr-x  -ps-  1 USER123  WASUSER  1482752 Aug  2 14:17 ihs390WASPlugin_http.so
```
运行setup.sh以创建两个文件 httpd.conf 和 httpd.enwars，用于定制和配置 Web 服务器。
创建httpd.conf和httpd.enwars/etc 目录中的文件。该setup.sh文件位于 usr/lpp/internet/sbin 目录中。
添加 "ServerInit,"ServerTerm,和服务指令到httpd.confHTTP Server的配置文件:
- 添加下列 ServerInit 和 ServerTerm 伪指令以指示插件的初始化和出口例程的入口点。这些例程在 ihs390WASPlugin_http.so DLL 文件中分别作为入口点 init_exit 和 term_exit 存在。
  避免麻烦:
  - 在本讨论中，为了便于打印将 ServerInit 和 Service 伪指令分开。在实际的 httpd.conf 文件中，在一行上输入每条伪指令。
  - 在 ServerInit 伪指令中，http_plugin_conf 表示 plugin-cfg.xml 文件的位置的完整路径。
  - 在 ServerInit、Service 和 ServerTerm 伪指令中，http_plugin_dir 表示：
    
    WebSphere Application Server Web 服务器插件目录的完整路径，例如 /usr/lpp/WebSphere/Plugins/V9R0(如果 HTTP Server 与 WebSphere Application Server位于同一 LPAR 上) ，或者
    
    在先前步骤中指定为 FTP 操作的目标的完整路径（如果 HTTP Server 不在有权访问 Web 服务器插件产品文件系统的系统上）。
```
ServerInit /http_plugin_dir/bin/
    ihs390WASPlugin_http.so:init_exit /http_plugin_conf/
    plugin-cfg.xml
ServerTerm /http_plugin_dir/bin/ihs390WASPlugin_http.so:term_exit
```
- 对每个将使用 Web 服务器插件的应用程序添加以下 Service 伪指令。此伪指令表明到插件的请求例程的入口点。请求例程在 ihs390WASPlugin_http.so 动态链接库 (DLL) 文件中作为入口点 service_exit 存在。
```
Service /webapp_contextroot/*  /http_plugin_dir/
     ihs390WASPlugin_http.so:service_exit
```
  webapp_contextroot 是应用程序的上下文根
对于转换用户: z/OS HTTP ServerV 5.3的 Web 服务器插件使用的 SSL 接口与先前产品版本中使用的 SSL 接口不同。 z/OS PTF UK35083 包含与此 Web 服务器插件更改相对应的 z/OS HTTP ServerV 5.3的 SSL 接口更改。因此，必须先对系统应用此 PTF，然后新的 Web 服务器插件 SSL 接口才能正常工作。
您还必须在 z/OS HTTP ServerV 5.3的 httpd.conf 文件中包含 SSLMode multi 选项。如果未在 httpd.conf 文件中指定 SSLMode multi 选项，或者如果未将 z/OS PTF UK35083 应用于系统，那么可能会收到错误消息 IMW0584W，指示为 HTTP Server 指定的 SSL 方式与用于 z/OS HTTP ServerV 5.3的 Web 服务器插件的 SSL 方式不兼容。在任一情况下，可能会产生不可预测的结果。
避免麻烦:
1. HTTP Server 将伪指令规范中的空格解释为定界符，将数字符号 (#) 解释为应忽略的注释的开始。因此，如果您需要在伪指令中使用空格或数字符号，那么必须在空格或数字符号前包括一个反斜杠 (\) 以使 HTTP Server 能够正确地处理该伪指令。
2. 如果 servlet 用任何方法设置 HTTP 响应代码（例如使用方法 lastModified() 或 setStatus()），且客户机未接收到期望的响应代码，那么将以下伪指令添加到 HTTP Server 配置文件：
```
ServiceSync On
```
如果 httpd.conf 文件包含设置为 /*的 Pass 伪指令，请确保 Service 伪指令在 Pass 伪指令之前。
使用 Profile Management Tool 或 zpmt 命令为本地或远程 z/OS Web 服务器创建 Web 服务器定义。
配置插件。
使用管理控制台或发出 GenPluginCfg 命令以创建 plugin-cfg.xml 文件。
注: 这两种方法都以 ASCII 格式创建插件配置文件 plugin-cfg.xml。（以前该配置文件是以 EBCDIC 格式生成的）。
1. 如果您需要编辑此文件，请发出以下命令以便将该文件转换为 EBCDIC 格式：
```
> iconv  -f ISO8859-1 -t IBM-1047 plugin-cfg.xml.ASCII > plugin-cfg.xml.EBCDIC
```
2. 编辑该文件，然后发出以下命令以便将其转换回 ASCII 格式：
```
> iconv  -f IBM-1047 -t ISO8859-1  plugin-cfg.xml.EBCDIC > plugin-cfg.xml.ASCII
```
要使用管理控制台：
1. 选择服务器> 服务器类型> Web 服务器> web_server_name > 插件属性。
2. 选择自动生成插件配置文件或单击以下一个或多个主题以手动配置 plugin-cfg.xml 文件:
  - 缓存
  - 请求和响应
  - 请求路由
  - 服务
3. 单击“确定”。
4. 您可能需要停止应用程序服务器，然后再次启动应用程序服务器，以使 Web 服务器能够找到 plugin-cfg.xml 文件。
确保为虚拟主机配置了 z/OS V5.3 HTTP Server所使用的端口号的别名。如果手动配置了 plugin-cfg.xml 文件，请在管理控制台中单击服务器> 服务器类型> Web 服务器> web_server_name > 插件属性 > 请求路由，并验证是否为 虚拟主机匹配 属性选择了 以物理方式使用请求中指定的端口 。
停止然后再次启动应用程序服务器和 HTTP Server。

配置完成。要激活配置，停止然后重新启动应用程序服务器和 HTTP Server。

结果

如果 HTTP Server for z/OS 插件在 HTTP Server 再次启动时成功启动，那么您将收到以下消息:

WebSphere HTTP plug-in for z/OS Version 6.00 Service Level 0 is starting
 WebSphere HTTP plug-in for z/OS initializing with configuration file :
         fully_qualified_path_to_the_plugin-cfg.xml_file 
WebSphere HTTP plug-in for z/OS initialization went OK :-)

下一步做什么？

应用程序服务器后，正确配置 HTTP Server 和插件：

产品可使用此插件执行常规的插件功能。
通过 HTTP Server 和插件，请求可从浏览器路由至部署所请求的应用程序的应用程序服务器。（新请求发送到随机选择的部署此应用程序的应用程序服务器。在建立会话后，请求路由回到指定给原始请求的应用程序服务器。）
专用头可用作将代理信息从 Web 服务器插件转发到 z/OS 系统上的应用程序服务器的机制。（否则，此信息不会与 HTTP 请求包括在一起。）