Proprietà utilizzate durante la generazione del file di configurazione del plug-in del server Web
Name | Type | Default | Description |
---|---|---|---|
pluginInstallRoot | string | /opt/IBM/WebSphere/Plugins | L'ubicazione di installazione del plug-in del server Web nel file system dell'host del server Web |
webserverName | string | webserver1 | Il 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. |
webserverPort | int Min: -1 Max: 65535 | 80 | Porta HTTP del server Web |
webserverSecurePort | int Min: -1 Max: 65535 | 443 | Porta HTTPS del server Web |
sslKeyringLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.kdb | Il percorso completo al file keyring SSL sull'host del server Web. |
sslStashfileLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.sth | Il percorso completo al file stash SSL sull'host del server Web. |
sslCertlabel | string | Specifica l'etichetta del certificato nel keyring che il plug-in deve utilizzare quando il contenitore Web richiede un certificato client dal plug-in. | |
ipv6Preferred | booleano | false | Utilizzato quando si risolve un host del server delle applicazioni {null} o {0}, per preferire il tipo di indirizzo, quando possibile |
httpEndpointRef | Un riferimento allelemento di livello più alto {0} (stringa). | defaultHttpEndpoint | 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'. |
connectTimeout | Un periodo di tempo con precisione al secondo | 5s | Identifica 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. |
serverIOTimeout | Un periodo di tempo con precisione al secondo | 900s | Identifica 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. |
wsServerIOTimeout | Un periodo di tempo con precisione al secondo | Identifica 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. | |
wsServerIdleTimeout | Un periodo di tempo con precisione al secondo | Identifica 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. | |
extendedHandshake | booleano | false | Se true, il plug-in del server Web utilizza un handshake esteso per determinare se il server delle applicazioni è in esecuzione. |
waitForContinue | booleano | false | Se 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. |
logFileName | Percorso a un file | Un 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. | |
logDirLocation | Percorso a una directory | ${pluginInstallRoot}/logs/${webserverName} | Obsoleto: Identifica la directory in cui è ubicato il file http_plugin.log. Consultare il nome file di log. |
serverIOTimeoutRetry | int Min: -1 Max: 65535 | -1 | Limita 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. |
loadBalanceWeight | int | 20 | Questo 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 |
| PRIMARY | Il 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 |
ESIEnable | booleano | true | La 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. |
ESIMaxCacheSize | int | 1024 | ESIMaxCacheSize è 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. |
ESIInvalidationMonitor | booleano | false | ESIInvalidationMonitor 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. |
ESIEnableToPassCookies | booleano | false | ESIEnableToPassCookies 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. |
trustedProxyEnable | booleano | Abilita l'utilizzo dei proxy affidabili. Quando specificata, questa proprietà sovrascrive il valore nel file di configurazione del plug-in del server web. | |
trustedProxyGroup | string | Un elenco separato da virgole di proxy affidabili. Quando specificata, questa proprietà sovrascrive il valore nel file di configurazione del plug-in del server web. |
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'.
Name | Type | Default | Description |
---|---|---|---|
onError |
| WARN | Azione 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. |
enabled | booleano | true | Attivare/disattivare la disponibilità di un endpoint. Quando questa opzione è impostata su true, questo endpoint verrà attivato dal dispatcher per gestire le richieste HTTP. |
host | string | localhost | L'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. |
httpPort | int Min: -1 Max: 65535 | La porta utilizzata per le richieste HTTP del client. Utilizzare -1 per disabilitare questa porta. | |
httpsPort | int Min: -1 Max: 65535 | La porta utilizzata per le richieste HTTP del client resa sicura con SSL (https). Utilizzare -1 per disabilitare questa porta. | |
httpOptionsRef | Un riferimento allelemento di livello più alto {0} (stringa). | defaultHttpOptions | Le opzioni del protocollo HTTP per l'endpoint. |
sslOptionsRef | Un riferimento allelemento di livello più alto {0} (stringa). | Le opzioni del protocollo SSL per l'endpoint. | |
tcpOptionsRef | Un riferimento allelemento di livello più alto {0} (stringa). | defaultTCPOptions | Le opzioni del protocollo TCP per l'endpoint. |
accessLoggingRef | Un riferimento allelemento di livello più alto {0} (stringa). | Configurazione della registrazione accessi HTTP per l'endpoint. |
Le opzioni del protocollo HTTP per l'endpoint.
Name | Type | Default | Description |
---|---|---|---|
keepAliveEnabled | booleano | true | Abilita 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. |
maxKeepAliveRequests | int Min: -1 | 100 | Il numero massimo di richieste persistenti consentite su una singola connessione HTTP, se le connessioni persistenti sono abilitate. Un valore -1 indica un numero illimitato. |
persistTimeout | Un periodo di tempo con precisione al secondo | 30s | L'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. |
readTimeout | Un periodo di tempo con precisione al secondo | 60s | L'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. |
writeTimeout | Un periodo di tempo con precisione al secondo | 60s | L'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. |
removeServerHeader | booleano | false | Rimuove le informazioni di implementazione del server dalle intestazioni HTTP e disabilita anche la pagina di benvenuto del Liberty Profile predefinito. |
NoCacheCookiesControl | booleano | true | Permette 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. |
AutoDecompression | booleano | true | Specifica se il canale HTTP decomprime automaticamente i dati del corpo richiesta in entrata. |
Le opzioni del protocollo SSL per l'endpoint.
Name | Type | Default | Description |
---|---|---|---|
sessionTimeout | Un periodo di tempo con precisione al secondo | 1d | L'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. |
suppressHandshakeErrors | booleano | false | Disabilitare 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. |
sslRef | Un riferimento allelemento di livello più alto {0} (stringa). | Il repertorio di configurazione SSL predefinito. Il valore predefinito è defaultSSLSettings. | |
sslSessionTimeout | Un periodo di tempo con precisione al millisecondo | 8640ms | Il 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. |
Le opzioni del protocollo TCP per l'endpoint.
Name | Type | Default | Description |
---|---|---|---|
inactivityTimeout | Un periodo di tempo con precisione al millisecondo | 60s | L'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. |
soReuseAddr | booleano | true | Abilita il rebind immediato a una porta senza un listener attivo. |
addressIncludeList | string | Un 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. | |
addressExcludeList | string | Un 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. | |
hostNameIncludeList | string | Un 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. | |
hostNameExcludeList | string | Un 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. |
Configurazione della registrazione accessi HTTP per l'endpoint.
Name | Type | Default | Description |
---|---|---|---|
enabled | booleano | true | Abilita la registrazione degli accessi. |
filePath | Percorso a un file | ${server.output.dir}/logs/http_access.log | Percorso 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}. |
logFormat | string | %h %u %{t}W "%r" %s %b | Specifica il formato del log che viene utilizzato durante la registrazione delle informazioni di accesso al client. |
maxFileSize | int Min: 0 | 20 | La dimensione massima di un file di log, in megabyte, prima che ne venga eseguito il rollover; un valore 0 indica nessun limite. |
maxFiles | int Min: 0 | 2 | Il numero massimo di file di log che verrà conservato prima che venga rimosso il file meno recente; un valore 0 indica nessun limite. |
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.