IBM WebSphere Development Studio Client for iSeries version 5.0 - Guide de migration

Cette rubrique explique comme migrer vos projets IBM WebSphere Development Studio Client for iSeries version 4.0 ou WebSphere Development Tools V5R1M0.

Avant de commencer

Important : Si WebSphere Development Studio Client for iSeries version 4.0 ou WebSphere Development Tools V5R1M0 est installé sur votre système et que vous souhaitez installer WebSphere Development Studio Client version 5.0, le processus d'installation supprimera la version antérieure du produit.

Avant de désinstaller Development Studio Client for iSeries version 4.0 :

  1. Vérifiez le répertoire où Development Studio Client for iSeries version 4.0 est installé. Si vous avez accepté le répertoire par défaut lors de l'installation de la version 4.0, votre espace de travail figure dans le répertoire X:\WDSC\WSSD\workspace, où X représente l'unité sur laquelle vous avez installé le produit. Dans le cas contraire, procédez comme suit :
  2. Sauvegardez votre espace de travail version 4.0. Si vous ne le faites pas, vous ne pourrez pas restaurer vos projets version 4.0 !
  3. Lisez les sections appropriées du présent guide de migration. Il contient également d'autres sections Avant l'installation.

    Vous pouvez également consulter ce guide après l'installation. Il figure dans le répertoire X:\WDSC\install\help\migrate.html.

  4. Pour savoir comment la migration vers la version 5.0 affecte votre espace de travail ou vos projets, consultez les sections appropriées du Guide de migration fourni avec votre produit WebSphere Studio de base. L'emplacement du guide dépend de l'édition Development Studio Client que vous avez achetée. Vous pouvez également consulter ce guide après l'installation dans le répertoire C:\Program Files\IBM\WebSphere Studio\migrate.html.

Migration des beans d'appel de programme de la version 4.0 vers la version 5.0

Migration des paramètres de l'explorateur de systèmes distants

Migration des projets WebFacing

Migration des projets Web iSeries

Migration des projets iSeries de la version 4.0 vers la version 5.0

Migration des beans d'appel de programme de projets iSeries Java et Web de la version 4.0 vers la version 5.0

Cette section explique comment migrer les beans d'appel de programme créés dans Development Studio Client for iSeries version 4.0 vers la version 5.0.

Après l'installation

Pour migrer les beans d'appel de programme d'un projet Java :

  1. Lorsque vous lancez la version 5.0 du produit (Démarrer > Programmes > IBM WebSphere Studio > Development Studio Client for iSeries), une fenêtre WebSphere Studio vous permet d'indiquer le répertoire à utiliser pour la session. Spécifiez le répertoire de l'espace de travail version 4.0.
  2. Lorsqu'un message vous demande si vous souhaitez passer au nouveau format d'interface utilisateur, cliquez sur OK.
  3. Supprimez l'ancien chemin de classe en remplaçant le chemin de construction Java du projet.
    1. Cliquez avec le bouton droit de la souris sur le projet Java et sélectionnez Propriétés.
    2. Dans la sous-fenêtre de gauche, sélectionnez Chemin de construction Java.
    3. Cliquez sur l'onglet Bibliothèques, sélectionnez les fichiers JAR suivants et cliquez sur Supprimer pour les supprimer du chemin de classe :
         ECLIPSE_HOME/plugins/com.ibm.etools.iseries.toolbox/runtime/jt400.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.iseries.webtools/lib/wdt400rt.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/j2ee.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/xerces.jar
  4. Relancez l'assistant d'appel de programme sur tous les fichiers PCML.

Pour migrer les beans d'appel de programme d'un projet Web :

  1. Lorsque vous lancez la version 5.0 du produit (Démarrer > Programmes > IBM WebSphere Studio > Development Studio Client for iSeries), une fenêtre WebSphere Studio vous permet d'indiquer le répertoire à utiliser pour la session. Spécifiez le répertoire de l'espace de travail version 4.0.
  2. Lorsqu'un message vous demande si vous souhaitez passer au nouveau format d'interface utilisateur, cliquez sur OK.
  3. Utilisez l'assistant de migration J2EE pour :
  4. Dans la perspective Web, cliquez avec le bouton droit de la souris sur le nom du projet et sélectionnez Migration > Projet Web Tools iSeries de 4.0 à 5.0.
  5. Important : A ce stade, vous devez fermer et ouvrir le projet pour éviter de générer une exception liée à la suppression de ressources.
  6. Une fenêtre indique que la structure et le contenu du projet vont être migrés. Pour continuer, cliquez sur OK.
  7. Pendant la migration, les fichiers wdt400rt.jar et wdt400tb.jar sont supprimés du dossier WEB-INF\lib et les fichiers iwdtrt.jar et jt400.jar de la version 5.0 sont copiés dans ce dossier.
  8. Relancez l'assistant d'appel de programme sur tous les fichiers PCML.

