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

Web 伺服器配置

外掛程式配置包括將 Web 伺服器配置成使用 WebSphere® Application Server 提供的二進位外掛程式模組。外掛程式配置還包括更新外掛程式 XML 配置檔,以反映現行應用程式伺服器配置。二進位模組使用 XML 檔來協助遞送 Web 用戶端要求。

[AIX Solaris HP-UX Linux Windows]安裝支援的 Web 伺服器之後,您必須安裝「Web 伺服器外掛程式」,以安裝 Web 伺服器的二進位外掛程式模組。外掛程式模組可讓 Web 伺服器與應用程式伺服器通訊。「Web 伺服器外掛程式配置工具」可讓您配置 Web 伺服器,並將 Web 伺服器定義建立在應用程式伺服器的配置中。「Web 伺服器外掛程式配置工具」使用下列檔案,來配置您所選 Web 伺服器的外掛程式:
  • 位於 Web 伺服器機器上的 Web 伺服器配置檔,例如 IBM® HTTP Server 的 httpd.conf 檔。
  • 位於 Web 伺服器機器上的二進位 Web 伺服器外掛程式檔案
  • 位於應用程式伺服器機器上,且要傳播(複製)到 Web 伺服器機器上的外掛程式配置檔 plugin-cfg.xml
  • 位於 Web 伺服器機器上的預設(暫時)外掛程式配置檔 plugin-cfg.xml
  • 您要從 Web 伺服器機器複製到應用程式伺服器機器上的 configureweb_server_name Script
[IBM i]外掛程式配置程序使用下列檔案,來配置您所選 Web 伺服器的外掛程式:
  • 位於 Web 伺服器機器上的 Web 伺服器配置檔,例如 IBM HTTP Server 的 httpd.conf 檔。
  • 位於 Web 伺服器機器上的二進位 Web 伺服器外掛程式檔案
  • 位於應用程式伺服器機器上,且要傳播(複製)到 Web 伺服器機器上的外掛程式配置檔 plugin-cfg.xml
  • 在遠端 HTTP 實務中,用來為您的應用程式伺服器配置 Web 伺服器定義的配置 Script

每一個檔案的說明如下。

Web 伺服器配置檔

Web 伺服器配置檔會隨 Web 伺服器一起安裝。

[AIX Solaris HP-UX Linux Windows]「Web 伺服器外掛程式配置工具」必須重新配置所支援 Web 伺服器的配置檔。

配置作業包括新增指引,以便識別下列兩個檔案的檔案位置:
  • 二進位 Web 伺服器外掛程式檔案
  • 外掛程式配置檔 plugin-cfg.xml

二進位 Web 伺服器外掛程式檔案

以 Windows 平台上的 IBM HTTP Server 為例,二進位外掛程式模組可以是 mod_was_ap22_http.dll 檔。

[IBM i]IBM i 為例,二進位外掛程式模組可以是 QSVTAP20 服務程式。

二進位外掛程式檔案不會變更。不過,二進位外掛程式的配置檔是 XML 檔。對 WebSphere Application Server 配置進行某些變更時,應用程式伺服器會變更配置檔。

二進位模組會讀取 XML 檔,以調整設定,以及將要求遞送至應用程式伺服器。

外掛程式配置檔 plugin-cfg.xml

外掛程式配置檔是一個 XML 檔,內含可讓您在管理主控台中調整的設定。檔案會列出安裝在 Web 伺服器定義上的所有應用程式。二進位模組會讀取 XML 檔,以調整設定,以及將要求遞送至應用程式伺服器。

[AIX Solaris HP-UX Linux Windows]獨立式應用程式伺服器會在 profile_root/config/cells/cell_name/nodes/web_server_name_node/servers/web_server_name 目錄中重新產生 plugin-cfg.xml 檔。只要應用程式伺服器配置中的變更會影響所部署的應用程式,就會執行重新產生。

[AIX Solaris HP-UX Linux Windows]只要應用程式伺服器配置中的變更,會影響部署在受管理節點上的應用程式,部署管理程式就會在 profile_root/config/cells/cell_name/nodes/node_name/servers/web_server_name 目錄中重新產生 plugin-cfg.xml 檔。

[IBM i]如果您對應用程式伺服器配置所做的變更,會影響所部署的應用程式,就會重新產生外掛程式配置 XML 檔。

在重新產生之後,會將檔案傳播(複製)到 Web 伺服器機器。之後二進位外掛程式有權存取其配置檔的最新副本。

[AIX Solaris HP-UX Linux Windows]當發生某些事件而變更了配置之後,Web 伺服器外掛程式配置服務會自動重新產生 plugin-cfg.xml 檔。當重新產生 plugin-cfg.xml 檔時,配置服務會自動將該檔案傳播至 IBM HTTP Server 機器。您必須手動將檔案複製到其他 Web 伺服器上。

