Migration de projets WebFacing

Les anciens projets doivent être migrés pour pouvoir poursuivre le développement de vos applications WebFacing. Par exemple, vous ne pouvez pas convertir du code source DDS ou modifier les propriétés de votre projet. Cependant, vous pouvez exécuter des projets non migrés. Afin de différencier les projets non migrés des projets à jour, les projets non migrés sont identifiés par des icônes uniques dans la vue Projets WebFacing.

La migration d'un projet est divisée en deux étapes. La première étape est réalisée par le produit de base pour tout projet Web. La seconde est réalisée par l'assistant de migration WebFacing pour les mises à jour spécifiques aux projets WebFacing.
Important :
  • WebFacing ne prend en charge que les projets de migration version 7.0 et ultérieure.
  • Pour obtenir la liste des problèmes connus et des résolutions en rapport avec la migration, ainsi que des mises à jour du processus de migration publiées après la date de publication du présent document, consultez la section Note technique sur la migration WebFacing.

Migration de base

A l'aide de IBM® Installation Manager, commencez par vérifier que les derniers ensembles de correctifs et de mises à jour pour tous les produits Rational sont installés. Cette étape est très importante, car elle permet de vous épargner un grand nombre de problèmes. Pour plus de détails, voir les rubriques Mise à jour des packages produit installés à l'adresse http://publib.boulder.ibm.com/infocenter/radhelp/v8r5/index.jsp?topic=/com.ibm.rad.install.doc/topics/t_update.html et Mise à jour de l'installation du kit d'outils HATS à l'adresse http://pic.dhe.ibm.com/infocenter/hatshelp/v90/topic/com.ibm.hats.doc/doc/gsinstal.htm#update.

Les projets WebFacing doivent être chargés dans un espace de travail courant avant de pouvoir être migrés par le biais de l'assistant de migration WebFacing. La migration est irréversible. Nous vous recommandons donc de sauvegarder votre espace de travail ou vos projets.

Les précédents projets WebFacing peuvent être introduits dans l'espace de travail de niveau courant en ouvrant l'ancien espace de travail ou en important les anciens projets. Les projets existants peuvent être directement importés à partir des dossiers ou fichiers archive, y compris les fichiers d'échange du projet (Importer > Général > Projets existants dans l'espace de travail, puis sélectionnez Sélectionner le fichier archive).

Une fois le projet ouvert dans l'espace de travail du niveau actuel, l'assistant de migration Rational Desktop Migration apparaît. Il vous permet de sélectionner les projets à mettre à jour et vous indique quels seront les fichiers modifiés. Utilisez l'assistant pour réaliser les modifications nécessaires puis cliquez sur Terminer pour lancer la migration du projet. Lorsque la migration de l'espace de travail est terminée, les résultats s'affichent dans la vue Résultats de la migration. Pour plus de détails, voir la rubrique Migration des espaces de travail et des projets à l'adresse http://publib.boulder.ibm.com/infocenter/radhelp/v8r5/index.jsp?topic=/com.ibm.etools.rad.migration.doc/topics/t_migratefrom70.html

Si les résultats signalent des erreurs ou que le projet migré en comporte, voir Identification et résolution des incidents dans les applications WebFacing ainsi que le document en ligne Note technique sur la migration WebFacing (mise à jour régulièrement).

Remarque : Vous pouvez ignorer la boîte de dialogue qui apparaît une fois que l'assistant de migration de l'espace de travail a terminé. Cette erreur sera résolue plus loin dans ce document.
  • La validation de la migration s'est achevée avec des erreurs. Pour plus d'informations, voir la vue Résultats de la migration. La vue Résultats de la migration met en évidence des erreurs telles que celle-ci : La valeur WebSphere "WebSphere Web (Extended) 5.1" est incompatible avec l'environnement d'exécution WebSphere "WebSphere Application Server version X.Y.

Après la migration de l'espace de travail, vous pouvez réinitialiser la perspective manuellement en cliquant sur Fenêtre > Réinitialiser la perspective.

