當產生 Web 伺服器外掛程式配置檔時使用內容
Name | Type | Default | Description |
---|---|---|---|
pluginInstallRoot | string | /opt/IBM/WebSphere/Plugins | Web 伺服器主機檔案系統中的 Web 伺服器外掛程式位置 |
webserverName | string | webserver1 | 將使用這項配置的 Web 伺服器名稱。用來產生外掛程式日誌檔位置(如果日誌檔名稱或目錄未明確指定它)。 |
webserverPort | int Min: -1 Max: 65535 | 80 | Web 伺服器 HTTP 埠 |
webserverSecurePort | int Min: -1 Max: 65535 | 443 | Web 伺服器 HTTPS 埠 |
sslKeyringLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.kdb | Web 伺服器主機上之 SSL 金鑰環檔案的完整路徑 |
sslStashfileLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.sth | Web 伺服器主機上之 SSL 隱藏檔的完整路徑 |
sslCertlabel | string | 指定金鑰環內的憑證標籤,以便在 Web 儲存器向外掛程式要求用戶端憑證時,供外掛程式使用。 | |
ipv6Preferred | boolean | false | 在解析 {null} 或 {0} 的應用程式伺服器主機名稱時使用,以選擇偏好的位址類型(如果可能的話) |
httpEndpointRef | 最上層 httpEndpoint 元素的參照(字串)。 | defaultHttpEndpoint | 指定要在產生的 plugin-cfg.xml 檔中包含的 HTTP 端點的 ID。端點定義叢集中的伺服器。預設值是 'defaultHttpEndpoint'。 |
connectTimeout | 精準度是秒鐘的時間量 | 5s | 識別應用程式伺服器應維護 Web 伺服器連線的時間量上限。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 |
serverIOTimeout | 精準度是秒鐘的時間量 | 900s | 識別 Web 伺服器外掛程式在傳送要求或接收應用程式伺服器的回應時,應等待的時間量上限。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 |
wsServerIOTimeout | 精準度是秒鐘的時間量 | 識別 Web 伺服器外掛程式在傳送要求或接收應用程式伺服器的 WebSocket 回應時,應等待的時間量上限。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 | |
wsServerIdleTimeout | 精準度是秒鐘的時間量 | 識別當終止閒置的 WebSocket 連線時,Web 伺服器外掛程式要等待的時間量上限。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 | |
extendedHandshake | boolean | false | 若為 true,Web 伺服器外掛程式會使用延伸信號交換,來判斷應用程式伺服器是否正在執行。 |
waitForContinue | boolean | false | 若為 false(預設值),Web 伺服器外掛程式在傳送含有訊息內文的 HTTP 要求時,會包含 "Expect: 100-continue" 標頭。如果設為 true,Web 伺服器外掛程式在傳送每一項 HTTP 要求時,都會包含 "Expect: 100-continue" 標頭。如果 Web 伺服器和應用程式伺服器之間存在防火牆,且動輒因沒有要求內容而重試要求,請考量將此值設為 true。 |
logFileName | 檔案的路徑 | Web 伺服器外掛程式日誌檔的完整路徑。目錄元件必須已存在。若為 Apache 型 Web 伺服器,會將以直線字元開頭的路徑解譯成外部管道日誌程式。若有指定此項,路徑會置換 logDirLocation。 | |
logDirLocation | 目錄的路徑 | ${pluginInstallRoot}/logs/${webserverName} | 已淘汰:識別 http_plugin.log 檔所在的目錄。請參閱日誌檔名稱。 |
serverIOTimeoutRetry | int Min: -1 Max: 65535 | -1 | 限制讀取或寫入逾時之後的要求重試次數。若為預設值 {-1},則不套用其他的限制,因此會以叢集中的可用伺服器數目來限制重試次數。{0} 值表示不應重試。此值會將範圍限定為伺服器叢集,且不適用於因 HTTP 外掛程式連線逾時或 Web Socket 逾時所造成的連線失敗或逾時。 |
loadBalanceWeight | int | 20 | 在執行時期,此值會動態變更。每當將要求指派給伺服器時,伺服器的加權就會降低。當所有伺服器的所有加權降至 0 或更低的值時,Web 伺服器外掛程式會重新調整所有加權,使其大於 0。 |
serverRole |
| PRIMARY | 伺服器角色會將伺服器識別為主要或備份。當主要伺服器可用時,Web 伺服器外掛程式會使用它們進行負載平衡和失效接手。不過,如果沒有任何可用的主要伺服器,Web 伺服器外掛程式只會使用備份伺服器來進行負載平衡和失效接手。 BACKUP 備份 PRIMARY 主要 |
ESIEnable | boolean | true | ESIEnable 內容會啟用 Edge Side Include 處理程序,來快取回應。這個內容提供選項讓您在 Web 伺服器外掛程式配置檔中停用 ESI。 |
ESIMaxCacheSize | int | 1024 | ESIMaxCacheSize 是快取大小上限,預設值為 1MB。這個內容提供選項讓您置換 Web 伺服器外掛程式配置檔中的值。 |
ESIInvalidationMonitor | boolean | false | ESIInvalidationMonitor 指定 ESI 處理器是否應接收來自應用程式伺服器的失效通知。這個內容提供選項讓您置換 Web 伺服器外掛程式配置檔中的值。 |
ESIEnableToPassCookies | boolean | false | ESIEnableToPassCookies 容許將階段作業 Cookie 轉遞至 WebSphere Application Server。這個內容提供選項讓您置換 Web 伺服器外掛程式配置檔中的值。 |
trustedProxyEnable | boolean | 啟用要使用的授信 Proxy。若有指定,這個內容會置換 Web 伺服器外掛程式配置檔中的值。 | |
trustedProxyGroup | string | 以逗點區隔的授信 Proxy 清單。若有指定,這個內容會置換 Web 伺服器外掛程式配置檔中的值。 |
指定要在產生的 plugin-cfg.xml 檔中包含的 HTTP 端點的 ID。端點定義叢集中的伺服器。預設值是 'defaultHttpEndpoint'。
Name | Type | Default | Description |
---|---|---|---|
onError |
| WARN | 無法啟動端點之後要採取的動作。 IGNORE 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。 WARN 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。 FAIL 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。 |
enabled | boolean | true | 切換此端點的可用性。如果是 true,分派器便會啟動這個端點來處理 HTTP 要求。 |
host | string | localhost | 用戶端用來要求資源的 IP 位址、含網域名稱字尾的網域名稱伺服器 (DNS) 主機名稱,或只是 DNS 主機名稱。使用 '*' 來代表所有可用網路介面。 |
httpPort | int Min: -1 Max: 65535 | 用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。 | |
httpsPort | int Min: -1 Max: 65535 | 受到 SSL (https) 保護的用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。 | |
httpOptionsRef | 最上層 httpOptions 元素的參照(字串)。 | defaultHttpOptions | 端點的 HTTP 通訊協定選項。 |
sslOptionsRef | 最上層 sslOptions 元素的參照(字串)。 | 端點的 SSL 通訊協定選項。 | |
tcpOptionsRef | 最上層 tcpOptions 元素的參照(字串)。 | defaultTCPOptions | 端點的 TCP 通訊協定選項。 |
accessLoggingRef | 最上層 httpAccessLogging 元素的參照(字串)。 | 端點的 HTTP 存取記載配置。 |
端點的 HTTP 通訊協定選項。
Name | Type | Default | Description |
---|---|---|---|
keepAliveEnabled | boolean | true | 啟用持續性連線(HTTP 保持作用中)。如果是 true,連線會保持作用中,供多個循序要求和回應重複使用。如果是 false,則會送出回應之後關閉連線。 |
maxKeepAliveRequests | int Min: -1 | 100 | 啟用持續性連線時,單一 HTTP 連線所允許的持續性要求數目上限。值 -1 表示無限制。 |
persistTimeout | 精準度是秒鐘的時間量 | 30s | 允許 Socket 在要求之間保持閒置的時間量。只有在啟用持續性連線時,這項設定才適用。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 |
readTimeout | 精準度是秒鐘的時間量 | 60s | 在進行第一次讀取之後,在 Socket 上等待讀取要求完成的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 |
writeTimeout | 精準度是秒鐘的時間量 | 60s | 在 Socket 上等待傳輸每部分回應資料的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 |
removeServerHeader | boolean | false | 將伺服器實作資訊從 HTTP 標頭移除,同時停用預設的 Liberty 設定檔歡迎使用頁面。 |
NoCacheCookiesControl | boolean | true | 容許使用者控制 Set-Cookie 標頭的顯示狀態是否應以相符的「無快取」值來更新 Cache-Control 標頭。這也會新增 Expires 標頭。 |
AutoDecompression | boolean | true | 指定 HTTP 通道是否要自動解壓縮送入要求內文資料。 |
端點的 SSL 通訊協定選項。
Name | Type | Default | Description |
---|---|---|---|
sessionTimeout | 精準度是秒鐘的時間量 | 1d | 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 |
suppressHandshakeErrors | boolean | false | 停用 SSL 信號交換記載錯誤。在正常作業期間可能會發生 SSL 信號交換錯誤,不過當 SSL 的行為並非所預期時,這些訊息可能會非常有用。 |
sslRef | 最上層 ssl 元素的參照(字串)。 | 預設 SSL 配置儲存庫。預設值是 defaultSSLSettings。 | |
sslSessionTimeout | 精準度是毫秒的時間量 | 8640ms | 「SSL 通道」所建立之 SSL 階段作業的逾時限制。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 |
端點的 TCP 通訊協定選項。
Name | Type | Default | Description |
---|---|---|---|
inactivityTimeout | 精準度是毫秒的時間量 | 60s | 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 |
soReuseAddr | boolean | true | 在沒有作用中接聽器的情況下,能夠立即重新連結至埠。 |
addressIncludeList | string | 容許在這個端點上建立入埠連線的位址清單(以逗點區隔)。您可以指定 IPv4 或 IPv6 位址。IPv4 或 IPv6 位址中的所有值都必須用數字或星號萬用字元來表示。 | |
addressExcludeList | string | 不容許在這個端點上建立入埠連線的位址清單(以逗點區隔)。您可以指定 IPv4 或 IPv6 位址。IPv4 或 IPv6 位址中的所有值都必須用數字或星號萬用字元來表示。 | |
hostNameIncludeList | string | 容許在這個端點上建立入埠連線的主機名稱清單(以逗點區隔)。主機名稱不區分大小寫,且開頭可以是星號(作為萬用字元)。不過,星號不能位於主機名稱中的其他位置。例如,* abc.com 有效,但 *.abc.* 無效。 | |
hostNameExcludeList | string | 不容許在這個端點上建立入埠連線的主機名稱清單(以逗點區隔)。主機名稱不區分大小寫,且開頭可以是星號(作為萬用字元)。不過,星號不能位於主機名稱中的其他位置。例如,* abc.com 有效,但 *.abc.* 無效。 |
端點的 HTTP 存取記載配置。
Name | Type | Default | Description |
---|---|---|---|
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 Min: 0 | 20 | 日誌檔在輪替之前的大小上限 (MB);0 值表示無限制。 |
maxFiles | int Min: 0 | 2 | 在移除最舊檔案之前,將保留的日誌檔數目上限;0 值表示無限制。 |
要在產生之外掛程式配置檔的 Config 元素中新增的其他內容。這些內容可以由 IBM 支援中心指定,以修改 Web 伺服器外掛程式的行為。