[z/OS]

安裝和配置 5.3 版 HTTP Server for z/OS 的外掛程式

適用於 z/OS® 的 HTTP Server 外掛程式是 WebSphere® Application Server for z/OS 的 Web 伺服器外掛程式元件的一部分。 如果要使用這個外掛程式,您必須已將 5.3 版 HTTP Server for z/OS 配置成 z/OS 系統的一部分。

關於這項作業

註: 在 WebSphere Application Server for z/OS 第 7 版和更舊版本中,IBM® HTTP Server (IHS/390) 的 Web 伺服器外掛程式位於 WebSphere Application Server for z/OS 基礎產品的 bin 目錄中。在 8.0 版及更新版本中,這個外掛程式位於 Web 伺服器外掛程式產品檔案系統的 bin 目錄中,且外掛程式已從 ihs390WAS70Plugin_http.so 更名為 ihs390WASPlugin_http.so

5.3 版 HTTP Server for z/OS 隨附於 z/OS 基礎作業系統中。HTTP Server for z/OS 是 Apache 型伺服器。HTTP Server for z/OS 支援 64 位元架構,也支援 IPv6。

此程序概述如何安裝及配置 HTTP Server for z/OS 的外掛程式。

程序

  1. 請確定 5.3 版 HTTP Server for z/OS 已安裝在 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 伺服器外掛程式產品檔案系統沒有存取權,請執行下列步驟,以二進位格式,從執行應用程式伺服器的 LPAR,將 HTTP Server for z/OS 外掛程式和 plugin-cfg.xml 檔,下載到安裝 HTTP Server 的 LPAR 中。 下載外掛程式時的目標目錄必須可供用來執行 HTTP Server 的 MVS™ ID 讀取。
    1. 使用 FTP 或其他檔案傳送機制,以二進位格式將 HTTP Server for z/OS 外掛程式從您的安裝目錄,下載到 HTTP Server 系統,以及下載到可供用來執行 HTTP Server 之 MVS ID 讀取的目錄。 ihs390WASPlugin_http.so DLL 位於 Web 伺服器外掛程式的 /bin/ 目錄中,例如:
      /usr/lpp/WebSphere/Plugins/V9R0/bin 
    2. 設定對外掛程式 ihs390WASPlugin_http.so 檔的許可權 (755 +p)。 使用獲授權的 z/OS 使用者 ID,從 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,建立 httpd.conf 和 httpd.enwars 這兩個檔案,以用來自訂和配置 Web 伺服器。/etc 目錄中,建立 httpd.confhttpd.enwars 檔。setup.sh 檔位於 usr/lpp/internet/sbin 目錄。
  5. 將 ServerInit、ServerTerm 和 Service 指引新增至 HTTP Server 的 httpd.conf 配置檔:
    • 新增下列 ServerInit 和 ServerTerm 指引,以指出外掛程式起始設定和結束常式的進入點。這些常式分別以 init_exit 和 term_exit 進入點形式存在於 ihs390WASPlugin_http.so DLL 檔中。
      避免困難 避免困難:
      • 這項討論會分割 ServerInit 和 Service 指引,以方便列印。在實際的 httpd.conf 檔中,請以單行輸入這每一項指引。
      • 在 ServerInit 指引中,http_plugin_conf 代表 plugin-cfg.xml 檔位置的完整路徑。
      • 在 ServerInit、Service 和 ServerTerm 指引中,http_plugin_dir 代表:
        1. 如果 HTTP Server 位於與 WebSphere Application Server 相同的 LPAR 中,則是 WebSphere Application Server Web 伺服器外掛程式目錄的完整路徑,例如 /usr/lpp/WebSphere/Plugins/V9R0,或者
        2. 如果 HTTP Server 所在的系統無權存取 Web 伺服器外掛程式產品檔案系統,則是您在先前步驟中指定成 FTP 作業目的地的完整路徑。
      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 指引。這項指引指出外掛程式要求常式的進入點。要求常式會以 service_exit 進入點形式存在於 ihs390WASPlugin_http.so 動態鏈結程式庫 (DLL) 檔內。
      Service /webapp_contextroot/*  /http_plugin_dir/
           ihs390WASPlugin_http.so:service_exit

      webapp_contextroot 是應用程式的環境定義根目錄

    轉移: z/OS HTTP Server 5.3 版的 Web 伺服器外掛程式使用的 SSL 介面,有別於產品舊版中使用的 SSL 介面。z/OS PTF UK35083 含有 z/OS HTTP Server 5.3 版的 SSL 介面變更,該變更對應至這項 Web 伺服器外掛程式變更。因此,這個 PTF 必須套用至您的系統,新的 Web 伺服器外掛程式 SSL 介面才能正常運作。

    您也必須在 z/OS HTTP Server 5.3 版的 httpd.conf 檔中,包含 SSLMode multi 選項。如果沒有在 httpd.conf 檔中指定 SSLMode multi 選項,或者您沒有將 z/OS PTF UK35083 套用至您的系統,可能會收到錯誤訊息 IMW0584W,指出指定給 HTTP Server 的 SSL 模式,不相容於與 z/OS HTTP Server 5.3 版搭配使用之 Web 伺服器外掛程式的 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 檔:
      • 快取
      • 要求和回應
      • 要求遞送
      • 服務
    3. 按一下確定
    4. 您可能需要停止再重新啟動應用程式伺服器,讓 Web 伺服器可以找到 plugin-cfg.xml 檔。
  9. 確定您是以 z/OS 5.3 版 HTTP Server 所用埠號的別名來配置虛擬主機。如果您已手動配置 plugin-cfg.xml 檔,請在管理主控台中,按一下伺服器 > 伺服器類型 > Web 伺服器 > web_server_name > 外掛程式內容 > 要求遞送,並驗證對於虛擬主機比對內容,選取的是實際使用要求中指定的埠
  10. 停止應用程式伺服器和 HTTP Server,然後再次啟動它們。

    配置完成。如果要啟動配置,請停止再重新啟動應用程式伺服器和 HTTP Server 兩者。

結果

如果 HTTP Server for z/OS 外掛程式在 HTTP Server 重新啟動時能順利啟動,您會收到下列訊息:
WebSphere HTTP for z/OS 6.00 版服務等級 l 0 外掛程式啟動中 WebSphere HTTP for z/OS 外掛程式正在使用配置檔來起始設定:
         fully_qualified_path_to_the_plugin-cfg.xml_file 
WebSphere HTTP for z/OS 外掛程式已順利起始設定

下一步

在適當配置應用程式伺服器、HTTP Server 和外掛程式之後:
  • 產品可以使用這個外掛程式來執行一般的外掛程式功能。
  • 要求可以從瀏覽器經由 HTTP Server 和外掛程式,遞送至已部署所要求之應用程式的應用程式伺服器。(新要求會傳送至隨機選取並已部署這個應用程式的應用程式伺服器。等建立階段作業之後,會將要求遞送回指派給原始要求的應用程式伺服器。)
  • 私密標頭可作為一種轉遞機制,藉以將 Proxy 資訊從 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