Web 伺服器外掛程式 (pluginConfiguration)
產生 Web 伺服器外掛程式配置檔時所用的內容
| 屬性名稱 | 資料類型 | 預設值 | 說明 |
|---|---|---|---|
| connectTimeout | 具有秒精準度的時間量 | 5s | 識別應用程式伺服器應維護 Web 伺服器連線的時間量上限。請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m) 或秒 (s)。 例如,30 秒指定為 30s。 單一項目可以包含多個值。比方說,1m30s 相當於 90 秒。 |
| extendedHandshake | 布林 | false | 若為 true,Web 伺服器外掛程式會使用延伸信號交換,來判斷應用程式伺服器是否正在執行。 |
| httpEndpointRef | 最上層 httpEndpoint 元素的參照(字串)。 | defaultHttpEndpoint | 指定 HTTP 端點 ID,以包含在產生的 plugin-cfg.xml 檔中。端點是定義叢集中的伺服器。預設值為 'defaultHttpEndpoint'。 |
| ipv6Preferred | 布林 | false | 在解析應用程式伺服器主機名稱 {null} 或 {0} 時使用,以便在可能之時,設定偏好的位址類型 |
| logDirLocation | 目錄的路徑 | 已淘汰:識別 http_plugin.log 檔的所在目錄。請參閱「日誌檔名稱」。 | |
| logFileName | 檔案的路徑 | ${pluginInstallRoot}/logs/${webserverName}/http_plugin.log | Web 伺服器外掛程式日誌檔的完整路徑。 目錄元件必須已存在。 如果是 Apache 型 Web 伺服器,開頭為垂直線字元的路徑會解譯為外部管道的日誌程式。 如果指定的話,這個路徑會置換 logDirLocation。 |
| pluginInstallRoot | 字串 | /opt/IBM/WebSphere/Plugins | Web 伺服器外掛程式在 Web 伺服器主機檔案系統中的安裝位置 |
| serverIOTimeout | 具有秒精準度的時間量 | 900s | 識別 Web 伺服器外掛程式等待傳送要求或接收應用程式伺服器回應的時間量上限。請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m) 或秒 (s)。 例如,30 秒指定為 30s。 單一項目可以包含多個值。比方說,1m30s 相當於 90 秒。 |
| serverIOTimeoutRetry | int 下限:-1 上限:65535 |
-1 | 限制讀取或寫入逾時之後的要求重試次數。 預設值 {-1} 不會套用任何其他限制,因此,重試次數會受限於叢集中可用伺服器的數目。 {0} 值指示不應該重試。 這個值的範圍限於伺服器叢集,不適用於因 HTTP 外掛程式連線逾時而導致的連線失敗或逾時,也不適用於 Web Socket 逾時。 |
| sslCertlabel | 字串 | 在金鑰環內指定憑證的標籤,當 Web 儲存器向外掛程式要求用戶端憑證時,供外掛程式使用。 | |
| sslKeyringLocation | 字串 | ${pluginInstallRoot}/config/${webserverName}/plugin-key.kdb | Web 伺服器主機上 SSL 金鑰環檔案的完整路徑 |
| sslStashfileLocation | 字串 | ${pluginInstallRoot}/config/${webserverName}/plugin-key.sth | Web 伺服器主機上 SSL 隱藏檔的完整路徑 |
| waitForContinue | 布林 | false | 若為 false(預設值),Web 伺服器外掛程式會將 "Expect: 100-continue" 標頭隨著具有訊息內文的 HTTP 要求一起傳送。當設為 true,Web 伺服器外掛程式會將 "Expect: 100-continue" 標頭隨著每一項 HTTP 要求一起傳送。如果您在 Web 伺服器和應用程式伺服器之間有防火牆,而且介意在沒有要求內文的情況下重試要求,請考量將此值設為 true。 |
| webserverName | 字串 | webserver1 | 將使用此配置的 Web 伺服器名稱。 在日誌檔名稱或目錄未明確指定外掛程式日誌檔位置時,用來產生該位置。 |
| webserverPort | int 下限:-1 上限:65535 |
80 | Web 伺服器 HTTP 埠 |
| webserverSecurePort | int 下限:-1 上限:65535 |
443 | Web 伺服器 HTTPS 埠 |
| wsServerIOTimeout | 具有秒精準度的時間量 | 識別 Web 伺服器外掛程式等待傳送要求或接收應用程式伺服器 WebSocket 回應的時間量上限。請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m) 或秒 (s)。 例如,30 秒指定為 30s。 單一項目可以包含多個值。比方說,1m30s 相當於 90 秒。 | |
| wsServerIdleTimeout | 具有秒精準度的時間量 | 識別 Web 伺服器外掛程式等待終止閒置 WebSocket 連線的時間量上限。請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m) 或秒 (s)。 例如,30 秒指定為 30s。 單一項目可以包含多個值。比方說,1m30s 相當於 90 秒。 |
- httpEndpoint
說明: 指定 HTTP 端點 ID,以包含在產生的 plugin-cfg.xml 檔中。端點是定義叢集中的伺服器。預設值為 'defaultHttpEndpoint'。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 accessLoggingRef 最上層 httpAccessLogging 元素的參照(字串)。 端點的 HTTP 存取記載配置。 已啟用 布林 True 切換端點的可用性。 當設為 true 時,分派器會啟動這個端點來處理 HTTP 要求。 host 字串 localhost 用戶端用來要求資源的 IP 位址、含網域名稱字尾的網域名稱伺服器 (DNS) 主機名稱,或只有 DNS 主機名稱。 使用 '*' 作為所有可用的網路介面。 httpOptionsRef 最上層 httpOptions 元素的參照(字串)。 defaultHttpOptions 端點的 HTTP 通訊協定選項。 httpPort int 下限:-1
上限:65535
用戶端 HTTP 要求所用的埠。使用 -1 停用這個埠。 httpsPort int 下限:-1
上限:65535
受 SSL 保護的用戶端 HTTP 要求 (https) 所用的埠。 使用 -1 停用這個埠。 onError - IGNORE
- FAIL
- WARN
WARN 啟動端點失敗之後,要採取的動作。 - IGNORE
- 當伺服器發現配置錯誤時,不發出任何警告和錯誤訊息。
- FAIL
- 第一次出現錯誤時,伺服器發出警告或錯誤訊息,然後停止。
- WARN
- 當伺服器發現配置錯誤時,發出警告和錯誤訊息。
sslOptionsRef 最上層 sslOptions 元素的參照(字串)。 端點的 SSL 通訊協定選項。 tcpOptionsRef 最上層 tcpOptions 元素的參照(字串)。 defaultTCPOptions 端點的 TCP 通訊協定選項。 - httpEndpoint > accessLogging
說明: 端點的 HTTP 存取記載配置。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 已啟用 布林 True 啟用存取記載。 filePath 檔案的路徑 ${server.output.dir}/logs/http_access.log 存取日誌檔的目錄路徑和名稱。 指定目錄路徑時,可以使用標準變數替代項目,例如 ${server.output.dir}。 logFormat 字串 %h %u %{t}W "%r" %s %b 指定記載用戶端存取資訊時,所用的日誌格式。 maxFileSize int 下限:0
20 日誌檔在輪替之前的大小上限 (MB);0 值表示無限制。 maxFiles int 下限:0
2 在移除最舊的檔案之前,所要保存的日誌檔數目上限;0 值表示無限制。
- httpEndpoint > httpOptions
說明: 端點的 HTTP 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 keepAliveEnabled 布林 True 啟用持續連線(HTTP 保持作用中)。 如果是 true,連線會保持作用中,供多個循序的要求和回應重複使用。 如果是 false,傳回回應之後,連線會關閉。 maxKeepAliveRequests int 下限:-1
100 在啟用持續連線的情況下,單一 HTTP 連線所接受的持續要求數目上限。 -1 值表示無限制。 persistTimeout 具有秒精準度的時間量 30s 在要求之間,Socket 可以維持閒置的時間量。 只有在啟用持續連線之時,這個設定才適用。 請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m) 或秒 (s)。 例如,30 秒指定為 30s。 單一項目可以包含多個值。比方說,1m30s 相當於 90 秒。 readTimeout 具有秒精準度的時間量 60s 在進行第一次讀取之後,在 Socket 上等待讀取要求完成的時間量。 請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m) 或秒 (s)。 例如,30 秒指定為 30s。 單一項目可以包含多個值。比方說,1m30s 相當於 90 秒。 removeServerHeader 布林 false 將伺服器實作資訊從 HTTP 標頭移除,同時停用預設的 Liberty 設定檔歡迎使用頁面。 writeTimeout 具有秒精準度的時間量 60s 在 Socket 上等待傳輸每部分回應資料的時間量。 請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m) 或秒 (s)。 例如,30 秒指定為 30s。 單一項目可以包含多個值。比方說,1m30s 相當於 90 秒。
- httpEndpoint > sslOptions
說明: 端點的 SSL 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 sessionTimeout 具有秒精準度的時間量 1d 在 Socket 上等待讀寫要求完成的時間量。通訊協定特定的逾時會置換這個值。請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m) 或秒 (s)。 例如,30 秒指定為 30s。 單一項目可以包含多個值。比方說,1m30s 相當於 90 秒。 sslRef 最上層 ssl 元素的參照(字串)。 預設 SSL 配置儲存庫。預設值為 defaultSSLSettings。 suppressHandshakeErrors 布林 false 停用 SSL 信號交換錯誤的記載。SSL 信號交換錯誤有可能出現在正常作業期間,不過,當 SSL 行為不符合預期時,這些訊息可能很有用。
- httpEndpoint > tcpOptions
說明: 端點的 TCP 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 inactivityTimeout 具有毫秒精準度的時間量 60s 在 Socket 上等待讀寫要求完成的時間量。通訊協定特定的逾時會置換這個值。請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m)、秒 (s) 或毫秒 (ms)。 例如,500 毫秒指定為 500ms。 單一項目可以包含多個值。比方說,1s500ms 相當於 1.5 秒。 soReuseAddr 布林 True 在沒有作用中接聽器的情況下,能夠立即重新連結至某個埠。
參照主題