pluginConfiguration - Plug-in server Web (pluginConfiguration)

Proprietà utilizzate durante la generazione del file di configurazione del plug-in del server Web

NameTypeDefaultDescription
pluginInstallRootstring/opt/IBM/WebSphere/PluginsL'ubicazione di installazione del plug-in del server Web nel file system dell'host del server Web
webserverNamestringwebserver1Il nome del server Web in cui verrà utilizzata questa configurazione. Utilizzato per generare l'ubicazione del file di log del plug-in se non è specificata esplicitamente dal nome o dalla directory file di log.
webserverPortint
Min: -1

Max: 65535
80Porta HTTP del server Web
webserverSecurePortint
Min: -1

Max: 65535
443Porta HTTPS del server Web
sslKeyringLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.kdbIl percorso completo al file keyring SSL sull'host del server Web.
sslStashfileLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.sthIl percorso completo al file stash SSL sull'host del server Web.
sslCertlabelstringSpecifica l'etichetta del certificato nel keyring che il plug-in deve utilizzare quando il contenitore Web richiede un certificato client dal plug-in.
ipv6PreferredbooleanofalseUtilizzato quando si risolve un host del server delle applicazioni {null} o {0}, per preferire il tipo di indirizzo, quando possibile
httpEndpointRefUn riferimento allelemento di livello più alto {0} (stringa).defaultHttpEndpointSpecificare l'identificativo dell'endpoint http da includere nel file plugin-cfg.xml generato. L'endpoint definisce il server nel cluster. Il valore predefinito è 'defaultHttpEndpoint'.
connectTimeoutUn periodo di tempo con precisione al secondo5sIdentifica la quantità massima di tempo per cui il server delle applicazioni deve mantenere una connessione con il server Web. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m) o secondi (s). Ad esempio, specificare 30 secondi come 30s. È possibile includere più valori in una singola immissione. Ad esempio, 1m30s è equivalente a 90 secondi.
serverIOTimeoutUn periodo di tempo con precisione al secondo900sIdentifica la quantità massima di tempo per cui il plug-in del server Web attende prima di inviare una richiesta o ricevere una risposta dal server delle applicazioni. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m) o secondi (s). Ad esempio, specificare 30 secondi come 30s. È possibile includere più valori in una singola immissione. Ad esempio, 1m30s è equivalente a 90 secondi.
wsServerIOTimeoutUn periodo di tempo con precisione al secondoIdentifica la quantità massima di tempo per cui il plug-in del server Web attende prima di inviare una richiesta o ricevere una risposta websocket dal server delle applicazioni. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m) o secondi (s). Ad esempio, specificare 30 secondi come 30s. È possibile includere più valori in una singola immissione. Ad esempio, 1m30s è equivalente a 90 secondi.
wsServerIdleTimeoutUn periodo di tempo con precisione al secondoIdentifica la quantità massima di tempo per cui il plug-in del server Web attende prima di terminare una connessione websocket inattiva. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m) o secondi (s). Ad esempio, specificare 30 secondi come 30s. È possibile includere più valori in una singola immissione. Ad esempio, 1m30s è equivalente a 90 secondi.
extendedHandshakebooleanofalseSe true, il plug-in del server Web utilizza un handshake esteso per determinare se il server delle applicazioni è in esecuzione.
waitForContinuebooleanofalseSe false (il valore predefinito), il plug-in del server Web invia l'intestazione "Expect: 100-continue" con le richieste HTTP che hanno un corpo del messaggio. Quando è impostato su true, il plug-in del server Web invia l'intestazione "Expect: 100-continue" con ogni richiesta HTTP. Considerare di impostare questo valore su true se si dispone di un firewall tra il server Web e il server delle applicazioni e si è soggetti a nuovi tentativi di richieste senza il corpo.
logFileNamePercorso a un fileUn percorso completo al file di log del plug-in del server Web. Il componente directory deve già essitere. Per i server Web bsati su Apache, un percorso che inizia con un carattere pipe viene interpretato come un programma di registrazione con pipe esterno. Se specificato, il percorso sovrascrive logDirLocation.
logDirLocationPercorso a una directory${pluginInstallRoot}/logs/${webserverName}Obsoleto: Identifica la directory in cui è ubicato il file http_plugin.log. Consultare il nome file di log.
serverIOTimeoutRetryint
Min: -1

