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
- 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,.
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.
- 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.
- 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
Que faire ensuite
- 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.