Un hôte virtuel fournit un regroupement logique pour la configuration d'applications Web sur un nom d'hôte donné. L'hôte virtuel par défaut (default_host) est approprié pour les configurations les plus simples.
Name | Type | Default | Description |
---|---|---|---|
id | string | ID de configuration unique. | |
enabled | boolean | true | Activer cet hôte virtuel. |
allowFromEndpointRef | Liste de références aux éléments httpEndpoint de niveau supérieur (chaîne dans laquelle les éléments sont séparés par des virgules). | Spécifiez l'identificateur d'un ou de plusieurs noeuds finaux HTTP pour limiter le trafic entrant de cet hôte virtuel aux noeuds finaux spécifiés. |
Associez un hôte et un port à cet hôte virtuel, à l'aide de la syntaxe host:port. L'hôte spécifié peut être une adresse IP, un nom d'hôte du serveur DNS (Domain Name Server) avec suffixe de nom de domaine, un nom d'hôte DNS ou une concordance de caractère générique sur tous les noms d'hôte. Notez que les adresses IPv6 doivent être placées entre crochets, [].
Spécifiez l'identificateur d'un ou de plusieurs noeuds finaux HTTP pour limiter le trafic entrant de cet hôte virtuel aux noeuds finaux spécifiés.
Name | Type | Default | Description |
---|---|---|---|
id | string | ID de configuration unique. | |
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 |
allowFromEndpoint > httpOptions
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. |
allowFromEndpoint > sslOptions
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. |
allowFromEndpoint > tcpOptions
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. |
allowFromEndpoint > accessLogging
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. |