pluginConfiguration - Plug-in de serveur Web (pluginConfiguration)

Propriétés utilisées lors de la génération du fichier de configuration de serveur Web

NameTypeDefaultDescription
pluginInstallRootstring/opt/IBM/WebSphere/PluginsEmplacement d'installation du plug-in de serveur Web sur le système de fichiers de l'hôte du serveur Web
webserverNamestringwebserver1Nom du serveur Web où cette configuration sera utilisée. Utilisé pour générer l'emplacement du fichier journal du plug-in s'il n'est pas spécifié explicitement par le répertoire ou le nom de fichier du journal.
webserverPortint
Min: -1

Max: 65535
80Port HTTP du serveur Web
webserverSecurePortint
Min: -1

Max: 65535
443Port HTTPS du serveur Web
sslKeyringLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.kdbChemin d'accès complet du fichier de clés SSL sur l'hôte du serveur Web
sslStashfileLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.sthChemin d'accès complet du fichier de dissimulation (stash) SSL sur l'hôte du serveur Web
sslCertlabelstringIndique le libellé du certificat du fichier de clés que le plug-in doit utiliser quand le conteneur Web demande un certificat client au plug-in.
ipv6PreferredbooleanfalseUtilisé pour résolution d'un nom d'hôte de serveur d'application indiquant {null} ou {0} afin de spécifier une préférence de type d'adresse si possible
httpEndpointRefRéférence à lélément {0} de niveau supérieur (chaîne).defaultHttpEndpointSpécifiez l'identificateur du noeud final HTTP à inclure dans le fichier plugin-cfg.xml généré. Le noeud final définit le serveur dans le cluster. La valeur par défaut est 'defaultHttpEndpoint'.
connectTimeoutPériode avec une précision à la seconde près5sIdentifie la durée maximale pendant laquelle le serveur d'application doit maintenir une connexion avec le serveur Web. Indiquez une valeur entière suivie d'une unité de temps, qui peut être heure (h), minute (m) ou seconde (s). Par exemple, pour 30 secondes, indiquez 30s. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1m30s correspond à 90 secondes.
serverIOTimeoutPériode avec une précision à la seconde près900sIdentifie la durée maximale pendant laquelle le serveur Web doit attendre que le plug-in de serveur Web envoie une demande ou reçoive une réponse du serveur d'application. Indiquez une valeur entière suivie d'une unité de temps, qui peut être heure (h), minute (m) ou seconde (s). Par exemple, pour 30 secondes, indiquez 30s. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1m30s correspond à 90 secondes.
wsServerIOTimeoutPériode avec une précision à la seconde prèsIdentifie la durée maximale pendant laquelle le serveur Web doit attendre que le plug-in de serveur Web envoie une demande ou reçoive une réponse websocket du serveur d'application. Indiquez une valeur entière suivie d'une unité de temps, qui peut être heure (h), minute (m) ou seconde (s). Par exemple, pour 30 secondes, indiquez 30s. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1m30s correspond à 90 secondes.
wsServerIdleTimeoutPériode avec une précision à la seconde prèsIdentifie le temps maximum attendu par le serveur Web avant l'arrêt d'une connexion websocket inactive. Indiquez une valeur entière suivie d'une unité de temps, qui peut être heure (h), minute (m) ou seconde (s). Par exemple, pour 30 secondes, indiquez 30s. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1m30s correspond à 90 secondes.
extendedHandshakebooleanfalseSi sa valeur est true, le plug-in de serveur Web utilise un établissement de liaison étendu pour déterminer si le serveur d'application est en opération.
waitForContinuebooleanfalseSi sa valeur est false (valeur par défaut), le plug-in de serveur Web envoie l'en-tête "Expect: 100-continue" avec les demandes HTTP comportant un corps de message. Si sa valeur est true, le plug-in de serveur Web envoie l'en-tête "Expect: 100-continue" avec chaque demande HTTP. Vous pouvez envisager de définir cette valeur à true si vous avez un pare-feu entre le serveur Web et le serveur d'application et devez distinguer les nouvelles tentatives de demandes sans corps de demande.
logFileNameChemin vers un fichierChemin d'accès complet du fichier journal du plug-in de serveur Web. Le composant répertoire doit déjà exister. Pour les serveurs Web basés Apache, un chemin commençant par une barre verticale est interprété comme un consignateur externe signalé par le signe barre verticale. S'il est spécifié, le chemin prévaut sur logDirLocation.
logDirLocationChemin vers un répertoire${pluginInstallRoot}/logs/${webserverName}Obsolète : Identifie le répertoire sous lequel réside le fichier http_plugin.log. Voir Nom du fichier journal.
serverIOTimeoutRetryint
Min: -1

