Web 伺服器外掛程式內容

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

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

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

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

註：這個主題參照一或多個應用程式伺服器日誌檔。建議的另一種作法是，您可以在分散式系統和 IBM® i 系統上配置伺服器，來使用「高效能可延伸記載 (HPEL)」日誌和追蹤基礎架構，而不使用 SystemOut.log、SystemErr.log、trace.log 和 activity.log 檔。 HPEL 也可以與原生 z/OS® 記載機能一起使用。如果使用 HPEL，您可以從伺服器設定檔 bin 目錄中，利用 LogViewer 指令行工具來存取您的所有日誌和追蹤資訊。請參閱有關利用 HPEL 疑難排解應用程式的資訊，以取得更多使用 HPEL 的相關資訊。

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

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

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

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

依預設，當這個值是 false 時，DNS 失敗會使外掛程式無法起始設定，要求也會失敗。不過，Web 伺服器會啟動。

參考資訊	值
資料類型	String
預設值	false

重新整理配置間隔

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

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

參考資訊	值
資料類型	Integer
預設值	60 秒。

外掛程式配置檔名稱

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

避免困難：這個欄位會停用且無法變更，但為了提供參考，仍會顯示這個值。gotcha

如果想使用不同的位置，您必須重新執行「外掛程式配置工具 (PCT)」，來定義新的位置，然後執行新的 configureWebserver Script，這個 Script 是由 WebSphere Application Server 機器上的安裝程序產生的。

如果您在安裝期間選取 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 便可以將外掛程式配置檔自動傳送至遠端機器。

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

參考資訊	值
資料類型	String
預設值	plugin-cfg.xml

自動產生外掛程式配置檔

如果要自動產生外掛程式配置檔給遠端 Web 伺服器，請執行下列動作：

必須勾選這個欄位。
必須啟用外掛程式配置服務

如果啟用了外掛程式配置服務，且發生下列情況，就會自動產生 Web 伺服器的外掛程式配置檔︰

WebSphere Application Server 管理者定義新的 Web 伺服器。
應用程式部署到應用程式伺服器。
解除安裝應用程式。
更新及儲存虛擬主機定義。

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

重要：在產生外掛程式配置檔時，虛擬主機的清單中並不含 admin_host。資訊中心的「允許 Web 伺服器存取管理主控台」一文會說明如何將 admin_host 新增到虛擬主機清單。

自動傳送外掛程式配置檔

指定應用程式伺服器是否要自動傳送一份變更過的外掛程式配置檔到 Web 伺服器，請執行下列動作︰

必須勾選這個欄位。
必須啟用外掛程式配置服務
在 Network Deployment 環境中，WebSphere Application Server 節點代理程式必須位於管理 Web 伺服器的節點上，而該 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 伺服器的金鑰儲存庫目錄中。

參考資訊	值
資料類型	String
預設值	無

外掛程式配置目錄和檔案名稱

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

避免困難：這個欄位會停用且無法變更，但為了提供參考，仍會顯示這個值。gotcha

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

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

避免困難：這個欄位會停用且無法變更，但為了提供參考，仍會顯示這個值。gotcha

外掛程式記載

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

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

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

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

參考資訊	值
資料類型	String
預設值	`plugins_root`/logs/`web_server_name`/http_plugin.log 指定 http_plugin.log 檔的檔案路徑。

日誌層次：外掛程式應寫到日誌中的日誌訊息詳細程度。您可以指定這個屬性的下列值之一：

Trace。詳細記載要求程序中的所有步驟。
Stats。記載每個要求的所選伺服器及用來處理要求的相關負載平衡資訊。
Warn。記載因處理異常要求而產生的所有警告和錯誤訊息。
Error。只記載因處理異常要求而產生的錯誤訊息。
Debug。記載處理要求時所執行的所有重要步驟。
Detail。記錄要求和回應的所有相關資訊。

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

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

重要：如果 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

參考資訊	值
資料類型	String
預設值	錯誤

檔名： uwsv_plugin_props.html