pluginConfiguration - Plug-in server web (pluginConfiguration)

Proprietăţile utilizate la generarea fişierului de configuraţie plug-in de server web

NameTypeDefaultDescription
pluginInstallRootstring/opt/IBM/WebSphere/PluginsLocaţia de instalare a plug-in-ului de server web în sistemul de fişiere al gazdei serverului web
webserverNamestringwebserver1Numele serverului web unde va fi utilizată această configuraţie. Utilizat pentru a genera locaţia fişierului istoric de plug-in dacă nu este specificată explicit de directorul sau numele de fişier Istoric.
webserverPortint
Min: -1

Max: 65535
80Port HTTP server web
webserverSecurePortint
Min: -1

Max: 65535
443Port HTTPS server web
sslKeyringLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.kdbCalea complet calificată către fişierul inel de chei SSL de pe gazda serverului web
sslStashfileLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.sthCalea complet calificată către fişierul stash SSL de pe gazda serverului web
sslCertlabelstringSpecifică eticheta certificatului din inelul de chei pe care urmează să-l utilizeze plug-in-ul când un container web necesită un certificat de client din plug-in.
ipv6PreferredbooleanfalseUtilizat la rezolvarea unui nume de gazdă de server de aplicaţii de {null} sau {0}, pentru a prefera tipul de adresă când este posibil
httpEndpointRefO referinţă la elementul de nivel înalt httpEndpoint (şir).defaultHttpEndpointSpecificaţi identificatorul punctului final http pentru a includere în fişierul plugin-cfg.xml generat. Punctul final defineşte serverul din cluster. Valoarea implicită este 'defaultHttpEndpoint'.
connectTimeoutO perioadă de timp cu precizie de secunde5sIdentifică durata maximă cât serverul de aplicaţii ar trebui să menţină o conexiune cu serverul de web. Specificaţi un întreg pozitiv urmat de o unitate de timp, care poate fi ore (o), minute (m) sau secunde (s). De exemplu, specificaţi 30 secunde ca 30s. Puteţi include valori multiple într-o singură intrare. De exemplu, 1m30s este echivalent cu 90 secunde.
serverIOTimeoutO perioadă de timp cu precizie de secunde900sIdentifică durata maximă de timp în care plug-in-ul de server web aşteaptă să trimită o cerere sau să primească un răspuns de la serverul de aplicaţii. Specificaţi un întreg pozitiv urmat de o unitate de timp, care poate fi ore (o), minute (m) sau secunde (s). De exemplu, specificaţi 30 secunde ca 30s. Puteţi include valori multiple într-o singură intrare. De exemplu, 1m30s este echivalent cu 90 secunde.
wsServerIOTimeoutO perioadă de timp cu precizie de secundeIdentifică intervalul de timp maxim cât aşteaptă plugin-ul de server web pentru a trimite o cerere sau a primi un răspuns websocket de la serverul de aplicaţii. Specificaţi un întreg pozitiv urmat de o unitate de timp, care poate fi ore (o), minute (m) sau secunde (s). De exemplu, specificaţi 30 secunde ca 30s. Puteţi include valori multiple într-o singură intrare. De exemplu, 1m30s este echivalent cu 90 secunde.
wsServerIdleTimeoutO perioadă de timp cu precizie de secundeIdentifică intervalul de timp maxim cât aşteaptă plugin-ul de server web pentru a termina o conexiune websocket nefolosită. Specificaţi un întreg pozitiv urmat de o unitate de timp, care poate fi ore (o), minute (m) sau secunde (s). De exemplu, specificaţi 30 secunde ca 30s. Puteţi include valori multiple într-o singură intrare. De exemplu, 1m30s este echivalent cu 90 secunde.
extendedHandshakebooleanfalseDacă este adevărat, plug-in-ul de server web foloseşte un dialog de confirmare extins pentru a determina dacă serverul de aplicaţii rulează.
waitForContinuebooleanfalseDacă este fals (valoarea implicită), plug-in-ul de server web trimite antetul "Expect: 100-continue" cu cereri HTTP care au un corp de mesaj. Când este setat la adevărat, plug-in-ul de server web trimite antetul "Expect: 100-continue" cu fiecare cerere HTTP. Luaţi în considerare setarea acestei valori la adevărat dacă aveţi un firewall între serverul de web server şi serverul de aplicaţii şi acestea sunt sensibile la reîncercări de cereri fără niciun corp de mesaj.
logFileNameCalea la un fişierO cale complet aalificată către fişierul istoric al plug-in-ului de server web. Componenta de director trebuie să existe deja. Pentru servere web bazate pe Apache, o cale care începe cu un caracter bară verticală este interpretat ca instrument de înregistrare în jurnal extern. Dacă este specificată, calea ignoră logDirLocation.
logDirLocationCalea la un director${pluginInstallRoot}/logs/${webserverName}Perimat: Identifică directorul unde este localizat fişierul http_plugin.log. Vedeţi numele Fişierului istoric.
serverIOTimeoutRetryint
Min: -1

