[AIX Solaris HP-UX Linux Windows][IBM i]

外掛程式配置

「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 設定檔。

Network Deployment 產品的配置流程

「Web 伺服器外掛程式配置工具」會將 Web 伺服器和 WebSphere Application Server 的所有配置解析成三個實務範例: 遠端應用程式伺服器、本端分散式應用程式伺服器，以及本端獨立式應用程式伺服器。 下圖顯示在判斷哪一項實務適用於該配置時，所實作的邏輯。

設計邏輯的外掛程式流程
圖註：
安裝類型？
安裝類型可以是遠端或本端。

如果 Web 伺服器和應用程式伺服器不是位於相同電腦上，請選擇遠端實務。 如果 Web 伺服器和應用程式伺服器都位於相同電腦上，請選擇本端實務。

設定檔？
如果已安裝產品，但 設定檔管理工具 尚未建立設定檔，則實務範例視為遠端安裝。
含有 Web 伺服器定義的獨立式應用程式伺服器？
如果設定檔是一部具有現有 Web 伺服器定義的應用程式伺服器，則會視為遠端安裝架構。
設定檔類型?
「Web 伺服器外掛程式配置工具」一次只能配置一個設定檔。 這三種路徑顯示對於不同類型的設定檔，處理方式上有何不同。
聯合？
如果聯合了應用程式伺服器節點，「Web 伺服器外掛程式配置工具」會將 Web 伺服器定義配置在受管理節點上。 這有其優點。 假設 Web 伺服器和受管理節點位於不同機器上。 在節點同步化期間，會自動將 plugin-cfg.xml 檔傳播到遠端節點，這是因為 Web 伺服器定義是節點配置的一部分。
分散式設定檔？
如果部署管理程式具有聯合的自訂節點（自訂設定檔），「Web 伺服器外掛程式配置工具」會將 Web 伺服器定義配置在受管理節點上。 這有其優點。 假設 Web 伺服器和受管理節點位於不同機器上。 在節點同步化期間，會自動將 plugin-cfg.xml 檔傳播到遠端節點，這是因為 Web 伺服器定義是節點配置的一部分。

「Web 伺服器外掛程式配置工具」會將 Web 伺服器定義建立在應用程式伺服器設定檔內。

「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 伺服器。

假設您在獨立式應用程式伺服器中建立 Web 伺服器定義，然後聯合該節點。 Web 伺服器定義不會聯合到 Cell 中，這是因為 Web 伺服器定義是定義成獨立式應用程式伺服器中的另一個節點。 您必須在受管理節點上重建 Web 伺服器定義。 請參閱 實務範例 2。
表 1. 符合本端獨立式應用程式伺服器實務的配置 。
設定檔類型 聯合狀態 自動建立 Web 伺服器定義？ Web 伺服器已定義在應用程式伺服器配置中？
應用程式伺服器 未聯合 是(Y) 否

如果未聯合的獨立式應用程式伺服器具有現有 Web 伺服器定義，則應當成遠端外掛程式配置來處理。

獨立式應用程式伺服器上的現有 Web 伺服器定義會要求「Web 伺服器外掛程式配置工具」遵循遠端安裝路徑。 獨立式應用程式伺服器只能有一項 Web 伺服器定義。

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

已聯合的獨立式應用程式伺服器應當成本端分散式外掛程式配置來處理。 如需這種節點類型的說明，請參閱實務 2。

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

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

「Web 伺服器外掛程式配置工具」不會自動將 Web 伺服器定義建立在已聯合的應用程式伺服器設定檔內。 工具會改為在 plugins_root/bin 目錄中建立 configureweb_server_name Script。

「Web 伺服器外掛程式配置工具」會將 Web 伺服器配置成使用 plugin-cfg.xml 檔，這個檔案會在您執行 Script 時建立在應用程式伺服器設定檔內。 部署管理程式會在 profile_root/config/cells/cell_name/nodes/node_name/servers/web_server_name 目錄中重新產生 plugin-cfg.xml 檔。 只要應用程式伺服器配置中的變更會影響部署在受管理節點上的應用程式，就會執行重新產生。

