外掛程式配置

「Web 伺服器外掛程式配置工具」會配置 Web 伺服器類型的應用程式伺服器，並將 Web 伺服器定義建立在應用程式伺服器的配置中。您將熟悉「Web 伺服器外掛程式配置工具」所能使用的各種處理方法。

本文說明「Web 伺服器外掛程式配置工具」在配置 Web 伺服器和建立 plugin-cfg.xml 檔（這是外掛程式配置檔）時，可以採行的兩種方式。

支援的配置: 此工具僅在 AIX®、 Linux®及 Windows 上受支援。除了使用「Web 伺服器外掛程式配置工具」，您也可以改用 pct 指令行工具與回應檔，來配置 Web 伺服器。如需相關資訊，請閱讀「使用 pct 工具來配置 Web 伺服器外掛程式」。

開始之前: 在外掛程式配置期間，會更新外掛程式和 Web 伺服器配置檔。如果您以非 root 使用者身分，來使用「Web 伺服器外掛程式配置工具」或 pct 指令行工具，在開始配置之前，請先驗證您具備適當的專用權，來更新「Web 伺服器外掛程式」的配置檔以及您 Web 伺服器（例如 IHS）的配置檔，尤其是如果您不是這些檔案的擁有者，更需要這麼做。

注意: 當使用「Web 伺服器外掛程式配置工具」來配置「 IBM® HTTP Server 管理伺服器」時， WebSphere Customization Toolbox 必須以具有管理者/root 專用權的「本端」帳戶來執行。

此外，預設 httpd.conf 配置檔必須保留在 <IHS_HOME>/conf 目錄內，且您必須在管理配置之後手動執行 setupadm 。

支援的配置: 「Web 伺服器外掛程式配置工具」預期與完整 WebSphere® Application Server 設定檔搭配使用; 在產生 Liberty 設定檔的 Web 伺服器外掛程式時，不需要或支援使用它。如需為 Liberty 設定檔產生 Web 伺服器外掛程式的相關資訊，請閱讀使用 Web 伺服器外掛程式來配置 Liberty 設定檔。

配置流程

「Web 伺服器外掛程式配置工具」會將 Web 伺服器和 WebSphere Application Server 的所有配置解析成兩種實務: 遠端外掛程式配置和本端外掛程式配置。下圖顯示在判斷哪一項實務適用於該配置時，所實作的邏輯。

圖註：

安裝類型？: 安裝類型可以是遠端或本端。
如果 Web 伺服器和應用程式伺服器不是位於相同電腦上，請選擇遠端實務。如果 Web 伺服器和應用程式伺服器都位於相同電腦上，請選擇本端實務。
設定檔？: 如果已安裝產品，但是設定檔不慎刪除或者遺失，則會將實務視為遠端安裝架構。請在執行 Script 之前先建立設定檔。
含有 Web 伺服器定義的獨立式應用程式伺服器？: 如果設定檔具有現有 Web 伺服器定義，則會將安裝架構視為遠端外掛程式配置。獨立式應用程式伺服器中不能有多項 Web 伺服器定義。

實務 A. 本端獨立式外掛程式配置

在這項實務中，「Web 伺服器外掛程式配置工具」會將 Web 伺服器定義直接建立在應用程式伺服器設定檔內，而不使用 Script。

「Web 伺服器外掛程式配置工具」會將 Web 伺服器配置成使用應用程式伺服器設定檔內的 plugin-cfg.xml 檔。應用程式伺服器會重新產生 profile_root/config/cells/ cell_name/nodes/ web_server_name_node/servers/ web_server_name 目錄中的 plugin-cfg.xml 檔案。只要應用程式伺服器配置中的變更會影響所部署的應用程式，就會執行重新產生。

針對本端 Web 伺服器配置應用程式伺服器之後，可立即啟動應用程式伺服器和 Web 伺服器。

表 1. 符合本端應用程式伺服器實務的配置。
設定檔類型	自動建立 Web 伺服器定義？	Web 伺服器已定義在應用程式伺服器配置中？
應用程式伺服器	是	否

如果應用程式伺服器設定檔具有現有 Web 伺服器定義，則應當成遠端外掛程式配置來處理。應用程式伺服器只能有一項 Web 伺服器定義。

