pluginConfiguration - Modul plug-in webového serveru (pluginConfiguration)

Vlastnosti použité při generování konfiguračního souboru modulu plug-in webového serveru

NameTypeDefaultDescription
pluginInstallRootstring/opt/IBM/WebSphere/PluginsUmístění instalace modulu plug-in webového serveru v systému souborů hostitele webového serveru
webserverNamestringwebserver1Název webového serveru, kde se použije tato konfigurace. Slouží k vygenerování umístění souboru protokolu modulu plug-in, pokud není explicitně určeno názvem nebo adresářem souboru protokolu.
webserverPortint
Min: -1

Max: 65535
80Port webového serveru HTTP
webserverSecurePortint
Min: -1

Max: 65535
443Port webového serveru HTTPS
sslKeyringLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.kdbÚplná cesta k souboru SSL keyring na hostiteli webového serveru
sslStashfileLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.sthÚplná cesta k souboru pro dočasné ukládání SSL na hostiteli webového serveru
sslCertlabelstringUrčuje jmenovku certifikátu v souboru soubor svazku klíčů, jenž má modul plug-in použít, když webový kontejner vyžaduje certifikát od modulu plug-in.
ipv6PreferredbooleanfalseUmožňuje interpretovat název hostitele aplikačního serveru {null} nebo {0} tak, aby se upřednostnil typ adresy, je-li to možné
httpEndpointRefOdkaz na prvek nejvyšší úrovně httpEndpoint (řetězec).defaultHttpEndpointUrčete identifikátor koncového bodu http, který se má začlenit v generovaném souboru plugin-cfg.xml. Koncový bod definuje server v klastru. Výchozí hodnota je 'defaultHttpEndpoint'.
connectTimeoutČasové období s přesností na sekundy5sIdentifikuje maximální dobu, po kterou aplikační server může spravovat připojení k webovému serveru. Zadejte kladné celé číslo následované jednotkou času, což může být hodina (h), minuta (m) nebo sekunda (s). Například 30 sekund zadejte jako 30s. Do jedné položky můžete zahrnout více hodnot. Například 1m30s je ekvivalentní 90 sekundám.
serverIOTimeoutČasové období s přesností na sekundy900sIdentifikuje maximální dobu, po kterou modul plug-in webovému serveru čeká na odeslání požadavku nebo přijetí odezvy z aplikačního serveru. Zadejte kladné celé číslo následované jednotkou času, což může být hodina (h), minuta (m) nebo sekunda (s). Například 30 sekund zadejte jako 30s. Do jedné položky můžete zahrnout více hodnot. Například 1m30s je ekvivalentní 90 sekundám.
wsServerIOTimeoutČasové období s přesností na sekundyIdentifikuje maximální dobu, po kterou modul plug-in webovému serveru čeká na odeslání požadavku nebo přijetí odezvy webového soketu z aplikačního serveru. Zadejte kladné celé číslo následované jednotkou času, což může být hodina (h), minuta (m) nebo sekunda (s). Například 30 sekund zadejte jako 30s. Do jedné položky můžete zahrnout více hodnot. Například 1m30s je ekvivalentní 90 sekundám.
wsServerIdleTimeoutČasové období s přesností na sekundyIdentifikuje maximální dobu, po kterou modul plug-in webovému serveru čeká na ukončení nečinného připojení k webovému soketu. Zadejte kladné celé číslo následované jednotkou času, což může být hodina (h), minuta (m) nebo sekunda (s). Například 30 sekund zadejte jako 30s. Do jedné položky můžete zahrnout více hodnot. Například 1m30s je ekvivalentní 90 sekundám.
extendedHandshakebooleanfalseMá-li hodnotu true, bude modul plug-in webového serveru používat rozšířené navázání komunikace k určení, zda je aplikační server spuštěný.
waitForContinuebooleanfalseMá-li hodnotu false (výchozí hodnota), bude modul plug-in webového serveru posílat záhlaví "Expect: 100-continue" s každým požadavkem HTTP, který má tělo zprávy. Má-li hodnotu true, bude modul plug-in webového serveru posílat záhlaví "Expect: 100-continue" s každým požadavkem HTTP. Zvažte nastavení této hodnoty na true, pokud máte bránu firewall mezi webovým serverem a aplikací, které jsou citlivé na opakované požadavky bez těla zprávy.
logFileNameCesta k souboruÚplná cesta k souboru protokolu modulu plug-in webového serveru. Komponenta adresáře již musí existovat. V případě webových serverů typu Apache, je cesta, která začíná znakem propojení, interpretována jako externí propojený modul protokolování. Při určení se potlačí cesta umístění logDirLocation.
logDirLocationCesta k adresáři${pluginInstallRoot}/logs/${webserverName}Zamítnuto: Identifikuje adresář, kde je umístěn soubor http_plugin.log. Viz název souboru protokolu.
serverIOTimeoutRetryint
Min: -1