安裝本端 Web 伺服器的二進位外掛程式之後，您必須先執行 Script，才能啟動 Web 伺服器。 Web 伺服器已配置成使用應用程式伺服器配置中的 plugin-cfg.xml 檔。 必須等執行 configureweb_server_name Script 之後，該檔案才會存在。
表 2. 符合本端分散式應用程式伺服器實務的配置 。
設定檔類型 聯合狀態 建立 Web 伺服器定義？ Web 伺服器已定義在應用程式伺服器配置中？
應用程式伺服器設定檔 聯合的 依據 Script 無
自訂設定檔 未聯合 依據 Script 無
自訂設定檔 聯合的 依據 Script 無
具有受管理節點的部署管理程式設定檔（分散式設定檔） 無 依據 Script 無

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

  1. 啟動部署管理程式。
  2. 如果您打算將應用程式伺服器節點新增至部署管理程式 Cell，但尚未如此做，請先聯合該節點，再安裝外掛程式。 在您聯合該節點時，如果 Web 伺服器定義已存在，一旦聯合，Web 伺服器定義就會遺失。
  3. 在應用程式伺服器中建立 Web 伺服器定義。 有兩個選項可供選擇：
    • 使用部署管理程式的管理主控台，為受管理節點建立 Web 伺服器定義。 請按一下伺服器 > Web 伺服器 > 新建，然後利用「建立新的 Web 伺服器項目」精靈，來建立 Web 伺服器定義。
    • 執行 Script，以手動將 Web 伺服器定義建立在部署管理程式的配置內。 從 plugins_root/bin 目錄執行 Script。 Script 可以將部署管理程式定址在相同機器上。
      開啟指令視窗，並執行適當的 Script：
      • [Linux][AIX][HP-UX][Solaris]./configureweb_server_name.sh
      • [Windows]configureweb_server_name.bat
      附註: Script 中的 webserverNode名稱 值是您為 Web 伺服器選擇的暱稱與字尾 -node的連結。 在外掛程式安裝期間會自動建立它，且無法變更。 例如，如果您在外掛程式安裝期間，將 Web 伺服器命名為 myserver，在執行 Script 之後所建立的相關聯 Web 伺服器定義的值會是 myserver-node。

      如果您已啟用安全或變更預設 JMX 連接器類型， 請編輯 Script，並包含適當的參數。

  4. 請使用適合您 Web 伺服器的程序來啟動 Web 伺服器。
    例如，從指令行啟動 IBM HTTP Server :
    • [Linux][AIX][HP-UX][Solaris]./IHS_root/bin/apachectl start
    • [Windows]IHS_root\bin\apache
  5. 啟動應用程式伺服器。
    切換至 profile_root/bin 目錄，然後執行 startServer 指令：
    • [Linux][AIX][HP-UX][Solaris]./profile_root/bin/startServer.sh server1
    • [Windows]profile_root\bin\startServer server1
  6. 開啟部署管理程式的管理主控台。 等待進行節點同步化，並儲存已變更的配置（內含新的 Web 伺服器定義）。
  7. 將瀏覽器指向 http://localhost:9080/snoop，測試應用程式伺服器提供的內部 HTTP 傳輸。 將瀏覽器指向 http://Host_name_of_Web_server_machine/snoop，以測試 Web 伺服器外掛程式。
  8. 驗證這兩個網址都會顯示「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 伺服器定義。
表 3. 符合遠端應用程式伺服器實務範例的配置 。
設定檔類型 聯合狀態 建立 Web 伺服器定義？ Web 伺服器已定義在應用程式伺服器配置中？
如果您在「Web 伺服器外掛程式配置工具」中選取遠端安裝類型，則是任一處中的任何設定檔 無 依據 Script 無
無設定檔 無 依據 Script 無
含有現有 Web 伺服器定義的未聯合獨立式應用程式伺服器設定檔 未聯合 依據 Script 是(Y)
沒有受管理節點的部署管理程式設定檔 無 依據 Script 無

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

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

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

  1. 請使用適合您 Web 伺服器的程序來啟動 Web 伺服器。
    例如，從指令行啟動 IBM HTTP Server :
    • [Linux][AIX][HP-UX][Solaris]./IHS_root/bin/apachectl start
    • [Windows]IHS_root\bin\apache
  2. 啟動遠端機器上的應用程式伺服器。
    切換至 profile_root/bin 目錄，然後執行 startServer 指令：
    • [Linux][AIX][HP-UX][Solaris]./profile_root/bin/startServer.sh server1
    • [Windows]profile_root\bin\startServer server1
  3. 將瀏覽器指向 http://localhost:9080/snoop，測試應用程式伺服器提供的內部 HTTP 傳輸。 將瀏覽器指向 http://Host_name_of_Web_server_machine/snoop，以測試 Web 伺服器外掛程式。
  4. 驗證這兩個網址都會顯示「Snoop Servlet - 要求/用戶端資訊」頁面。