Max: 65535
-1Limite le nombre de nouvelles tentatives de la demande après une expiration du délai d'attente de lecture ou d'écriture. La valeur par défaut, {-1}, n'applique pas d'autres limites, de sorte que les nouvelles tentatives ne sont limitées que par le nombre de serveurs disponibles dans le cluster. Une valeur {0} indique de ne pas effectuer d'autres tentatives. Cette valeur ne porte que sur le cluster de serveurs et ne s'applique pas aux échecs de connexion ou aux expirations de délai d'attente de connexion au plug-in HTTP ou au socket Web.
loadBalanceWeightint20Cette valeur est modifiée de manière dynamique en phase d'exécution. Le poids d'un serveur est diminué à chaque fois qu'une requête est affectée à ce serveur. Lorsque tous les poids de tous les serveurs chutent à 0 ou à une valeur inférieure, le plug-in du serveur Web réajuste tous les poids de manière à ce qu'ils soient supérieurs à 0.
serverRole
  • BACKUP
  • PRIMARY
PRIMARYLe rôle de serveur identifie un serveur comme serveur principal ou comme serveur de remplacement. Lorsque des serveurs principaux sont disponibles, le plug-in de serveur Web les utilise pour l'équilibrage des charges et la reprise. Cependant, si aucun des serveurs principaux n'est disponible, le plug-in de serveur Web utilise uniquement les serveurs de secours pour l'équilibrage des charges et les opérations de reprise.
BACKUP
De secours
PRIMARY
Principal
ESIEnablebooleantrueLa propriété ESIEnable active le traitement ESI (Edge Side Include) afin de mettre en cache les réponses. L'option décrite ici offre la possibilité d'outrepasser la valeur de cette propriété dans le fichier de configuration du plug-in de serveur web.
ESIMaxCacheSizeint1024ESIMaxCacheSize fixe la taille maximum du cache. Sa valeur par défaut est de 1 Mo (1MB). L'option décrite ici offre la possibilité d'outrepasser la valeur spécifiée pour cette propriété dans le fichier de configuration du plug-in de serveur web.
ESIInvalidationMonitorbooleanfalseESIInvalidationMonitor indique si le processeur ESI doit recevoir ou non les invalidations du serveur d'applications. L'option décrite ici offre la possibilité d'outrepasser la valeur spécifiée pour cette propriété dans le fichier de configuration du plug-in de serveur web.
ESIEnableToPassCookiesbooleanfalseESIEnableToPassCookies autorise ou non le transfert des cookies de session à WebSphere Application Server. L'option décrite ici offre la possibilité d'outrepasser la valeur spécifiée pour cette propriété dans le fichier de configuration du plug-in de serveur web.
trustedProxyEnablebooleanActive les proxys sécurisés à utiliser. Lorsqu'elle est spécifiée, cette propriété remplace la valeur dans le fichier de configuration du plug-in de serveur Web.
trustedProxyGroupstringListe de proxys sécurisés séparés par une virgule. Lorsqu'elle est spécifiée, cette propriété remplace la valeur dans le fichier de configuration du plug-in de serveur Web.

httpEndpoint

Spécifiez l'identificateur du noeud final HTTP à inclure dans le fichier plugin-cfg.xml généré. Le noeud final définit le serveur dans le cluster. La valeur par défaut est 'defaultHttpEndpoint'.

NameTypeDefaultDescription
onError
  • IGNORE
  • WARN
  • FAIL
WARNAction à entreprendre après une erreur lors du démarrage d'un noeud final.
IGNORE
Le serveur n'émet pas de message d'avertissement et d'erreur lorsqu'une erreur de configuration survient.
WARN
Le serveur émet des messages d'avertissement et d'erreur lorsqu'il détecte une erreur de configuration.
FAIL
Le serveur émet un message d'avertissement ou d'erreur lors de la première erreur puis arrête le serveur.
enabledbooleantrueDétermine la disponibilité d'un noeud final. Lorsque cette propriété a la valeur true, le noeud final est activé par le répartiteur afin de pouvoir prendre en charge des demandes HTTP.
hoststringlocalhostAdresse IP, nom d'hôte du serveur DNS (Domain Name Server) avec suffixe de nom de domaine ou nom d'hôte DNS seul, utilisé par un client pour demander une ressource. Utilisez '*' pour désigner toutes les interfaces réseau disponibles.
httpPortint
Min: -1

