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.
- 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.
- 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
- 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
- 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.
- 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 :
- 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é.
- Ouvrez
WebSphere
Integration Developer dans l'espace de travail vide et importez tous
les projets autres que des services en cliquant sur
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 :
- Avec le bouton droit, cliquez sur le projet et sélectionnez
.
- Lisez les avertissements sur la première page et cliquez sur
Suivant.
- 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.
- 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.
- 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 :
- Sélectionnez .
- Ensuite, sélectionnez .
- 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.
- 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.