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.
Nom de l'attribut | Type de données | Valeur par défaut | Description |
---|---|---|---|
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. | |
enabled | boolean | true | Activer cet hôte virtuel. |
id | string | ID de configuration unique. |
- allowFromEndpoint
Description : 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.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 {0} de niveau supérieur (chaîne). Configuration de la journalisation des accès HTTP pour le noeud final 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. httpOptionsRef Référence à lélément {0} de niveau supérieur (chaîne). defaultHttpOptions Options de protocole HTTP pour le noeud final. httpPort int Minimum : -1
Maximum : 65535
Le port utilisé par les demandes HTTP des clients. Utilisez -1 pour désactiver ce port. httpsPort int 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. id string ID de configuration unique. 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 {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. - allowFromEndpoint > accessLogging
Description : Configuration de la journalisation des accès HTTP pour le noeud finalObligatoire : falseType de données Nom de l'attribut Type de données Valeur par défaut 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 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 int 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.
- allowFromEndpoint > 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 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 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 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. 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. 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.
- allowFromEndpoint > 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 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. 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 %ssl.sslSessionTimeout.desc. 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. 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.
- allowFromEndpoint > 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 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.
- hostAlias
Description : 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, [].Obligatoire : falseType de données string