Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

15.3. Configurer le sous-système du Servlet/HTTP

Dans la console de gestion, cliquer sur l'onglet Configuration en haut de l'écran, développer le menu de sous-systèmes, puis développer le menu Web. Cliquer sur l'élément de menu de Servlet/HTTP. cliquer sur le nom du composant, puis cliquer sur modifier. Cliquer sur le bouton avancé pour afficher les options avancées. Les options sont expliquées ci-dessous.
Si les commandes d'interface CLI doivent être appliquées à un profil, ajouter le préfixe /profile=PROFILE.

Exemple 15.1. Configurez les nom de cette instance

/profile=full-ha/subsystem=web:write-attribute(name=instance-id,value=worker1)

Options de configuration globale

Timeout de session par défaut
Disponible à partir de JBoss EAP 6.4. Timeout de session par défaut du conteneur web.
Attribut d'interface CLI : default-session-timeout
Serveur virtuel par défaut
Le serveur virtuel par défaut du conteneur web.
L'attribut d'interface CLI : default-virtual-server
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.
Attribut d'interface CLI : instance-id
Natif
Ajouter le listener d'initialisation natif au conteneur web.
Attribut d'interface CLI : native. Valeurs: true ou false. Valeur par défaut : false.

Options de configuration JSP

Délai entre les vérifications
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.
Attribut d'interface CLI : check-interval
Développement
Si sur true, active Development Mode, qui produit davantage d'informations verbeuses de débogage. Valeur par défaut : false.
Attribut d'interface CLI : development
Désactivé
Si sur true, désactive le conteneur Java ServerPages (JSP). Valeur par défaut false. Utile si vous n'utilisez pas les pages JSP.
Attribut d'interface CLI : disabled
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. Option définie sur true par défaut.
Attribut d'interface CLI : instance-id
Afficher les fragments de 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. Valeur par défaut : true.
Attribut d'interface CLI : display-source-fragment
X Powered By
Si défini sur true, JSP engine est commercialisé x-powered-by. Valeur par défaut : true.
Attribut d'interface CLI : x-powered-by
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 15.2. 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)

Options de connecteurs

Nom
Un nom unique de connecteur, à but d'affichage.
Attribut d'interface CLI : 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 sockets sont configurées pour chaque serveur autonome, ou par l'intermédiaire de groupes de liaisons de sockets dans un domaine géré. Un groupe de liaisons de sockets est appliqué à un groupe de serveurs.
Attribut d'interface CLI : socket-binding
Schéma
Le schéma de connecteur web, comme HTTP ou HTTPS.
Attribut d'interface CLI :
Protocol
Le protocole de connecteur web à utiliser, comme AJP ou HTTP.
Attribut d'interface CLI : protocol
Activé
Indique si le connecteur web connecté est activé.
Attribut d'interface CLI : enabled
Redirect Port
Utilisé pour indiquer un numéro de port à utiliser en cas de redirection, normalement pour une redirection vers un connecteur AJP ou HTTPS (sécurisé).
Attribut d'interface CLI : redirect-port
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. L'option 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. Elle donne les mêmes résultats que l'option redirection-port
Attribut d'interface CLI : redirect-binding
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 15.3. 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)

Options de serveurs virtuels

Nom
Nom unique de serveur virtuel, à but d'affichage.
Attribut d'interface CLI : 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.
Attribut d'interface CLI : alias
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.
Attribut d'interface CLI : default-web-module