Max: 65535
Le port utilisé par les demandes HTTP des clients. Utilisez -1 pour désactiver ce port.
httpsPortint
Min: -1

Max: 65535
Le port utilisé par les demandes HTTP des clients lorsqu'elles sont émises sur la couche sécurisée SSL (https). Utilisez -1 pour désactiver ce port.
httpOptionsRefRéférence à lélément {0} de niveau supérieur (chaîne).defaultHttpOptionsOptions de protocole HTTP pour le noeud final.
sslOptionsRefRéférence à lélément {0} de niveau supérieur (chaîne).Options de protocole SSL pour le noeud final.
tcpOptionsRefRéférence à lélément {0} de niveau supérieur (chaîne).defaultTCPOptionsOptions de protocole TCP pour le noeud final.
accessLoggingRefRéférence à lélément {0} de niveau supérieur (chaîne).Configuration de la journalisation des accès HTTP pour le noeud final

httpEndpoint > httpOptions

Options de protocole HTTP pour le noeud final.

NameTypeDefaultDescription
keepAliveEnabledbooleantrueActive les connexions persistantes (HTTP keepalive). Si cette propriété est true, les connexions sont maintenues en vie et réutilisées par plusieurs demandes et réponses consécutives. Si la valeur est false, les connexions sont fermées une fois la réponse envoyée.
maxKeepAliveRequestsint
Min: -1
100Nombre maximal de demandes admises sur une même connexion HTTP, lorsque les connexions persistantes sont activées. La valeur -1 correspond à un nombre illimité.
persistTimeoutPériode avec une précision à la seconde près30sDurée pendant laquelle un socket peut rester au repos entre deux demandes. Cette propriété s'applique uniquement si les connexions persistantes sont activées. Indiquez une valeur entière suivie d'une unité de temps, qui peut être heure (h), minute (m) ou seconde (s). Par exemple, pour 30 secondes, indiquez 30s. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1m30s correspond à 90 secondes.
readTimeoutPériode avec une précision à la seconde près60sDélai maximal, accordé à l'exécution d'une demande de lecture sur un socket une fois que la première lecture a eu lieu. Indiquez une valeur entière suivie d'une unité de temps, qui peut être heure (h), minute (m) ou seconde (s). Par exemple, pour 30 secondes, indiquez 30s. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1m30s correspond à 90 secondes.
writeTimeoutPériode avec une précision à la seconde près60sDurée accordée à l'attente sur un socket de chaque partie des données de réponse à transmettre. Indiquez une valeur entière suivie d'une unité de temps, qui peut être heure (h), minute (m) ou seconde (s). Par exemple, pour 30 secondes, indiquez 30s. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1m30s correspond à 90 secondes.
removeServerHeaderbooleanfalseRetire les informations d'implémentation de serveur des en-têtes HTTP et désactive également la page d'accueil par défaut du profil Liberty.
NoCacheCookiesControlbooleantruePermet à l'utilisateur de contrôler si la présence, ou non, d'un en-tête Set-Cookie doit mettre à jour l'en-tête Cache-Control avec la valeur no-cache correspondante. Cette option ajoute également l'en-tête Expires.
AutoDecompressionbooleantrueSpécifie si le canal HTTP doit décompresser automatiquement les données de corps de demande entrante.

httpEndpoint > sslOptions

Options de protocole SSL pour le noeud final.