Max: 65535
-1Omezuje počet opakování žádosti po časovém limitu čtení nebo zápisu. Výchozí hodnota je {-1}. Při ní se neuplatní žádné další limity a opakování jsou omezena počtem dostupných serverů v klastru. Hodnota {0} indikuje, že by neměla být žádná opakování. Tato hodnota je vymezena velikostí serverového klastru a neuplatňuje se na selhání připojení nebo vypršení časového limitu u časových limitů připojení modulu plug-in HTTP či webového soketu.
loadBalanceWeightint20Tato hodnota se za běhu dynamicky mění. Váha serveru se snižuje vždy, když je mu přiřazen požadavek. Když váhy všech serverů klesnou na hodnotu 0 nebo na nižší hodnotu, modul plug-in webového serveru upraví všechny váhy tak, aby byly větší než 0.
serverRole
  • BACKUP
  • PRIMARY
PRIMARYRole serveru identifikuje server jako primární nebo záložní. Když jsou k dispozici primární servery, používá modul plug-in webového serveru tyto servery k vyrovnání zátěže a překonání selhání . Pokud však není k dispozici žádný z primárních serverů, modul plug-in webového serveru používá k vyrovnání zátěže a překonání selhání pouze záložní servery.
BACKUP
Záložní
PRIMARY
Primární
ESIEnablebooleantrueVlastnost ESIEnable umožňuje zpracování typu ESI (Edge Side Include) k uložení odezev do mezipaměti. Tato vlastnost nabízí volbu k zakázání ESI v konfiguračním souboru modulu plug-in webového serveru.
ESIMaxCacheSizeint1024Vlastnost ESIMaxCacheSize určuje maximální velikost mezipaměti s výchozím nastavením na 1 MB. Tato vlastnost umožňuje potlačit hodnotu v konfiguračním souboru modulu plug-in webového serveru.
ESIInvalidationMonitorbooleanfalseVlastnost ESIInvalidationMonitor určuje, zda má procesor ESI přijmout zneplatnění z aplikačního serveru. Tato vlastnost umožňuje potlačit hodnotu v konfiguračním souboru modulu plug-in webového serveru.
ESIEnableToPassCookiesbooleanfalseVlastnost ESIEnableToPassCookies umožňuje předání souborů cookie relace do aplikačního serveru WebSphere Application Server. Tato vlastnost umožňuje potlačit hodnotu v konfiguračním souboru modulu plug-in webového serveru.
trustedProxyEnablebooleanPovolí použití důvěryhodných serverů proxy. Je-li tato vlastnost zadána, přepíše vlastnost hodnotu v konfiguračním souboru modulu plug-in webového serveru.
trustedProxyGroupstringSeznam důvěryhodných serverů proxy oddělený čárkami. Je-li tato vlastnost zadána, přepíše vlastnost hodnotu v konfiguračním souboru modulu plug-in webového serveru.

httpEndpoint

Určete identifikátor koncového bodu http, který se má začlenit v generovaném souboru plugin-cfg.xml. Koncový bod definuje server v klastru. Výchozí hodnota je 'defaultHttpEndpoint'.

NameTypeDefaultDescription
onError
  • IGNORE
  • WARN
  • FAIL
WARNAkce prováděná po neúspěšném spuštěná koncového bodu.
IGNORE
Server při rozpoznání chyby konfigurace nevygeneruje varovné ani chybové zprávy.
WARN
Server při rozpoznání chyby konfigurace vygeneruje varovné a chybové zprávy.
FAIL
Server při rozpoznání prvního výskytu chyby konfigurace vygeneruje varovnou či chybovou zprávu a poté se zastaví.
enabledbooleantruePřepíná dostupnost koncového bodu. Pokud má hodnotu true, dispečer aktivuje tento koncový bod ke zpracování požadavků HTTP.
hoststringlocalhostAdresa IP, název hostitele DNS (Domain Name Server) s příponou názvu domény nebo jen název hostitele DNS používaný klientem k vyžádání prostředku. Pro všechna dostupná síťová rozhraní použijte '*'.
httpPortint
Min: -1

