Web 伺服器外掛程式 (pluginConfiguration)
當產生 Web 伺服器外掛程式配置檔時使用內容
屬性名稱 | 資料類型 | 預設值 | 說明 |
---|---|---|---|
connectTimeout | 精準度是秒鐘的時間量 | 5s | 識別應用程式伺服器應維護 Web 伺服器連線的時間量上限。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 |
extendedHandshake | boolean | false | 若為 true,Web 伺服器外掛程式會使用延伸信號交換,來判斷應用程式伺服器是否正在執行。 |
httpEndpointRef | 最上層 httpEndpoint 元素的參照(字串)。 | defaultHttpEndpoint | 指定要在產生的 plugin-cfg.xml 檔中包含的 HTTP 端點的 ID。端點定義叢集中的伺服器。預設值是 'defaultHttpEndpoint'。 |
ipv6Preferred | boolean | false | 在解析 {null} 或 {0} 的應用程式伺服器主機名稱時使用,以選擇偏好的位址類型(如果可能的話) |
loadBalanceWeight | int | 20 | %plugin.loadBalanceWeight.desc |
logDirLocation | 目錄的路徑 | ${pluginInstallRoot}/logs/${webserverName} | 已淘汰:識別 http_plugin.log 檔所在的目錄。請參閱日誌檔名稱。 |
logFileName | 檔案的路徑 | Web 伺服器外掛程式日誌檔的完整路徑。目錄元件必須已存在。若為 Apache 型 Web 伺服器,會將以直線字元開頭的路徑解譯成外部管道日誌程式。若有指定此項,路徑會置換 logDirLocation。 | |
pluginInstallRoot | string | /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 逾時所造成的連線失敗或逾時。 |
serverRole |
|
PRIMARY | %plugin.serverRole.desc
|
sslCertlabel | string | 指定金鑰環內的憑證標籤,以便在 Web 儲存器向外掛程式要求用戶端憑證時,供外掛程式使用。 | |
sslKeyringLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.kdb | Web 伺服器主機上之 SSL 金鑰環檔案的完整路徑 |
sslStashfileLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.sth | Web 伺服器主機上之 SSL 隱藏檔的完整路徑 |
waitForContinue | boolean | false | 若為 false(預設值),Web 伺服器外掛程式在傳送含有訊息內文的 HTTP 要求時,會包含 "Expect: 100-continue" 標頭。如果設為 true,Web 伺服器外掛程式在傳送每一項 HTTP 要求時,都會包含 "Expect: 100-continue" 標頭。如果 Web 伺服器和應用程式伺服器之間存在防火牆,且動輒因沒有要求內容而重試要求,請考量將此值設為 true。 |
webserverName | string | 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 | 精準度是秒鐘的時間量 | 識別當終止閒置的 WebSocket 連線時,Web 伺服器外掛程式要等待的時間量上限。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 |
- extraConfigProperties
說明: 要在產生之外掛程式配置檔的 Config 元素中新增的其他內容。這些內容可以由 IBM 支援中心指定,以修改 Web 伺服器外掛程式的行為。必要: false資料類型:
- httpEndpoint
說明: 指定要在產生的 plugin-cfg.xml 檔中包含的 HTTP 端點的 ID。端點定義叢集中的伺服器。預設值是 'defaultHttpEndpoint'。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 accessLoggingRef 最上層 httpAccessLogging 元素的參照(字串)。 端點的 HTTP 存取記載配置。 enabled boolean true 切換此端點的可用性。如果是 true,分派器便會啟動這個端點來處理 HTTP 要求。 host string localhost 用戶端用來要求資源的 IP 位址、含網域名稱字尾的網域名稱伺服器 (DNS) 主機名稱,或只是 DNS 主機名稱。使用 '*' 來代表所有可用網路介面。 httpOptionsRef 最上層 httpOptions 元素的參照(字串)。 defaultHttpOptions 端點的 HTTP 通訊協定選項。 httpPort int 下限:-1
上限:65535
用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。 httpsPort int 下限:-1
上限:65535
受到 SSL (https) 保護的用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。 onError - IGNORE
- FAIL
- WARN
WARN 無法啟動端點之後要採取的動作。 - IGNORE
- 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
- FAIL
- 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
- WARN
- 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
sslOptionsRef 最上層 sslOptions 元素的參照(字串)。 端點的 SSL 通訊協定選項。 tcpOptionsRef 最上層 tcpOptions 元素的參照(字串)。 defaultTCPOptions 端點的 TCP 通訊協定選項。 - httpEndpoint > accessLogging
說明: 端點的 HTTP 存取記載配置。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 enabled boolean true 啟用存取記載。 filePath 檔案的路徑 ${server.output.dir}/logs/http_access.log 存取日誌檔的目錄路徑和名稱。指定目錄路徑時,可以使用標準變數替代項目,例如 ${server.output.dir}。 logFormat string %h %u %{t}W "%r" %s %b 指定記載用戶端存取資訊時要使用的日誌格式。 maxFileSize int 下限:0
20 日誌檔在輪替之前的大小上限 (MB);0 值表示無限制。 maxFiles int 下限:0
2 在移除最舊檔案之前,將保留的日誌檔數目上限;0 值表示無限制。
- httpEndpoint > httpOptions
說明: 端點的 HTTP 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 keepAliveEnabled boolean 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 boolean 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。 sslSessionTimeout 精準度是毫秒的時間量 8640ms %ssl.sslSessionTimeout.desc. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 suppressHandshakeErrors boolean false 停用 SSL 信號交換記載錯誤。在正常作業期間可能會發生 SSL 信號交換錯誤,不過當 SSL 的行為並非所預期時,這些訊息可能會非常有用。
- httpEndpoint > tcpOptions
說明: 端點的 TCP 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 inactivityTimeout 精準度是毫秒的時間量 60s 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 soReuseAddr boolean true 在沒有作用中接聽器的情況下,能夠立即重新連結至埠。