Migration d'un configuration de passerelle de services Web Version 5.1

En WebSphere Application Server Version 5.1, la passerelle des services Web était un composant distinct doté de sa propre interface utilisateur. Dans les versions suivantes du produit, la passerelle est intégrée aux services Web compatibles avec le bus d'intégration de services et est mise en oeuvre pour étendre et lier les services entrants et sortants. Vous utilisez un script de commande wsadmin pour faire migrer une configuration de passerelle existante d'un serveur d'applications Version 5.1 vers un serveur d'applications ou un cluster sur une version ultérieure.

Avant de commencer

Déterminez s'il est nécessaire de migrer les passerelles existantes :
  • WebSphere Application Server Version 5.0 n'est plus pris en charge. Il est donc recommandé de migrer les passerelles existantes en cours d'exécution sur des serveurs d'applications Version 5.0 et de les exécuter au même niveau que le produit.
  • Les passerelles de services Web en cours d'exécution sur WebSphere Application Server Version 5.1 peuvent, avec certaines restrictions, coexister avec les instances de passerelle qui s'exécutent sur les Version 7.0 ou ultérieures serveurs d'applications,.
  • Un Version 7.0 ou ultérieures peut contenir Version 5.1, Version 6 et Version 7.0 ou ultérieures serveurs d'applications,.
Pour plus d'informations, voir Coexistence : conservation ou migration d'une passerelle de Version 5.1.

Vous pouvez faire migrer une passerelle Version 5.1 utilisée dans un environnement de production sans l'arrêter. Les applications à l'origine des demandes peuvent alors utiliser la nouvelle configuration de passerelle, la passerelle Version 5.1 existante poursuivant son exécution en parallèle.

Pourquoi et quand exécuter cette tâche

Le processus de migration emploie une application de passerelle Version 5.1 dont la configuration a été exportée vers un fichier XML et utilise ce dernier pour configurer les mêmes fonctions de passerelle sur un cluster ou un serveur d'applications unique sur la version ultérieure. Pour ce faire, exportez la configuration de la passerelle Version 5.1, puis exécutez un script pour migrer la configuration exportée dans une nouvelle instance de passerelle, située sur un serveur d'applications ou un cluster existant sur la version ultérieure.

La configuration Version 5.1 est migrée comme suit :
  • Lors du processus de migration, une instance de passerelle est créée automatiquement.
  • Les services de passerelle, les services cible et les références UDDI sont migrés directement.
  • Les définitions dans la passerelle des gestionnaires JAX-RPC et des listes de gestionnaires sont également migrées. Vous devez vous assurer que les classes de gestionnaire sous-jacentes sont disponibles lors de l'exécution.
  • Les affectations de service de passerelle à des canaux spécifiques sont remplacées par des affectations équivalentes à des paires port de communications entrantes/programme d'écoute de noeud final (car dans les versions ultérieures, les fonctions d'un canal sont partagées entre un programme d'écoute de noeud final et un port de communications entrantes). Tout canal SOAP Apache utilisé est migré vers un port de communications entrantes et un programme d'écoute de noeud final SOAP sur HTTP.
  • Les filtres ne sont pas migrés. L'utilisation de filtres était déconseillée dans Version 5.1.1. Leur prise en charge a été supprimée dans la version 7.0. Le rôle anciennement joué par les filtres est désormais pris en charge par une combinaison de gestionnaires JAX-RPC et de médiations de bus d'intégration de services.
  • Les clients de services Web qui sont générés à partir du WSDL pour le service cible, et non pour le service de passerelle, sont marqués par défaut comme erreur dans les versions ultérieures.
  • Si vous avez utilisé le document WSDL du service de passerelle Version 5.1 pour générer les clients de services Web et que la liaison WSDL et le style de codage ne sont pas de type document littéral, après la migration vers une version ultérieure, vous devez régénérer les modules de remplacement client à l'aide du nouveau fichier WSDL du service de passerelle.
  • Les liaisons WS-Security sont migrées en tant que liaisons compatibles avec la spécification WS-Security Draft 13. Toutefois :
    • La version finale (1.0) de la spécification WS-Security (implémentée dans WebSphere Application Server Version 6) n'est pas compatible avec la version Draft 13. Il est donc déconseillé d'utiliser WS-Security Draft 13 dans WebSphere Application Server Version 6. WS-Security Draft 13 est obsolète et vous devez vous en servir uniquement pour continuer à utiliser une application client de services Web existante écrite conformément à la spécification WS-Security Draft 13.
    • Les objets de liaison WS-Security sont migrés uniquement si le processus de migration est effectué sur la machine où le serveur cible exécute dans le cas d'un serveur autonome, ou sur la machine où le gestionnaire de déploiement exécute une configuration de déploiement réseau.
    • Seuls les objets de liaison WS-Security utilisés par un service de passerelle ou par une configuration WS-Security du service cible sont migrés. Les objets de liaison que vous avez créés mais que vous n'utilisez pas ne sont pas migrés. Par exemple : Si vous avez une configuration WS-Security qui fait référence à un objet d'informations de signature et que ce dernier fait référence à un ancrage sécurisé, alors les informations de signature et l'ancrage sécurisé sont migrés en même temps que la configuration WS-Security qui les référence.