Max: 65535
Port použitý pro požadavky HTTP klienta. Chcete-li tento port zakázat, použijte hodnotu -1.
httpsPortint
Min: -1

Max: 65535
Port použitý pro požadavky HTTP klienta zabezpečený prostřednictvím protokolu SSL (https). Chcete-li tento port zakázat, použijte hodnotu -1.
httpOptionsRefOdkaz na prvek nejvyšší úrovně httpOptions (řetězec).defaultHttpOptionsVolby protokolu HTTP koncového bodu.
sslOptionsRefOdkaz na prvek nejvyšší úrovně sslOptions (řetězec).Volby protokolu SSL koncového bodu.
tcpOptionsRefOdkaz na prvek nejvyšší úrovně tcpOptions (řetězec).defaultTCPOptionsVolby protokolu TCP koncového bodu.
accessLoggingRefOdkaz na prvek nejvyšší úrovně httpAccessLogging (řetězec).Konfigurace protokolování přístupu HTTP pro koncový bod.

httpEndpoint > httpOptions

Volby protokolu HTTP koncového bodu.

NameTypeDefaultDescription
keepAliveEnabledbooleantruePovolí trvalá připojení (udržení aktivity HTTP). Pokud má hodnotu true, je pomocí vícenásobných sekvenčních požadavků a odezev udržována aktivita připojení pro opětovné použití. Pokud má hodnotu false, připojení jsou po odeslání odezvy uzavřena.
maxKeepAliveRequestsint
Min: -1
100Určuje maximální počet trvalých požadavků povolený pro jedno připojení HTTP, pokud jsou povolena trvalá připojení. Hodnota -1 znamená neomezený počet.
persistTimeoutČasové období s přesností na sekundy30sDoba, po kterou může soket zůstat v nečinnosti mezi jednotlivými požadavky. Toto nastavení platí pouze, pokud jsou povolena trvalá připojení. Zadejte kladné celé číslo následované jednotkou času, což může být hodina (h), minuta (m) nebo sekunda (s). Například 30 sekund zadejte jako 30s. Do jedné položky můžete zahrnout více hodnot. Například 1m30s je ekvivalentní 90 sekundám.
readTimeoutČasové období s přesností na sekundy60sDoba čekání na zpracování požadavku na čtení v soketu po prvním čtení. Zadejte kladné celé číslo následované jednotkou času, což může být hodina (h), minuta (m) nebo sekunda (s). Například 30 sekund zadejte jako 30s. Do jedné položky můžete zahrnout více hodnot. Například 1m30s je ekvivalentní 90 sekundám.
writeTimeoutČasové období s přesností na sekundy60sDoba čekání na přenesení jednotlivých částí dat odpovědi prostřednictvím soketu. Zadejte kladné celé číslo následované jednotkou času, což může být hodina (h), minuta (m) nebo sekunda (s). Například 30 sekund zadejte jako 30s. Do jedné položky můžete zahrnout více hodnot. Například 1m30s je ekvivalentní 90 sekundám.
removeServerHeaderbooleanfalseOdebírá informace o implementaci serveru ze záhlaví HTTP a rovněž zakazuje úvodní stránku profilu Liberty.
NoCacheCookiesControlbooleantrueUmožňuje uživateli určit, zda má přítomnost záhlaví Set-Cookie aktualizovat záhlaví Cache-Control odpovídající no-cache hodnotou. Tato možnost také přidává záhlaví Expires.
AutoDecompressionbooleantrueUrčuje, zda kanál HTTP automaticky dekomprimuje data těla příchozích požadavků.

httpEndpoint > sslOptions

Volby protokolu SSL koncového bodu.

