Chapitre 17. Sous-système web

17.1. Configurer le sous-système web

Vous pouvez configurer la plupart des aspects du sous-système web à l'aide de la console de gestion sur le web ou l'interface CLI de ligne de commande. Chaque paramètre est expliqué dans l'ordre dans lequel il apparaît dans la console de gestion, et les commandes de l'interface CLI sont également fournies.
Afficher le sous-système basé web par la console de gestion

Pour configurer le sous-système de web à l'aide de la console de gestion sur le web, cliquez sur l'onglet Configuration en haut à droite de l'écran. Développez le menu de Subsystems, puis le menu Web. Chaque partie configurable du sous-système web est montrée.

Note

Le composant mod_cluster n'est disponible que si votre profil est ha ou full-ha, dans un domaine géré, ou si vous démarrez votre serveur autonome avec le profil standalone-ha ou standalone-full-ha. La configuration mod_cluster est abordée dans Section 19.5.2, « Configurer le sous-système mod_cluster ».
Configurer le conteneur JSP, les connecteurs HTTP, et les serveurs HTTP virtuels

Pour configurer le conteneur JSP, les connecteurs HTTP et des serveurs virtuels HTTP, cliquer sur l'entrée de menu Servlet/HTTP. Cliquer sur le bouton Edit pour modifier une valeur. Cliquer sur le bouton Advanced pour afficher les options avancées. Les options sont expliquées ci-dessous. Les options pour les serveurs virtuels et les connecteurs HTTP figurent dans des tableaux distincts.

Tableau 17.1. Options de configuration Servlet/HTTP

Option Description Commande CLI
ID de l'instance
L'identificateur utilisé pour activer l'affinité de session dans les scénarios d'équilibrage de charge. L'identificateur doit être unique sur tous les serveurs du cluster JBoss EAP et est ajouté à l'identificateur de session généré. Cela permet au proxy frontal de transmettre la session spécifique à une même instance de JBoss EAP. L'ID d'instance n'est pas défini par défaut.
/profile=full-ha/subsystem=web:write-attribute(name=instance-id,value=worker1)
Disabled?
Si sur true, désactive le conteneur Java ServerPages (JSP). Valeur par défaut false. Utile si vous n'utilisez pas les pages JSP.
/profile=full-ha/subsystem=web/configuration=jsp-configuration/:write-attribute(name=disabled,value=false)
Development?
Si sur true, active Development Mode, qui produit davantage d'informations verbeuses de débogage. Valeur par défaut false.
/profile=full-ha/subsystem=web/configuration=jsp-configuration/:write-attribute(name=development,value=false)
Keep Generated?
Cliquer sur Advanced pour voir cette option, si elle est cachée. Si sur true, garde les servlets générés. Défini sur true par défaut.
/profile=full-ha/subsystem=web/configuration=jsp-configuration/:write-attribute(name=keep-generated,value=true)
Check Interval?
Cliquer sur Advanced pour voir cette option, si elle est cachée. Valeur en secondes qui détermine la fréquence des vérifications de mises à jour JSP par un processus en arrière-plan. La valeur par défaut est 0.
/profile=full-ha/subsystem=web/configuration=jsp-configuration/:write-attribute(name=check-interval,value=0)
Display Source?
Cliquer sur Advanced pour voir cette option, si elle est cachée. Si sur true, le fragment de source JSP est affiché quand une erreur d'exécution a lieu. La valeur par défaut est true.
/profile=full-ha/subsystem=web/configuration=jsp-configuration/:write-attribute(name=display-source-fragment,value=true)
Les connecteurs AJP and HTTP utilisent mod_cluster, mod_jk, mod_proxy, ISAPI, et NSAPI pour l'équilibrage des charges et pour le clustering HA. Pour configurer un connecteur, sélectionner l'onglet Connectors et cliquer sur Add. Pour supprimer un connecteur, le sélectionner et cliquer sur Remove. Pour modifier un connecteur, le sélectionner et cliquer sur Edit.
Quand vous créez un nouveau connecteur par l'interface CLI, ses options sont définies aussitôt, comme dans la commande suivante :

