[z/OS]

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

HTTP Server for z/OS® 插件包含在 WebSphere® Application Server for z/OS 的 Web 服务器插件组件中。要使用此插件,必须将 HTTP Server for z/OS V5.3 配置为 z/OS 系统的一部分。

关于此任务

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

HTTP Server for z/OS V5.3 随 z/OS 基本操作系统提供。HTTP Server for z/OS 不是基于 Apache 的服务器。HTTP Server for z/OS 既支持 64 位体系结构,又支持 IPv6。

此过程说明了如何安装并配置 HTTP Server for z/OS 的插件。

过程

  1. 确保 HTTP Server for z/OS V5.3 已安装在 z/OS 系统上。
  2. 安装 Web 服务器插件。 使用 IBM Installation Manager 安装 WebSphere Application Server for z/OS 的 Web 服务器插件,并在目标 z/OS 系统上安装产品文件系统。缺省情况下,插件位于 /usr/lpp/WebSphere/Plugins/V9R0 目录。
  3. 如果 HTTP Server 无权访问 Web 服务器插件产品文件系统,请执行下列步骤以二进制格式将 HTTP Server for z/OS 插件和 plugin-cfg.xml 文件从正在运行应用程序服务器的 LPAR 下载到安装 HTTP Server 的 LPAR。 下载插件的目录必须对于执行 HTTP Server 的 MVS™ 标识是可读的。
    1. 使用 FTP 或另一个文件传输机制以二进制格式从安装目录将 HTTP Server for z/OS 插件下载到 HTTP Server 的系统,然后将它放入执行 HTTP Server 的 MVS 标识可以读取的目录。 ihs390WASPlugin_http.so DLL 位于 Web 服务器插件的 /bin/ 目录中;例如:
      /usr/lpp/WebSphere/Plugins/V9R0/bin 
    2. 对插件的 ihs390WASPlugin_http.so 文件设置许可权 (755 +p)。 使用已授权的 z/OS 用户标识,从 OMVS 命令行提示发出以下命令,以便在 HTTP Server for z/OS 插件所在的 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
  4. 运行 setup.sh 以创建用于定制和配置 Web 服务器的两个文件 httpd.conf 和 httpd.enwars。/etc 目录中创建 httpd.confhttpd.enwars 文件。setup.sh 文件在 usr/lpp/internet/sbin 目录中。
  5. 将 ServerInit、ServerTerm 和 Service 伪指令添加到 HTTP Server 的 httpd.conf 配置文件:
    • 添加下列 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 表示:
        1. WebSphere Application Server Web 服务器插件目录的完整路径,例如,/usr/lpp/WebSphere/Plugins/V9R0(如果 HTTP Server 与 WebSphere Application Server 在同一 LPAR 上),或者
        2. 在先前步骤中指定为 FTP 操作的目标的完整路径(如果 HTTP Server 不在有权访问 Web 服务器插件产品文件系统的系统上)。
      gotcha
      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 是应用程序的上下文根

    transition: z/OS HTTP Server V5.3 的 Web 服务器插件使用的 SSL 接口不同于在产品的先前版本中使用的 SSL 接口。z/OS PTF UK35083 包含对 z/OS HTTP Server V5.3 的 SSL 接口更改,此更改对应于此 Web 服务器插件更改。因此,必须先对系统应用此 PTF,然后新的 Web 服务器插件 SSL 接口才能正常工作。

    对于 z/OS HTTP Server V5.3,您还必须在 httpd.conf 文件中包含 SSLMode multi 选项。如果未在 httpd.conf 文件中指定 SSLMode multi 选项,或者未对系统应用 z/OS PTF UK35083,那么可能会接收到错误消息 IMW0584W,指示为 HTTP Server 指定的 SSL 方式与 Web 服务器插件(与 z/OS HTTP Server V5.3 配合使用)的 SSL 方式不兼容。在任何一种这样的情况下,都可能会发生不可预测的结果。

    避免故障 避免故障:
    1. HTTP Server 将伪指令规范中的空格解释为定界符,将数字符号 (#) 解释为应忽略的注释的开始。因此,如果您需要在伪指令中使用空格或数字符号,那么必须在空格或数字符号前包括一个反斜杠 (\) 以使 HTTP Server 能够正确地处理该伪指令。
    2. 如果 servlet 用任何方法设置 HTTP 响应代码(例如使用方法 lastModified() 或 setStatus()),且客户机未接收到期望的响应代码,那么将以下伪指令添加到 HTTP Server 配置文件:
      ServiceSync On
    gotcha
  6. 如果 httpd.conf 文件包含设置为 /* 的 Pass 伪指令,请确保 Service 伪指令在 Pass 伪指令之前。
  7. 使用概要文件管理工具或 zpmt 命令为本地或远程 z/OS Web 服务器创建 Web 服务器定义。
  8. 配置插件。 使用管理控制台或发出 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 文件:
      • 高速缓存
      • 请求和响应
      • 请求路由
      • Service
    3. 单击确定
    4. 您可能需要停止并重新启动应用程序服务器,Web 服务器才能找到 plugin-cfg.xml 文件。
  9. 确保使用 z/OS HTTP Server V5.3 所用的端口号的别名来配置虚拟主机。如果您手动配置 plugin-cfg.xml 文件,请在管理控制台中单击服务器 > 服务器类型 > Web 服务器 > web_server_name > 插件属性 > 请求路由,并验证是否对虚拟主机匹配属性选中了以物理方式使用请求中指定的端口
  10. 停止然后再次启动应用程序服务器和 HTTP Server。

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

结果

如果在 HTTP Server 重新启动时 HTTP Server for z/OS 插件成功启动,那么您将接收到以下消息:
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 请求包括在一起。)

指示主题类型的图标 任务主题



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