Max: 65535
-1Limitează numărul de reîncercări de cereri după un timeout de citire şi scriere. Valoarea implicită, {-1}, nu aplică nicio limită suplimentară, deci reîncercările sunt limitate de numărul de servere disponibile în cluster. O valoare de {0} indică faptul că nu ar trebui să existe nicio reîncercare. Această valoare este destinată clusterului de servere şi nu se aplică defectelor de conexiuni sau timeout-urilor din cauza timeout-ului HTTP plug-in Connection, sau a timeout-urilor de socluri web.
loadBalanceWeightint20Această valoare este modificată dinamic în timpul rulării. Ponderea unui server este scăzută de fiecare dată când este asignată o cerere la acel server. Când toate ponderile pentru toate serverele scade la 0 sau la o valoare mai mică, plug-in-ul de server web reajustează toate ponderile pentru a fi mai mari decât 0.
serverRole
  • BACKUP
  • PRIMARY
PRIMARYRolul serverului identifică un server ca fiind primar sau de rezervă. Când sunt disponibile serverele primare, plug-in-ul de server le utilizează pentru echilibrarea încărcării şi preluarea la defect. Totuşi, dacă nu este disponibil niciun server primar, plug-in-ul de server web utilizează numai serverele de rezervă pentru echilibrarea încărcării şi preluarea la defect.
BACKUP
De rezervă
PRIMARY
Primar
ESIEnablebooleantrueProprietatea ESIEnable activează procesarea ESI (Edge Side Include) pentru a pune în cache răspunsurile. Această proprietate furnizează opţiunea de a dezactiva ESI în fişierul de configuraţie a plug-in-ului de server web.
ESIMaxCacheSizeint1024ESIMaxCacheSize este dimensiunea maximă de cache care este implicit 1MB. Această proprietate furnizează opţiunea de a înlocui valoarea din fişierul de configuraţie a plug-in-ului de server web.
ESIInvalidationMonitorbooleanfalseESIInvalidationMonitor specifică dacă procesorul ESI ar trebui să primească invalidări de la serverul de aplicaţii. Această proprietate furnizează opţiunea de a înlocui valoarea din fişierul de configuraţie a plug-in-ului de server web.
ESIEnableToPassCookiesbooleanfalseESIEnableToPassCookies permite înaintarea cookie-urilor de sesiune către WebSphere Application Server. Această proprietate furnizează opţiunea de a înlocui valoarea din fişierul de configuraţie a plug-in-ului de server web.
trustedProxyEnablebooleanPermite utilizarea proxy-urilor de încredere. Când este specificată, această proprietate înlocuieşte valoarea în fişierul de configuraţie a plug-in-ului de server web.
trustedProxyGroupstringO listă separată prin virgule a proxy-urilor de încredere. Când este specificată, această proprietate înlocuieşte valoarea în fişierul de configuraţie a plug-in-ului de server web.

httpEndpoint

Specificaţi identificatorul punctului final http pentru a includere în fişierul plugin-cfg.xml generat. Punctul final defineşte serverul din cluster. Valoarea implicită este 'defaultHttpEndpoint'.

NameTypeDefaultDescription
onError
  • IGNORE
  • WARN
  • FAIL
WARNAcţiune de efectuat după eşecul de pornire a unui punct final.
IGNORE
Serverul nu va emite niciun avertisment şi niciun mesaj de eroare când apare o eroare de configurare.
WARN
Serverul va emite un avertisment şi mesaje de eroare când apare o eroare de configurare.
FAIL
Serverul va emite un avertisment sau un mesaj de eroare la prima apariţie a unei erori şi apoi va opri serverul.
enabledbooleantrueComutare disponibilitate punct final. Când este adevărat, acest punct final va fi activat de către dispecer pentru manipularea cererilor HTTP.
hoststringlocalhostAdresă IP, nume gazdă DNS (domain name server) cu sufix de nume domeniu sau doar nume DNS gazdă utilizat de către un client pentru solicitarea unei resurse. Folosiţi '*' pentru toate interfeţele de reţea disponibile.
httpPortint
Min: -1

