Migration à partir de WebSphere Studio V5.1, 5.1.1 ou 5.1.2

Cette documentation comporte des instructions de migration à partir de WebSphere Studio Site Developer V5.1.x vers Rational Web Developer V6.0.

Des informations supplémentaires sont disponibles dans les rubriques suivantes :

Cette documentation relative à la migration est également disponible au format HTML (fichier migrate.html). Le fichier HTML se trouve à la racine du premier CD du produit.

Pour obtenir la documentation mise à jour, reportez-vous à la section www.ibm.com/developerworks/rational.

Pour obtenir plus d'informations sur la migration à partir de versions antérieures de WebSphere Studio vers v5.x ou sur la migration à partir de VisualAge for Java vers WebSphere Studio, accédez au site www.ibm.com/software/awdtools/studioappdev/support/ et recherchez le guide de migration.

Pour effectuer la migration à partir de WebSphere Studio V5.1.x :
  1. Avant l'installation, lisez les informations relatives à la compatibilité avec Eclipse V2.x et WebSphere Studio V5.1.x. Prenez en compte que la compatibilité en amont n'est pas prise en charge pour les projets d'application de portlet migrés à partir de Portal Toolkit V5.0.2.2 avec WebSphere Studio V5.1.2.
  2. Sauvegardez l'espace de travail WebSphere Studio V5.1.x.
  3. Installez Rational Web Developer. Reportez-vous au guide d'installation (fichier install.html) qui est disponible à la racine du premier CD du produit.
  4. Recommandation : Par défaut, lors du premier démarrage de Rational Web Developer, vous êtes invité à confirmer que vous voulez utiliser un espace de travail appelé rationalsdp6.0\workspace. La boîte de dialogue Programme de lancement de l'espace de travail désigne un répertoire qui n'est pas l'espace de travail WebSphere Studio. Pour explorer le nouvel environnement avant de migrer l'ancien espace de travail, acceptez la valeur par défaut ou spécifiez un nouveau nom de répertoire lors du démarrage de Rational Web Developer. Il est possible de créer un ou deux environnement de test, consulter les nouveautés (Aide > Bienvenue), suivre les nouveaux tutoriels (Aide > Galerie de tutoriels) ou de découvrir de nouveaux exemples (Aide > Galerie d'exemples).
  5. Migrez les projets vers la version 6.0. Les projets créés dans WebSphere Studio V5.1.x peuvent être automatiquement migrés vers la version 6.0 de la manière suivante :
    1. Migration d'un espace de travail : Lorsque vous êtes prêt à migrer l'espace de travail V5.1.x, démarrez Rational Web Developer avec l'ancien espace de travail. Un indicateur de progression confirme que les projets sont automatiquement migrés.

      Remarques : Lors de la migration d'un espace de travail, une boîte de dialogue Incidents s'affiche. Cette boîte de dialogue comporte le message Impossible de restaurer la présentation du plan de travail. Motif : Erreurs lors de la restauration du plan de travail. Les messages d'erreur n'ont aucune influence sur la migration de l'espace de travail. Notez le nom de la perspective qui n'a pas pu être restaurée en cliquant sur le bouton Détails dans la boîte de dialogue des erreurs puis cliquez sur OK pour fermer la boîte de dialogue.

      Pour restaurer la perspective, procédez comme suit :
      1. Fermez la perspective en sélectionnant Fenêtre > Fermer la perspective
      2. Ouvrez à nouveau la perspective en sélectionnant Fenêtre > Ouvrir la perspective.
      Remarque : Pour les projets EGL (Enterprise Generation Language) qui utilisaient la perspective Web EGL dans WebSphere Studio V5.1.2 : cette perspective a été supprimée dans Rational Web Developer V6.0. Tous les projets EGL sont migrés sans cette perspective dans Rational Web Developer V6.0. Si vous utilisiez la perspective Web EGL, suivez la procédure ci-après.
      1. Fermez la perspective Web EGL.
      2. Activez les fonctions EGL dans la fenêtre Préférences (Fenêtre > Préférences). Pour obtenir des détails sur l'activation des fonctions EGL, reportez-vous à l'aide en ligne.
      3. Sélectionnez Fenêtre > Ouvrir la perspective et choisissez la perspective Web.
    2. Migration de projets chargés à partir d'un système SCM (source code management) : Les projets de WebSphere Studio 5.1.x qui existent dans un système SCM sont automatiquement migrés vers la version 6.0 lors de leur chargement dans Rational Web Developer.
    3. Migration de projets importés à l'aide de Project Interchange : Les projets exportés à partir de WebSphere Studio V5.1.2 ou V5.1.1 et importés dans Rational Web Developer V6.0 à l'aide de la fonction Project Interchange sont automatiquement migrés vers la version 6.0. La fonction Project Interchange était disponible dans WebSphere Studio V5.1.2 et était un plug-in facultatif dans la version 5.1.1.
    Remarques :
    • Pour chaque projet V5.1.x migré vers la version 6.0, le programme de migration ajoute automatiquement un fichier .compatibility au dossier de projet dans la version 6.0. Ce fichier est utilisé pour la compatibilité en amont avec WebSphere Studio V5.1.x. Ne modifiez ou ne supprimez pas ce fichier. Pour obtenir plus d'informations, reportez-vous à la section relative à la compatibilité avec WebSphere Studio V5.1.x.
    Important :
    • S'il existe des configurations de lancement de débogage associées à l'espace de travail migré, vous devez prendre en compte que certaines configurations de lancement ne seront pas migrées automatiquement. Pour obtenir plus d'informations sur le mode de restauration des configurations de lancement vers un espace de travail migré, reportez-vous à la section Modifications apportés au débogueur dans la version 6.0.
    • Si vous utilisiez le débogueur XSLT ou le débogueur EGL sur les projets dans l'espace de travail migré, vous devez changer l'environnement d'exécution Java (JRE) installé avec Rational Web Developer V6.0. Pour savoir comment effectuer ce changement, reportez-vous à la section Modifications apportés au débogueur dans la version 6.0.
    • Si vous avez des programmes développés à l'aide d'EGL (Enterprise Generation Language) migrés vers la version 6.0, n'oubliez pas qu'il y a de nouveaux mots réservés pour EGL dans la version 6.0. Si vous utilisez ces mots comme noms de variables ou de parties, vous devez les changer. Reportez-vous à la section Mots réservés dans V6.0
  6. Le pilote JDBC DB2 Net n'est pas pris en charge dans Rational Web Developer V6.0. Si vous avez créé des connexions JDBC à l'aide du pilote JDBC DB2 Net, vous ne pourrez plus vous connecter à nouveau dans Rational Web Developer V6.0. Vous devez changer la connexion pour utiliser un des pilotes JDBC pris en charge. Pour obtenir plus d'informations sur les pilotes JDBC pris en charge dans la version 6.0, reportez-vous à l'aide en ligne.
  7. Si vous disposez de contenu de fichier Web ou XML migré à partir WebSphere Studio Site Developer V5.1.x qui utilisait le jeu de caractères Shift_JIS et incluait des caractères sélectionnés par le fournisseur, vous devez à la place spécifier le jeu de caractères Windows-31J.
  8. Si vous avez installé les plug-ins du fournisseur avec WebSphere Studio Site Developer V5.1.x, vous devez obtenir les plug-ins correspondants pour la version V6.0 et les installer à nouveau.
  9. Si vous utilisez des fonctions pour lesquelles Agent Controller est requis, mettez-le à niveau en installant la version fournie avec Rational Web Developer. Pour plus de détail, reportez-vous au guide d'installation.
  10. Pour effectuer la migration à partir de VisualAge Generator, reportez-vous au guide relatif à la migration de VisualAge Generator vers EGL (Enterprise Generation Language) disponible au format PDF dans la section relative à la migration et à l'installation de l'aide en ligne sous la rubrique d'aide relative à l'accès au guide de migration de VisualAge Generator vers EGL . La version la plus récente est disponible sur le site http://www.ibm.com/developerworks/rational/library/egldoc.html.
Concepts associés
Compatibilité avec WebSphere Studio V5.1.x
Référence associée
Modifications apportés au débogueur dans la version 6.0
Migration WDO vers SDO
Mots réservés dans V6.0
Modifications apportées aux environnements de test WebSphere
Commentaires
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.