Plug-in de serveur Web (pluginConfiguration)
Propriétés utilisées lors de la génération du fichier de configuration de serveur Web
| Nom de l'attribut | Type de données | Valeur par défaut | Description |
|---|---|---|---|
| connectTimeout | Période avec une précision à la seconde | 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. |
| extendedHandshake | Booléen | 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. |
| httpEndpointRef | Référence à l'élément httpEndpoint de niveau supérieur (string) | 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'. |
| ipv6Preferred | Booléen | 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 |
| logDirLocation | Chemin vers un répertoire | Obsolète : Identifie le répertoire sous lequel réside le fichier http_plugin.log. Voir Nom du fichier journal. | |
| logFileName | Chemin de fichier | ${pluginInstallRoot}/logs/${webserverName}/http_plugin.log | 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. |
| pluginInstallRoot | chaîne | /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 |
| serverIOTimeout | Période avec une précision à la seconde | 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. |
| serverIOTimeoutRetry | Entier
Minimum : -1 Maximum : 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. |
| sslCertlabel | chaîne | 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. | |
| sslKeyringLocation | chaîne | ${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 | chaîne | ${pluginInstallRoot}/config/${webserverName}/plugin-key.sth | Chemin d'accès complet du fichier de dissimulation (stash) SSL sur l'hôte du serveur Web |
| waitForContinue | Booléen | 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. |
| webserverName | chaîne | 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 | Entier
Minimum : -1 Maximum : 65535 |
80 | Port HTTP du serveur Web |
| webserverSecurePort | Entier
Minimum : -1 Maximum : 65535 |
443 | Port HTTPS du serveur Web |
| wsServerIOTimeout | Période avec une précision à la seconde | 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 | 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. |
- httpEndpoint
Description : 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'.Obligatoire : falseType de données Nom de l'attribut Type de données Valeur par défaut Description accessLoggingRef Référence à l'élément httpAccessLogging de niveau supérieur (string) Configuration de la journalisation des accès HTTP pour le noeud final. enabled Booléen 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 chaîne 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. httpOptionsRef Référence à l'élément httpOptions de niveau supérieur (string) defaultHttpOptions Options de protocole HTTP pour le noeud final. httpPort Entier Minimum : -1
Maximum : 65535
Le port utilisé par les demandes HTTP des clients. Utilisez -1 pour désactiver ce port. httpsPort Entier Minimum : -1
Maximum : 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. onError - IGNORE
- FAIL
- WARN
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.
- FAIL
- Le serveur émet un message d'avertissement ou d'erreur lors de la première erreur puis arrête le serveur.
- WARN
- Le serveur émet des messages d'avertissement et d'erreur lorsqu'il détecte une erreur de configuration.
sslOptionsRef Référence à l'élément sslOptions de niveau supérieur (string) Options de protocole SSL pour le noeud final. tcpOptionsRef Référence à l'élément tcpOptions de niveau supérieur (string) defaultTCPOptions Options de protocole TCP pour le noeud final. - httpEndpoint > accessLogging
Description : Configuration de la journalisation des accès HTTP pour le noeud final.Obligatoire : falseType de données Nom de l'attribut Type de données Valeur par défaut Description enabled Booléen true Activez la journalisation des accès. filePath Chemin de fichier ${server.output.dir}/logs/http_access.log Nom et chemin du répertoire dans lequel se trouve le fichier journal d'accès. Vous pouvez utiliser des substitutions de variable standard telles que ${server.output.dir} pour spécifier le chemin de répertoire. logFormat chaîne %h %u %{t}W "%r" %s %b Spécifie le format du journal qui est utilisé lors de la journalisation des informations d'accès client. maxFileSize Entier Minimum : 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 Entier Minimum : 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.
- httpEndpoint > httpOptions
Description : Options de protocole HTTP pour le noeud final.Obligatoire : falseType de données Nom de l'attribut Type de données Valeur par défaut Description keepAliveEnabled Booléen 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 Entier Minimum : -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 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 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. removeServerHeader Booléen false Supprime les informations d'implémentation du serveur des en-têtes HTTP et désactive la page d'accueil du profil Liberty par défaut. writeTimeout Période avec une précision à la seconde 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.
- httpEndpoint > sslOptions
Description : Options de protocole SSL pour le noeud final.Obligatoire : falseType de données Nom de l'attribut Type de données Valeur par défaut Description sessionTimeout Période avec une précision à la seconde 1d Durée à attendre 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. sslRef Référence à l'élément SSL de niveau supérieur (chaîne). Répertoire de configuration SSL par défaut. La valeur par défaut est defaultSSLSettings. suppressHandshakeErrors Booléen 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.
- httpEndpoint > tcpOptions
Description : Options de protocole TCP pour le noeud final.Obligatoire : falseType de données Nom de l'attribut Type de données Valeur par défaut Description inactivityTimeout Période avec une précision à la milliseconde près 60s Durée à attendre 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 Booléen true Permet une reliaison immédiate à un port sans écouteur actif.
Rubrique de référence