Remarque :
  • La migration suppose que les adresses Web externes des services migrés n'ont pas été modifiées. Cette supposition s'appuie sur le fait que ces adresses sont associées à un serveur Web et non pas à la machine sur laquelle la passerelle est hébergée et que le nom d'hôte et le numéro de port de ces adresses ne sont donc pas affectés. Si, dans la configuration, les adresses Web externes pointent vers la machine de la passerelle, modifiez la configuration du programme d'écoute de noeud final une fois le processus de migration terminé.
  • Vous pouvez utiliser WebSphere Application Server Network Deployment pour migrer vers un serveur unique s'exécutant sous l'un ou l'autre des profils de configuration (serveur autonome ou gestionnaire de déploiement). Toutefois, vous devez toujours effectuer la migration vers un serveur unique en cours d'exécution sous un profil de gestionnaire de déploiement. Si vous effectuez la migration vers un profil de serveur autonome, vous ne pouvez pas utiliser la console d'administration pour modifier ensuite la configuration de la passerelle.
  • Les services Web activés par un bus d'intégration de services procèdent à une validation plus complète des messages de service Web que WebSphere Application Server Version 5.1. Par conséquent, certaines applications client qui utilisent des demandes ou des réponses dont la syntaxe est incorrecte (où les noms des parties de message sont incorrects) et qui fonctionnent lors de l'utilisation de Version 5.1 sont désormais identifiées comme ayant une syntaxe incorrecte. Pour connaître la procédure à suivre pour résoudre l'incident, voir Services Web activés par un bus : restrictions connues.

Pour faire migrer une configuration de passerelle existante depuis un serveur d'applications Version 5.1 vers la fonction de passerelle sur un serveur d'applications ou un cluster d'une version ultérieure, procédez comme suit :

