virtualHost - Hôte virtuel (virtualHost)

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.

NameTypeDefaultDescription
idstringID de configuration unique.
enabledbooleantrueActiver cet hôte virtuel.
allowFromEndpointRefListe 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.

hostAlias

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, [].

allowFromEndpoint

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.

NameTypeDefaultDescription
idstringID de configuration unique.
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

allowFromEndpoint > 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.

allowFromEndpoint > 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.

allowFromEndpoint > 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.

allowFromEndpoint > 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.