Red Hat Training

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

17.4.6. Configurer JBoss EAP 6 pour accepter des requêtes en provenance des serveurs web externes

Aperçu

JBoss EAP 6 n'a pas besoin de savoir de quel proxy elle accepte les requêtes, uniquement le port et le protocole. Ce n'est pas le cas pour mod_cluster, qui est davantage lié à la configuration de JBoss EAP 6. En revanche, les tâches suivantes fonctionnent pour mod_jk, mod_proxy, ISAPI, et NSAPI. Substituer les protocoles et les ports que vous aurez besoin de configurer par ceux des exemples.

Pour configurer JBoss EAP 6 pour mod_cluster, consulter Section 17.6.6, « Configurer un nœud de worker de mod_cluster ».

Conditions préalables

  • Vous devrez être connecté au Management CLI ou à la console de gestion pour effectuer cette tâche. Les étapes précises utilisent l'interface CLI, mais la même procédure de base est utilisée dans la console de gestion.
  • Vous aurez besoin d'une liste des protocoles que vous devrez utiliser, que ce soit HTTP, HTTPS ou AJP.

Procédure 17.6. Modifier la configuration et ajouter les liaisons de socket

  1. Configurer les propriétés de système jvmRoute

    Par défaut, le jvmRoute est sur la même valeur que le nom du serveur. Si vous avez besoin de le personnaliser, vous pouvez utiliser une commande semblable à la suivante. Remplacer ou supprimer la partie de la commande /profile=ha, en fonction du profil que vous utilisez ou si vous utilisiez un serveur autonome. Remplacez la chaîne CUSTOM_ROUTE_NAME par votre nom jvmRoute personnalisé.
    [user@localhost:9999 /] /profile=ha/subsystem=web:write-attribute(name="instance-id",value="CUSTOM_ROUTE_NAME")
  2. Lister les connecteurs disponibles dans le sous-sytème.

    Note

    Cette étape est nécessaire uniquement si vous n'utilisez pas les profils ha ou complète-ha dans un serveur autonome ou un groupe de serveurs dans un domaine géré. Ces configurations incluent déjà tous les connecteurs nécessaires.
    Pour qu'un service de serveur web externe puisse se connecter au serveur web de JBoss EAP 6, le sous-système web doit avoir un connecteur. Chaque protocole a besoin de son propre connecteur, lié à un groupe de sockets.
    Pour avoir la liste des connecteurs actuellement disponibles, lancer la commande suivante :
    [standalone@localhost:9999 /] /subsystem=web:read-children-names(child-type=connector)
    S'il n'y a aucune ligne sur le connecteur dont vous avez besoin (HTTP, HTTPS, AJP), vous devrez ajouter un connecteur.
  3. Lire la configuration d'un connecteur.

    Pour voir les détails de configuration d'un connecteur, vous pourrez lire sa configuration. La commande suivante lit la configuration du connecteur AJP. Les autres connecteurs ont des sorties de configuration semblables.
    [standalone@localhost:9999 /] /subsystem=web/connector=ajp:read-resource(recursive=true)
    {
        "outcome" => "success",
        "result" => {
            "enable-lookups" => false,
            "enabled" => true,
            "max-post-size" => 2097152,
            "max-save-post-size" => 4096,
            "protocol" => "AJP/1.3",
            "redirect-port" => 8443,
            "scheme" => "http",
            "secure" => false,
            "socket-binding" => "ajp",
            "ssl" => undefined,
            "virtual-server" => undefined
        }
    }
    
  4. Ajouter les connecteurs utiles au sous-système web.

    Pour ajouter un connecteur au sous-système web, il doit y avoir une liaison de sockets. La liaison de sockets est ajoutée au groupe de liaisons de sockets utilisées par votre serveur ou groupe de serveurs. Les étapes suivantes supposent que votre groupe de serveurs est server-group-one et que votre groupe de liaisons de sockets est standard-sockets.
    1. Ajouter une liaison au groupe de liaisons de sockets.

      Pour ajouter un groupe de liaison de sockets, lancer la commande suivante, en remplaçant le protocole et le port par ceux dont vous avez besoin.
      [standalone@localhost:9999 /] /socket-binding-group=standard-sockets/socket-binding=ajp:add(port=8009)
    2. Ajouter la liaison de socket au sous-système web.

      Lancer la commande suivante pour ajouter un connecteur au sous-système web, en substituant le nom de liaison de socket et le protocole par ceux que vous avez besoin.
      [standalone@localhost:9999 /] /subsystem=web/connector=ajp:add(socket-binding=ajp, protocol="AJP/1.3", enabled=true, scheme="http")