如需此節點類型的說明，請參閱實務範例 B。

下列概觀顯示 Web 伺服器配置的驗證程序：

請使用適合您 Web 伺服器的程序來啟動 Web 伺服器。
例如，從指令行啟動 IBM HTTP Server :
- ./IHS_root/bin/apachectl start
- IHS_root\bin\apache
啟動應用程式伺服器。
切換至 profile_root/bin 目錄，然後執行 startServer 指令：
- ./profile_root/bin/startServer.sh server1
- profile_root\bin\startServer server1
開啟管理主控台，然後儲存已變更的定義。
將瀏覽器指向 http://localhost:9080/snoop，測試應用程式伺服器提供的內部 HTTP 傳輸。將瀏覽器指向 http://Host_name_of_Web_server_machine/snoop，以測試 Web 伺服器外掛程式。
驗證這兩個網址都會顯示「Snoop Servlet - 要求/用戶端資訊」頁面。

「Web 伺服器外掛程式配置工具」不會自動將 Web 伺服器定義建立在遠端機器上的分散式設定檔內。此工具反而會建立 configureweb_server_name Script。

「Web 伺服器外掛程式配置工具」會將 Web 伺服器配置成使用 Web 伺服器機器上 plugins_root/config/web_server_name 目錄中所維護的 plugin-cfg.xml 檔。這個檔案需要定期傳播。傳播是指複製應用程式伺服器機器中的現行 plugin-cfg.xml 檔，以取代 plugins_root/config/web_server_name/plugin-cfg.xml 檔。

安裝本端 Web 伺服器的二進位外掛程式之後，不必執行 Script，就能啟動應用程式伺服器和 Web 伺服器。不過，必須等執行 Script 之後，才能充分利用應用程式伺服器節點中的 Web 伺服器定義。

表 2. 符合遠端應用程式伺服器實務範例的配置。
設定檔類型	建立 Web 伺服器定義？	Web 伺服器已定義在應用程式伺服器配置中？
如果您在「Web 伺服器外掛程式配置工具」中選取遠端安裝類型，則是任一處中的任何設定檔	用 Script	不適用
無設定檔	用 Script	不適用
含有現有 Web 伺服器定義的獨立式應用程式伺服器設定檔	用 Script	是

下列概觀顯示暫時 plugins_root/config/web_server_name/plugin-cfg.xml 檔的驗證程序。

Web 伺服器會使用暫時 plugin-cfg.xml 檔，來與遠端應用程式伺服器通訊。

如果指派給應用程式伺服器的 HTTP 傳輸埠不是 9080，則測試會失敗。請繼續下一節，以便在應用程式伺服器上建立 Web 伺服器定義，並完成您的配置測試。

請使用適合您 Web 伺服器的程序來啟動 Web 伺服器。
例如，從指令行啟動 IBM HTTP Server :
- ./IHS_root/bin/apachectl start
- IHS_root\bin\apache
啟動遠端機器上的應用程式伺服器。
切換至 profile_root/bin 目錄，然後執行 startServer 指令：
- ./profile_root/bin/startServer.sh server1
- profile_root\bin\startServer server1
將瀏覽器指向 http://localhost:9080/snoop，測試應用程式伺服器提供的內部 HTTP 傳輸。將瀏覽器指向 http://Host_name_of_Web_server_machine/snoop，以測試 Web 伺服器外掛程式。
驗證這兩個網址都會顯示「Snoop Servlet - 要求/用戶端資訊」頁面。

下列概觀顯示用來完成配置的程序。 Web 伺服器定義必須存在於應用程式伺服器節點的配置中，才能完成配置。在重新產生有效的外掛程式配置檔 plugin-cfg.xml 時，Web 伺服器定義是一個核心元素。

在應用程式伺服器中建立 Web 伺服器定義。
執行 Script，以便手動將 Web 伺服器定義建立在應用程式伺服器節點的配置內：
1. 將 Script 從 plugins_root/bin 目錄複製到遠端 app_server_root/bin 目錄。
2. 開啟指令視窗，並執行 Script：
  - ./configureweb_server_name.sh
  - configureweb_server_name.bat