Max: 65535
Portul folosit pentru cererile HTTP de client. Folosiţi -1 pentru a dezactiva acest port.
httpsPortint
Min: -1

Max: 65535
Portul folosit pentru cererile HTTP de client securizate cu SSL (https). Folosiţi -1 pentru a dezactiva acest port.
httpOptionsRefO referinţă la elementul de nivel înalt httpOptions (şir).defaultHttpOptionsOpţiuni de protocol HTTP pentru punctul final.
sslOptionsRefO referinţă la elementul de nivel înalt sslOptions (şir).Opţiuni de protocol SSL pentru punctul final.
tcpOptionsRefO referinţă la elementul de nivel înalt tcpOptions (şir).defaultTCPOptionsOpţiuni de protocol TCP pentru punctul final.
accessLoggingRefO referinţă la elementul de nivel înalt httpAccessLogging (şir).Configurarea înregistrării în istoric a accesului HTTP pentru punctul final.

httpEndpoint > httpOptions

Opţiuni de protocol HTTP pentru punctul final.

NameTypeDefaultDescription
keepAliveEnabledbooleantruePermite conexiuni persitente (ţinere în viaţă HTTP). Dacă e adevărat, conexiunile sunt ţinute în viaţă pentru reutilizare de mai multe cereri şi răspunsuri secvenţiale. Dacă e fals, conexiunile sunt închise după ce se trimite răspunsul.
maxKeepAliveRequestsint
Min: -1
100Numărul maxim de cereri persistente care sunt permise pe o singură conexiune HTTP dacă sunt activate conexiunile persistente. Valoarea -1 înseamnă nelimitat.
persistTimeoutO perioadă de timp cu precizie de secunde30sDurata cât îi este permis unui socket să rămână nefolosit între cereri. Această setare se aplică numai dacă sunt activate conexiunile persistente. Specificaţi un întreg pozitiv urmat de o unitate de timp, care poate fi ore (o), minute (m) sau secunde (s). De exemplu, specificaţi 30 secunde ca 30s. Puteţi include valori multiple într-o singură intrare. De exemplu, 1m30s este echivalent cu 90 secunde.
readTimeoutO perioadă de timp cu precizie de secunde60sTimpul de aşteptare până la finalizarea unei cereri de citire pe un socket după apariţia primei citiri. Specificaţi un întreg pozitiv urmat de o unitate de timp, care poate fi ore (o), minute (m) sau secunde (s). De exemplu, specificaţi 30 secunde ca 30s. Puteţi include valori multiple într-o singură intrare. De exemplu, 1m30s este echivalent cu 90 secunde.
writeTimeoutO perioadă de timp cu precizie de secunde60sTimpul de aşteptare al unui socket pentru ca fiecare porţiune a datelor de răspuns să fie transmisă. Specificaţi un întreg pozitiv urmat de o unitate de timp, care poate fi ore (o), minute (m) sau secunde (s). De exemplu, specificaţi 30 secunde ca 30s. Puteţi include valori multiple într-o singură intrare. De exemplu, 1m30s este echivalent cu 90 secunde.
removeServerHeaderbooleanfalseÎnlătură informaţiile de implementare a serverului din anteturile HTTP şi, de asemenea, dezactivează pagina de bun venit a profilului implicit Liberty.
NoCacheCookiesControlbooleantruePermite utilizatorului să controleze dacă prezenţa unui antet Set-Cookie va actualiza sau nu antetul Cache-Control cu o valoare no-cache care să se potrivească. Aceasta va adăuga şi antetul Expires.
AutoDecompressionbooleantrueSpecifică dacă canalul HTTP decomprimă automat datele corpul cererii de intrare.

httpEndpoint > sslOptions

Opţiuni de protocol SSL pentru punctul final.