Max: 65535
-1Limita il numero di tentativi di richiesta dopo un timeout di scrittura o lettura. Il valore predefinito, {-1}, non applica ulteriori limiti quindi i tentativi sono limitati dal numero di server disponibili nel cluster. Un valore {0} indica che non ci saranno nuovi tentativi. Questo valore riguarda l'ambito del cluster di server e non si applica agli errori di connessione o ai timeout dovuti al timeout di connessione del plug-in HTTP o ai timeout del socket web.
loadBalanceWeightint20Questo valore viene modificato dinamicamente durante il run time. Il peso di un server viene ridotto ogni volta che viene assegnata una richiesta a tale server. Quando tutti i pesi per tutti i server sono 0 o un valore inferiore, il plug-in del server Web riadatta i pesi in modo che siano maggiori di 0.
serverRole
  • BACKUP
  • PRIMARY
PRIMARYIl ruolo del server identifica un server come primario o di backup. Quando i server primari sono disponibili, il plug-in del server Web li utilizza per il bilanciamento del carico e il failover. Tuttavia, se nessun server primario è disponibile, il plug-in del server Web utilizza solo i server di backup per il bilanciamento del carico e il failover.
BACKUP
Backup
PRIMARY
Primario
ESIEnablebooleanotrueLa proprietà ESIEnable abilita l'elaborazione ESI (Edge Side Include) per memorizzare in cache le risposte. Questa proprietà fornisce la possibilità di disabilitare ESI nel file di configurazione del plug-in del server Web.
ESIMaxCacheSizeint1024ESIMaxCacheSize è la dimensione massima della cache il cui valore predefinito è 1MB. Questa proprietà fornisce la possibilità di sovrascrivere il valore nel file di configurazione del plug-in del server Web.
ESIInvalidationMonitorbooleanofalseESIInvalidationMonitor specifica se il processore ESI deve ricevere invalidazioni dal server delle applicazioni. Questa proprietà fornisce la possibilità di sovrascrivere il valore nel file di configurazione del plug-in del server Web.
ESIEnableToPassCookiesbooleanofalseESIEnableToPassCookies permette l'inoltro di cookie sessione a WebSphere Application Server. Questa proprietà fornisce la possibilità di sovrascrivere il valore nel file di configurazione del plug-in del server Web.
trustedProxyEnablebooleanoAbilita l'utilizzo dei proxy affidabili. Quando specificata, questa proprietà sovrascrive il valore nel file di configurazione del plug-in del server web.
trustedProxyGroupstringUn elenco separato da virgole di proxy affidabili. Quando specificata, questa proprietà sovrascrive il valore nel file di configurazione del plug-in del server web.

httpEndpoint

Specificare l'identificativo dell'endpoint http da includere nel file plugin-cfg.xml generato. L'endpoint definisce il server nel cluster. Il valore predefinito è 'defaultHttpEndpoint'.

NameTypeDefaultDescription
onError
  • IGNORE
  • WARN
  • FAIL
WARNAzione da eseguire dopo un errore di avvio di un endpoint.
IGNORE
Il server non emetterà messaggi di avvertenza e di errore quando si verifica un errore di configurazione.
WARN
Il server emetterà messaggi di avvertenza e di errore quando si verifica un errore di configurazione.
FAIL
Il server emetterà un messaggio di avvertenza o di errore alla prima ricorrenza dell'errore, quindi si arresterà il server.
enabledbooleanotrueAttivare/disattivare la disponibilità di un endpoint. Quando questa opzione è impostata su true, questo endpoint verrà attivato dal dispatcher per gestire le richieste HTTP.
hoststringlocalhostL'indirizzo IP, il nome host DNS (domain name server) con il suffisso del nome del dominio, o solo il nome host DNS, utilizzato da un client per richiedere una risorsa. Utilizzare '*' per tutte le interfacce di rete disponibili.
httpPortint
Min: -1