NameTypeDefaultDescription
sessionTimeoutČasové období s přesností na sekundy1dDoba, kterou se má počkat, než bude požadavek čtení nebo zápisu na soketu dokončen. Tato hodnota je potlačena časovými limity specifickými pro protokol. Zadejte kladné celé číslo následované jednotkou času, což může být hodina (h), minuta (m) nebo sekunda (s). Například 30 sekund zadejte jako 30s. Do jedné položky můžete zahrnout více hodnot. Například 1m30s je ekvivalentní 90 sekundám.
suppressHandshakeErrorsbooleanfalseZakázat protokolování chyb navázání komunikace přes zabezpečení SSL. K chybám navázání komunikace přes zabezpečení SSL může při normálním provozu docházet, ale tyto zprávy mohou být důležité, když se SSL chová nečekaným způsobem.
sslRefOdkaz na prvek nejvyšší úrovně ssl (řetězec).Repertoár konfigurace výchozího SSL. Výchozí hodnota je defaultSSLSettings.
sslSessionTimeoutČasové období s přesností na milisekundy8640msČasový limit relace SSL zřízené kanálem SSL. Zadejte kladné celé číslo následované jednotkou času, což může být hodina (h), minuta (m), sekunda (s) nebo milisekunda (ms). Například 500 milisekund zadejte jako 500ms. Do jedné položky můžete zahrnout více hodnot. Například 1s500ms je ekvivalentní 1,5 sekundy.

httpEndpoint > tcpOptions

Volby protokolu TCP koncového bodu.

NameTypeDefaultDescription
inactivityTimeoutČasové období s přesností na milisekundy60sDoba, kterou se má počkat, než bude požadavek čtení nebo zápisu na soketu dokončen. Tato hodnota je potlačena časovými limity specifickými pro protokol. Zadejte kladné celé číslo následované jednotkou času, což může být hodina (h), minuta (m), sekunda (s) nebo milisekunda (ms). Například 500 milisekund zadejte jako 500ms. Do jedné položky můžete zahrnout více hodnot. Například 1s500ms je ekvivalentní 1,5 sekundy.
soReuseAddrbooleantrueUmožňuje okamžité převázání na port bez aktivního listeneru.
addressIncludeListstringSeznam adres oddělený čárkami, kterým je povoleno navazovat příchozí připojení v tomto koncovém bodu. Zadat můžete adresu IPv4 nebo IPv6. Všechny hodnoty v adresách IPv4 nebo IPv6 musí být vyjádřeny číslem nebo zástupným znakem hvězdičky.
addressExcludeListstringSeznam adres oddělený čárkami, kterým není povoleno navazovat příchozí připojení v tomto koncovém bodu. Zadat můžete adresu IPv4 nebo IPv6. Všechny hodnoty v adresách IPv4 nebo IPv6 musí být vyjádřeny číslem nebo zástupným znakem hvězdičky.
hostNameIncludeListstringSeznam názvů hostitelů oddělený čárkami, kterým je povoleno navazovat příchozí připojení v tomto koncovém bodu. Názvy hostitelů rozlišují velká a malá písmena a mohou začínat hvězdičkou, což je zástupný znak. Nicméně hvězdičky nemohou být v názvu hostitele na jiném místě. Např. *.abc.com je platné, ale *.abc.* platné není.
hostNameExcludeListstringSeznam názvů hostitelů oddělený čárkami, kterým není povoleno navazovat příchozí připojení v tomto koncovém bodu. Názvy hostitelů rozlišují velká a malá písmena a mohou začínat hvězdičkou, což je zástupný znak. Nicméně hvězdičky nemohou být v názvu hostitele na jiném místě. Např. *.abc.com je platné, ale *.abc.* platné není.

httpEndpoint > accessLogging

Konfigurace protokolování přístupu HTTP pro koncový bod.

NameTypeDefaultDescription
enabledbooleantruePovoluje protokolování přístupu.
filePathCesta k souboru${server.output.dir}/logs/http_access.logCesta k adresáři s názvem souboru protokolu přístupu. Při zadávání cesty k adresáři lze použít standardní substituce proměnných, jako například ${server.output.dir}.
logFormatstring%h %u %{t}W "%r" %s %bUrčuje formát protokolu, jenž má být použit k protokolování informací o klientském přístupu.
maxFileSizeint
Min: 0
20Maximální velikost souboru protokolu v megabajtech před založením nového souboru. Hodnota 0 znamená neomezenou velikost.
maxFilesint
Min: 0
2Maximální počet souborů protokolu, které budou uchovány před tím, než bude odebrán nejstarší soubor. Hodnota 0 znamená neomezený počet.

extraConfigProperties

Další vlastnosti, které se mají přidat do prvku Config ve vygenerovaném konfiguračním souboru modulu plug-in. Tyto vlastnosti může určit podpora IBM k úpravě chování modulu plug-in webového serveru.