[IBM i]IBM i 系統上,不會自動產生外掛程式。必須手動重新產生和傳播檔案。

[AIX Solaris HP-UX Linux Windows]

預設外掛程式配置檔 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]

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 伺服器定義建立在應用程式伺服器的配置中。

當使用 IBM HTTP Server 時,也請配置 IBM HTTP Administration Server。IBM HTTP Administration Server 會使用管理主控台,來管理 Web 伺服器定義。此外,請使用管理主控台,利用遠端 Web 伺服器管理選項來更新 Web 伺服器定義。請按一下伺服器 > 伺服器類型 > Web 伺服器 > web_server_name,查看配置選項。例如,按一下遠端 Web 伺服器管理,來變更如下的內容:
  • 主機名稱
  • 管理埠
  • 使用者 ID
  • 密碼
重要: 在執行這個 Script 之前,請一律先開啟新的指令視窗。如此做可避免發生潛在問題。

這個問題就是 Shell 環境變數 WAS_USER_SCRIPT 和實際預設設定檔之間發生潛在衝突。Script 的處理對象一律是預設設定檔。不過,一旦設定 WAS_USER_SCRIPT 環境變數,就會發生衝突,這是因為 Script 會嘗試處理此變數所識別的設定檔。

一不小心就會設定這個變數。請從任何設定檔的 profile_root/bin 目錄來發出任何指令,並將此變數設為該設定檔。

如果您的系統上有多個設定檔,預設設定檔與此變數所識別的設定檔,有可能是不同的設定檔。若是如此,便會發生衝突,且 Script 不見得將 Web 伺服器定義建立在正確的設定檔中,或者可能根本不會建立 Web 伺服器定義。

請使用下列兩種方式之一,來重設變數:
  • 關閉您在其中設定變數的指令視窗,並開啟新的指令視窗。
  • 切換至預設設定檔的 profile_root/bin 目錄,然後找到 setupCmdLine.sh Script:
    [Windows]
    1. 開啟命令提示視窗。
    2. 切換至 app_server_root\bin 目錄。
    3. 發出 setupCmdLine.bat 指令。
    [AIX][HP-UX][Linux][Solaris]
    1. 開啟指令 Shell 視窗。
    2. 切換至 app_server_root/bin 目錄。
    3. 發出 . ./setupCmdLine.sh 指令。請注意句點之間的空格。由於這個指令的特殊格式,指令會讓所有從指令 Shell 啟動的程序的設定都起作用。

如果獨立式應用程式伺服器已存在 Web 伺服器定義,執行 Script 並不會新增 Web 伺服器定義。每一部獨立式應用程式伺服器只能有一項 Web 伺服器定義。

您無法利用獨立式應用程式伺服器的管理主控台,來新增或刪除 Web 伺服器定義。不過,利用管理 Scripting 介面,就能執行這兩項作業:
  • 使用 configureweb_server_name Script,透過 wsadmin 機能來新增 Web 伺服器定義。Script 會使用名稱是 configureWebserverDefinition.jacl 的 「Java™ 指令語言 (Jacl)」Script,來建立和配置 Web 伺服器定義。
  • 使用 wsadmin 指令來刪除 Web 伺服器定義。在下列範例中,Web 伺服器的名稱是 webserver1:
     set webserverName webserver1
     set webserverNodeSuffix _node
     set webserverNodeName   $webserverName$webserverNodeSuffix
     $AdminConfig remove [$AdminConfig getid /Node:$webserverNodeName/Server:$webserverName]
     $AdminConfig remove [$AdminConfig getid /Node:$webserverNodeName]
     $AdminConfig save 

相對地,受管理節點可以有多項 Web 伺服器定義。除非 Web 伺服器名稱相同,Script 會建立新的 Web 伺服器定義。

[IBM i]

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 伺服器定義建立在應用程式伺服器的配置中。

IBM i 管理 GUI」具有一些外掛程式,可讓管理主控台管理 IBM HTTP Server。請使用管理主控台,利用遠端 Web 伺服器管理選項來更新 Web 伺服器定義。請按一下伺服器 > 伺服器類型 > Web 伺服器 > web_server_name,查看配置選項。例如,按一下遠端 Web 伺服器管理,來變更如下的內容:
  • 主機名稱
  • 管理埠
  • 使用者 ID
  • 密碼

如果獨立式應用程式伺服器已存在 Web 伺服器定義,執行 Script 並不會新增 Web 伺服器定義。每一部獨立式應用程式伺服器只能有一項 Web 伺服器定義。

