Web 伺服器外掛程式內容

請利用這個頁面來檢視或變更 Web 伺服器外掛程式配置檔的設定。外掛程式配置檔 plugin_cfg.xml 提供了內容來建立 Web 伺服器和應用程式伺服器之間的通訊。

若要檢視這個管理主控台頁面,請按一下伺服器 > 伺服器類型 > Web 伺服器 > web_server_name > 外掛程式內容

您可以在配置標籤中編輯欄位,在執行時期標籤中,您可以查看唯讀資訊。

只有當這個 Web 伺服器已經存取在應用程式伺服器中執行的應用程式,且有 http_plugin.log 檔時,才能使用執行時期標籤。

「配置」標籤

在 Web 伺服器啟動期間,忽略 DNS 失敗

指定在啟動時,外掛程式是否要忽略配置內的 DNS 失敗。

這個欄位對應於 plugin-cfg.xml 檔中的 IgnoreDNSFailures 元素。

當設定為 true 時,如果在每個 ServerCluster 中,至少有一部伺服器能夠解析主機名稱,外掛程式會忽略配置內的 DNS 失敗且會順利啟動。在配置的生命期間,主機名稱無法解析的任何伺服器都會標示為無法使用。 在遞送要求期間,之後就不會再嘗試解析主機名稱。如果發生 DNS 失敗,就會在外掛程式日誌檔中寫入一則日誌訊息,外掛程式的起始設定會繼續下去,不會使 Web 伺服器無法啟動。 當指定 false 時,DNS 失敗會使 Web 伺服器無法啟動。

資料類型 字串
預設值 false
重新整理配置間隔

指定外掛程式應該檢查配置檔是否有更新或變更的時間間隔(秒)。外掛程式會檢視這個檔案以瞭解上次載入外掛程式配置之後所發生的任何修改。

在經常變更的開發環境中,最好採用低於預設值 60 秒的設定。在正式作業環境中,值最好比預設值高,因為這時不會常常更新配置。如果外掛程式因故無法重新載入,外掛程式日誌檔會寫入一則訊息,在外掛程式配置檔順利重新載入之前,會使用舊配置。如果您看不出外掛程式配置的變更,請檢查外掛程式日誌檔,以找出問題的指示。

資料類型 整數
預設值 60 秒。
外掛程式配置檔名稱

指定外掛程式的配置檔檔名。依預設,應用程式伺服器會產生 plugin-cfg.xml 檔。配置檔會識別 Web 伺服器的應用程式、應用程式伺服器、叢集和 HTTP 埠。Web 伺服器使用該檔案來存取各個應用程式伺服器中部署的應用程式。

您可以變更外掛程式配置檔的名稱。不過,如果您變更檔名,也必須要變更 Web 伺服器配置指向新的外掛程式配置檔。

如果您在安裝期間選取 Web 伺服器外掛程式,安裝程式會配置 Web 伺服器識別 plugin-cfg.xml 檔的位置(如果可能)。依預設,外掛程式配置檔會安裝在 plugins_root/config/web_server_name 目錄中。

安裝程式會將指定 plugin-cfg.xml 檔案位置的指引加入 Web 伺服器配置。

如果是遠端 Web 伺服器,您必須從安裝應用程式伺服器所在的本端目錄將檔案複製到遠端機器。這就是所謂的傳送外掛程式配置檔。如果您的 Web 伺服器是 IBM® HTTP Server 6.1 版或更新的版本,且已備妥傳送檔案的作用中 HTTP 傳輸機制,WebSphere® Application Server 便可以將外掛程式配置檔自動傳送至遠端機器。

您可以按一下檢視來顯示現行外掛程式配置檔的複本。

資料類型 字串
預設值 plugin-cfg.xml
自動產生外掛程式配置檔
若要自動產生外掛程式配置檔給遠端 Web 伺服器,請執行下列動作:
  • 必須勾選這個欄位。
  • 必須啟用外掛程式配置服務
