pluginConfiguration - Webkiszolgáló bedolgozó (pluginConfiguration)

A webkiszolgáló bedolgozó konfigurációs fájl előállítása során használt tulajdonságok

NameTypeDefaultDescription
pluginInstallRootstring/opt/IBM/WebSphere/PluginsA webkiszolgáló bedolgozó telepítési helye a webkiszolgáló hoszt fájlrendszerében.
webserverNamestringwebserver1A webkiszolgáló neve, amelynél a konfiguráció felhasználásra kerül. A bedolgozó naplófájl helyét állítja elő, ha kifejezetten naplófájl név vagy könyvtár nem lett megadva.
webserverPortint
Min: -1

Max: 65535
80Webkiszolgáló HTTP portja
webserverSecurePortint
Min: -1

Max: 65535
443Webkiszolgáló HTTPS portja
sslKeyringLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.kdbA teljes képzésű útvonal az SSL kulcscsomó fájlhoz a webkiszolgáló hoszton.
sslStashfileLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.sthA teljes képzésű útvonal az SSL kulcstároló fájlhoz a webkiszolgáló hoszton.
sslCertlabelstringMegadja a bedolgozó által a kulcscsomóban használandó tanúsítványcímkét, amikor a webtároló ügyféltanúsítványt kér a bedolgozótól.
ipv6PreferredlogikaifalseA {null} vagy {0} alkalmazáskiszolgáló hosztnév feloldása során kerül felhasználásra, előnyben részesítendő címtípus, amikor lehetséges.
httpEndpointRefHivatkozás a felső szintű httpEndpoint elemre (karaktersorozat).defaultHttpEndpointAz előállított plugin-cfg.xml fájlban szerepeltetendő http végpont azonosítóját. A végpont határozza meg a kiszolgálót a fürtben. Az alapértelmezett érték: 'defaultHttpEndpoint'.
connectTimeoutIdőtartam másodperces pontossággal5sAzonosítja a maximális időtartamot, ameddig az alkalmazáskiszolgálónak fenn kell tartania a kapcsolatot a webkiszolgálóval. Adjon meg egy egész számot, amelyet egy időegység követ, amely lehet óra (ó), perc (p) vagy másodperc (s). A 30 másodpercet például 30s formában adhatja meg. Egyetlen bejegyzésbe több értéket is belefoglalhat. Például 1p30s egyenértékű 90 másodperccel.
serverIOTimeoutIdőtartam másodperces pontossággal900sAzonosítja a maximális időtartamot, ameddig a webkiszolgáló bedolgozó vár egy kérés elküldésével, vagy egy válasz fogadására az alkalmazáskiszolgálótól. Adjon meg egy egész számot, amelyet egy időegység követ, amely lehet óra (ó), perc (p) vagy másodperc (s). A 30 másodpercet például 30s formában adhatja meg. Egyetlen bejegyzésbe több értéket is belefoglalhat. Például 1p30s egyenértékű 90 másodperccel.
wsServerIOTimeoutIdőtartam másodperces pontossággalAzonosítja a maximális időtartamot, ameddig a webkiszolgáló bedolgozó vár egy kérés elküldésével, vagy egy websocket válasz fogadására az alkalmazáskiszolgálótól. Adjon meg egy egész számot, amelyet egy időegység követ, amely lehet óra (ó), perc (p) vagy másodperc (s). A 30 másodpercet például 30s formában adhatja meg. Egyetlen bejegyzésbe több értéket is belefoglalhat. Például 1p30s egyenértékű 90 másodperccel.
wsServerIdleTimeoutIdőtartam másodperces pontossággalAz a maximális időtartam, amennyit a webkiszolgáló bedolgozó várakozik egy tétlen websocket kapcsolat lezárására. Adjon meg egy egész számot, amelyet egy időegység követ, amely lehet óra (ó), perc (p) vagy másodperc (s). A 30 másodpercet például 30s formában adhatja meg. Egyetlen bejegyzésbe több értéket is belefoglalhat. Például 1p30s egyenértékű 90 másodperccel.
extendedHandshakelogikaifalseHa a true értékre van beállítva, akkor a webkiszolgáló bedolgozó egy kiterjesztett kézfogást használ annak eldöntésére, hogy az alkalmazáskiszolgáló fut-e.
waitForContinuelogikaifalseHa a false értékre van beállítva (az alapértelmezett érték), akkor a webkiszolgáló bedolgozó az "Expect: 100-continue" fejlécet üzenettörzzsel rendelkező HTTP kérésekkel küldi el. Ha a true értékre van beállítva, akkor a webkiszolgáló bedolgozó az "Expect: 100-continue" fejlécet minden HTTP kéréssel elküldi. Fontolja meg a true érték beállítását, ha tűzfallal rendelkezik a webkiszolgáló és az alkalmazáskiszolgáló között, és érzékeny a törzzsel nem rendelkező kérések újrapróbálkozásaira.
logFileNameFájl elérési útvonalaEgy teljes képzésű útvonal a webkiszolgáló bedolgozó naplófájljához. A könyvtár összetevőnek már léteznie kell. Az Apache-alapú webkiszolgálók esetében a függőleges vonal karakterrel kezdődő útvonal külső adatcsatornás naplózót jelent. Ha az útvonal meg van adva, akkor felülírja a logDirLocation paramétert.
logDirLocationKönyvtár elérési útvonala${pluginInstallRoot}/logs/${webserverName}Elavult: Azt a könyvtárat azonosítja, amelyben a http_plugin.log fájl található. Lásd naplófájlnév.
serverIOTimeoutRetryint
Min: -1