NameTypeDefaultDescription
sessionTimeoutPériode avec une précision à la seconde près1dDélai d'attente avant qu'une demande de lecture ou d'écriture n'aboutisse sur un socket. Cette valeur est supplantée par les temporisations (timeouts) propres au protocole. Indiquez une valeur entière suivie d'une unité de temps, qui peut être heure (h), minute (m) ou seconde (s). Par exemple, pour 30 secondes, indiquez 30s. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1m30s correspond à 90 secondes.
suppressHandshakeErrorsbooleanfalseDésactiver la consignation des erreurs d'établissement de liaison SSL. Ces erreurs peuvent se produire en mode de fonctionnement normal ; toutefois, ces messages peuvent être utiles lorsque SSL se comporte de manière inattendue.
sslRefRéférence à lélément {0} de niveau supérieur (chaîne).Répertoire de configuration SSL par défaut. La valeur par défaut est defaultSSLSettings.
sslSessionTimeoutPériode avec une précision à la milliseconde près8640msLimite d'attente d'une session SSL établie par le canal SSL. Indiquez une valeur entière positive suivie d'une unité de temps, qui peut être heure (h), minute (m), seconde (s) ou milliseconde (ms). Par exemple, pour 500 millisecondes, indiquez 500ms. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1s500ms correspond à 1 seconde et demie.

httpEndpoint > tcpOptions

Options de protocole TCP pour le noeud final.

NameTypeDefaultDescription
inactivityTimeoutPériode avec une précision à la milliseconde près60sDélai d'attente avant qu'une demande de lecture ou d'écriture n'aboutisse sur un socket. Cette valeur est supplantée par les temporisations (timeouts) propres au protocole. Indiquez une valeur entière positive suivie d'une unité de temps, qui peut être heure (h), minute (m), seconde (s) ou milliseconde (ms). Par exemple, pour 500 millisecondes, indiquez 500ms. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1s500ms correspond à 1 seconde et demie.
soReuseAddrbooleantruePermet une nouvelle liaison immédiate à un port sans écouteur actif.
addressIncludeListstringListe d'adresses, séparées par des virgules, autorisées à établir des connexions entrantes sur ce noeud final. Vous pouvez spécifiez des adresse IPv4 ou IPv6. Toutes les valeurs des adresses IPv4 ou IPv6 doivent être représentées par un nombre ou par un caractère générique.
addressExcludeListstringListe d'adresses, séparées par des virgules, non autorisées à établir des connexions entrantes sur ce noeud final. Vous pouvez spécifiez des adresse IPv4 ou IPv6. Toutes les valeurs des adresses IPv4 ou IPv6 doivent être représentées par un nombre ou par un caractère générique.
hostNameIncludeListstringListe de noms d'hôte, séparés par des virgules, autorisés à établir des connexions entrantes sur ce noeud final. Les noms d'hôte ne sont pas sensibles à la casse et peuvent commencer par un astérisque, lequel est utilisé en tant que caractère générique. Toutefois, vous ne pouvez pas utiliser ailleurs des astérisques dans le nom d'hôte. Par exemple, *.abc.com est valide, mais *.abc.* ne l'est pas.
hostNameExcludeListstringListe de noms d'hôte, séparés par des virgules, non autorisés à établir des connexions entrantes sur ce noeud final. Les noms d'hôte ne sont pas sensibles à la casse et peuvent commencer par un astérisque, lequel est utilisé en tant que caractère générique. Toutefois, vous ne pouvez pas utiliser ailleurs des astérisques dans le nom d'hôte. Par exemple, *.abc.com est valide, mais *.abc.* ne l'est pas.

httpEndpoint > accessLogging

Configuration de la journalisation des accès HTTP pour le noeud final

NameTypeDefaultDescription
enabledbooleantrueActivation de la journalisation des accès.
filePathChemin vers un fichier${server.output.dir}/logs/http_access.logChemin de répertoire et nom du fichier journal des accès. Des substitutions de variable standard telles que ${server.output.dir} peuvent être utilisées pour spécifier le chemin de répertoire.
logFormatstring%h %u %{t}W "%r" %s %bIndique le format de journal utilisé lors de la journalisation des informations d'accès des clients.
maxFileSizeint
Min: 0
20Taille maximale d'un fichier journal, en mégaoctets, avant sa clôture. La valeur 0 (zéro) signifie l'absence de limite de taille.
maxFilesint
Min: 0
2Nombre maximal de fichiers journaux qui seront conservés avant que le fichier le plus ancien ne soit supprimé. La valeur 0 (zéro) signifie qu'il n'existe aucune limite.

extraConfigProperties

Propriétés supplémentaires à ajouter dans l'élément Config dans le fichier de configuration de plug-in généré. Ces propriétés peuvent être spécifiées par le support IBM afin de modifier le comportement du plug-in du serveur Web.