下列概觀顯示用來完成配置的程序。 Web 伺服器定義必須存在於應用程式伺服器節點的配置中，才能完成配置。 在重新產生有效的外掛程式配置檔 plugin-cfg.xml 時，Web 伺服器定義是一個核心元素。
  1. 如果您正在配置部署管理程式或受管理節點，請啟動部署管理程式。
  2. 如果您打算在某段期間聯合節點，請立即聯合遠端應用程式伺服器節點或自訂節點。 在您聯合節點時，如果 Web 伺服器定義已存在，該定義就會遺失。
  3. 在應用程式伺服器中建立 Web 伺服器定義。 對於受管理節點，您有兩個選項可選。 如果部署管理程式設定檔不含受管理節點，請使用 Script 選項。
    • 使用部署管理程式的管理主控台，為受管理節點建立 Web 伺服器定義。 請按一下伺服器 > Web 伺服器 > 新建，然後利用「建立新的 Web 伺服器項目」精靈，來建立 Web 伺服器定義。
    • 執行 Script，以便手動將 Web 伺服器定義建立在應用程式伺服器節點的配置內：
      1. 將 Script 從 plugins_root/bin 目錄複製到遠端 app_server_root/bin 目錄。
      2. 開啟指令視窗，並執行 Script：
        • [Linux][AIX][HP-UX][Solaris]./configureweb_server_name.sh
        • [Windows]configureweb_server_name.bat
      附註: Script 中的 webserverNode名稱 值是您為 Web 伺服器選擇的暱稱與字尾 -node的連結。 在外掛程式安裝期間會自動建立它，且無法變更。 例如，如果您在外掛程式安裝期間，將 Web 伺服器命名為 myserver，在執行 Script 之後所建立的相關聯 Web 伺服器定義的值會是 myserver-node。

      如果您已啟用安全或變更預設「Java™ 管理延伸 (JMX)」連接器類型，請編輯 Script 並包含適當的參數。

  4. 如果已聯合節點，請開啟部署管理程式的管理主控台。 等待受管理節點上進行節點同步化，並儲存已變更的配置（內含新的 Web 伺服器定義）。 如果未聯合遠端節點，請開啟應用程式伺服器的管理主控台，並儲存已變更的配置。
  5. 複製 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 伺服器需要手動傳播。
  6. 請使用適合您 Web 伺服器的程序來啟動 Web 伺服器。
  7. 將瀏覽器指向 http://localhost:9080/snoop，測試應用程式伺服器提供的內部 HTTP 傳輸。 將瀏覽器指向 http://Host_name_of_Web_server_machine/snoop，以測試 Web 伺服器外掛程式。
  8. 驗證這兩個網址都會顯示「Snoop Servlet - 要求/用戶端資訊」頁面。

總而言之，「Web 伺服器外掛程式」有三項實務。 每一項實務都聚焦在外掛程式配置檔 plugin-cfg.xml 的唯一位置。 應用程式伺服器會產生外掛程式配置檔。 這個檔案的用途在於，發佈 Web 伺服器所有相關應用程式伺服器元素的位置。 舉例來說，這類元素包括：應用程式、提供應用程式的虛擬主機、叢集，以及叢集成員。

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

在每一項本端實務中，Web 伺服器可以取得 plugin-cfg.xml 檔，因為它就位於檔案的相同機器上。 會有兩項本端實務，這是因為本端 plugin-cfg.xml 檔位於兩個不同的位置。

WebSphere Application Server 的配置架構會將外掛程式配置檔放在 Web 伺服器節點或受管理節點內的 Web 伺服器定義中。 在本文中，實務 2 和實務 1 之間的節點類型不同。 實務 2 的所有配置都要求 Web 伺服器定義必須存在於受管理應用程式伺服器節點內。 實務 1 的所有配置都將 Web 伺服器定義放在其本身的 Web 伺服器節點內。

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

下表顯示本文所說明之各項配置的 plugin-cfg.xml 檔位置：
表 4. 外掛程式配置檔位置 。 這份表格說明外掛程式配置檔的位置。
實務範例 設定檔類型 plugin-cfg.xml 檔的位置
plugins_root profile_root：位於受管理節點內 profile_root：位於 Web 伺服器節點內
1 應用程式伺服器設定檔     X
2 應用程式伺服器設定檔   X  
自訂設定檔   X  
具有受管理節點的部署管理程式設定檔（分散式設定檔）   X  
3 如果您在「Web 伺服器外掛程式配置工具」中選取遠端安裝類型，則是任一處中的任何設定檔 X    
無設定檔 X    
含有現有 Web 伺服器定義的未聯合（獨立式）應用程式伺服器設定檔 X    
沒有受管理節點的部署管理程式設定檔 X    
圖註：
plugins_root
plugins_root
/config/web_server_name/plugin-cfg.xml
profile_root：位於受管理節點內
profile_root/config/cells/cell_name/nodes/node_name_of_AppServer/servers/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