Vos projets peuvent maintenant être utilisés dans le nouvel espace de travail. Cependant, ils doivent encore être migrés avec l'assistant de migration WebFacing.

Utilisation de l'assistant de Migration WebFacing

Préparation d'un projet pour la migration WebFacing

Vous devez réaliser les tâches préparatoires suivantes avant de lancer l'assistant de migration WebFacing.

  1. Assurez-vous qu'un serveur valide est sélectionné sur la page Environnements d'exécution cible. Cette vérification est requise si le serveur ciblé initialement n'est plus pris en charge.
    1. Dans la vue Navigateur, cliquez avec le bouton droit de la souris sur le projet et sélectionnez Propriétés.
    2. Ouvrez la page Environnements d'exécution cible et sélectionnez le niveau de serveur sur lequel sera exécuté le projet.
    3. Cliquez sur OK.
  2. Si votre projet est au niveau Java™ EE 1.3, il doit être migré vers le niveau 1.4 ou plus à l'aide de l'assistant Migration des spécifications Java EE avant d'effectuer la migration WebFacing. Consultez la rubrique Migration du niveau de spécification de projets Java EE à l'adresse http://publib.boulder.ibm.com/infocenter/radhelp/v8r5/index.jsp?topic=/com.ibm.javaee.doc/topics/tmgv6j2eewiz.html.
    Remarque : Si une boîte de dialogue intitulée Fichiers incohérents apparaît lors de la migration Java EE, cliquez sur Oui pour la fermer. De même, si le message La migration s'est terminée avec des erreurs apparaît à la fin de l'assistant, cliquez sur le bouton Détails. Le message suivant peut être ignoré : Erreur : org.eclipse.core.runtime.CoreException : Le module de remplacement Runtime WebSphere Portal version 6.0 ne prend pas en charge la valeur de projet WebFacing 1.0.
  3. Résolvez toutes les erreurs du chemin d'accès aux classes de votre projet.
    1. Ouvrez la vue Problèmes (Fenêtre > Afficher vue > Autre > Problèmes).
    2. Vérifiez la présence de chemins d'accès aux classes ou d'erreurs de génération, par exemple : Le nom de classe ne peut pas être résolu [pour un type], Le projet ne peut pas être généré tant que les erreurs du chemin de génération ne sont pas résolues, ou Variable de chemin d'accès aux classes non liée.
    3. Résolvez ces erreurs comme décrit dans la section Note technique sur la migration WebFacing.

Exécution de l'assistant de Migration WebFacing

Puis, utilisez l'assistant Migration de WebFacing pour mettre à jour vos projets vers la dernière version. Vous ne pouvez plus migrer les projets en reconvertissant les fichiers DDS.

  1. Pour lancer l'assistant Migration de WebFacing, cliquez avec le bouton droit sur votre projet non migré dans la vue Projets de WebFacing et sélectionnez Migrer le projet WebFacing.
  2. Cliquez sur Terminer pour migrer le projet sélectionné vers la version actuelle.
  3. Cliquez sur OK si une boîte de dialogue Résultats apparaît pour être averti de la modification de la version de Struts de votre projet.
  4. Si votre projet a été migré à partir d'une version antérieure à la version 7.5.0, il est recommandé de reconvertir votre spécification de description de données, en particulier si vous envisagez d'utiliser le navigateur Firefox avec vos applications WebFacing.
Remarque : Si le projet migré est compatible HATS/WebFacing, le projet HATS correspondant doit également être migré. Pour plus de détails, voir Migration vers la version 9.0 de HATS.

Les projets personnalisés peuvent nécessiter une intervention manuelle. Pour plus de détails, voir Procédure manuelle de migration des projets avec des fichiers personnalisés et Prise en charge WebFacing de plusieurs navigateurs.

Une licence HATS est nécessaire pour que les projets WebFacing migrés soient déployés, comme pour les nouveaux projets WebFacing. Si une licence HATS est déjà appliquée, les projets migrés contiendront également ce paramètre de licence. Pour plus d'informations, voir Activation des licences.