Max: 65535
-1Korlátozza a kérések újrapróbálásának számát olvasási vagy írási időtúllépés után. Az alapértelmezett érték {-1}, nem alkalmaz további korlátot, az újbóli kísérletek számát így a fürtben elérhető kiszolgálók száma határozza meg. A {0} érték jelzi, hogy több kísérlet nem lehetséges. Ez az érték a kiszolgálófürt hatásköre, és nem vonatkozik a HTTP bedolgozó kapcsolódási időtúllépés miatti kapcsolódási hibákra vagy időtúllépésekre, illetve a websocket időtúllépésekre.
loadBalanceWeightegész szám20Ez az érték futás közben dinamikusan változik. A kiszolgáló súlya minden alkalommal csökken, amikor kérést rendelnek az adott kiszolgálóhoz. Ha az összes kiszolgáló összes súlya 0 vagy kisebb értékre csökken, akkor a webkiszolgáló bedolgozó beállítja az összes súlyt, hogy nullánál nagyobbak legyenek.
serverRole
  • BACKUP
  • PRIMARY
PRIMARYA kiszolgálói szerepkör elsődlegesként vagy tartalékként azonosít egy kiszolgálót. Ha elérhetők elsődleges kiszolgálók, akkor a webkiszolgáló bedolgozó azokat használja terheléskiegyenlítésre és átállásra. Azonban, ha egy elsődleges kiszolgáló sem érhető el, akkor a webkiszolgáló bedolgozó csak tartalék kiszolgálókat használ terheléskiegyenlítésre és átállásra.
BACKUP
Tartalék
PRIMARY
Elsődleges
ESIEnablelogikaitrueAz ESIEnable tulajdonság lehetővé teszi az Edge Side Include feldolgozást a válaszok gyorsítótárazására. A tulajdonság az ESI letiltását is lehetővé teszi a webkiszolgáló bedolgozó konfigurációs fájlban.
ESIMaxCacheSizeegész szám1024Az ESIMaxCacheSize a gyorsítótár maximális mérete, amely alapértelmezésben 1MB. A tulajdonság az érték felülírását is lehetővé teszi a webkiszolgáló bedolgozó konfigurációs fájlban.
ESIInvalidationMonitorlogikaifalseAz ESIInvalidationMonitor meghatározza, hogy az ESI feldolgozó fogadhat-e érvénytelenítéseket az alkalmazáskiszolgálótól. A tulajdonság az érték felülírását is lehetővé teszi a webkiszolgáló bedolgozó konfigurációs fájlban.
ESIEnableToPassCookieslogikaifalseAz ESIEnableToPassCookies lehetővé teszi a munkamenet cookie-k továbbítását a WebSphere alkalmazáskiszolgálónak. A tulajdonság az érték felülírását is lehetővé teszi a webkiszolgáló bedolgozó konfigurációs fájlban.
trustedProxyEnablelogikaiA használandó megbízható proxykat engedélyezi. Ha meg van adva, akkor ez a tulajdonság felülírja a webkiszolgáló bedolgozó konfigurációs fájlban található értéket.
trustedProxyGroupstringA megbízható proxyk vesszővel elválasztott listája. Ha meg van adva, akkor ez a tulajdonság felülírja a webkiszolgáló bedolgozó konfigurációs fájlban található értéket.

