這個主題說明如何實作 Web 伺服器外掛程式。
本產品會利用 Web 伺服器來遞送 Web 應用程式發出的動態內容要求,如 Servlet。將瀏覽器的資料流量導向執行於應用程式伺服器的應用程式時,需要 Web 伺服器。
Web 伺服器外掛程式會利用 XML 配置檔,來判斷要求是否針對應用程式伺服器而提出。
開始之前
- 請參閱選擇 WebSphere® Application Server 拓蹼前端系統的相關資訊。這個主題可協助您判斷是否應該設定 Web 伺服器外掛程式、Proxy 伺服器或安全 Proxy 伺服器,以提供 WebSphere Application Server 拓蹼的階段作業親緣性、失效接手支援和工作量平衡。
如果尚未安裝 Web 伺服器,請安裝它。
避免困難: IBM® i 提供的 Web 伺服器已安裝在 5761-DG1 產品 (
IBM i V6R1) 或 5770-DG1 (
IBM i V7R1) 之下。
IBM i Web 伺服器稱為 IBM HTTP Server for
IBM i。
這個 Web 伺服器有別於
WebSphere Application Server 所提供的 IBM HTTP Server,它無法在
IBM i 上執行。
gotcha
如果您想使用產品提供的 IBM HTTP Server,請參閱安裝 IBM HTTP Server 的相關資訊。否則,請參閱 Web 伺服器所提供的安裝資訊。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
確定已將適當的外掛程式檔安裝在 Web 伺服器中,且已執行 configureweb_server_name Script 來建立及配置這個 Web 伺服器的 Web 伺服器定義。
如果您使用分散式平台 Web 伺服器,請利用「Web 伺服器外掛程式配置工具」,將適當的外掛程式檔案安裝在您的 Web 伺服器中。
然後執行工具所建立的 configureweb_server_name Script,以便在 WebSphere 配置儲存庫中建立及配置 Web 伺服器定義。
如果您使用產品所提供的 IBM HTTP Server for z/OS®(採用 Apache 技術),請參閱在 z/OS 上安裝和配置 IBM HTTP Server for WebSphere Application Server 外掛程式的相關資訊。
如果您使用 z/OS 基本作業系統所提供的 IBM HTTP Server 5.3 版,請參閱安裝和配置 IBM HTTP Server for z/OS 5.3 版 Web 伺服器外掛程式的相關資訊。
如果您將分散式平台 Web 伺服器,與執行於 z/OS 作業系統上的產品版本搭配使用,請利用 FTP 連線,將外掛程式傳送到 Web 伺服器,然後利用「外掛程式安裝精靈」,將適當的外掛程式檔安裝在您的 Web 伺服器中。
如果您要進行一系列的同時變更(例如:安裝許多應用程式),您可以停用配置服務,直到完成最後一項變更為止。依預設,會啟用 Web 伺服器外掛程式配置服務。如果要停用這項服務,請在管理主控台中,按一下,然後清除選項。
避免困難: 如果您的安裝架構使用防火牆,請確定您將 Web 伺服器外掛程式配置成會使用已開啟的埠。
請洽詢安全管理者,以尋求如何取得開啟埠的相關資訊。
gotcha
關於這項作業
已安裝適當的外掛程式檔。此外,也建立一個 http 設定檔 (/QIBM/UserData/WebSphere/Plugins/V85/webserver/profiles/http)。
http 設定檔可用來協助建立 Web 伺服器定義。
請參閱有關選取 Web 伺服器拓蹼圖與導覽圖的主題,取得如何配置 IBM HTTP Server for IBM i,以便與應用程式伺服器通訊的相關指示。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
以下是外掛程式安裝程序所執行的步驟。
請參閱外掛程式安裝導覽圖,以取得其他資訊。
會建立節點。當 Web 伺服器位在不同於應用程式伺服器的電腦上時,會建立未受管理的節點。
未受管理的節點是指其中並未執行節點代理程式的節點。當使用未受管理的節點時,本產品可以代表並非其配置拓蹼中之應用程式伺服器的伺服器。這種表示法可讓您維護那些伺服器與應用程式伺服器之間的連線資訊。如需相關資訊,請參閱有關新增、管理和移除節點的主題。
- 建立 Web 伺服器定義。
您也可以利用管理主控台或 ConfigurewebServerDefintion.jacl Script 來建立 Web 伺服器定義。
- 應用程式或模組會對映至 Web 伺服器。如果要與這部 Web 伺服器搭配使用的應用程式已安裝,則該應用程式會自動對映至 Web 伺服器。如果未安裝應用程式,請在執行應用程式安裝程序的「將模組對映至伺服器」步驟期間,選取這個 Web 伺服器。
- 會更新和儲存主要儲存庫。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
當您配置外掛程式時,會自動建立這個外掛程式的配置檔。您可以變更或調整這個配置檔中的內容預設值。只要您變更任何設定,就必須重新產生這個檔案,變更才會生效。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
產生或重新產生配置檔可能需要一會兒才能完成。
完成之後,管理 Cell 中的所有物件都會使用 Web 伺服器能夠存取的最新設定。
如果應用程式伺服器是在 Web 伺服器的相同實體工作站中,通常需要 30 至 60 秒才能重新產生完成。
如果應用程式伺服器和 Web 伺服器在不同的工作站上,重新產生需要更長的時間。
下列程序說明更新外掛程式配置檔的步驟,其中包括 SSL 和 Web 伺服器的調整配置。
程序
- 請利用管理主控台,來變更外掛程式配置檔中的設定。
在設定 Web 伺服器外掛程式時,您必須決定是否要自動產生配置,來回應配置變更。當啟用 Web 伺服器外掛程式配置服務,且出現下列任何情況時,就會自動產生外掛程式配置檔:
- 建立或儲存 Web 伺服器時
- 安裝應用程式時
- 解除安裝應用程式時
- 更新虛擬主機定義時
避免困難: 在最初產生外掛程式配置檔時,虛擬主機的清單中並不含 admin_host。
有關容許 Web 伺服器存取管理主控台的資訊,會說明如何將它新增至清單。
gotcha
您可以使用管理主控台,或發出 GenPluginCfg 指令來重新產生您的 plugin-cfg.xml 檔。
請利用管理主控台,完成下列步驟來重新產生您的 plugin-cfg.xml 檔:
- 選取。
- 選取自動產生外掛程式配置檔,或按一下下列一或多個主題,手動配置 plugin-cfg.xml 檔:
避免困難: 請勿手動更新
plugin-cfg.xml 檔。
每當重新產生 Web 伺服器的
plugin-cfg.xml 檔時,都會置換這個 Web 伺服器的任何手動更新。
gotcha
- 按一下確定。
傳播外掛程式配置。 如果要從管理主控台傳播外掛程式配置,請按一下web_server_name。
另一個配置傳播外掛程式的方法是執行 GenPluginCfg 指令。如需相關資訊,請參閱 GenPluginCfg 指令說明文件。
如果 Web 伺服器位於產品相關聯獨立式版本的相同機器上,就不需要傳播外掛程式配置。如果傳播外掛程式配置失敗且原因不明,您必須用手動方式將 plugin-cfg.xml 檔複製到遠端 Web 伺服器的安裝位置。
避免困難: 如果您利用 FTP 功能來執行複製,但重新載入配置失敗,請檢查
plugin-cfg.xml 檔的檔案權限,確定 QTMHHTTP、QNOTES 和 QEJBSVR 使用者具備 RWX 權限。如果權限不正確,Web 伺服器就無法存取新版本的檔案,而導致重新載入配置失敗。如果要檢查權限,請執行下列 IBM i 指令:
wrklnk 'plug_in_folder_location/plugin-cfg.xml'
然後選取選項 9,檢視指派給使用者(QTMHHTTP、QNOTES 和 QEJBSVR)的權限。
gotcha
如果權限不正確,請發出下列 IBM i 指令,將檔案權限變更為適當的設定:
CHGAUT USER(QEJBSVR QTMHHTTP QNOTES) OBJ('plug_in_folder_location/plugin-cfg.xml') DTAAUT(*RWX)
plug_in_folder_location 是您傳送 plugin-cfg.xml 檔時所指定的位置。
- 您可能需要停止應用程式伺服器,再重新啟動應用程式伺服器,供 Web 伺服器尋找 plugin-cfg.xml 檔。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
調整 Web 伺服器。 如需相關資訊,請參閱有關調整 Web 伺服器的頁面。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
傳播外掛程式配置。 如果啟用 Web 伺服器外掛程式配置服務,且出現下列狀況之一,就會自動將外掛程式配置檔 plugin-cfg.xml 傳播至 Web 伺服器:
- Web 伺服器是本端 Web 伺服器,也就是說,Web 伺服器和應用程式伺服器位於相同的工作站。
- Web 伺服器是一個正在執行 IBM HTTP Server 管理伺服器的遠端 IBM HTTP Server 第 7 版。
如果兩個條件都不符合,您必須將 plugin-cfg.xml 檔手動複製到遠端 Web 伺服器的安裝位置。請將 <app_server_root>/profiles/<profilename>/config/cells/../../nodes/../servers/<webservername> 中的 plugin-cfg.xml 檔,複製到 Web 伺服器主機位置,亦即 <PluginInstallRoot>/config/<webservername>/。
重要: 如果您利用 FTP 功能來複製檔案,但配置重新載入失效,請檢查
plugin-cfg.xml 檔的檔案許可權,確定它們已設為
rw-r--r--。
如果檔案許可權不正確,Web 伺服器就無法存取新版本的檔案,而導致重新載入配置失敗。
如果檔案許可權不正確,請發出下列指令,將檔案許可權變更為適當的設定:
chmod 644 plugin-cfg.xml
AIX® FTP 功能不會保留檔案屬性。因此,如果您需要手動複製 AIX 作業系統中的 plugin-cfg.xml,可利用 AIX RCP 功能取代 FTP 功能,來複製檔案。
遠端 Web 伺服器的安裝位置是建立這部 Web 伺服器的節點時所指定的位置。
- 將金鑰儲存庫檔複製到 Web 伺服器的金鑰儲存庫目錄。
避免困難: 必須執行這個步驟,Web 伺服器才能正常運作。
gotcha
如需有關複製金鑰儲存庫檔的詳細指示,請閱讀有關配置 Web 伺服器外掛程式使用 Secure Sockets Layer 的主題。
結果
配置完成。如果要啟動配置,請停止再重新啟動 Web 伺服器。如果您在重新啟動 Web 伺服器時發生問題,請檢查
http_plugin.log 檔,以瞭解
plugin-cfg.xml 檔哪個部分含有錯誤的相關資訊。
日誌檔會指出發生錯誤的行號,且會提供其他詳細資料,可能有助於診斷 Web 伺服器未啟動的原因。
之後,您可以利用管理主控台來更新
plugin-cfg.xml 檔。
如果應用程式不會經常安裝或解除安裝(在正式作業環境中,就不會經常安裝或解除安裝),或您可以容忍每次發生上面列出的動作時,產生和配送外掛程式配置檔所造成的效能影響,請考慮啟用這項配置服務。