![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
Web 伺服器配置
外掛程式配置包括將 Web 伺服器配置成使用 WebSphere® Application Server 提供的二進位外掛程式模組。外掛程式配置還包括更新外掛程式 XML 配置檔,以反映現行應用程式伺服器配置。二進位模組使用 XML 檔來協助遞送 Web 用戶端要求。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
每一個檔案的說明如下。
Web 伺服器配置檔
Web 伺服器配置檔會隨 Web 伺服器一起安裝。
「Web 伺服器外掛程式配置工具」必須重新配置所支援 Web 伺服器的配置檔。
二進位 Web 伺服器外掛程式檔案
以 Windows 平台上的 IBM HTTP Server 為例,二進位外掛程式模組可以是 mod_was_ap22_http.dll 檔。
以 IBM i 為例,二進位外掛程式模組可以是 QSVTAP20 服務程式。
二進位外掛程式檔案不會變更。不過,二進位外掛程式的配置檔是 XML 檔。對 WebSphere Application Server 配置進行某些變更時,應用程式伺服器會變更配置檔。
二進位模組會讀取 XML 檔,以調整設定,以及將要求遞送至應用程式伺服器。
外掛程式配置檔 plugin-cfg.xml
外掛程式配置檔是一個 XML 檔,內含可讓您在管理主控台中調整的設定。檔案會列出安裝在 Web 伺服器定義上的所有應用程式。二進位模組會讀取 XML 檔,以調整設定,以及將要求遞送至應用程式伺服器。
獨立式應用程式伺服器會在
profile_root/config/cells/cell_name/nodes/web_server_name_node/servers/web_server_name 目錄中重新產生 plugin-cfg.xml 檔。只要應用程式伺服器配置中的變更會影響所部署的應用程式,就會執行重新產生。
只要應用程式伺服器配置中的變更,會影響部署在受管理節點上的應用程式,部署管理程式就會在 profile_root/config/cells/cell_name/nodes/node_name/servers/web_server_name 目錄中重新產生 plugin-cfg.xml 檔。
如果您對應用程式伺服器配置所做的變更,會影響所部署的應用程式,就會重新產生外掛程式配置 XML 檔。
在重新產生之後,會將檔案傳播(複製)到 Web 伺服器機器。之後二進位外掛程式有權存取其配置檔的最新副本。
當發生某些事件而變更了配置之後,Web 伺服器外掛程式配置服務會自動重新產生 plugin-cfg.xml 檔。當重新產生 plugin-cfg.xml 檔時,配置服務會自動將該檔案傳播至 IBM HTTP Server 機器。您必須手動將檔案複製到其他 Web 伺服器上。
在 IBM i 系統上,不會自動產生外掛程式。必須手動重新產生和傳播檔案。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
預設外掛程式配置檔 plugin-cfg.xml
「Web 伺服器外掛程式配置工具」會在 plugins_root/config/web_server_name 目錄中,建立暫時 plugin-cfg.xml 檔。此工具會針對每一個遠端安裝實務建立這個檔案。
預設檔案是一個位置保留元,您必須以應用程式伺服器上之 Web 伺服器定義中的 plugin-cfg.xml 檔來取代它。預設檔案是一個抄本,抄寫自應用程式伺服器針對預設獨立式應用程式伺服器所建立的檔案。
在執行 configureweb_server_name Script 時,若為遠端安裝,請從應用程式伺服器機器的 app_server_root/bin 目錄執行,若為本端安裝,則直接從 plugins_root/bin 目錄執行。Script 會在預設設定檔的配置檔中建立 Web 伺服器定義。如果要配置非預設的設定檔,請編輯 configureweb_server_name Script。請使用 -profileName 參數,來識別預設設定檔以外的設定檔。
建立 Web 伺服器定義之後,應用程式伺服器中的 Web 伺服器外掛程式配置服務會在應用程式伺服器機器上的 Web 伺服器定義中,建立第一個 plugin-cfg.xml 檔。如果您安裝應用程式、建立虛擬主機,或執行任何會變更配置的動作,您必須將已更新的 plugin-cfg.xml 檔從應用程式伺服器機器傳播至 Web 伺服器機器,以取代預設檔案。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Web 伺服器定義的 configureweb_server_name Script
「Web 伺服器外掛程式配置工具」會在 Web 伺服器機器上的 plugins_root/bin 目錄中,建立 configureweb_server_name Script。在遠端實務中,如果某部機器在 AIX® 或 Linux 等作業系統之下執行,另一部機器在 Windows 之下執行,請使用建立在 plugins_root/bin/crossPlatformScripts 目錄中的 Script。只有在遠端安裝實務中,才會建立 Script。
請將 Script 從 Web 伺服器機器複製到遠端應用程式伺服器機器上的 app_server_root/bin 目錄。若為本端安裝架構,則不必複製 Script。執行 Script,以便將 Web 伺服器定義建立在應用程式伺服器的配置中。
這個問題就是 Shell 環境變數 WAS_USER_SCRIPT 和實際預設設定檔之間發生潛在衝突。Script 的處理對象一律是預設設定檔。不過,一旦設定 WAS_USER_SCRIPT 環境變數,就會發生衝突,這是因為 Script 會嘗試處理此變數所識別的設定檔。
一不小心就會設定這個變數。請從任何設定檔的 profile_root/bin 目錄來發出任何指令,並將此變數設為該設定檔。
如果您的系統上有多個設定檔,預設設定檔與此變數所識別的設定檔,有可能是不同的設定檔。若是如此,便會發生衝突,且 Script 不見得將 Web 伺服器定義建立在正確的設定檔中,或者可能根本不會建立 Web 伺服器定義。
如果獨立式應用程式伺服器已存在 Web 伺服器定義,執行 Script 並不會新增 Web 伺服器定義。每一部獨立式應用程式伺服器只能有一項 Web 伺服器定義。
相對地,受管理節點可以有多項 Web 伺服器定義。除非 Web 伺服器名稱相同,Script 會建立新的 Web 伺服器定義。
![[IBM i]](../images/iseries.gif)
Web 伺服器定義的配置 Script
如果透過 configureOs400WebserverDefinition Script 或使用「IBM i 管理 GUI」,來配置 Web 伺服器,將會在 Web 伺服器機器的 plugins_root/bin 目錄中建立 configureweb_server_name Script。只有在遠端安裝實務中,才會建立 Script。
將 Script 從 Web 伺服器機器複製到 IBM i 分割區中的 app_server_root/bin 目錄。執行 Script,以便將 Web 伺服器定義建立在應用程式伺服器的配置中。
如果獨立式應用程式伺服器已存在 Web 伺服器定義,執行 Script 並不會新增 Web 伺服器定義。每一部獨立式應用程式伺服器只能有一項 Web 伺服器定義。
或者,您可以使用 configureOs400WebServerDefinition 和 removeOs400WebServerDefinition Script,來執行這些作業。
相對地,受管理節點可以有多項 Web 伺服器定義。除非 Web 伺服器名稱相同,Script 會建立新的 Web 伺服器定義。
以 Web 伺服器定義中的檔案,取代預設外掛程式配置檔(傳播)
預設檔案會使用固定的參數值,這可能與應用程式伺服器上之實際檔案中的參數值不符。預設檔案只是一個位置保留元。
檔案無法反映應用程式伺服器配置中所做的變更。檔案也無法反映可能已在應用程式伺服器中生效的非預設值。
應用程式伺服器的實際
plugin-cfg.xml 檔中必須有下列值。若是如此,預設檔案就能順利配置二進位外掛程式模組。之後外掛程式模組就能順利與 Web 伺服器和應用程式伺服器通訊。
假設應用程式伺服器的實際 plugin-cfg.xml 檔中沒有下列值。在此情況下,預設檔案將不當配置二進位外掛程式模組。外掛程式模組一律能與 Web 伺服器通訊。但是如果配置檔不適當,外掛程式模組就無法順利與應用程式伺服器通訊。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)