httpEndpoint

Az előállított plugin-cfg.xml fájlban szerepeltetendő http végpont azonosítóját. A végpont határozza meg a kiszolgálót a fürtben. Az alapértelmezett érték: 'defaultHttpEndpoint'.

NameTypeDefaultDescription
onError
  • IGNORE
  • WARN
  • FAIL
WARNVégpont indításának meghiúsulása után végrehajtandó művelet.
IGNORE
A kiszolgáló nem ad ki figyelmeztetés- és hibaüzeneteket, amikor konfigurációs hiba fordul elő.
WARN
A kiszolgáló figyelmeztetés- és hibaüzeneteket ad ki, amikor konfigurációs hiba fordul elő.
FAIL
A kiszolgáló figyelmeztetés- vagy hibaüzenetet ad ki az első hiba előfordulásakor, majd a kiszolgáló leáll.
enabledlogikaitrueVáltókapcsoló a végpont elérhetőségének beállításához. Ha értéke 'true', akkor az irányító aktiválja a végpontot HTTP kérések kezeléséhez.
hoststringlocalhostAz ügyfél által az erőforrások kéréséhez használt IP cím, tartománynév-kiszolgáló (DNS) hosztnév tartománynév utótaggal, vagy csak DNS hosztnév. Az összes elérhető hálózati csatolóhoz használja a '*' karaktert.
httpPortint
Min: -1

Max: 65535
Az ügyfél HTTP kérésekhez használt port. A port letiltásához használja a -1 értéket.
httpsPortint
Min: -1

Max: 65535
Az SSL protokollal védett ügyfél HTTP (https) kérésekhez használt port. A port letiltásához használja a -1 értéket.
httpOptionsRefHivatkozás a felső szintű httpOptions elemre (karaktersorozat).defaultHttpOptionsA végpont HTTP protokoll beállításai.
sslOptionsRefHivatkozás a felső szintű sslOptions elemre (karaktersorozat).A végpont SSL protokoll beállításai.
tcpOptionsRefHivatkozás a felső szintű tcpOptions elemre (karaktersorozat).defaultTCPOptionsA végpont TCP protokoll beállításai.
accessLoggingRefHivatkozás a felső szintű httpAccessLogging elemre (karaktersorozat).A végpontra vonatkozó HTTP hozzáférési napló beállítás.

httpEndpoint > httpOptions

A végpont HTTP protokoll beállításai.