如果啟用了外掛程式配置服務,且發生下列情況,即會自動產生外掛程式配置檔︰
  • WebSphere Application Server 管理者定義新的 Web 伺服器。
  • 應用程式部署到應用程式伺服器。
  • 解除安裝應用程式。
  • 更新及儲存虛擬主機定義。

依預設,會勾選這個欄位。 如果您要手動產生這個 Web 伺服器的外掛程式配置檔,請清除這個勾選框。

[AIX Solaris HP-UX Linux Windows] 重要: 在產生外掛程式配置檔時,虛擬主機的清單中並不含 admin_host。 資訊中心的「允許 Web 伺服器存取管理主控台」一文會說明如何將 admin_host 新增到虛擬主機清單中。
自動傳送外掛程式配置檔
指定應用程式伺服器是否要自動傳送一份變更過的外掛程式配置檔到 Web 伺服器,請執行下列動作︰
  • 必須勾選這個欄位。
  • 必須啟用外掛程式配置服務
  • 在 Network Deployment 環境中,WebSphere Application Server 節點代理程式必須與已變更之外掛程式配置檔相關的 Web 伺服器位在相同節點上。
依預設,會勾選這個欄位。
註: 只有當 Web 伺服器是 IBM HTTP Server 6.1 版或更新版本的 Web 伺服器,且管理伺服器在執行中,外掛程式配置檔才能自動傳播到遠端 Web 伺服器。

由於外掛程式配置服務是在背景中執行,並未連結於管理主控台,因此,管理主控台無法顯示自動傳送的結果。

[AIX Solaris HP-UX Linux Windows] 如果是分散式平台,您可以檢查部署管理程式 SystemOut.log 檔中的相關訊息,確認已順利完成自動傳送程序。

[z/OS] 如果是 z/OS® 平台,您可以檢查 TSO JOB 日誌中的相關訊息,確認已順利完成自動傳送程序。

外掛程式金鑰儲存庫檔案名稱
指定 Web 伺服器外掛程式用於 HTTPS 要求的安全金鑰環所在之資料庫檔案的完整目錄路徑和檔案名稱。 這個檔案在這個 Web 伺服器外掛程式的相關 Web 伺服器中。 在指定了資料庫檔案的完整目錄路徑和檔案名稱之後,您可以執行下列動作:
  • 按一下管理金鑰和憑證來更新這個檔案。
  • 按一下複製到 Web 伺服器金鑰儲存庫目錄,以將這個檔案的複本新增到 Web 伺服器的金鑰儲存庫目錄中。
資料類型 字串
預設值
外掛程式配置目錄和檔案名稱

指定 Web 伺服器外掛程式配置的 Web 伺服器複本之完整路徑。這個路徑是檔案名稱 加上 Web 伺服器執行所在的機器位置。

外掛程式金鑰儲存庫目錄和檔案名稱

指定您的安全金鑰環所在的資料庫檔案之 Web 伺服器複本的完整路徑。這個路徑是檔案名稱 加上 Web 伺服器執行所在的機器位置。

外掛程式記載

指定 http_plugin.log 檔的位置和名稱。並指定日誌中的訊息範圍。

日誌說明外掛程式所寫入之日誌訊息的位置和層次。如果配置檔中沒有指定日誌,在某些情況下,日誌訊息會寫入 Web 伺服器錯誤日誌中。

在分散式平台中,如果日誌檔不存在,會建立這個檔案。如果日誌檔已經存在,會以附加的模式來開啟它,先前的外掛程式日誌訊息都會維持不變。

日誌檔名稱 - 外掛程式要將錯誤訊息寫入其中之日誌檔的完整路徑。

資料類型 字串
預設值 plugins_root/logs/web_server_name/http_plugin.log

指定 http_plugin.log 檔的檔案路徑。

日誌層次- 外掛程式應該寫入日誌之日誌訊息的明細層次。您可以指定這個屬性的下列值之一:
  • Trace。詳細記載要求程序中的所有步驟。
  • Stats。記載每個要求的所選伺服器及用來處理要求的相關負載平衡資訊。
  • Warn。記載因處理異常要求而產生的所有警告和錯誤訊息。
  • Error。只記載因處理異常要求而產生的錯誤訊息。
  • Debug。記載處理要求時所執行的所有重要步驟。
  • Detail。記錄要求和回應的所有相關資訊。