您無法利用獨立式應用程式伺服器的管理主控台,來新增或刪除 Web 伺服器定義。不過,利用管理 Scripting 介面,就能執行這兩項作業:
  • 利用 configureweb_server_name Script,透過 wsadmin 機能來新增 Web 伺服器定義。Script 會使用名稱是 configureWebserverDefinition.jacl 的 「Java 指令語言 (Jacl)」Script,來建立和配置 Web 伺服器定義。
  • 使用 wsadmin 指令來刪除 Web 伺服器定義。在下列範例中,Web 伺服器的名稱是 webserver1:
    set webserverName webserver1
    set webserverNodeSuffix _node
    set webserverNodeName 
    $webserverName$webserverNodeSuffix
    $AdminConfig remove 
      [$AdminConfig getid
        /Node:$webserverNodeName/Server:$webserverName]
    $AdminConfig remove 
      [$AdminConfig getid /Node:$webserverNodeName]
    $AdminConfig save 

或者,您可以使用 configureOs400WebServerDefinitionremoveOs400WebServerDefinition Script,來執行這些作業。

相對地,受管理節點可以有多項 Web 伺服器定義。除非 Web 伺服器名稱相同,Script 會建立新的 Web 伺服器定義。

以 Web 伺服器定義中的檔案,取代預設外掛程式配置檔(傳播)

預設檔案會使用固定的參數值,這可能與應用程式伺服器上之實際檔案中的參數值不符。預設檔案只是一個位置保留元。

檔案無法反映應用程式伺服器配置中所做的變更。檔案也無法反映可能已在應用程式伺服器中生效的非預設值。

[AIX Solaris HP-UX Linux Windows]應用程式伺服器的實際 plugin-cfg.xml 檔中必須有下列值。若是如此,預設檔案就能順利配置二進位外掛程式模組。之後外掛程式模組就能順利與 Web 伺服器和應用程式伺服器通訊。

[AIX Solaris HP-UX Linux Windows]假設應用程式伺服器的實際 plugin-cfg.xml 檔中沒有下列值。在此情況下,預設檔案將不當配置二進位外掛程式模組。外掛程式模組一律能與 Web 伺服器通訊。但是如果配置檔不適當,外掛程式模組就無法順利與應用程式伺服器通訊。

[AIX Solaris HP-UX Linux Windows]以下是暫時外掛程式配置檔中的固定參數值。
  • 虛擬主機名稱

    預設值:default_host

    這部虛擬主機會配置成提供 DefaultApplication。此值可能與實際 plugin-cfg.xml 檔中的值相同。不過,假設您另建虛擬主機來提供應用程式,並在其中安裝 DefaultApplication。若是如此,會重新產生實際 plugin-cfg.xml 檔。Web 伺服器將無法存取 DefaultApplication。(應用程式包含 snoop Servlet 和 hitcount Servlet。)

    如果要存取新虛擬主機上的應用程式,請傳播實際的 plugin-cfg.xml 檔。傳播是指將已更新的檔案從應用程式伺服器機器複製到 Web 伺服器機器。

  • HTTP 傳輸埠

    預設值:9080

    9080 值是 default_host 虛擬主機 HTTP 傳輸埠的預設值。此值可能與已更新的檔案中的值相同。不過,在應用程式伺服器機器上,每一個設定檔中的這個值已變更。對於每一部應用程式伺服器,HTTP 傳輸埠值都必須是唯一的。

    如果要在通訊時使用不同埠,請傳播實際的 plugin-cfg.xml 檔。

  • Web 伺服器接聽埠

    預設值:80

    80 值是用來控制 Web 伺服器通訊之埠的預設值。不過,每一個應用程式伺服器設定檔都必須使用唯一的埠值來與 Web 伺服器通訊。實際埠值可能是 81 或其他數字。

    如果要在通訊時使用不同埠,請傳播實際的 plugin-cfg.xml 檔。

  • HTTPS 傳輸埠

    預設值:9443

    9443 值是 default_host 虛擬主機 HTTPS(安全)傳輸埠的預設值。此值可能與已更新的檔案中的值相同。不過,在應用程式伺服器機器上,每一個設定檔中的這個值已變更。對於每一部應用程式伺服器,HTTPS 傳輸埠值都必須是唯一的。

    如果要在通訊時使用不同的安全埠,請傳播實際的 plugin-cfg.xml 檔。

  • 安裝在 server1 應用程式伺服器上的應用程式

    預設 Servlet 和應用程式全都會包含在預設檔案中。

    如果要提供使用 Web 伺服器開發的應用程式,請傳播實際的 plugin-cfg.xml 檔。


指出主題類型的圖示 概念主題



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