Migration des paramètres de l'explorateur de systèmes distants

Après l'installation
  1. Lorsque vous lancez la version 5.0 du produit (Démarrer > Programmes > IBM WebSphere Studio > Development Studio Client for iSeries), une fenêtre WebSphere Studio vous permet d'indiquer le répertoire à utiliser pour la session. Spécifiez le répertoire de l'espace de travail version 4.0.
  2. Lorsqu'un message vous demande si vous souhaitez passer au nouveau format d'interface utilisateur, cliquez sur OK.
  3. Dans le menu principal, cliquez sur Fenêtre > Préférences.
  4. Dans la sous-fenêtre de gauche, développez Editeur LPEX et sélectionnez Analyseurs syntaxiques.
  5. Dans la sous-fenêtre de droite, sélectionnez ILErpg. Dans la zone Nom de classe inférieure, remplacez le nom de la classe par com.ibm.etools.iseries.editor.ISeriesEditorRPGILEParser. Cliquez sur Définir.
  6. Dans la sous-fenêtre de droite, sélectionnez rpg. Dans la zone Nom de classe inférieure, remplacez le nom de la classe par com.ibm.etools.iseries.editor.ISeriesEditorRPGOPMParser. Cliquez sur Définir.
  7. Cliquez sur Appliquer. Cliquez sur OK.

Migration des projets WebFacing

Vous pouvez migrer vos projets WebFacing de WebSphere Development Studio Client version 4.0 ou WebSphere Development Tools version 5.1 vers la version 5.0 à l'aide de l'assistant d'importation. Pour ce faire, procédez comme suit :

Après l'installation

  1. Sélectionnez Fichier > Importer.
  2. Choisissez Projets WebFacing. Cliquez sur Suivant.
  3. Cliquez sur Parcourir pour rechercher le dossier contenant les projets WebFacing que vous souhaitez migrer vers la version 5.0. Cliquez sur Suivant.
    Remarque :
    • Si vous effectuez une mise à niveau à partir de la version 4.0, vos projets sont toujours disponibles dans le répertoire d'origine de l'espace de travail 4.0. Si vous n'avez pas modifié le répertoire par défaut de l'espace de travail et selon le chemin d'accès que vous avez choisi lors de l'installation de la version 4.0, l'espace de travail figure dans un répertoire du type X:\WDSC\WSSD\workspace.
    • Si vous effectuez une mise à niveau à partir de WebSphere Development Tools version 5.1 et selon le chemin d'accès que vous avez choisi lors de l'installation de la version 5.1, vos projets WebFacing figurent dans un répertoire du type X:\WDT\WebFacing\eclipse.
  4. Tous les projets WebFacing détectés par l'assistant apparaissent dans la sous-fenêtre Projets WebFacing trouvés. Sélectionnez les projets à importer. L'assistant crée un fichier EAR pour le projet. Un fichier EAR est un fichier d'archive d'application d'entreprise J2EE. Par défaut, le fichier EAR utilise le nom de votre projet WebFacing et ajoute le suffixe _EAR au nom. Si vous souhaitez utiliser un autre nom ou si vous regroupez plusieurs projets dans un seul fichier EAR, vous pouvez modifier le nom dans la zone Projet d'application d'entreprise.
  5. Cliquez sur Fin. Le projet est transféré dans l'espace de travail version 5.
  6. Pour afficher le projet dans la perspective WebFacing, sélectionnez Fenêtre > Ouvrir la perspective > WebFacing.
Remarque :
  • Si votre projet WebFacing a déjà été converti à l'aide de l'IDE version 4.0, vous n'avez pas besoin de le reconvertir après la migration.
  • Si votre projet d'origine a été migré à partir de WebSphere Development Tools version 5.1, vous devez reconvertir le projet.

Migration des projets Web iSeries

Migration des projets Web iSeries version 4.0 vers la version 5.0