NameTypeDefaultDescription
sessionTimeoutO perioadă de timp cu precizie de secunde1dCantitatea de timp de aşteptare pentru a citi sau scrie cererea pentru a finaliza un socket. Această valoare este înlocuită de timeout-urile specifice protocolului. Specificaţi un întreg pozitiv urmat de o unitate de timp, care poate fi ore (o), minute (m) sau secunde (s). De exemplu, specificaţi 30 secunde ca 30s. Puteţi include valori multiple într-o singură intrare. De exemplu, 1m30s este echivalent cu 90 secunde.
suppressHandshakeErrorsbooleanfalseDezactivaţi înregistrarea în istoric a erorilor de dialog de confirmare SSL. Erorile de dialog de confirmare SSL pot apărea în timpul operaţiei normale, totuşi aceste mesaje pot fi utile când SSL se comportă neaşteptat.
sslRefO referinţă la elementul de nivel înalt ssl (şir).Repertoriul SSL de configuraţie implicit. Valoarea implicită este defaultSSLSettings.
sslSessionTimeoutO perioadă de timp cu precizie de milisecunde8640msLimita de timeout pentru o sesiune SSL care este stabilită de canalul SSL. Specificaţi un întreg pozitiv urmat de o unitate de timp, care poate fi ore (o), minute (m), secunde (s) sau milisecunde (ms). De exemplu, specificaţi 500 milisecunde ca 500ms. Puteţi include valori multiple într-o singură intrare. De exemplu, 1s500ms este echivalent cu 1.5 secunde.

httpEndpoint > tcpOptions

Opţiuni de protocol TCP pentru punctul final.

NameTypeDefaultDescription
inactivityTimeoutO perioadă de timp cu precizie de milisecunde60sCantitatea de timp de aşteptare pentru a citi sau scrie cererea pentru a finaliza un socket. Această valoare este înlocuită de timeout-urile specifice protocolului. Specificaţi un întreg pozitiv urmat de o unitate de timp, care poate fi ore (o), minute (m), secunde (s) sau milisecunde (ms). De exemplu, specificaţi 500 milisecunde ca 500ms. Puteţi include valori multiple într-o singură intrare. De exemplu, 1s500ms este echivalent cu 1.5 secunde.
soReuseAddrbooleantrueActivează relegarea imdiată la un port cu un ascultător activ.
addressIncludeListstringO listă separată de virgule de adrese cărora li se permite să facă conexiuni de intrare la acest punct final. Puteţi specifica adrese IPv4 sau IPv6. Toate valorile din adresele IPv4 sau IPv6 trebuie reprezentate de un număr sau de un metacaracter asterisc.
addressExcludeListstringO listă separată de virgule de adrese cărora nu li se permite să facă conexiuni de intrare la acest punct final. Puteţi specifica adrese IPv4 sau IPv6. Toate valorile din adresele IPv4 sau IPv6 trebuie reprezentate de un număr sau de un metacaracter asterisc.
hostNameIncludeListstringO listă separată de virgule de nume de gazde cărora li se permise să facă conexiuni de intrare la acest punct final. Numele de gazde nu sunt sensibile la majuscule şi pot începe cu un asterisc, care este folosit ca un metacaracter. Dar, asteriscurile nu pot fi în altă parte în numele de gazde. De exemplu, *.abc.com este valid, dar *.abc.* nu este valid.
hostNameExcludeListstringO listă separată de virgule de nume de gazde cărora nu li se permise să facă conexiuni de intrare la acest punct final. Numele de gazde nu sunt sensibile la majuscule şi pot începe cu un asterisc, care este folosit ca un metacaracter. Dar, asteriscurile nu pot fi în altă parte în numele de gazde. De exemplu, *.abc.com este valid, dar *.abc.* nu este valid.

httpEndpoint > accessLogging

Configurarea înregistrării în istoric a accesului HTTP pentru punctul final.

NameTypeDefaultDescription
enabledbooleantruePermiteţi jurnalizarea accesului
filePathCalea la un fişier${server.output.dir}/logs/http_access.logCalea de director şi numele fişierului istoric de acces. Substituţii de variabile standard, precum ${server.output.dir}, pot fi folosite când specificaţi calea directorului.
logFormatstring%h %u %{t}W "%r" %s %bSpecifică formatul istoricului folosit la înregistrarea în istoric a informaţiilor de acces client.
maxFileSizeint
Min: 0
20dimensiune maximă a unui fişier istoric, în megaocteţi, înainte de a fi derulat înapoi; o valoare de 0 înseamnă nicio limită.
maxFilesint
Min: 0
2Numărul maxim de fişiere istoric care vor fi păstrate, înainte ca fişierul cel mai vechi să fie înlăturat; o valoare de 0 înseamnă nicio limită.

extraConfigProperties

Proprietăţi suplimentare pentru a fi adăugat elementul Config în fişierul configuraţie plug-in generat. Aceste proprietăţi pot fi specificate de suportul IBM pentru a modifica comportamentul plug-in-ului serverului web.