NameTypeDefaultDescription
keepAliveEnabledlogikaitrueEngedélyezi a folytonos kapcsolatokat (HTTP kapcsolatfenntartás). True értékre beállítva a kapcsolatok újrafelhasználás céljából több egymást követő kérés és válasz küldésével fenn lesznek tartva. False értékre beállítva a kapcsolatok a válasz elküldése után le lesznek zárva.
maxKeepAliveRequestsint
Min: -1
100Az egyetlen HTTP kapcsolaton engedélyezett folytonos kérések maximális száma, ha a folytonos kapcsolatok engedélyezve vannak. A -1 érték jelentése: korlátlan.
persistTimeoutIdőtartam másodperces pontossággal30sAz időmennyiség, ameddig a socket tétlen maradhat két kérés között. Ez a beállítás csak akkor érvényes, ha a folytonos kapcsolatok engedélyezve vannak. Adjon meg egy egész számot, amelyet egy időegység követ, amely lehet óra (ó), perc (p) vagy másodperc (s). A 30 másodpercet például 30s formában adhatja meg. Egyetlen bejegyzésbe több értéket is belefoglalhat. Például 1p30s egyenértékű 90 másodperccel.
readTimeoutIdőtartam másodperces pontossággal60sAz időmenyiség, ameddig a rendszer az első olvasás után egy olvasási kérés befejezésére várakozik egy socketen. Adjon meg egy egész számot, amelyet egy időegység követ, amely lehet óra (ó), perc (p) vagy másodperc (s). A 30 másodpercet például 30s formában adhatja meg. Egyetlen bejegyzésbe több értéket is belefoglalhat. Például 1p30s egyenértékű 90 másodperccel.
writeTimeoutIdőtartam másodperces pontossággal60sAz időmennyiség, ameddig a rendszer a továbbítandó válaszadatok egyes részeire várakozik egy socketen. Adjon meg egy egész számot, amelyet egy időegység követ, amely lehet óra (ó), perc (p) vagy másodperc (s). A 30 másodpercet például 30s formában adhatja meg. Egyetlen bejegyzésbe több értéket is belefoglalhat. Például 1p30s egyenértékű 90 másodperccel.
removeServerHeaderlogikaifalseEltávolítja a kiszolgáló megvalósítási információkat a HTTP fejlécekből, egyúttal letiltja a Liberty profil alapértelmezett üdvözlő oldalát.
NoCacheCookiesControllogikaitrueLehetővé teszi a felhasználó számára annak vezérlését, hogy egy Set-Cookie fejléc jelenléte frissítse-e a Cache-Control fejlécet egy megfelelő no-cache értékkel. Ez hozzáadja az Expires fejlécet is.
AutoDecompressionlogikaitrueMegadja, hogy a HTTP Channel automatikusan kibontja a bejövő kérés törzsében lévő adatokat.

httpEndpoint > sslOptions

A végpont SSL protokoll beállításai.

NameTypeDefaultDescription
sessionTimeoutIdőtartam másodperces pontossággal1dAz idő, amit egy írási vagy olvasási kérés befejeződésére várni kell egy socketen. Az értéket a protokollra jellemző időkorlátok felülbírálják. Adjon meg egy egész számot, amelyet egy időegység követ, amely lehet óra (ó), perc (p) vagy másodperc (s). A 30 másodpercet például 30s formában adhatja meg. Egyetlen bejegyzésbe több értéket is belefoglalhat. Például 1p30s egyenértékű 90 másodperccel.
suppressHandshakeErrorslogikaifalseLetiltja az SSL kézfogás hibák naplózását. A normál működés során is előfordulhatnak SSL kézfogás hibák, ám hasznosak lehetnek ezek az üzenetek, amikor az SSL nem a várt módon viselkedik.
sslRefHivatkozás a felső szintű ssl elemre (karaktersorozat).Az alapértelmezett SSL konfigurációs rejtjelkészlet. Az alapértelmezett érték defaultSSLSettings.
sslSessionTimeoutIdőtartam ezredmásodperces pontossággal8640msAz SSL csatornán létrehozott SSL munkamenet időkorlátja. Adjon meg egy egész számot, amelyet egy időegység követ, amely lehet óra (ó), perc (p), másodperc (s), vagy ezredmásodperc (ms). Az 500 ezredmásodpercet adja meg például 500ms formában. Egyetlen bejegyzésbe több értéket is belefoglalhat. Például 1s500ms egyenértékű 1,5 másodperccel.