Exemple 17.1. Créer un nouveau connecteur

/profile=full-ha/subsystem=web/connector=ajp/:add(socket-binding=ajp,scheme=http,protocol=AJP/1.3,secure=false,name=ajp,max-post-size=2097152,enabled=true,enable-lookups=false,redirect-port=8433,max-save-post-size=4096)

Tableau 17.2. Options de connecteur

Option Description Commande CLI
Nom
Un nom unique de connecteur, à but d'affichage.
/profile=full-ha/subsystem=web/connector=ajp/:read-attribute(name=name)
Liaisons de sockets
La liaison de socket nommée à laquelle le connecteur doit se lier. La liaison de socket est un mappage entre un nom de socket et un port réseau. Les liaisons de socket sont configurées pour chaque serveur autonome, ou par l'intermédiaire de groupes de liaison de socket dans un domaine géré. Un groupe de liaisons de sockets est appliqué à un groupe de serveurs.
/profile=full-ha/subsystem=web/connector=ajp/:write-attribute(name=socket-binding,value=ajp)
Schéma
Le schéma de connecteur web, comme HTTP ou HTTPS.
/profile=full-ha/subsystem=web/connector=ajp/:write-attribute(name=scheme,value=http)
Protocole
Le protocole de connecteur web à utiliser, comme AJP ou HTTP.
/profile=full-ha/subsystem=web/connector=ajp/:write-attribute(name=protocol,value=AJP/1.3)
Activé
Indique si le connecteur web connecté est activé.
/profile=full-ha/subsystem=web/connector=ajp/:write-attribute(name=enabled,value=true)
Redirect Port
Utilisé pour spécifier un numéro de port à utiliser en cas de redirection; les plus communs étant redirigés vers un connecteur «secure» (https) ou AJP
/profile=full-ha/subsystem=web/connector=http:write-attribute(name=redirect-port,value=8443)
Redirect Binding
La redirection de liaison est similaire pour rediriger le port en termes de comportement, sauf qu'il faut la spécification d'un nom de liaison de socket comme "valeur" au lieu d'un numéro de port. redirect-liaison fournit une plus grande flexibilité de configuration car il permet l'utilisation d'une liaison de socket pré-définie liaison (https, AJP etc.) vers le port spécifique de redirection. Il donne les mêmes résultats que l'option redirection-port
/profile=full-ha/subsystem=web/connector=http:write-attribute(name=redirect-binding,value=https)
Pour configurer des serveurs virtuels, cliquer sur l'onglet Virtual Servers. Utiliser le bouton Add pour ajouter un nouveau serveur virtuel. Pour modifier ou supprimer un serveur virtuel, le sélectionner et cliquer le bouton Edit ou Remove.
Quand vous ajoutez un nouveau serveur virtuel par l'interface CLI, toutes les options requises sont définies en même temps, comme par la commande suivante.

Exemple 17.2. Ajouter un nouveau serveur virtuel

/profile=full-ha/subsystem=web/virtual-server=default-host/:add(enable-welcome-root=true,default-web-module=ROOT.war,alias=["localhost","example.com"],name=default-host)

Tableau 17.3. Options de serveurs virtuels

Option Description Commande CLI
Nom
Nom unique de serveur virtuel, à but d'affichage.
/profile=full-ha/subsystem=web/virtual-server=default-host/:read-attribute(name=name)
Alias
Une liste de noms d'hôtes qui doivent correspondre à ce serveur virtuel. Dans la console de gestion, utiliser un nom d'hôte par ligne.
/profile=full-ha/subsystem=web/virtual-server=default-host/:write-attribute(name=alias,value=["localhost","example.com"])
Module par défaut
Le module dont l'application web doit être déployée au nœud racine de ce serveur virtuel et qui sera affiché quand aucun répertoire n'est donné par la requête HTTP.
/profile=full-ha/subsystem=web/virtual-server=default-host/:write-attribute(name=default-web-module,value=ROOT.war)