[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 伺服器外掛程式」。sptcfg
開始之前: 在配置外掛程式期間,會更新外掛程式和 Web 伺服器配置檔。如果您以非 root 使用者身分,來使用「Web 伺服器外掛程式配置工具」或 pct 指令行工具,在開始配置之前,請先驗證您具備適當的專用權,來更新「Web 伺服器外掛程式」的配置檔以及您 Web 伺服器(例如 IHS)的配置檔,尤其是如果您不是這些檔案的擁有者,更需要這麼做。
小心: 當您使用「Web 伺服器外掛程式配置工具」來配置 IBM® HTTP Server 管理伺服器時,必須以具備管理者/root 專用權的「本端」帳戶,來執行 WebSphere Customization Toolbox。

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

支援的配置 支援的配置: 「Web 伺服器外掛程式配置工具」主要是與完整的 WebSphere® Application Server 設定檔搭配使用;當您針對 Liberty 設定檔產生 Web 伺服器外掛程式時,不需要也不支援使用它。如需為 Liberty 設定檔產生 Web 伺服器外掛程式的相關資訊,請閱讀使用 Web 伺服器外掛程式來配置 Liberty 設定檔。sptcfg

配置流程

「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 伺服器配置的驗證程序:

  1. 請使用適合您 Web 伺服器的程序來啟動 Web 伺服器。
    例如,從指令行啟動 IBM HTTP Server:
    • [AIX][HP-UX][Linux][Solaris]./IHS_root/bin/apachectl start
    • [Windows]IHS_root\bin\apache
  2. 啟動應用程式伺服器。
    切換至 profile_root/bin 目錄,然後執行 startServer 指令:
    • [AIX][HP-UX][Linux][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 伺服器定義建立在遠端機器上的分散式設定檔內。此工具反而會建立 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 N/A
無設定檔 用 Script N/A
含有現有 Web 伺服器定義的獨立式應用程式伺服器設定檔 用 Script 是

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

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

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

  1. 請使用適合您 Web 伺服器的程序來啟動 Web 伺服器。
    例如,從指令行啟動 IBM HTTP Server:
    • [AIX][HP-UX][Linux][Solaris]./IHS_root/bin/apachectl start
    • [Windows]IHS_root\bin\apache
  2. 啟動遠端機器上的應用程式伺服器。
    切換至 profile_root/bin 目錄,然後執行 startServer 指令:
    • [AIX][HP-UX][Linux][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. 在應用程式伺服器中建立 Web 伺服器定義。
    執行 Script,以便手動將 Web 伺服器定義建立在應用程式伺服器節點的配置內:
    1. 將 Script 從 plugins_root/bin 目錄複製到遠端 app_server_root/bin 目錄。
    2. 開啟指令視窗,並執行 Script:
      • [AIX][HP-UX][Linux][Solaris]./configureweb_server_name.sh
      • [Windows]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 中的 webserverNodeName 值是您選擇的 Web 伺服器暱稱,配上 -node 字尾。在配置外掛程式期間會自動建立它,且無法變更。例如,如果您在配置外掛程式期間,將 Web 伺服器命名為 myserver,在執行 Script 之後所建立的相關聯 Web 伺服器定義的值會是 myserver-node。

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

  2. 複製 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 伺服器需要手動傳播。
  3. 請使用適合您 Web 伺服器的程序來啟動 Web 伺服器。開啟管理主控台,並儲存已變更的配置。
  4. 將瀏覽器指向 http://localhost:9080/snoop,測試應用程式伺服器提供的內部 HTTP 傳輸。 將瀏覽器指向 http://Host_name_of_Web_server_machine/snoop,以測試 Web 伺服器外掛程式。
  5. 驗證這兩個網址都會顯示「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

指出主題類型的圖示 參照主題



時間戳記圖示 前次更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=cins_webplugins
檔名:cins_webplugins.html