pluginConfiguration - Web 伺服器外掛程式 (pluginConfiguration)

當產生 Web 伺服器外掛程式配置檔時使用內容

NameTypeDefaultDescription
pluginInstallRootstring/opt/IBM/WebSphere/PluginsWeb 伺服器主機檔案系統中的 Web 伺服器外掛程式位置
webserverNamestringwebserver1將使用這項配置的 Web 伺服器名稱。用來產生外掛程式日誌檔位置(如果日誌檔名稱或目錄未明確指定它)。
webserverPortint
Min: -1

Max: 65535
80Web 伺服器 HTTP 埠
webserverSecurePortint
Min: -1

Max: 65535
443Web 伺服器 HTTPS 埠
sslKeyringLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.kdbWeb 伺服器主機上之 SSL 金鑰環檔案的完整路徑
sslStashfileLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.sthWeb 伺服器主機上之 SSL 隱藏檔的完整路徑
sslCertlabelstring指定金鑰環內的憑證標籤,以便在 Web 儲存器向外掛程式要求用戶端憑證時,供外掛程式使用。
ipv6Preferredbooleanfalse在解析 {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 秒。
extendedHandshakebooleanfalse若為 true,Web 伺服器外掛程式會使用延伸信號交換,來判斷應用程式伺服器是否正在執行。
waitForContinuebooleanfalse若為 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 檔所在的目錄。請參閱日誌檔名稱。
serverIOTimeoutRetryint
Min: -1

Max: 65535
-1限制讀取或寫入逾時之後的要求重試次數。若為預設值 {-1},則不套用其他的限制,因此會以叢集中的可用伺服器數目來限制重試次數。{0} 值表示不應重試。此值會將範圍限定為伺服器叢集,且不適用於因 HTTP 外掛程式連線逾時或 Web Socket 逾時所造成的連線失敗或逾時。
loadBalanceWeightint20在執行時期,此值會動態變更。每當將要求指派給伺服器時,伺服器的加權就會降低。當所有伺服器的所有加權降至 0 或更低的值時,Web 伺服器外掛程式會重新調整所有加權,使其大於 0。
serverRole
  • BACKUP
  • PRIMARY
PRIMARY伺服器角色會將伺服器識別為主要或備份。當主要伺服器可用時,Web 伺服器外掛程式會使用它們進行負載平衡和失效接手。不過,如果沒有任何可用的主要伺服器,Web 伺服器外掛程式只會使用備份伺服器來進行負載平衡和失效接手。
BACKUP
備份
PRIMARY
主要
ESIEnablebooleantrueESIEnable 內容會啟用 Edge Side Include 處理程序,來快取回應。這個內容提供選項讓您在 Web 伺服器外掛程式配置檔中停用 ESI。
ESIMaxCacheSizeint1024ESIMaxCacheSize 是快取大小上限,預設值為 1MB。這個內容提供選項讓您置換 Web 伺服器外掛程式配置檔中的值。
ESIInvalidationMonitorbooleanfalseESIInvalidationMonitor 指定 ESI 處理器是否應接收來自應用程式伺服器的失效通知。這個內容提供選項讓您置換 Web 伺服器外掛程式配置檔中的值。
ESIEnableToPassCookiesbooleanfalseESIEnableToPassCookies 容許將階段作業 Cookie 轉遞至 WebSphere Application Server。這個內容提供選項讓您置換 Web 伺服器外掛程式配置檔中的值。
trustedProxyEnableboolean啟用要使用的授信 Proxy。若有指定,這個內容會置換 Web 伺服器外掛程式配置檔中的值。
trustedProxyGroupstring以逗點區隔的授信 Proxy 清單。若有指定,這個內容會置換 Web 伺服器外掛程式配置檔中的值。

httpEndpoint

指定要在產生的 plugin-cfg.xml 檔中包含的 HTTP 端點的 ID。端點定義叢集中的伺服器。預設值是 'defaultHttpEndpoint'。

NameTypeDefaultDescription
onError
  • IGNORE
  • WARN
  • FAIL
WARN無法啟動端點之後要採取的動作。
IGNORE
伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
WARN
伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
FAIL
伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
enabledbooleantrue切換此端點的可用性。如果是 true,分派器便會啟動這個端點來處理 HTTP 要求。
hoststringlocalhost用戶端用來要求資源的 IP 位址、含網域名稱字尾的網域名稱伺服器 (DNS) 主機名稱,或只是 DNS 主機名稱。使用 '*' 來代表所有可用網路介面。
httpPortint
Min: -1

Max: 65535
用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。
httpsPortint
Min: -1

Max: 65535
受到 SSL (https) 保護的用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。
httpOptionsRef最上層 httpOptions 元素的參照(字串)。defaultHttpOptions端點的 HTTP 通訊協定選項。
sslOptionsRef最上層 sslOptions 元素的參照(字串)。端點的 SSL 通訊協定選項。
tcpOptionsRef最上層 tcpOptions 元素的參照(字串)。defaultTCPOptions端點的 TCP 通訊協定選項。
accessLoggingRef最上層 httpAccessLogging 元素的參照(字串)。端點的 HTTP 存取記載配置。

httpEndpoint > httpOptions

端點的 HTTP 通訊協定選項。

NameTypeDefaultDescription
keepAliveEnabledbooleantrue啟用持續性連線(HTTP 保持作用中)。如果是 true,連線會保持作用中,供多個循序要求和回應重複使用。如果是 false,則會送出回應之後關閉連線。
maxKeepAliveRequestsint
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 秒。
removeServerHeaderbooleanfalse將伺服器實作資訊從 HTTP 標頭移除,同時停用預設的 Liberty 設定檔歡迎使用頁面。
NoCacheCookiesControlbooleantrue容許使用者控制 Set-Cookie 標頭的顯示狀態是否應以相符的「無快取」值來更新 Cache-Control 標頭。這也會新增 Expires 標頭。
AutoDecompressionbooleantrue指定 HTTP 通道是否要自動解壓縮送入要求內文資料。

httpEndpoint > sslOptions

端點的 SSL 通訊協定選項。

NameTypeDefaultDescription
sessionTimeout精準度是秒鐘的時間量1d在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
suppressHandshakeErrorsbooleanfalse停用 SSL 信號交換記載錯誤。在正常作業期間可能會發生 SSL 信號交換錯誤,不過當 SSL 的行為並非所預期時,這些訊息可能會非常有用。
sslRef最上層 ssl 元素的參照(字串)。預設 SSL 配置儲存庫。預設值是 defaultSSLSettings。
sslSessionTimeout精準度是毫秒的時間量8640ms「SSL 通道」所建立之 SSL 階段作業的逾時限制。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。

httpEndpoint > tcpOptions

端點的 TCP 通訊協定選項。

NameTypeDefaultDescription
inactivityTimeout精準度是毫秒的時間量60s在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
soReuseAddrbooleantrue在沒有作用中接聽器的情況下,能夠立即重新連結至埠。
addressIncludeListstring容許在這個端點上建立入埠連線的位址清單(以逗點區隔)。您可以指定 IPv4 或 IPv6 位址。IPv4 或 IPv6 位址中的所有值都必須用數字或星號萬用字元來表示。
addressExcludeListstring不容許在這個端點上建立入埠連線的位址清單(以逗點區隔)。您可以指定 IPv4 或 IPv6 位址。IPv4 或 IPv6 位址中的所有值都必須用數字或星號萬用字元來表示。
hostNameIncludeListstring容許在這個端點上建立入埠連線的主機名稱清單(以逗點區隔)。主機名稱不區分大小寫,且開頭可以是星號(作為萬用字元)。不過,星號不能位於主機名稱中的其他位置。例如,* abc.com 有效,但 *.abc.* 無效。
hostNameExcludeListstring不容許在這個端點上建立入埠連線的主機名稱清單(以逗點區隔)。主機名稱不區分大小寫,且開頭可以是星號(作為萬用字元)。不過,星號不能位於主機名稱中的其他位置。例如,* abc.com 有效,但 *.abc.* 無效。

httpEndpoint > accessLogging

端點的 HTTP 存取記載配置。

NameTypeDefaultDescription
enabledbooleantrue啟用存取記載。
filePath檔案的路徑${server.output.dir}/logs/http_access.log存取日誌檔的目錄路徑和名稱。指定目錄路徑時,可以使用標準變數替代項目,例如 ${server.output.dir}。
logFormatstring%h %u %{t}W "%r" %s %b指定記載用戶端存取資訊時要使用的日誌格式。
maxFileSizeint
Min: 0
20日誌檔在輪替之前的大小上限 (MB);0 值表示無限制。
maxFilesint
Min: 0
2在移除最舊檔案之前,將保留的日誌檔數目上限;0 值表示無限制。

extraConfigProperties

要在產生之外掛程式配置檔的 Config 元素中新增的其他內容。這些內容可以由 IBM 支援中心指定,以修改 Web 伺服器外掛程式的行為。