Cette section explique comment migrer les projets Web iSeries créés dans Development Studio Client for iSeries version 4.0 vers la version 5.0.

Le processus de migration comprend les étapes suivantes :

  1. Migration des projets avec un espace de travail V4.0.x
  2. Migration de la structure de projet Web vers la structure J2EE 1.3

    Remarque : Il n'est pas obligatoire de migrer le projet Web vers J2EE 1.3. Toutefois, J2EE 1.2 ne prend pas en charge l'architecture JCA (Java Connector Achitecture).

  3. Migration du contenu des projets iSeries Web Tools
  4. Résolution des erreurs et avertissements générés lors de la migration

Etape 1 : Migration des projets avec un espace de travail V4.0.x

Cette méthode est partiellement prise en charge et entraîne une migration incomplète. Les paramètres de l'interface utilisateur, les paramètres de débogage et la plupart des préférences sont perdus. Les noms de projet, les fichiers source de projet et le chemin de construction Java (chemin de classe) sont conservés, mais la protection des autres données n'est pas assurée. Cette méthode doit être utilisée uniquement si aucun système de gestion de configuration logicielle (SCM) n'est en cours d'utilisation et s'il est indispensable de conserver les informations relatives au chemin de construction de projet, qui sont perdues lorsque vous importez des projets à partir de la version 4.0. Vous pouvez utiliser l'espace de travail version 4.0.x existant comme suit :

Avant l'installation

  1. Appliquez (libérez) toutes les modifications en attente sur le référentiel.
  2. Fermez toutes les perspectives et arrêtez le produit version 4.0.
  3. Sauvegardez le contenu du répertoire_espace_de_travail, où répertoire_espace_de_travail représente le nom qualifié complet du répertoire contenant l'espace de travail version 4.0.x. Par défaut, le sous-répertoire de l'espace de travail version 4.0.x figure dans le répertoire d'installation du produit. Vous aurez besoin de cette sauvegarde si vous souhaitez à nouveau utiliser le produit version 4.0.x. Une fois que vous avez désigné un espace de travail version 4.0.x à partir d'un IDE version 5.0, vous ne pouvez plus réutiliser cet espace de travail dans le produit version 4.0.x.
  4. Installez Development Studio Client for iSeries version 5.0.
Après l'installation
  1. Lorsque vous lancez la version 5.0 du produit (Démarrer > Programmes > IBM WebSphere Studio > Development Studio Client for iSeries), une fenêtre WebSphere Studio vous permet d'indiquer le répertoire à utiliser pour la session. Spécifiez le répertoire de l'espace de travail version 4.0.x.
  2. Lorsqu'un message vous demande si vous souhaitez passer au nouveau format d'interface utilisateur, cliquez sur OK.
  3. Avant d'effectuer des reconstructions ou de valider des projets figurant dans l'espace de travail, sélectionnez tous les projets dans la vue Navigateur de la perspective Ressource et cliquez sur Régénérer dans le menu instantané. Tous les fichiers sont synchronisés avec les métadonnées appropriées.
  4. Ouvrez tous les projets fermés (voir section Problèmes et restrictions connus ci-dessous).
  5. Vérifiez les variables de chemin de classe (voir section Problèmes et restrictions connus ci-dessous).
  6. Certains générateurs et valideurs ont été ajoutés, supprimés ou modifiés dans cette version. Pour vous assurer que les erreurs et avertissements adéquats s'affichent, vous devez reconstruire tous les projets en sélectionnant Projet > Reconstruire tout, puis Exécuter validation pour chaque projet Java.
  7. Certaines préférences utilisateur seront sans doute conservées, mais bon nombre d'autres ne le seront pas. Vérifiez que les paramètres de préférence dans la version 5 sont corrects.

Suppression des références de chemin d'accès absolu des fichiers EAR et de configuration serveur après la migration