configureweb_server_name Script 可以使用下列三個參數：profile_name、Admin_Console_Username 和 Admin_Console_Password。
- profile_name 指出用來建立 Web 伺服器定義的設定檔名稱。
- Admin_Console_Username 指出管理主控台的使用者名稱。已部署管理主控台的設定檔必須啟用管理主控台安全。如果 profile_name 空白，不能使用這個參數。
- Admin_Console_Password 指出使用者名稱的對應密碼。如果 profile_name 和 Admin_Console_Username 都空白，不能使用這個參數。
附註: Script 中的 webserverNode名稱 值是您為 Web 伺服器選擇的暱稱與字尾 -node的連結。在配置外掛程式期間會自動建立它，且無法變更。例如，如果您在配置外掛程式期間，將 Web 伺服器命名為 myserver，在執行 Script 之後所建立的相關聯 Web 伺服器定義的值會是 myserver-node。
如果您已啟用安全或變更預設 JMX 連接器類型，請編輯 Script，並包含適當的參數。
複製 profile_root/config/cells/cell_name/nodes/web_server_name_node/servers/web_server_name 目錄中的現行外掛程式配置檔 plugin-cfg.xml。將檔案貼到 Web 伺服器機器上，以取代暫時的 plugins_root/config/web_server_name/plugin-cfg.xml 檔。 IBM HTTP Server 支援自動延伸。其他 Web 伺服器需要手動傳播。
請使用適合您 Web 伺服器的程序來啟動 Web 伺服器。開啟管理主控台，然後儲存已變更的定義。
將瀏覽器指向 http://localhost:9080/snoop，測試應用程式伺服器提供的內部 HTTP 傳輸。將瀏覽器指向 http://Host_name_of_Web_server_machine/snoop，以測試 Web 伺服器外掛程式。
驗證這兩個網址都會顯示「Snoop Servlet - 要求/用戶端資訊」頁面。

總而言之，「Web 伺服器外掛程式」有兩項實務。每一項實務都聚焦在外掛程式配置檔 plugin-cfg.xml 的唯一位置。

應用程式伺服器會產生外掛程式配置檔。這個檔案的用途在於，發佈 Web 伺服器所有相關應用程式伺服器物件的位置，以及控制二進位外掛程式配置選項。檔案會識別物件，例如：應用程式和提供應用程式的虛擬主機。

如果 Web 伺服器無法存取應用程式伺服器機器上的檔案，您必須將檔案複製到 Web 伺服器。該程序稱為「傳播」。傳播專供遠端外掛程式配置實務使用，亦即，本文中的實務 B。

在本端實務中，Web 伺服器可以存取 plugin-cfg.xml 檔，因為 Web 伺服器就位於檔案的相同機器上。

實務 A 的所有配置都將 Web 伺服器定義放在其本身的 Web 伺服器節點內。

限制管理選項不讓您在獨立式應用程式伺服器的管理主控台中，建立或刪除一項 Web 伺服器定義。也因為獨立式應用程式伺服器無法建立 Web 伺服器定義，才會以「Web 伺服器外掛程式配置工具」所建立的配置 Script 為依據。如果沒有 Script，就無法輕易在獨立式應用程式伺服器節點上建立 Web 伺服器定義。

下表顯示本文所說明之各項配置的 plugin-cfg.xml 檔位置：

表 3. 外掛程式配置檔位置。這份表格說明外掛程式配置檔的位置。
實務	設定檔類型	plugin-cfg.xml 檔的位置
實務	設定檔類型	`plugins_root`	`profile_root`：位於 Web 伺服器節點內
A	應用程式伺服器設定檔		X
B	如果您在「Web 伺服器外掛程式配置工具」中選取遠端安裝類型，則是任一處中的任何設定檔	X
	無設定檔	X
	含有現有 Web 伺服器定義的應用程式伺服器設定檔	X

圖註：

plugins_root

plugins_root/config/web_server_name/plugin-cfg.xml

profile_ root：位於 Web 伺服器節點內

profile_root/config/cells/cell_name/nodes/web_server_name_node/servers/web_server_name/plugin-cfg.xml