Max: 65535
La porta utilizzata per le richieste HTTP del client. Utilizzare -1 per disabilitare questa porta.
httpsPortint
Min: -1

Max: 65535
La porta utilizzata per le richieste HTTP del client resa sicura con SSL (https). Utilizzare -1 per disabilitare questa porta.
httpOptionsRefUn riferimento allelemento di livello più alto {0} (stringa).defaultHttpOptionsLe opzioni del protocollo HTTP per l'endpoint.
sslOptionsRefUn riferimento allelemento di livello più alto {0} (stringa).Le opzioni del protocollo SSL per l'endpoint.
tcpOptionsRefUn riferimento allelemento di livello più alto {0} (stringa).defaultTCPOptionsLe opzioni del protocollo TCP per l'endpoint.
accessLoggingRefUn riferimento allelemento di livello più alto {0} (stringa).Configurazione della registrazione accessi HTTP per l'endpoint.

httpEndpoint > httpOptions

Le opzioni del protocollo HTTP per l'endpoint.

NameTypeDefaultDescription
keepAliveEnabledbooleanotrueAbilita le connessioni persistenti (keepalive HTTP). Se l'opzione è impostata su true, le connessioni vengono mantenute attive in modo da essere riutilizzate da più richieste e risposte in sequenza. Se l'opzione è impostata su false, le connessioni vengono chiuse una volta inviata la risposta.
maxKeepAliveRequestsint
Min: -1
100Il numero massimo di richieste persistenti consentite su una singola connessione HTTP, se le connessioni persistenti sono abilitate. Un valore -1 indica un numero illimitato.
persistTimeoutUn periodo di tempo con precisione al secondo30sL'intervallo di tempo durante il quale un socket può rimanere inattivo tra le richieste. Questa impostazione viene applicata solo se le connessioni persistenti sono abilitate. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m) o secondi (s). Ad esempio, specificare 30 secondi come 30s. È possibile includere più valori in una singola immissione. Ad esempio, 1m30s è equivalente a 90 secondi.
readTimeoutUn periodo di tempo con precisione al secondo60sL'intervallo di tempo di attesa del completamento di una richiesta di lettura su un socket dopo che si è verificata la prima lettura. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m) o secondi (s). Ad esempio, specificare 30 secondi come 30s. È possibile includere più valori in una singola immissione. Ad esempio, 1m30s è equivalente a 90 secondi.
writeTimeoutUn periodo di tempo con precisione al secondo60sL'intervallo di tempo di attesa su un socket per la trasmissione di ciascuna porzione dei dati della risposta. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m) o secondi (s). Ad esempio, specificare 30 secondi come 30s. È possibile includere più valori in una singola immissione. Ad esempio, 1m30s è equivalente a 90 secondi.
removeServerHeaderbooleanofalseRimuove le informazioni di implementazione del server dalle intestazioni HTTP e disabilita anche la pagina di benvenuto del Liberty Profile predefinito.
NoCacheCookiesControlbooleanotruePermette all'utente di controllare se la presenza di un'intestazione Set-Cookie deve o meno aggiornare l'intestazione Cache-Control con un valore no-cache corrispondente. Ciò aggiunge anche l'intestazione Scadenza.
AutoDecompressionbooleanotrueSpecifica se il canale HTTP decomprime automaticamente i dati del corpo richiesta in entrata.

httpEndpoint > sslOptions

Le opzioni del protocollo SSL per l'endpoint.

