Un module
d'écoute de noeud final correspond au point (adresse) de réception
des messages d'un service entrant. Les modules d'écoute de
noeud final fournis avec WebSphere
Application Server prennent en
charge les liaisons SOAP sur HTTP et SOAP sur JMS.
Pourquoi et quand exécuter cette tâche
Les modules d'écoute de noeud final correspondent à un noeud final physique permettant de recevoir
des demandes de service entrantes. Un service entrant décrit une destination de bus sous la forme d'un service Web logique. Un port entrant associe un service entrant (logique)
à un module d'écoute de noeud final pour fournir un noeud final (physique)
à partir duquel le service peut être appelé. Par conséquent, vous devez avoir défini
un module d'écoute de noeud final pour pouvoir créer un port entrant.
Une demande arrive dans un module d'écoute de noeud final. Elle est ensuite
transmise à un port de communications entrantes (à ce stade, la sécurité et les listes de
gestionnaires JAX-RPC peuvent être appliquées), puis envoyée à la destination de services. Les réponses suivent le même
chemin, mais à l'envers.
Pour configurer un
nouveau module d'écoute de noeud final afin de l'utiliser avec un service
entrant, vous devez suivre une procédure à deux étapes :
- Configurez le module d'écoute pour un serveur d'applications ou un cluster
spécifique (comme indiqué dans cette tâche).
- Configurez un service entrant sur le même bus de façon à utiliser le module d'écoute
(comme indiqué dans la tâche Transformation d'un service Web hébergé en interne en service Web).
Pour
configurer un module d'écoute de noeud final via la console
d'administration, procédez comme suit :
Procédure
- Démarrez la console d'administration.
- Dans la sous-fenêtre de navigation, cliquez sur l'un des chemins suivants :
Le
formulaire
de collecte de modules d'écoute de noeud final s'affiche.
- Cliquez sur Nouveau. L'assistant
de création de module d'écoute de noeud final s'ouvre.
- A l'aide de l'assistant, créez une configuration de module d'écoute
de noeud final en effectuant la procédure ci-après. Pour plus d'informations
sur les propriétés définies à l'aide de l'assistant, voir Programmes d'écoute de noeud final [Paramètres]. Vous pouvez choisir d'utiliser les valeurs indiquées dans Exemples de valeurs pour la configuration d'un programme d'écoute de noeud final.
- Sélection
du nom du module d'écoute et du type de liaison.
- Nom
du module d'écoute de noeud final
- Entrez le nom sous lequel le module d'écoute de noeud final doit être
connu. Par exemple : wsgwsoaphttp, wsgwsoaphttp2, SOAPJMSChannel1, SOAPJMSChannel2.
- Type de liaison
- Sélectionnez
le type de liaison que ce module d'écoute de noeud final prend en
charge.
Pour un module d'écoute de noeud final SOAP sur HTTP ou SOAP sur HTTPS, sélectionnez SOAP/HTTP ou SOAP/HTTPS.
Pour un module d'écoute de noeud final SOAP sur JMS, sélectionnez SOAP/JMS.
- Facultatif : Configuration
des paramètres JMS.
Ce panneau s'affiche uniquement si vous avez sélectionné SOAP/JMS dans le panneau précédent.
Vous pouvez choisir de déployer votre application de module d'écoute
de noeud final afin d'utiliser une spécification d'activation ou un port d'écoute.
Les ports d'écouteur sont stabilisés. Pour plus d'informations, lisez l'article sur les fonctions stabilisées. Dans la mesure du possible, déployez l'application écouteur de noeud final pour qu'elle utilise une spécification d'activation.
Seules les spécifications d'activation peuvent être employées avec le fournisseur de messagerie
par défaut, tandis que le fournisseur de messagerie WebSphere MQ
permet d'utiliser les spécifications d'activation ou les ports d'écoute.
Dans
les listes déroulantes, sélectionnez le
port d'écoute ou
la spécification d'activation,
ainsi que la fabrique de connexions de
file d'attente configurée auparavant comme décrit dans Configuration des ressources JMS du module d'écoute de noeud final SOAP sur JMS synchrone.
- Configuration
des URL requises. Configurez les adresses Web de la racine de l'application et de la racine du serveur WSDL. Vous pouvez sélectionner
des adresses préconfigurées en fonction d'hôtes virtuels connus ou créer de nouvelles valeurs.
- Racine d'URL
- Sélectionnez ou tapez l'adresse qui permet aux clients externes d'accéder au noeud final du module d'écoute de noeud final. La racine URL est la racine de contexte de l'application d'écoute de noeud final et elle fournit la racine de l'adresse Web à utiliser pour créer les adresses de noeud final dans les fichiers WSDL pour diriger les demandeurs vers l'écouteur de noeud final.
- Un serveur HTTP peut être employé avec un serveur d'applications autonome.
Par ailleurs, si des clients externes emploient votre module d'écoute de noeud final pour
accéder à un cluster prenant en charge la haute disponibilité ou la gestion de la charge de travail, ce cluster utilise généralement un serveur HTTP (ou un serveur proxy WebSphere) configuré de façon appropriée et jouant le rôle de diffuseur IP. Dans les deux cas, si des clients externes accèdent au module d'écoute
de noeud final via un serveur HTTP ou un cluster de serveurs à l'aide du port 80 par défaut, indiquez le nom du serveur HTTP, sans numéro de port. Par exemple (pour le module d'écoute de noeud final 1 SOAP sur HTTP) :
http://www.votreentreprise.com/wsgwsoaphttp1
Pour un serveur d'applications autonome, votre module d'écoute de noeud final
est généralement configuré de façon à ce que les clients se connectent directement à un serveur d'applications
individuel.
Si des clients externes utilisent le module d'écoute pour accéder à un
cluster, vous pouvez le configurer pour que les clients se connectent
directement à un serveur d'applications individuels du cluster, comme indiqué dans
l'exemple ci-dessous, mais cette configuration risque de limiter les fonctions de haute disponibilité
ou de gestion de la charge de travail de votre cluster. Cependant, si vous autorisez des clients externes à se connecter directement à votre serveur d'applications (par exemple, car il s'agit d'un serveur autonome ou dans un environnement de développement ou de test), indiquez le nom d'hôte du serveur d'applications et le numéro de port. Par exemple (pour le module d'écoute de noeud final 1 SOAP sur HTTP) :http://nom.votre.serveur:9080/wsgwsoaphttp1
où
le numéro de port (dont le valeur est 9080 dans cet exemple) correspond à la valeur de port WC_defaultHost du
serveur d'applications concerné.
- Racine de l'URL HTTP servant le document WSDL
- Entrez la racine de l'adresse Web des fichiers WSDL des services entrants disponibles dans cet écouteur de noeud
final. Cette adresse contient la racine de l'adresse HTTP via laquelle des clients externes accèdent à votre application de module d'écoute de noeud final, suivie de /sibws. Elle correspond à l'URL utilisée pour publier l'URL WSDL dans un registre UDDI.
Les noms d'hôte et de port que vous indiquez pour la racine de l'URL HTTP servant le document WSDL correspondent généralement à ceux spécifiés pour la racine de l'URL.
Si les clients externes accèdent au programme d'écoute du noeud final via un serveur ou un cluster de serveurs HTTP, en utilisant le port par défaut 80, généralement, cette racine URL contient le nom du serveur HTTP et aucun numéro de port. Exemple :
http://www.votreentreprise.com/sibws
Cependant, si vous autorisez des clients externes à se connecter
directement à votre serveur d'applications (par exemple,
dans un environnement de développement ou de test), alors cette racine URL
indique le nom d'hôte du serveur d'applications et
le numéro de port. Par
exemple :
http://nom.votre.serveur:9080/sibws
Remarque : La racine URL HTTP qui sert le WSDL est utilisée uniquement en interne par les autres composants de WebSphere
Application Server (notamment le registre IBM UDDI). Pour toute autre utilisation, vous pouvez accéder au fichier WSDL via le noeud final du module d'écoute de noeud final du service entrant. Pour obtenir des informations détaillées sur l'emplacement d'un fichier WSDL de service entrant donné, publiez le fichier WSDL dans un fichier compressé comme décrit dans Modification d'une configuration de service entrant existante, puis recherchez l'emplacement dans le fichier WSDL exporté.
- Sélectionnez les bus d'intégration de services auxquels le nouveau module d'écoute de noeud final doit être connecté. Seuls les bus dont le serveur d'applications ou le cluster est membre peuvent être sélectionnés.
- Cliquez sur Finish.
Résultats
Si
le traitement aboutit, la liste des modules d'écoute de noeud final
est actualisée pour inclure le nouveau module d'écoute de noeud
final. Sinon, un message
d'erreur est s'affiche.
Que faire ensuite
Vous
pouvez désormais sélectionner ce module d'écoute de noeud final et
l'utiliser avec un service entrant, comme décrit dans
Transformation d'un service Web hébergé en interne en service Web.