httpEndpoint > tcpOptions

A végpont TCP protokoll beállításai.

NameTypeDefaultDescription
inactivityTimeoutIdőtartam ezredmásodperces pontossággal60sAz idő, amit egy írási vagy olvasási kérés befejeződésére várni kell egy socketen. Az értéket a protokollra jellemző időkorlátok felülbírálják. Adjon meg egy egész számot, amelyet egy időegység követ, amely lehet óra (ó), perc (p), másodperc (s), vagy ezredmásodperc (ms). Az 500 ezredmásodpercet adja meg például 500ms formában. Egyetlen bejegyzésbe több értéket is belefoglalhat. Például 1s500ms egyenértékű 1,5 másodperccel.
soReuseAddrlogikaitrueAz azonnali újrakötést engedélyezése egy porthoz, amelynek nincs aktív figyelője.
addressIncludeListstringCímek vesszővel elválasztott listája, amelyek bejövő kapcsolatokat létesíthetnek ezen a végponton. Megadhat IPv4 és IPv6 címeket. Az IPv4 és IPv6 cím értéke szám vagy csillag helyettesítő karakter lehet.
addressExcludeListstringCímek vesszővel elválasztott listája, amelyek nem létesíthetnek bejövő kapcsolatokat ezen a végponton. Megadhat IPv4 és IPv6 címeket. Az IPv4 és IPv6 cím értéke szám vagy csillag helyettesítő karakter lehet.
hostNameIncludeListstringHosztnevek vesszővel elválasztott listája, amelyek bejövő kapcsolatokat létesíthetnek ezen a végponton. A hosztnevek nem különböztetik meg a kis- és nagybetűket, és kezdődhetnek csillag karakterrel, amely helyettesítő karakterként működik. Azonban csillag máshol nem lehet a hosztnévben. Például a *.abc.com érvényes, a *.abc.* azonban nem.
hostNameExcludeListstringHosztnevek vesszővel elválasztott listája, amelyek nem létesíthetnek bejövő kapcsolatokat ezen a végponton. A hosztnevek nem különböztetik meg a kis- és nagybetűket, és kezdődhetnek csillag karakterrel, amely helyettesítő karakterként működik. Azonban csillag máshol nem lehet a hosztnévben. Például a *.abc.com érvényes, a *.abc.* azonban nem.

httpEndpoint > accessLogging

A végpontra vonatkozó HTTP hozzáférési napló beállítás.

NameTypeDefaultDescription
enabledlogikaitrueHozzáférés naplózásának engedélyezése.
filePathFájl elérési útvonala${server.output.dir}/logs/http_access.logA hozzáférési naplófájlt tároló könyvtár útvonala és neve. A könyvtárútvonal megadásához használhatók a szabványos változó helyettesítések (mint például ${server.output.dir}).
logFormatstring%h %u %{t}W "%r" %s %bMegadja az ügyfél-hozzáférési információk naplózásához használandó naplóformátumot.
maxFileSizeint
Min: 0
20Naplófájl maximális mérete (MB), mielőtt újra lenne kezdve; a 0 érték azt jelenti, hogy nincs korlát.
maxFilesint
Min: 0
2A megtartott naplófájlok maximásis száma, amelyet túllépve, a legrégebbi fájl eltávolításra kerül. A 0 érték azt jelenti, hogy nincs korlát.

extraConfigProperties

Az előállított bedolgozó konfigurációs fájlban a Config elemhez hozzáadandó további tulajdonságok. Ezeket a tulajdonságokat az IBM támogatás adhatja meg a webkiszolgáló bedolgozó viselkedésének módosításához.