Création d'une configuration de module d'écoute de noeud final

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.

Avant de commencer

Pour chaque serveur ou cluster devant héberger un écouteur de noeud final, vous devez installer et configurer un référentiel SDO (Service Data Objects) sur le serveur autonome , ou (pour un serveur ou cluster faisant partie d'une cellule gérée) dans la cellule de déploiement de réseau.

Si vous voulez modifier le rôle de sécurité par défaut du module d'écoute de noeud final HTTP, procédez de la sorte avant de configurer le module d'écoute de noeud final SOAP sur HTTP.

Avant de configurer un module d'écoute de noeud final SOAP sur JMS, configurez les ressources JMS associées.

Vous pouvez configurer des modules d'écoute de noeud final distincts pour les demandes entrantes et sortantes. Pour plus d'informations, voir Modules d'écoute de noeud final et ports d'entrée : Points d'entrée sur le bus d'intégration de services.

Déterminez la méthode à utiliser pour configurer ces ressources. Vous pouvez créer une configuration d'écouteur de noeud final à l'aide de la console d'administration, comme décrit dans cette tâche, ou à l'aide de la Commande createSIBWSEndpointListener.
Remarque : Si vous souhaitez créer une configuration pour le module d'écoute de noeud final de votre propre application et non pour l'un des modules d'écoute fournis avec WebSphere Application Server, vous devez utiliser l'outil wsadmin.

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 :
  1. Configurez le module d'écoute pour un serveur d'applications ou un cluster spécifique (comme indiqué dans cette tâche).
  2. 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

  1. Démarrez la console d'administration.
  2. Dans la sous-fenêtre de navigation, cliquez sur l'un des chemins suivants :
    • Serveurs -> Types de serveurs -> Serveurs d'applications WebSphere -> nom_serveur -> Programmes d'écoute de noeud final
    • Serveurs -> Clusters -> Clusters de serveurs d'applications WebSphere -> nom_cluster -> Programmes d'écoute de noeud final
    Le formulaire de collecte de modules d'écoute de noeud final s'affiche.
  3. Cliquez sur Nouveau. L'assistant de création de module d'écoute de noeud final s'ouvre.
  4. 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.
    1. 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.
    2. 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.

    3. 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é.
    4. 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.
  5. 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.

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tjw_epl_new_61x
Nom du fichier : tjw_epl_new_61x.html