Propriétés utilisées lors de la génération du fichier de configuration de serveur Web
Name | Type | Default | Description |
---|---|---|---|
pluginInstallRoot | string | /opt/IBM/WebSphere/Plugins | Emplacement d'installation du plug-in de serveur Web sur le système de fichiers de l'hôte du serveur Web |
webserverName | string | webserver1 | Nom 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. |
webserverPort | int Min: -1 Max: 65535 | 80 | Port HTTP du serveur Web |
webserverSecurePort | int Min: -1 Max: 65535 | 443 | Port HTTPS du serveur Web |
sslKeyringLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.kdb | Chemin d'accès complet du fichier de clés SSL sur l'hôte du serveur Web |
sslStashfileLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.sth | Chemin d'accès complet du fichier de dissimulation (stash) SSL sur l'hôte du serveur Web |
sslCertlabel | string | Indique 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. | |
ipv6Preferred | boolean | false | Utilisé 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 |
httpEndpointRef | Référence à lélément {0} de niveau supérieur (chaîne). | defaultHttpEndpoint | 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'. |
connectTimeout | Période avec une précision à la seconde près | 5s | Identifie 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. |
serverIOTimeout | Période avec une précision à la seconde près | 900s | Identifie 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. |
wsServerIOTimeout | Période avec une précision à la seconde près | Identifie 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. | |
wsServerIdleTimeout | Période avec une précision à la seconde près | Identifie 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. | |
extendedHandshake | boolean | false | Si 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. |
waitForContinue | boolean | false | Si 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. |
logFileName | Chemin vers un fichier | Chemin 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. | |
logDirLocation | Chemin 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. |
serverIOTimeoutRetry | int Min: -1 Max: 65535 | -1 | Limite 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. |
loadBalanceWeight | int | 20 | Cette 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 |
| PRIMARY | Le 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 |
ESIEnable | boolean | true | La 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. |
ESIMaxCacheSize | int | 1024 | ESIMaxCacheSize 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. |
ESIInvalidationMonitor | boolean | false | ESIInvalidationMonitor 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. |
ESIEnableToPassCookies | boolean | false | ESIEnableToPassCookies 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. |
trustedProxyEnable | boolean | Active 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. | |
trustedProxyGroup | string | Liste 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. |
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'.
Name | Type | Default | Description |
---|---|---|---|
onError |
| WARN | Action à 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. |
enabled | boolean | true | Dé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. |
host | string | localhost | Adresse 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. |
httpPort | int Min: -1 Max: 65535 | Le port utilisé par les demandes HTTP des clients. Utilisez -1 pour désactiver ce port. | |
httpsPort | int 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. | |
httpOptionsRef | Référence à lélément {0} de niveau supérieur (chaîne). | defaultHttpOptions | Options de protocole HTTP pour le noeud final. |
sslOptionsRef | Référence à lélément {0} de niveau supérieur (chaîne). | Options de protocole SSL pour le noeud final. | |
tcpOptionsRef | Référence à lélément {0} de niveau supérieur (chaîne). | defaultTCPOptions | Options de protocole TCP pour le noeud final. |
accessLoggingRef | Référence à lélément {0} de niveau supérieur (chaîne). | Configuration de la journalisation des accès HTTP pour le noeud final |
Options de protocole HTTP pour le noeud final.
Name | Type | Default | Description |
---|---|---|---|
keepAliveEnabled | boolean | true | Active 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. |
maxKeepAliveRequests | int Min: -1 | 100 | Nombre maximal de demandes admises sur une même connexion HTTP, lorsque les connexions persistantes sont activées. La valeur -1 correspond à un nombre illimité. |
persistTimeout | Période avec une précision à la seconde près | 30s | Duré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. |
readTimeout | Période avec une précision à la seconde près | 60s | Dé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. |
writeTimeout | Période avec une précision à la seconde près | 60s | Duré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. |
removeServerHeader | boolean | false | Retire 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. |
NoCacheCookiesControl | boolean | true | Permet à 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. |
AutoDecompression | boolean | true | Spécifie si le canal HTTP doit décompresser automatiquement les données de corps de demande entrante. |
Options de protocole SSL pour le noeud final.
Name | Type | Default | Description |
---|---|---|---|
sessionTimeout | Période avec une précision à la seconde près | 1d | Dé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. |
suppressHandshakeErrors | boolean | false | Dé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. |
sslRef | Ré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. | |
sslSessionTimeout | Période avec une précision à la milliseconde près | 8640ms | Limite 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. |
Options de protocole TCP pour le noeud final.
Name | Type | Default | Description |
---|---|---|---|
inactivityTimeout | Période avec une précision à la milliseconde près | 60s | Dé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. |
soReuseAddr | boolean | true | Permet une nouvelle liaison immédiate à un port sans écouteur actif. |
addressIncludeList | string | Liste 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. | |
addressExcludeList | string | Liste 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. | |
hostNameIncludeList | string | Liste 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. | |
hostNameExcludeList | string | Liste 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. |
Configuration de la journalisation des accès HTTP pour le noeud final
Name | Type | Default | Description |
---|---|---|---|
enabled | boolean | true | Activation de la journalisation des accès. |
filePath | Chemin vers un fichier | ${server.output.dir}/logs/http_access.log | Chemin 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. |
logFormat | string | %h %u %{t}W "%r" %s %b | Indique le format de journal utilisé lors de la journalisation des informations d'accès des clients. |
maxFileSize | int Min: 0 | 20 | Taille maximale d'un fichier journal, en mégaoctets, avant sa clôture. La valeur 0 (zéro) signifie l'absence de limite de taille. |
maxFiles | int Min: 0 | 2 | Nombre 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. |
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.