Préparation des artefacts source pour la migration

Avant de migrer des artefacts source vers WebSphere Integration Developer depuis WebSphere Studio Application Developer Integration Edition, vous devez vérifier que vous avez bien préparé votre environnement.

Les étapes suivantes décrivent comment préparer votre environnement avant de migrer les artefacts source vers WebSphere Integration Developer depuis WebSphere Studio Application Developer Integration Edition.
  1. Vérifiez que vous disposez d'une copie de sauvegarde de tout l'espace de travail de la version 5.1 avant d'effectuer la migration.
  2. Relisez la section relative à la migration dans le Centre de documentation de Rational Application Developer pour déterminer la meilleure manière de migrer les projets non WBI dans votre espace de travail : http://publib.boulder.ibm.com/infocenter/rtnl0600/topic/com.ibm.etools.rad.migration.doc/ topics/tmigratefrom51x.html
  3. Relisez la section sur les services Web dans le Centre de documentation de Rational Application Developer pour obtenir des informations sur les fonctionnalités de service Web fournies par Rational Application Developer : http://publib.boulder.ibm.com/infocenter/rtnl0600/topic/com.ibm.webservices.rad.nav.doc/ developingweb.html
  4. Vérifiez que toutes les fonctions requises de WebSphere Integration Developer sont activées. Si elles ne sont pas activées, vous risquez de ne pas voir les options de menu décrites ci-après. Pour activer les fonctions importantes :
    • Dans WebSphere Integration Developer, sélectionnez l'option Fenêtre puis sélectionnez Préférences.
    • Ouvrez l'espace de travail puis sélectionnez la catégorie Fonctionnalités.
    • Sélectionnez toutes les fonctionnalités dans les catégories suivantes :
      • Advanced J2EE
      • Enterprise Java
      • Integration Developer
      • Java Developer
      • Web Developer (standard)
      • Web Service Developer
      • XML Developer
    • Cliquez sur OK.
  5. Utilisez un nouveau répertoire d'espace de travail pour WebSphere Integration Developer. Il est déconseillé d'ouvrir WebSphere Integration Developer dans un ancien espace de travail WebSphere Studio Application Developer Integration Edition qui contient des projets de service car ces projets doivent d'abord être migrés dans un format lisible par WebSphere Integration Developer. Les étapes à suivre pour le faire sont les suivantes :
    1. Copiez tous les projets autres que des services depuis l'ancien espace de travail vers le nouveau. Ne copiez pas les projets version 5.1 EJB, Web et EAR générés lors de la création du code de déploiement pour un projet de service 5.1. Le nouveau code de déploiement 6.0 sera régénéré automatiquement quand le module BI sera compilé.
    2. Ouvrez WebSphere Integration Developer dans l'espace de travail vide et importez tous les projets autres que des services en cliquant sur Fichier > Importer > Projet existant dans l'espace de travail puis sélectionnez les projets que vous avez copiés dans le nouvel espace de travail.
      • Si le projet est un projet J2EE, migrez-le vers le niveau 1.4 en utilisant l'Assistant de migration de Rational Application Developer :
        1. Avec le bouton droit, cliquez sur le projet et sélectionnez Migration > Assistant de migration J2EE.
        2. Lisez les avertissements sur la première page et cliquez sur Suivant.
        3. Vérifiez que le projet J2EE est coché dans la liste des projets. Laissez cochées les options Migrer la structure de projet et Migrer le niveau de spécification J2EE. Sélectionnez J2EE version 1.4 et Serveur de processus WebSphere v6.0 du serveur cible.
        4. Sélectionnez toutes les autres options appropriées pour votre projet J2EE et cliquez sur Terminer. Si cette étape s'accomplit normalement, un message vous indiquera que la migration a réussi.
        5. S'il existe des erreurs dans le projet J2EE après la migration, vous devrez supprimer toutes les entrées de chemin de classe qui référencent des fichiers jar v5 ou des bibliothèques et ajouter les bibliothèques Bibliothèque système JRE et Cible de serveur WPS dans le chemin de classe (voir ci-après). Ceci devrait résoudre la plupart de ces erreurs.
      • Pour les projets EJB WebSphere Business Integration contenant des données CMM (Extended Messaging) ou CMP/A (Container Managed Persistence over Anything), les fichiers de descripteurs d'extension jar EJB IBM doivent être migrés une fois le projet 5.1 importé dans l'espace de travail 6.0. Voir "Migration de projets EJB WebSphere Business Integration" pour plus d'informations.
      • Modifiez le chemin de classe pour chaque projet non-service importé dans l'espace de travail. Pour ajouter les bibliothèques JRE et WebSphere Process Server dans le chemin de classe, avec le bouton droit, cliquez sur le projet importé et sélectionnez Propriétés. Allez à l'entrée Chemin de compilation Java et sélectionnez l'onglet Bibliothèques. Ensuite, exécutez les opérations suivantes :
        1. Sélectionnez Ajouter une bibliothèque > Bibliothèque système JRE > Autre JRE - WPS Server v6.0 JRE > Terminer.
        2. Ensuite, sélectionnez Ajouter une bibliothèque > Cible de serveur WPS > Configurer le chemin de classe du serveur WPS > Terminer.
  6. Pour obtenir les meilleurs résultats, avant d'exécuter l'Assistant de migration, sélectionnez l'option de menu Projet et vérifiez que la case Compiler automatiquement n'est PAS cochée. WebSphere Integration Developer est différent de WebSphere Studio Application Developer Integration Edition car les options de déploiement de service y sont spécifiées au moment de la conception. Quand le projet est compilé, le code de déploiement est automatiquement mis à jour dans les projets EJB et Web générés et l'option Générer le code de déploiement n'existe donc plus.
  7. Pour migrer tous les fichiers .bpel d'un projet de service, vous devez vérifier que tous les fichiers .wsdl et .xsd référencés par les fichiers .bpel peuvent être résolus dans un projet Business Integration dans le nouvel espace de travail :
    • Si les fichiers .wsdl et/ou .xsd sont dans le même projet de service que le fichier .bpel, aucune autre action n'est requise.
    • Si les fichiers .wsdl et/ou .xsd sont dans un autre projet de service que celui que vous migrez, les artefacts 5.1 doivent être réorganisés avec WebSphere Studio Application Developer Integration Edition avant la migration car les projets de module Business Integration ne partagent pas les artefacts. Vous pouvez réorganiser les artefacts 5.1 de deux manières :
      • Dans WebSphere Studio Application Developer Integration Edition, créez un nouveau projet Java contenant tous les artefacts communs. Placez tous les fichiers .wsdl et .xsd qui sont partagés par plusieurs projets de service dans ce nouveau projet Java. Ajoutez sur ce nouveau projet Java une dépendance avec tous les projets de service qui utilisent ces artefacts communs. Dans WebSphere Integration Developer, créez un nouveau projet de bibliothèque Business Integration portant le même nom que le projet Java 5.1 partagé avant de migrer les projets de service. Copiez manuellement les anciens fichiers .wsdl et .xsd depuis le projet Java 5.1 partagé vers le dossier de ce nouveau projet de bibliothèque BI. Ceci doit être fait avant de migrer les projets de service BPEL.
      • Vous pouvez aussi garder une copie locale des fichiers partagés .wsdl et .xsd dans chaque projet de service pour qu'il n'existe pas de dépendances entre les projets de service.
    • Si les fichiers .wsdl et/ou .xsd sont dans un autre type de projet (habituellement d'autres projets Java), vous devez créer un projet de bibliothèque d'intégration métier portant le même nom que le projet 5.1. Vous devez également définir le chemin de classe du nouveau projet de bibliothèque en y ajoutant les entrées du projet Java 5.1, le cas échéant. Ce type de projet est utile pour stocker des artefacts partagés.
Vous êtes maintenant prêt à commencer le processus de migration.
Tâches associées
Migration des projets de service avec l'Assistant de migration de WebSphere Integration Developer

Commentaires
(C) Copyright IBM Corporation 2005. Tous droits réservés.