Procédure

  1. Facultatif : Supprimez les filtres de votre passerelle Version 5.1.
    Vous pouvez migrer une passerelle contenant des filtres. Les filtres ne fonctionnent toutefois pas dans les versions ultérieures : il est donc préférable de les supprimer de la configuration avant la migration en procédant comme suit :
    1. Vérifiez si la passerelle Version 5.1 utilise des filtres. Pour plus d'informations, voir la rubrique WebSphere Application Server Version 5.1 relative à l'affichage et la gestion des filtres déployés sur une passerelle.
    2. Supprimez les filtres. Pour plus d'informations, voir la rubrique WebSphere Application Server Version 5.1 : Suppression de filtres depuis la passerelle des services Web.
    Une fois la migration terminée, vous pouvez recréer les fonctions de filtrage en combinant des gestionnaires JAX-RPC et des médiations de bus d'intégration de services. Si vous migrez une passerelle de services Web comprenant un filtre de routage, vous pouvez recréer les fonctions de filtre.
  2. Choisissez un serveur ou un cluster cible correspondant à un serveur ou un cluster unique sur la version ultérieure et faisant partie d'une cellule de déploiement réseau.
  3. Configurez le serveur ou le cluster cible en tant que membre d'un bus d'intégration de services.
  4. Configurez un référentiel SDO (Data Objects) au niveau de la portée du serveur ou du cluster cible.
  5. Si vous migrez des liaisons EJB et que vous souhaitez continuer à utiliser une liaison codée RPC ou une liaison autre que document littéral, ajoutez une liaison du type correct à l'élément WSDL de la liaison EJB. Cette étape est nécessaire car la liaison par défaut de la passerelle Version 5.1 est de type codé RPC, alors que la liaison par défaut dans les versions ultérieures est document littéral.
  6. Vérifiez que le serveur d'applications source (Version 5.1) est en cours d'exécution et utilisez l'interface utilisateur de la passerelle Version 5.1 pour sauvegarder la configuration de la passerelle depuis le serveur d'applications Version 5.1 en tant que configuration privée. Pour plus d'informations, voir la rubrique WebSphere Application Server Version 5.1 relative à la sauvegarde d'une configuration de passerelle.
  7. Facultatif : Arrêtez le serveur d'applications Version 5.1.
    Remarque : Si vous faites migrer une passerelle utilisée dans un environnement de production, laissez la passerelle Version 5.1 en cours d'exécution jusqu'au terme de la configuration de la passerelle sur la version ultérieure. Utilisez ensuite les applications à l'origine des demandes pour la nouvelle configuration de passerelle, la passerelle Version 5.1 existante poursuivant son exécution en parallèle. Toutefois, il est inutile que les deux versions de la passerelle s'exécutent simultanément. Vous devrez peut-être arrêter le serveur Version 5.1 avant de démarrer le serveur ou le cluster sur la version ultérieure (par exemple, si vous installez le serveur ou le cluster sur la version ultérieure en remplacement direct du serveur Version 5.1, sur la même machine et avec les mêmes numéros de ports).
  8. Démarrez le serveur d'applications ou le cluster cible sur la version ultérieure et, pour un serveur ou un cluster unique dans une cellule gérée, le gestionnaire de déploiement pour la cellule cible.
  9. Vérifiez que tous les documents WSDL utilisés pour définir les services cible sur le serveur d'applications Version 5.1 sont disponibles aux emplacements donnés. Si l'emplacement WSDL correspond à une référence UDDI, vérifiez que le registre UDDI référencé est disponible.
  10. Facultatif : Si la passerelle migrée utilise des gestionnaires JAX-RPC et des listes de gestionnaires, vérifiez que les classes de gestionnaire sous-jacentes sont disponibles lors de l'exécution.
  11. Pour faire migrer la configuration exportée dans une nouvelle instance de passerelle dans le serveur d'applications ou le cluster sur la version ultérieure, procédez comme suit :
    1. Ouvrez une fenêtre d'invite de commande et placez-vous dans le répertoire racine_serveur_app/util.
    2. Exécutez la commande suivante :
      [IBM i]Remarque : [IBM i]Le client de scriptage wsadmin est exécuté à partir de Qshell. [IBM i]Pour plus d'informations, voir Configuration de Qshell pour exécuter des scripts WebSphere à l'aide de l'outil de scriptage wsadmin.
      migratewsgw[AIX Solaris HP-UX Linux Windows][z/OS].ext -C=nom_cellule [-S=nom_serveur -N=nom_noeud] 
                          [-X=nom_cluster] -B=nom_bus 
                           -G=nom_fichier_configuration_passerelle_v5 
                          [-H=nom_hôte_administration] [-A=port_administration] 
                          [-U=nom_instance_passerelle] [-P=préfixe_objet] 
                          [-username=ID_utilisateur_WAS -password=mot_de_passe_WAS]
      où :
      • [AIX Solaris HP-UX Linux Windows][z/OS].ext est l'extension de fichier .bat pour un système Windows, ou .sh pour un système Unix ou Linux.
      • Les crochets ("[ ]") indiquent qu'un paramètre est facultatif dans certaines circonstances.
      • nom_serveur et nom_noeud à la fois (pour un serveur unique) ou nom_cluster (pour un cluster), définissent le serveur ou le cluster vers lesquels la configuration de la passerelle est migrée.
      • nom_cellule, nom_serveur et nom_noeud (ou nom_cluster), nom_hôte_administration et port_administration définissent la connexion au serveur d'applications (ou cluster) sur la version ultérieure. nom_serveur ou nom_cluster spécifie le nom du serveur d'applications ou du cluster cible sur lequel les modules d'écoute de noeud final et les destinations de port de communications sortantes sont créés. Si vous effectuez la migration vers un serveur ou un cluster qui fait partie d'une cellule gérée, alors nom_hôte_administration et port_administration définissent le nom d'hôte et le numéro de port d'administration SOAP du gestionnaire de déploiement. Si vous effectuez la migration vers un serveur qui ne fait pas partie d'une cellule gérée, alors nom_hôte_administration et port_administration définissent le nom d'hôte et le numéro de port du serveur autonome et sont facultatifs. Si ces éléments sont omis, la commande suppose que les valeurs souhaitées sont localhost:8880 (c'est-à-dire les valeurs par défaut WebSphere Application Server d'un serveur autonome).
        [IBM i]Remarque : La variable nom_hôte_administration est obligatoire pour la plateforme IBM i.
      • nom_fichier_configuration_passerelle_v5 est le chemin complet et le nom du fichier de configuration XML de passerelle privée Version 5.1 exporté.
      • nom_bus et nom_instance_passerelle définissent ensemble l'instance de passerelle que vous créez dans ce bus. La variable nom_instance_passerelle n'est requise que si vous créez plusieurs instances de passerelle dans ce bus. Si vous omettez ce paramètre facultatif, un nom par défaut est attribué.
      • préfixe_objet est une chaîne permettant de précéder d'un préfixe les noms des objets définis par le processus de migration. Si vous l'omettez, il est remplacé par l'URI de l'espace de nom (valeur par défaut : urn:ibmwsgw) des services migrés.
      • ID_utilisateur_WAS et mot_de_passe_WAS sont nécessaires si le serveur d'applications ou le cluster cible est protégé par un mot de passe.
  12. Facultatif : Si les adresses Web externes des services migrés sont changées par le processus de migration, modifiez la configuration du programme d'écoute de noeud final pour mettre à jour ces adresses. Vous devez procéder ainsi si les adresses Web externes désignent la machine de la passerelle et non pas un serveur Web et que vous avez migré la passerelle vers une autre machine ou vers un port différent sur la même machine.

Que faire ensuite

Remarque :
  • Si votre passerelle Version 5.1 utilisait des filtres, recréez les fonctions de filtrage avec une combinaison de gestionnaires JAX-RPC et de médiations du bus d'intégration de services.
  • Si la configuration de la passerelle inclut des services de passerelle avec plusieurs services cible, la configuration Version 5.1 peut avoir utilisé un filtre de routage pour choisir un service cible déterminé. Si tel est le cas, vous devez poursuivre la configuration de la passerelle migrée afin de choisir un port et un service cible via une médiation de routage.
  • Une passerelle de services Web sur une version ultérieure utilise plus de mémoire pour traiter un message ; si vous envoyez une pièce jointe volumineuse via la passerelle migrée, vous pouvez obtenir une erreur de mémoire insuffisante dans la machine virtuelle Java. Pour résoudre ce problème, augmentez la taille du segment JVM.

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=twsg_coex_migrate
Nom du fichier : twsg_coex_migrate.html