Les fichiers EAR application.xml et les fichiers de configuration serveur de la version 4.0 contenaient des références de chemin d'accès absolu. Après avoir migré les fichiers vers la version 5.0, vous devez les ouvrir dans l'éditeur correspondant (qui transforme automatiquement les anciennes références de chemin d'accès absolu en nouvelles références relatives).

  1. Pour chaque projet EAR, cliquez avec le bouton droit de la souris sur META-INF/application.xml > Ouvrir avec > Editeur de descripteur de déploiement dans une vue Navigateur.
    1. Le message suivant apparaît : "The absolute path of one or more modules has changed since the last time this application was saved . . . Would you like to autocorrect?"
    2. Cliquez sur Oui.
    3. Enregistrez et fermez la fenêtre d'édition.
  2. Pour chaque configuration serveur, cliquez avec le bouton droit de la souris sur Serveur > Ouvrir dans une perspective Serveur (vue Configuration de serveur).
    1. Une fenêtre de rectification automatique similaire apparaît.
    2. Cliquez sur Oui.
    3. Enregistrez et fermez la fenêtre d'édition.

Problèmes et restrictions connus

Les problèmes suivants peuvent survenir si vous essayez d'effectuer une migration en ouvrant un espace de travail version 4.0 dans le produit version 5.0.

Valeur incorrecte dans la variable du chemin de classe JRE_LIB

Pour réinitialiser la variable de chemin de classe JRE_LIB sur un répertoire correct, procédez comme suit. Exécutez cette procédure même si la valeur semble correcte lorsque vous ouvrez la fenêtre Préférences pour la première fois.

  1. Sélectionnez Fenêtre > Préférences > Java > JRE installés.
  2. Dans la liste, cochez la case correspondant au répertoire par défaut où vous souhaitez définir JRE_LIB.
  3. Sélectionnez Editer, puis cliquez sur OK pour fermer la boîte de dialogue Edition JRE.

Si vous n'exécutez pas cette procédure, la valeur de JRE_LIB risque d'être incorrecte et de générer de nombreuses erreurs de construction dans les fichiers Java.

Vérifiez la valeur de toutes les autres variables de chemin de classe.

Pour les projets communs anciennement SCM, le menu Equipe contient l'option Partage de projet

La prise en charge d'équipes a fait l'objet d'importantes modifications entre Eclipse 1.0 et 2.0. La méthode de partage de projets avec le référentiel a également été modifiée.

  • Si vous sélectionnez Equipe > Partage de projet, un assistant vous guide dans le processus de migration. A la fin de l'opération, votre projet est partagé et la vue Synchronisation apparaît. Des modifications incompatibles apparaissent sur chaque fichier. Elles sont dues aux modifications apportées à la méthode de synchronisation des informations utilisée entre Eclipse 1.0 et 2.0.
  • Si vous n'avez pas de modifications en cours (cas normal si vous les avez toutes appliquées avant la mise à niveau conformément aux recommandations ci-dessus), il vous suffit de sélectionner le projet dans la vue Synchronisation et de cliquer sur Remplacer et mettre à jour pour charger le contenu actuel à partir du serveur.
  • Dans le cas contraire, vous pouvez afficher le menu triangle dans la vue Synchronisation et sélectionner Comparer le contenu de fichier. Après un certain temps, la vue Synchronisation n'affiche que les fichiers réellement différents. Vous pouvez alors utiliser cette vue pour résoudre ces conflits.

Projets créés à l'extérieur du répertoire de l'espace de travail

Par défaut, les projets sont créés dans le répertoire de l'espace de travail. Si vous avez remplacé la valeur par défaut pour créer des projets dans d'autres emplacements, ouvrez tous vos projets avant de fermer l'espace de travail. Cette opération permet d'écrire le fichier .project du projet dans l'emplacement approprié. Si vous n'ouvrez pas un projet dont le répertoire figure à l'extérieur de l'espace de travail, le projet réel sera masqué par un projet comprenant uniquement un fichier .project.

Etape 2 : Migration de la structure de projet Web vers la structure J2EE 1.3

L'assistant de migration J2EE peut effectuer deux tâches :

  • Migrer la structure de projet Web ou J2EE de la version 4.0 vers la version 5.0
  • Migrer éventuellement du niveau J2EE 1.2 vers le niveau 1.3

Pour effectuer la migration vers la structure de projet J2EE, procédez comme suit :

  1. Si ce n'est déjà fait, ouvrez l'IDE version 5.0 en sélectionnant le produit dans le menu Démarrer > Programmes.
  2. Dans l'IDE, sélectionnez Fenêtre > Ouvrir la perspective > Web pour ouvrir la perspective Web.
  3. Dans la vue Navigateur J2EE de la perspective Web, cliquez avec le bouton droit de la souris sur le nom du projet et sélectionnez Migration > Assistant de migration J2EE.
  4. Suivez les instructions de l'assistant. Si vous envisagez d'utiliser l'architecture JCA (Java Connector Architecture), vérifiez que vous avez coché la case Migration du projet de la version J2EE 1.2 vers la version J2EE 1.3.
  5. Cliquez sur Fin pour migrer les projets Web sélectionnés.

Etape 3 : Migration des projets iSeries Web Tools sélectionnés

Le processus de migration suivant dépend de la réussite de la migration du projet Web vers la structure de projet J2EE décrite dans la section précédente.

Pour migrer le contenu des projets iSeries Web Tools, procédez comme suit :

  1. Dans la perspective Web, cliquez avec le bouton droit de la souris sur le nom du projet et sélectionnez Migration > Projet Web Tools iSeries de 4.0 à 5.0.
  2. Important : A ce stade, vous devez fermer et ouvrir le projet pour éviter de générer une exception liée à la suppression de ressources.
  3. Une fenêtre indique que la structure et le contenu du projet vont être migrés. Pour continuer, cliquez sur OK.
  4. La fenêtre Informations sur l'opération en cours indique que l'opération de migration est en cours et affiche la progression de l'opération.
  5. A la fin de la migration, un message d'avertissement, d'erreur ou de réussite apparaît selon le résultat de la migration.
  6. Si le processus de migration aboutit, aucune action supplémentaire n'est nécessaire. En cas d'erreurs ou d'avertissements, consultez la section Résolution des erreurs et avertissements générés lors de la migration ci-dessous.

Le processus de migration exécute les actions suivantes :

  • Il convertit toutes les commandes de la phase de conception dans les fichiers JSP en nouvelles zones et commandes de composants Web.
  • Il ajoute le fichier d'exécution Apache Struts 1.02 et régénère les fichiers d'interaction Web selon la structure Struts des fichiers .wit.

Etape 4 : Résolution des erreurs et avertissements générés lors de la migration

Si des incidents surviennent pendant la migration, une fenêtre indique la présence d'erreurs ou d'avertissements, qui sont consignés dans le fichier journal de migration nom_projet_MigrationDetails.txt sous le nom du projet dans la perspective Web.

La section Migration Result en haut du fichier journal de migration indique l'état général de la migration et désigne un fichier de l'aide en ligne, qui décrit les erreurs et avertissements et indique l'action requise pour les corriger.

Pour plus d'informations, consultez la rubrique "Détails sur les avertissements et erreurs de migration" de l'aide en ligne :

       Development Studio Client for iSeries > Applications Web >
      iSeries Web Development > Référence > Détails sur les avertissements et erreurs de migration.

Migration des projets Web iSeries antérieurs à la version 4.0

Cette section explique comment migrer le produit WebSphere Studio utilisé avec WebSphere Development Tools for iSeries version 3.5. Dans cette section, WebSphere Studio est désigné par l'expression WebSphere Studio classique pour le distinguer des versions WebSphere Studio actuelles. Ces informations s'appliquent aux éditions avancée et professionnelle du produit WebSphere Studio classique.

Remarque : Les instructions suivantes concernent la migration du produit WebSphere Studio classique version 4.0. Si vous souhaitez effectuer une migration à partir d'une version antérieure au produit WebSphere Studio classique, vous devez d'abord migrer le produit vers WebSphere Studio classique version 4.0.

Pour effectuer une migration à partir de WebSphere Studio classique, procédez comme suit :

  1. Créez une nouvelle phase de migration sur un serveur.
  2. Créez un descripteur de configuration Web.
  3. Exportez un fichier JAR de migration.
  4. Importez le fichier JAR de migration dans un projet Web.
  5. Terminez la migration du projet Web iSeries.
  6. Configurez votre serveur et testez l'application migrée.

Avant de migrer des données WebSphere Studio classique, vous devez tenir compte des limites suivantes :

  • L'environnement de développement intégré de la version WebSphere Studio actuelle utilise un éditeur SQL basé XML. Par conséquent, les fichiers .sql ne peuvent pas être utilisés.
  • Les informations relatives à la phase et à la publication du projet ne peuvent pas être migrées.
  • Les informations relatives à la configuration du serveur WebSphere Studio classique ne peuvent pas être migrées.
  • Les informations relatives au contrôle de version ne peuvent pas être migrées.

Lors du processus de migration défini ci-dessous, vous allez créer un fichier JAR contenant tous les fichiers (publiables ou source) du projet pour un seul serveur. Tous les fichiers visibles dans la vue Publication du serveur par défaut sont assemblés dans le fichier JAR. Vous pouvez ensuite importer le fichier JAR dans un projet Web dans WebSphere Development Studio Client for iSeries version 5.0.

Lorsque vous migrez des projets existants, toutes les informations relatives à la phase et à la publication du projet sont perdues lors de la migration. Si la phase comporte plusieurs serveurs, seuls les fichiers publiés sur le serveur par défaut sont conservés. Par conséquent, vous devez créer une nouvelle phase contenant un seul serveur pour les besoins de la migration.

Procédure de migration

Etape 1 - Création d'une nouvelle phase monoserveur pour la migration

Si la phase contient plusieurs serveurs, créez une nouvelle phase monoserveur appelée Migration :

  1. Ouvrez le projet à migrer et cliquez sur Projet > Personnalisation de phases de publication.
  2. Dans la zone Nom de phase, tapez Migration.
  3. Cliquez sur Ajouter.
  4. Cliquez sur OK.
  5. Cliquez sur Projet > Phase de publication et sélectionnez Migration dans la liste des phases disponibles.
  6. Dans la vue Publication, cliquez sur Migration, puis sur Insérer > Serveur.
  7. Tapez un nom de serveur (hôte_local, par exemple) et cliquez sur OK.
  8. Facultatif : Effectuez cette tâche si vous avez défini des informations de mappage de servlet. Sinon, passez à l'Etape 2 ci-dessous. La modification du serveur ou de la phase de publication ne propage pas les informations de mappage du servlet pour WebSphere Application Server version 4.0. Dans la vue Publication, cliquez avec le bouton droit de la souris sur le servlet et sélectionnez Propriétés pour chaque servlet. Dans l'onglet Publication de la fenêtre Propriétés, indiquez les informations de mappage de servlet dans la zone Mappage de servlet et cliquez sur OK. Le mappage de servlet est le modèle d'URL désignant le servlet enregistré du serveur d'applications.

Etape 2 - Création d'un descripteur de configuration Web

  1. Dans la vue Publication, cliquez sur Projet > Création d'un descripteur de configuration Web.
  2. Sélectionnez tous les servlets requis.
  3. Sélectionnez tous les fichiers TLD (Tag Library Descriptor) requis.
  4. Cliquez sur Créer.

Le nom du descripteur de configuration Web par défaut est nom_serveur_web.xml. Le nom du fichier descripteur de configuration Web du serveur hôte_local est hôte_local_web.xml. Si vous n'avez pas défini un répertoire différent, le fichier .xml est sauvegardé dans le répertoire WEB-INF.

Etape 3 - Exportation d'un fichier JAR de migration

  1. Dans la vue Publication, cliquez avec le bouton droit de la souris sur le serveur hôte_local et sélectionnez Propriétés > Publication.
  2. Dans la zone Chemin Web WebApp, tapez un chemin d'accès Web (racine de contexte). Ce chemin est utilisé comme nom de projet Web lors de la création du projet dans Development Studio Client for iSeries version 5.0. Par exemple, si vous indiquez monprojet, ce nom sera utilisé pour désigner le projet Web dans la version 5.0.
  3. Cliquez sur OK.
  4. Dans la vue Publication, cliquez sur Projet > Créer un fichier de migration.
  5. Vérifiez que hôte_local est sélectionné.
  6. Vérifiez que le descripteur de configuration Web hôte_local_web.xml est sélectionné.
  7. Cliquez sur OK.
  8. Le nom du fichier JAR par défaut est nom_serveur.jar. Le nom du fichier JAR du serveur hôte_local est hôte_local.jar. Si nécessaire, vous pouvez renommer le fichier.
  9. Dans la zone Enregistrer dans, indiquez l'emplacement du fichier JAR et cliquez sur Enregistrer pour créer le fichier JAR.

Etape 4 - Importation du fichier JAR de migration dans un projet Web

  1. Lancez WebSphere Development Studio Client for iSeries version 5.0.
  2. Cliquez sur Fenêtre > Ouvrir la perspective > Autre, sélectionnez Web et cliquez sur OK pour ouvrir la perspective Web.
  3. Importez le fichier JAR.
    1. Cliquez sur Fichier > Importer.
    2. Dans la fenêtre Importation, cliquez sur Fichier WAR et sur Suivant.
  4. Dans la fenêtre Importation de ressources à partir d'un fichier WAR :
    1. Dans la zone Fichier WAR, entrez le nom et le chemin complet du fichier JAR. Par exemple, tapez d:\monjar\hôte_local.jar dans la zone Fichier WAR si le fichier JAR est hôte_local.jar et figure dans le répertoire d:\monjar,.
      Remarque : Vous devez importer le fichier JAR à l'aide de l'option Fichier WAR. Dans le cas contraire, il ne fonctionnera pas correctement.
    2. Cliquez sur le bouton d'option Nouveau du projet Web.
    3. Dans la zone Nouveau nom du projet, tapez le nom du chemin Web de l'application que vous avez défini au cours de l'Etape 3 ci-dessus comme nom de projet Web. Ce nom est automatiquement ajouté à la zone Racine de contexte. Si le nom n'est pas ajouté, entrez le nom du projet dans la zone Racine de contexte.
    4. Cliquez sur le bouton d'option Nouveau associé à la zone Projet d'application d'entreprise, puis tapez le nom du fichier EAR. Par défaut, le fichier EAR est appelé DefaultEAR. Vous pouvez modifier ce nom pour l'identifier rapidement dans votre nouveau projet. Par exemple, si le nom de votre nouveau projet est monprojet, vous pouvez appeler le fichier EAR monprojetEAR.
    5. Cliquez sur Fin pour décompresser le fichier JAR et créer le projet Web.
  5. Pour terminer l'initialisation du projet Web, exécuter l'assistant de configuration d'exécution iSeries Web Tools.
    1. Dans la vue Navigateur J2EE, cliquez avec le bouton droit de la souris sur le nom du projet Web et sélectionnez Spécification de la configuration d'exécution des outils Web iSeries.
    2. Dans l'assistant, cliquez sur Fin sans compléter les zones. L'assistant copie les fichiers JAR requis par les outils Web iSeries dans le répertoire Web-INF > lib du projet Web.
  6. Il peut y avoir plusieurs références non résolues ou fichiers d'importation manquants. Ils apparaissent dans la vue Tâches. Pour corriger ces problèmes, vous devez modifier le chemin de construction Java du projet Web :
    1. Cliquez avec le bouton droit de la souris sur le projet, puis cliquez sur Propriétés pour ouvrir la fenêtre Propriétés.
    2. Cliquez sur Chemin de construction Java et sur l'onglet Bibliothèques.
    3. Cliquez sur Ajouter des fichiers JAR externes.
    4. Importez les fichiers JAR dont vous avez besoin à partir des répertoires suivants :
      x:\WS*D\runtimes\base_v5\lib,
      x:\WS*D\runtimes\aes_v4\lib
      x:\WS*D\wstools\eclipse\plugins\com.ibm.etools.websphere.tools\runtime
      x:\WS*D représente le répertoire d'installation du produit de base.
  7. Dans la vue Navigateur, cliquez avec le bouton droit de la souris sur le projet et sélectionnez Reconstruire le projet.

Etape 5 - Fin de la migration du projet Web iSeries

Pour terminer la migration du projet, exécutez les étapes 2, 3 et 4 de la section Migration des projets Web iSeries version 4.0 :

  1. Facultatif : Les tâches de l'étape 2 sont obligatoires uniquement si vous envisagez d'exécuter votre application Web sur WebSphere Application Server version 4.x. Si vous souhaitez exécuter votre application Web sur WebSphere Application Server version 5.0, vous devez toutefois exécuter l'étape 2 pour migrer votre projet Web à partir de J2EE 1.2 vers J2EE  1.3.
  2. L'étape 3 explique comment migrer le contenu du projet Web.
  3. L'étape 4 contient des informations sur la gestion des erreurs et des avertissements générés lors de la migration du contenu du projet Web.

Une fois ces tâches terminées, passez à l'Etape 6 ci-dessous.

Etape 6 - Test de l'application migrée sur un serveur de test

Vous pouvez désormais tester votre application. Pour la tester sur le serveur de test par défaut, procédez comme suit :

  1. Cliquez avec le bouton droit de la souris sur la page initiale de votre application Web.
  2. Sélectionnez Exécuter sur le serveur.

Pour tester l'application dans d'autres environnements d'exécution serveur, consultez l'aide en ligne relative aux outils serveur.

Migration des projets iSeries de la version 4.0 vers la version 5.0

Si Development Studio Client for iSeries version 4.0 est toujours installé sur votre système :

Avant de désinstaller Development Studio Client version 4.0, vous devez exporter le contenu de votre projet sur la machine hôte. Ensuite, vous devez installer Development Studio Client version 5.0. Après l'installation, vous pouvez recréer les projets en effectuant une action dans l'explorateur de systèmes distants :

Avant l'installation
  1. Dans la version 4.0, cliquez avec le bouton droit de la souris sur le projet iSeries et sélectionnez Insérer les modifications. Cette option permet de télécharger tous les changements de code dans la bibliothèque associée au projet. Si vous ne savez pas quels sont l'hôte et la bibliothèque concernés par ce projet, cliquez avec le bouton droit de la souris sur Propriétés > Projet iSeries.
  2. Fermez et désinstallez la version 4.0.
  3. Continuez l'installation de Development Studio Client for iSeries version 5.0.
Après l'installation
  1. Dans la version 5.0, ouvrez la perspective de l'explorateur de systèmes distants en cliquant sur Fenêtre > Ouvrir une perspective > Explorateur de systèmes distants.
  2. Naviguez jusqu'à la bibliothèque associée à votre projet iSeries. Cette bibliothèque contient la source que vous avez téléchargée à partir du projet iSeries.
  3. Sélectionnez les fichiers source physiques de cette bibliothèque, qui faisaient partie de votre projet iSeries. Cliquez avec le bouton droit de la souris sur ces fichiers et sélectionnez Rendre disponible hors ligne. Cette action permet de recréer le projet iSeries qui est mappé sur cette bibliothèque et de télécharger tous les membres source en local dans votre projet. Vous pouvez désormais continuer le développement.

    Remarque : La sélection de l'option Créer un projet iSeries à partir d'une bibliothèque dans l'explorateur de systèmes distants est une autre méthode rapide pour recréer votre projet, mais ne permet pas de télécharger des membres source à partir de cette bibliothèque. Elle permet simplement de créer et de configurer un projet iSeries, qui est mappé sur cette bibliothèque et cet hôte.

Si vous avez déjà installé Development Studio Client for iSeries version 5.0 et que vous n'avez pas téléchargé vos projets sur l'hôte distant :

Après l'installation
  1. Lancez le produit version 5.0.
  2. Dans le menu principal, cliquez sur Fenêtre > Ouvrir une perspective > Ressource. Cliquez sur OK.
  3. Créez un projet simple en cliquant sur Fichier > Nouveau > Autre > Simple > Projet et appelez-le Temp. Ce projet est un conteneur permettant d'importer votre projet version 4.0 dans l'espace de travail version 5.0.
  4. Sélectionnez Fichier > Importer > Système de fichiers. Cliquez sur Suivant.
  5. Naviguez jusqu'à votre ancien espace de travail (par exemple, X:\WDSC\WSSD\workspace, où X représente l'unité sur laquelle vous avez installé le produit version 4.0) et importez le projet que vous souhaitez recréer.
  6. Créez un projet iSeries, qui est mappé sur la bibliothèque et l'hôte du projet de la version 4.0 que vous venez d'importer.
    • Dans la vue Navigateur, cliquez avec le bouton droit de la souris et sélectionnez Nouveau > Projet > iSeries > Local > Projet iSeries.
    • Si vous ne vous rappelez plus du nom de la bibliothèque et de l'hôte, vous trouverez ces informations dans le fichier XML .iseries_project_properties sous le projet Temp.
  7. Recréez les fichiers source physiques, qui existaient dans votre projet version 4.0 :
    • Cliquez sur Fichier > Nouveau > Autre > iSeries > Local > Fichier physique source iSeries.
    • Si vous n'êtes pas certain du CCSID et de la longueur d'enregistrement de vos fichiers source, vous trouverez ces informations dans le fichier XML .iseries_srcpf_properties sous chaque fichier physique source.
  8. Glissez-déposez les membres source de l'ancien projet version 4.0 dans le nouveau projet version 5.0.
  9. Supprimez le projet Temp désormais inutile et ouvrez la perspective Projets iSeries en cliquant sur Fenêtre > Ouvrir une perspective > Projets iSeries.

Marques et logos

Les termes qui suivent sont des marques d'International Business Machines Corporation aux Etats-Unis et/ou dans certains autres pays :

Java et toutes les marques et logos incluant Java sont des marques de Sun Microsystems, Inc. aux Etats-Unis et/ou dans certains autres pays.

D'autres sociétés sont propriétaires des autres marques, noms de produit ou logos qui pourraient apparaître dans ce document.