如果未指定日誌層次,則使用預設值 Error

設定層次為 Trace 時,請特別小心。這個層次會記載許多訊息,磁碟空間/檔案系統可能會很快填滿。在正常運作的環境中,不應該使用 Trace 設定,因為它會影響效能。

[AIX Solaris HP-UX Linux Windows] [iSeries] [z/OS] 重要: 如果 Web 伺服器和 Web 伺服器外掛程式是在 AIX®、HP-UX、Linux® 或 Solaris 系統上執行,且您在 plugin-cfg.xml 檔中變更了記載層次,便不會動態採納這項變更。 您必須重新啟動 Web 伺服器,使變更生效。 比方說,在 Solaris 上,如果您並未重新啟動 Web 伺服器,Plugin_Home/logs/http_plugin.log 檔會出現下列錯誤訊息:
ERROR: ws_config_parser:handleLogEnd: Failed to open log file
'/opt/IBM/WebSphere/Plugin/logs/sunwebserver/http_plugin.log', OS
資料類型 字串
預設值 錯誤

「執行時期」標籤

外掛程式記載

指定 http_plugin.log 檔的位置和名稱。並指定日誌中的訊息範圍。

日誌說明外掛程式所寫入之日誌訊息的位置和層次。如果配置檔中沒有指定日誌,在某些情況下,日誌訊息會寫入 Web 伺服器錯誤日誌中。

在分散式平台中,如果日誌檔不存在,會建立這個檔案。如果日誌檔已經存在,會以附加的模式來開啟它,先前的外掛程式日誌訊息都會維持不變。

日誌檔名稱 - 外掛程式要將錯誤訊息寫入其中之日誌檔的完整路徑。

資料類型 字串
預設值 plugins_root/logs/web_server_name/http_plugin.log

指定 http_plugin.log 檔的檔案路徑。

日誌層次- 外掛程式應該寫入日誌之日誌訊息的明細層次。您可以指定這個屬性的下列值之一:
  • Trace。詳細記載要求程序中的所有步驟。
  • Stats。記載每個要求的所選伺服器及用來處理要求的相關負載平衡資訊。
  • Warn。記載因處理異常要求而產生的所有警告和錯誤訊息。
  • Error。只記載因處理異常要求而產生的錯誤訊息。
  • Debug。記載處理要求時所執行的所有重要步驟。
  • Detail。記錄要求和回應的所有相關資訊。

如果未指定日誌層次,則使用預設值 Error

設定層次為 Trace 時,請特別小心。這個層次會記載許多訊息,磁碟空間/檔案系統可能會很快填滿。在正常運作的環境中,不應該使用 Trace 設定,因為它會影響效能。

[AIX Solaris HP-UX Linux Windows] [iSeries] [z/OS] 重要: 如果 Web 伺服器和 Web 伺服器外掛程式是在 AIX®、HP-UX、Linux® 或 Solaris 系統上執行,且您在 plugin-cfg.xml 檔中變更了記載層次,便不會動態採納這項變更。 您必須重新啟動 Web 伺服器,使變更生效。 比方說,在 Solaris 上,如果您並未重新啟動 Web 伺服器,Plugin_Home/logs/http_plugin.log 檔會出現下列錯誤訊息:
ERROR: ws_config_parser:handleLogEnd: Failed to open log file
'/opt/IBM/WebSphere/Plugin/logs/sunwebserver/http_plugin.log', OS
資料類型 字串
預設值 錯誤



標示(線上)的鏈結表示需要存取網際網路。

相關工作
相關參考
Web 伺服器外掛程式要求和回應最佳化內容
Web 伺服器外掛程式快取內容
Web 伺服器外掛程式要求遞送內容


檔名: uwsv_plugin_props.html