NameTypeDefaultDescription
sessionTimeoutUn periodo di tempo con precisione al secondo1dL'intervallo di tempo di attesa del completamento di una richiesta di lettura o scrittura su un socket. Questo valore viene sostituito dai timeout specifici del protocollo. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m) o secondi (s). Ad esempio, specificare 30 secondi come 30s. È possibile includere più valori in una singola immissione. Ad esempio, 1m30s è equivalente a 90 secondi.
suppressHandshakeErrorsbooleanofalseDisabilitare la registrazione degli errori di handshake SSL. Gli errori di handshake SSL possono verificarsi durante il normale funzionamento; tuttavia, questi messaggi possono essere utili in caso di funzionamento imprevisto di SSL.
sslRefUn riferimento allelemento di livello più alto {0} (stringa).Il repertorio di configurazione SSL predefinito. Il valore predefinito è defaultSSLSettings.
sslSessionTimeoutUn periodo di tempo con precisione al millisecondo8640msIl limite di timeout per una sessione SSL stabilito dal canale SSL. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m), secondi (s) o millisecondi (ms). Ad esempio, specificare 500 millisecondi come 500ms. È possibile includere più valori in una singola immissione. Ad esempio, 1s500ms è equivalente a 1,5 secondi.

httpEndpoint > tcpOptions

Le opzioni del protocollo TCP per l'endpoint.

NameTypeDefaultDescription
inactivityTimeoutUn periodo di tempo con precisione al millisecondo60sL'intervallo di tempo di attesa del completamento di una richiesta di lettura o scrittura su un socket. Questo valore viene sostituito dai timeout specifici del protocollo. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m), secondi (s) o millisecondi (ms). Ad esempio, specificare 500 millisecondi come 500ms. È possibile includere più valori in una singola immissione. Ad esempio, 1s500ms è equivalente a 1,5 secondi.
soReuseAddrbooleanotrueAbilita il rebind immediato a una porta senza un listener attivo.
addressIncludeListstringUn elenco separato da virgole di indirizzi a cui è consentito effettuare connessioni in entrata su questo endpoint. È possibile specificare gli indirizzi IPv4 o IPv6. Tutti i valori in un indirizzo IPv4 o IPv6 devono essere rappresentati da un numero o da un carattere jolly asterisco.
addressExcludeListstringUn elenco separato da virgole di indirizzi a cui non è consentito effettuare connessioni in entrata su questo endpoint. È possibile specificare gli indirizzi IPv4 o IPv6. Tutti i valori in un indirizzo IPv4 o IPv6 devono essere rappresentati da un numero o da un carattere jolly asterisco.
hostNameIncludeListstringUn elenco separato da virgole di nomi host a cui è consentito effettuare connessioni in entrata su questo endpoint. I nomi host non sono sensibili al maiuscolo/minuscolo e possono iniziare con un asterisco, che viene utilizzato come un carattere jolly. Tuttavia, l'asterisco non può trovarsi altrove nel nome host. Ad esempio, *.abc.com è valido, ma *.abc.* non è valido.
hostNameExcludeListstringUn elenco separato da virgole di nomi host a cui non è consentito effettuare connessioni in entrata su questo endpoint. I nomi host non sono sensibili al maiuscolo/minuscolo e possono iniziare con un asterisco, che viene utilizzato come un carattere jolly. Tuttavia, l'asterisco non può trovarsi altrove nel nome host. Ad esempio, *.abc.com è valido, ma *.abc.* non è valido.

httpEndpoint > accessLogging

Configurazione della registrazione accessi HTTP per l'endpoint.

NameTypeDefaultDescription
enabledbooleanotrueAbilita la registrazione degli accessi.
filePathPercorso a un file${server.output.dir}/logs/http_access.logPercorso di directory e nome del file di log di accesso. Quando si specifica il percorso di directory, è possibile utilizzare le sostituzioni della variabile standard, ad esempio ${server.output.dir}.
logFormatstring%h %u %{t}W "%r" %s %bSpecifica il formato del log che viene utilizzato durante la registrazione delle informazioni di accesso al client.
maxFileSizeint
Min: 0
20La dimensione massima di un file di log, in megabyte, prima che ne venga eseguito il rollover; un valore 0 indica nessun limite.
maxFilesint
Min: 0
2Il numero massimo di file di log che verrà conservato prima che venga rimosso il file meno recente; un valore 0 indica nessun limite.

extraConfigProperties

Ulteriori proprietà  da aggiungere all'elemento Config nel file di configurazione del plug-in. Tali proprietà possono essere specificate dal supporto IBM per modificare il funzionamento del plug-in del server Web.