Red Hat SummitChapitre 15. Sous-système web
15.1. Configurer le Sous-système Web
Copier lienLien copié sur presse-papiers!
Vous pouvez configurer la plupart des aspects du sous-système Web à l'aide de la Console de gestion sur le web ou le Management 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 Management CLI de gestion 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, cliquer sur l'onglet Profile(s) en haut à droite. Pour un domaine géré, sélectionner le profil de serveur que vous souhaitez configurer dans la boîte de sélection de Profil en haut à gauche. Développer le menu de Subsystems, puis le menu Web. Chaque partie configurable du sous-système Web est montré.
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 16.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.
| Option | Description | Commande CLI |
|---|---|---|
| Désactivé ? |
Si défini sur
true, le conteneur Java ServerPages (JSP) sera désactivé. Valeur par défaut false. Utile si vous n'utilisez pas les pages Java ServerPages (JSPs).
|
/profile=full-ha/subsystem=web/configuration=jsp-configuration/:write-attribute(name=disabled,value=false) |
| Développement ? |
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) |
| Garder Générés ? |
Cliquer sur Advanced pour voir cette option, si elle est cachée. Si sur
true garde les servlets générés. Activé par défaut.
|
/profile=full-ha/subsystem=web/configuration=jsp-configuration/:write-attribute(name=keep-generated,value=true) |
| Vérifier l'intervalle ? |
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) |
| Afficher 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 le Management CLI, ses options sont définies aussitôt, comme dans la commande suivante :
Exemple 15.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)
/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)| 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) |
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 le Management CLI, toutes les options requises sont définies en même temps, comme par la commande suivante.
Exemple 15.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)
/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)| Option | Description | Commande CLI |
|---|---|---|
| Nom |
Nom unique de serveur virtuel, à but d'affichage.
| |
| Alias |
Une liste de noms d'hôtes qui doivent correspondre à ce serveur virtuel. Dans la Console de management, 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) |
Configurer les Options de services web
Pour configurer les options de services web, cliquer sur Web Services. Les options sont expliquées dans le tableau ci-dessous.
| Option | Description | Commande CLI |
|---|---|---|
| Modifier l'adresse WSDL |
Indique si l'adresse WSDL peut être modifiée par les applications. Valeur par défaut
true.
|
/profile=full-ha/subsystem=webservices/:write-attribute(name=modify-wsdl-address,value=true) |
| Hôte WSDL |
Le contrat WSDL d'un Service Web JAX-WS inclut un élément <soap:address> qui pointe vers l'emplacement du point de terminaison. Si la valeur de <soap:address> est un URL valide, elle n'est pas remplacée à moins que
modify-wsdl-adress soit défini à la valeur true. Si la valeur de <soap:address> n'est pas un URL valide, elle est remplacée en utilisant les valeurs wsdl-host et wsdl-port ou wsdl-secure-port. Si wsdl-host est défini sur jbossws.undefined.host, l'adresse hôte de l'auteur de la demande est utilisée lorsque <soap:address> est réécrite. Par défaut, ${jboss.bind.address:127.0.0.1}, qui utilise 127.0.0.1 si aucune adresse de liaison est spécifiée lors du démarrage de JBoss EAP 6.
|
/profile=full-ha/subsystem=webservices/:write-attribute(name=wsdl-host,value=127.0.0.1) |
| Port WSDL |
Le port non-sécurisé utilisé pour écrire à nouveau l'adresse SOAP. Si définie sur
0 (défaut), le port sera identifié en demandant la liste des connecteurs installés.
|
/profile=full-ha/subsystem=webservices/:write-attribute(name=wsdl-port,value=80) |
| Port sécurisé WSDL |
Le port sécurisé utilisé pour écrire à nouveau l'adresse SOAP. Si définie sur
0 (défaut), le port sera identifié en demandant la liste des connecteurs installés.
|
/profile=full-ha/subsystem=webservices/:write-attribute(name=wsdl-secure-port,value=443) |
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}