IBM WebSphere Development Studio Client für iSeries Version 5.0 Migrationshandbuch

• Wurde Ihr WebFacing-Projekt bereits unter Verwendung der IDE von Version 4.0 konvertiert, ist es nicht erforderlich, das Projekt nach Abschluss der Migration erneut zu konvertieren.
• Wurde Ihr ursprüngliches Projekt von WebSphere Development Tools Version 5.1 migriert, müssen Sie das Projekt erneut konvertieren.

Migration von iSeries-Webprojekten

Migration von iSeries-Webprojekten von Version 4.0 auf Version 5.0

Dieser Abschnitt beschreibt die Migration von iSeries-Webprojekten, die in Development Studio Client für iSeries Version 4.0 erstellt wurden, auf Version 5.0.

Die Migrationsaktivitäten umfassen die folgenden Phasen:

1. Migration von Projekten unter Verwendung eines vorhandenen Arbeitsbereichs der Version 4.0.x
2. Migration der Webprojektstruktur in die J2EE 1.3-Projektstruktur

   Anmerkung: Die Migration des Webprojekts auf J2EE 1.3 ist optional. J2EE 1.2 unterstützt jedoch nicht JCA (Java Connector Achitecture).

3. Migration des Inhalts von iSeries-Webtoolsprojekten
4. Adressierung von Fehlern und Warnmeldungen, die infolge der Migration generiert wurden

Phase 1: Migration von Projekten unter Verwendung eines vorhandenen Arbeitsbereichs der Version 4.0.x

Diese Methode wird teilweise unterstützt und hat eine unvollständige Migration zur Folge. Alle Benutzerschnittstelleneinstellungen, alle Debugeinstellungen und die meisten Benutzervorgaben gehen verloren. Außer Projektnamen, Projektquellendateien und Java-Erstellungspfad für Projekte (Klassenpfad), die beibehalten werden, können alle anderen Angaben verloren gehen. Verwenden Sie diese Methode nur, wenn kein unterstütztes SCM-System (SCM = Software Configuration Management) verwendet wird und wenn es entscheidend ist, Angaben zum Projekterstellungspfad beizubehalten; diese gehen verloren, wenn Sie Projekte aus Version 4.0 importieren. Sie können den vorhandenen Arbeitsbereich der Version 4.0.x verwenden, indem Sie wie folgt vorgehen:

Vor der Installation

1. Schreiben Sie alle anstehenden Änderungen an dem Repository fest (d. h., geben Sie die Änderungen frei).
2. Schließen Sie alle Perspektiven und führen Sie für das Produkt der Version 4.0 einen Systemabschluss durch.
3. Sichern Sie den Inhalt für das Verzeichnis_workspace; dabei ist Verzeichnis_workspace der vollständig qualifizierte Name des Verzeichnisses, das den Arbeitsbereich der Version 4.0.x enthält. Standardmäßig befindet sich das Unterverzeichnis workspace der Version 4.0.x in demselben Verzeichnis, in dem das Produkt installiert ist. Sie müssen dieses Verzeichnis sichern, falls zu einem späteren Zeitpunkt nochmals mit dem Produkt der Version 4.0.x gearbeitet werden soll. Haben Sie erst einmal von einer IDE der Version 5.0 auf einen Arbeitsbereich der Version 4.0.x gezeigt, können Sie diesen Vorgang nicht mehr umkehren und diesen Arbeitsbereich im Produkt der Version 4.0.x nicht mehr verwenden.
4. Installieren Sie Development Studio Client für iSeries Version 5.0.

1. Beim Starten des Produkts der Version 5.0 (Start > Programme > IBM WebSphere Studio > Development Studio Client für iSeries) wird ein WebSphere Studio-Fenster geöffnet, in dem Sie das Verzeichnis angeben können, das für die Sitzung verwendet werden soll. Geben Sie die Verzeichnisposition Ihres Arbeitsbereichs der Version 4.0.x in diesem Fenster an.
2. Werden Sie aufgefordert zu bestätigen, dass die Konvertierung in das neue Benutzerschnittstellenformat erfolgen soll, klicken Sie OK an.
3. Bevor Sie erneute Erstellungen ausführen oder irgendwelche Projekte prüfen, die sich im Arbeitsbereich befinden, wählen Sie alle Projekte in der Sicht "Navigator" innerhalb der Perspektive "Ressource" und dann Aktualisieren im Kontextmenü aus. Damit wird sichergestellt, dass alle Dateien mit ihren entsprechenden Metadaten synchronisiert werden.
4. Öffnen Sie alle geschlossenen Projekte (siehe "Bekannte Probleme" weiter unten).
5. Überprüfen Sie Ihre Klassenpfadvariablen (siehe "Bekannte Probleme" weiter unten).
6. Einige Erstellungsprogramme und Prüfprogramme wurden in dieser Version hinzugefügt, entfernt oder geändert. Um sicherzustellen, dass die korrekten Fehler und Warnmeldungen angezeigt werden, müssen Sie alle Projekte erneut erstellen, indem Sie Projekt > Alle erneut erstellen und Gültigkeitsprüfung ausführen für jedes Java-Projekt auswählen.
7. Einige Benutzervorgaben werden möglicherweise beibehalten, während andere vielleicht nicht beibehalten werden. Überprüfen Sie Ihre Vorgabeneinstellungen in Version 5.0, um sicherzustellen, dass sie wie gewünscht definiert sind.

Entfernen von Verweisen auf den absoluten Pfad in der EAR- und Serverkonfiguration nach der Migration

In Version 4.0 enthielten EAR-Dateien anwendung.xml und Serverkonfigurationsdateien Verweise auf den absoluten Pfad. Nach ihrer Migration auf Version 5.0 müssen Sie diese Dateien mit dem zugehörigen Editor öffnen (damit werden die entsprechenden alten Verweise auf den absoluten Pfad automatisch in neue relative Verweise geändert).

1. Klicken Sie für jedes EAR-Projekt in einer Sicht "Navigator" mit der rechten Maustaste META-INF/anwendung.xml > Öffnen mit > Deployment Descriptor Editor an.
   1. Ein Nachrichtenfenster wird geöffnet: "Der absolute Pfad eines oder mehrerer Module hat sich seit dem letzten Sichern dieser Anwendung geändert. . . Soll eine Autokorrektur erfolgen?"
   2. Klicken Sie Ja an.
   3. Sichern und schließen Sie dann das Editierfenster.
2. Klicken Sie für jede Serverkonfiguration in einer Perspektive "Server", Sicht "Serverkonfiguration", mit der rechten Maustaste den Server > Öffnen an.
   1. Ein ähnliches Fenster zur Autokorrektur wird geöffnet.
   2. Klicken Sie Ja an.
   3. Sichern und schließen Sie dann das Editierfenster.

Bekannte Probleme und Einschränkungen

Die folgenden Probleme können auftreten, wenn Sie versuchen, eine Migration durchzuführen, indem Sie einen Arbeitsbereich der Version 4.0 in dem Produkt der Version 5.0 öffnen.

Fehlerhafter Wert in der Klassenpfadvariablen JRE_LIB

Um Ihre Klassenpfadvariable JRE_LIB auf eine gültige Position zurückzusetzen, führen Sie diese Schritte aus. Führen Sie diese Schritte selbst dann aus, wenn der Wert korrekt zu sein scheint, wenn Sie das Fenster "Benutzervorgaben" zum ersten Mal öffnen.

1. Wählen Sie Fenster > Benutzervorgaben > Java > Installierte JREs aus.
2. Wählen Sie in der Liste das Markierungsfeld für die standardmäßige JRE-Position aus, auf die Ihre Variable JRE_LIB gesetzt werden soll.
3. Wählen Sie Editieren aus und klicken Sie dann OK an, um das Dialogfenster "JRE editieren" zu schließen.

Führen Sie diese Schritte nicht aus, ist der Wert für JRE_LIB unter Umständen fehlerhaft, was viele Erstellungsfehler in Java-Dateien zur Folge haben kann.

Generell sollten Sie den Wert aller Ihrer Klassenpfadvariablen überprüfen.

Für zuvor gemeinsam benutzte SCM-Projekte enthält das Menü "Team" die Option "Projekt gemeinsam benutzen"

Die Team-Unterstützung hat sich von Eclipse 1.0 zu Eclipse 2.0 entscheidend geändert. Die Methode der gemeinsamen Benutzung von Projekten mit dem Repository hat sich ebenfalls geändert.

• Wählen Sie die Option Team > Projekt gemeinsam benutzen aus, werden Sie von einem Assistenten durch den Migrationsprozess geführt. Anschließend wird Ihr Projekt gemeinsam benutzt und die Sicht "Synchronisieren" geöffnet. Für jede Datei werden die Änderungen angezeigt, die Konflikte verursachen. Grund hierfür sind Änderungen, die die Art und Weise betreffen, auf die Synchronisationsangaben bei Eclipse 1.0 und Eclipse 2.0 gespeichert werden.
• Haben Sie keine abgehenden Änderungen (Sie sollten keine derartigen Änderungen haben, falls Sie - wie oben empfohlen - alle Ihre abgehenden Änderungen festgeschrieben haben, bevor Sie das Upgrade durchgeführt haben), können Sie einfach das Projekt in der Sicht "Synchronisieren" auswählen und dann Überschreiben und Aktualisieren auswählen; daraufhin wird der aktuelle Inhalt vom Server geladen.
• Haben Sie abgehende Änderungen, können Sie das Triangel-Pulldown-Menü in der Sicht "Synchronisieren" öffnen und Dateiinhalt vergleichen auswählen. Nach der Arbeit zeigt die Sicht "Synchronisieren" nur noch die Dateien, die tatsächlich unterschiedlich sind. In der Sicht "Synchronisieren" können Sie dann diese Konflikte beheben.

Projekte, die außerhalb des Verzeichnisses workspace erstellt wurden

Standardmäßig werden Projekte im Verzeichnis workspace erstellt. Hatten Sie den Standardwert überschrieben, um Projekte an anderer Position zu erstellen, öffnen Sie jetzt alle Ihre Projekte, bevor Sie die Workbench schließen. Damit kann die .project-Datei für dieses Projekt an die korrekte Position geschrieben werden. Schlägt das Öffnen eines geschlossenen Projekts, dessen Verzeichnis sich außerhalb des Arbeitsbereichs befindet, fehl, hat dies ein Projekt zur Folge, das das tatsächliche Projekt maskiert und nur eine .project-Datei enthält.

Phase 2: Migration der Webprojektstruktur in die J2EE 1.3-Projektstruktur

Beachten Sie bitte, dass der J2EE-Migrationsassistent zwei Funktionen ausführen kann:

• Migration der Webprojektstruktur oder J2EE-Projektstruktur von Version 4.0 auf Version 5.0
• Wahlweise Migration von J2EE-Ebene 1.2 auf Ebene 1.3

Um eine Migration in die J2EE-Projektstruktur auszuführen, gehen Sie wie folgt vor:

1. Öffnen Sie, falls erforderlich, die IDE der Version 5.0, indem Sie das Produkt im Menü Start > Programme auswählen.
2. Wählen Sie in der IDE Fenster > Perspektive öffnen > Web aus, um die Webperspektive zu öffnen.
3. Klicken Sie mit der rechten Maustaste den Projektnamen in der J2EE-Sicht "Navigator" der Webperspektive an und wählen Sie Migrieren > J2EE-Migrationsassistent aus.
4. Befolgen Sie die Anweisungen auf den Assistentenseiten. Planen Sie, die JCA-Unterstützung (JCA = Java Connector Architecture) zu verwenden, stellen Sie sicher, dass Sie das Markierungsfeld Projekt von Versionsstand J2EE 1.2 auf J2EE 1.3 migrieren auswählen.
5. Klicken Sie Fertig stellen an, um die ausgewählten Webprojekte zu migrieren.

Phase 3: Migration des Inhalts von iSeries-Webtoolsprojekten

Der folgende Migrationsprozess ist von der erfolgreichen Migration des Webprojekts in die im vorherigen Abschnitt beschriebene J2EE-Projektstruktur abhängig.

Um den Inhalt eines iSeries-Webtoolsprojekts zu migrieren, gehen Sie wie folgt vor:

1. Klicken Sie mit der rechten Maustaste den Projektnamen in der Webperspektive an und wählen Sie Migrieren > iSeries-Webtoolsprojekt 4.0 auf 5.0 aus.
2. Wichtig: An diesem Punkt müssen Sie das Projekt schließen und erneut öffnen, um eine Ausnahmebedingung zu verhindern, die sich auf das Löschen von Ressourcen bezieht.
3. Das Fenster "Migration bestätigen" zeigt an, dass die Projektstruktur und der Projektinhalt migriert werden. Um den Prozess fortzusetzen, klicken Sie OK an.
4. Das Fenster mit Angaben zum Fortschritt wird geöffnet; es gibt an, dass die Migrationsoperation durchgeführt wird und zeigt den Fortschritt der Migration.
5. Bei Beendigung des Migrationsprozesses wird ein Nachrichtenfenster (Warnung, Fehler oder Erfolg) angezeigt, das die Ergebnisse der Migration angibt.
6. Wurde der Migrationsprozess erfolgreich abgeschlossen, ist keine weitere Aktion erforderlich. Wurde der Migrationsprozess mit Fehlern oder Warnmeldungen beendet, fahren Sie mit Adressierung von Fehlern und Warnmeldungen, die infolge der Migration generiert wurden weiter unten fort.

Der Migrationsprozess führt die folgenden Aktionen aus:

• Er konvertiert alle Entwurfszeitsteuerelemente in JSP-Dateien in die neuen Webkomponentenfelder und -steuerelemente.
• Er fügt die Apache Struts 1.02-Laufzeitdatei hinzu und bewirkt die Neugenerierung von Dateien, die sich auf Webinteraktionen beziehen, abhängig von dem Struts-Gerüst der .wit-Dateien.

Phase 4: Adressierung von Fehlern und Warnmeldungen, die infolge der Migration generiert wurden

Treten während des Migrationsprozesses Fehler auf, wird ein Fenster geöffnet, das angibt, dass Fehler oder Warnmeldungen aufgetreten sind und dass diese in der Migrationsprotokolldatei Projektname_MigrationDetails.txt unter dem Projektnamen in der Webperspektive zu finden sind.

Der Abschnitt "Migrationsergebnis" am Anfang der Migrationsprotokolldatei gibt den Gesamtstatus der Migration an und verweist auf eine Datei in den Onlineinformationen, die die Fehler und Warnmeldungen sowie die zur Korrektur erforderliche Aktion beschreibt.

Siehe auch "Details zu Migrationsfehlern und -warnmeldungen" in der Onlinehilfe:

       Development Studio Client für iSeries > Webanwendungen>
iSeries Web Development > Verweis > Details zu Migrationsfehlern und
-warnmeldungen. 

Migration von iSeries-Webprojekten vor Version 4.0

Dieser Abschnitt beschreibt die Vorgehensweise bei der Migration von dem WebSphere Studio-Produkt, das mit WebSphere Development Tools für iSeries Version 3.5 verwendet wurde. Dieses WebSphere Studio-Produkt wird in diesem Abschnitt als WebSphere Studio klassisch bezeichnet, um es von den aktuellen Versionen von WebSphere Studio zu unterscheiden. Diese Informationen beziehen sich sowohl auf die Advanced Edition als auch auf die Professional Edition von WebSphere Studio klassisch.

Anmerkung: Die folgenden Anweisungen gelten für die Migration von WebSphere Studio klassisch, Version 4.0. Soll die Migration von einer früheren Version von WebSphere Studio klassisch erfolgen, müssen Sie eine Migration auf WebSphere Studio klassisch, Version 4.0, durchführen, bevor Sie fortfahren.

Die Migration von WebSphere Studio klassisch umfasst die folgenden Schritte:

1. Erstellen einer neuen Einzelserverphase für die Migration
2. Erstellen einer Webkonfigurationsdeskriptordatei
3. Exportieren einer Migrations-JAR-Datei
4. Importieren der Migrations-JAR-Datei in ein Webprojekt
5. Abschließen der iSeries-Webprojektmigration
6. Konfigurieren Ihres Servers und testen Ihrer migrierten Anwendung

Sie sollten sich der folgenden Einschränkungen bewusst sein, bevor Sie Ihre Daten von WebSphere Studio klassisch migrieren:

• Die integrierte Entwicklungsumgebung (IDE = Integrated Development Environment) in der aktuellen Version von WebSphere Studio verwendet einen XML-basierten SQL-Editor, d. h., Ihre .sql-Dateien können nicht in ihm verwendet werden.
• Projektpublikationsdaten und Phasendaten können nicht migriert werden.
• Serverkonfigurationsdaten von WebSphere Studio klassisch können nicht migriert werden.
• Versionssteuerungsdaten können nicht migriert werden.

Während des Migrationsprozesses, der nachfolgend kurz erläutert wird, erstellen Sie eine JAR-Datei, die alle Ihre Projektdateien (publizierbare Dateien und Quellendateien) für einen einzelnen Server enthält. Alle im Fenster "Publizieren" sichtbaren Dateien für den Standardserver werden in die JAR-Datei gepackt. Sie können dann die JAR-Datei in ein Webprojekt in WebSphere Development Studio Client für iSeries, Version 5.0, importieren.

Beim Migrieren vorhandener Projekte gehen alle Projektpublikations- und Phasendaten während der Migration verloren. Verfügt Ihre Phase über mehrere Server, werden nur Dateien, die für den Standardserver publiziert wurden, beibehalten. Aus diesem Grund erstellen Sie zum Zweck der Migration eine neue Phase, die nur einen einzigen Server hat.

Migrationsschritte

Schritt 1 - Erstellen einer neuen Einzelserverphase für die Migration

Haben Sie mehr als einen Server in Ihrer aktuellen Phase, erstellen Sie eine neue Phase mit dem Namen "Migration", die nur einen einzigen Server hat, indem Sie diese Schritte ausführen:

1. Öffnen Sie das Projekt, das migriert werden soll, und klicken Sie das Menü Projekt > Publikationsphasen anpassen an.
2. Geben Sie Migration in das Feld Name der Phase ein.
3. Klicken Sie Hinzufügen an.
4. Klicken Sie OK an.
5. Klicken Sie das Menü Projekt > Publikationsphase an und wählen Sie in der Liste der verfügbaren Phasen Migration aus.
6. Klicken Sie im Fenster "Publizieren" Migration an und klicken Sie dann das Menü Einfügen > Server an.
7. Geben Sie einen Servername, wie z. B. lokalerhost, ein und klicken Sie OK an.
8. Optional: Führen Sie diese Task aus, wenn Sie Servletzuordnungsdaten definiert haben; fahren Sie andernfalls mit Schritt 2 weiter unten fort. Durch das Ändern des Servers oder der Publikationsphase werden nicht die Servletzuordnungsdaten für WebSphere Application Server, Version 4.0, verbreitet. Rufen Sie das Fenster "Publizieren" für jedes Servlet auf, klicken Sie mit der rechten Maustaste das Servlet an und wählen Sie Merkmale aus. Geben Sie auf der Registerkarte Publizieren im Fenster "Merkmale" die tatsächliche Servletzuordnung in das Feld Servletzuordnung ein und klicken Sie OK an. Die Servletzuordnung ist das URL-Muster für das registrierte Servlet auf dem Anwendungsserver.

Schritt 2 - Erstellen einer Webkonfigurationsdeskriptordatei

1. Klicken Sie im Fenster "Publizieren" Projekt > Webkonfigurationsdeskriptordatei erstellen an.
2. Wählen Sie alle erforderlichen Servlets aus.
3. Wählen Sie alle erforderlichen TLD-Dateien (TLD = Tag Library Descriptor) aus.
4. Klicken Sie Erstellen an.

Der Name der Webkonfigurationsdeskriptordatei hat das Format Servername_web.xml. Für den Server lokalerhost lautet der Name der Webkonfigurationsdeskriptordatei lokalerhost_web.xml. Es sei denn, Sie hatten eine andere Position angegeben, wird die .xml-Datei im Verzeichnis WEB-INF gesichert.

Schritt 3 - Exportieren einer Migrations-JAR-Datei

1. Klicken Sie im Fenster "Publizieren" mit der rechten Maustaste den Server lokalerhost an und klicken Sie das Menü Merkmale > Publizieren an.
2. Geben Sie einen Webpfad (Kontextstamm) in das Feld Webpfad für Webanwendung ein. Diese Eingabe wird als der Webprojektname verwendet, wenn das Projekt in Development Studio Client für iSeries, Version 5.0, erstellt wird. Geben Sie beispielsweise meinproj ein, wird dieser Name als Webprojektname in Version 5.0 verwendet.
3. Klicken Sie OK an.
4. Klicken Sie im Fenster "Publizieren" Projekt > Migrationsdatei erstellen an.
5. Stellen Sie sicher, dass lokalerhost der ausgewählte Server ist.
6. Stellen Sie sicher, dass lokalerhost_web.xml die ausgewählte Webkonfigurationsdeskriptordatei ist.
7. Klicken Sie OK an.
8. Der JAR-Dateiname hat das Format Servername.jar. Für den Server lokalerhost lautet der JAR-Dateiname lokalerhost.jar. Benennen Sie die Datei, falls gewünscht, um.
9. Geben Sie die Position für die JAR-Datei im Feld Sichern in an und klicken Sie Sichern an, um die JAR-Datei zu erstellen.

Schritt 4 - Importieren der Migrations-JAR-Datei in ein Webprojekt

1. Starten Sie WebSphere Development Studio Client für iSeries, Version 5.0.
2. Klicken Sie das Menü Fenster > Perspektive öffnen > Andere an, wählen Sie Web aus und klicken Sie OK an, um die Webperspektive zu öffnen.
3. Importieren Sie die JAR-Datei.
   1. Klicken Sie Datei > Import an.
   2. Klicken Sie WAR-Datei im Fenster Import an und klicken Sie Weiter an.
4. Gehen Sie im Fenster Ressourcen aus einer WAR-Datei importieren wie folgt vor:
   1. Geben Sie den vollständigen Pfad und den JAR-Dateinamen in das Feld WAR-Datei ein. Lautet der JAR-Dateiname beispielsweise lokalerhost.jar und befindet sich die Datei in d:\meinjar, geben Sie d:\meinjar\lokalerhost.jar in das Feld WAR-Datei ein.
      Anmerkung: Sie müssen die JAR-Datei mit Hilfe der Option "WAR-Datei" importieren; andernfalls ist ihre Funktionsweise fehlerhaft.
   2. Wählen Sie den Radioknopf Neu für das Webprojekt aus.
   3. Geben Sie im Feld Neuer Projektname den Namen für den Webpfad für Webanwendung, den Sie in Schritt 3 (siehe oben) definiert haben, als Ihren Webprojektnamen ein. Dieser Name wird automatisch dem Feld Kontextstamm hinzugefügt. Wird er nicht hinzugefügt, geben Sie den Projektnamen in das Feld Kontextstamm ein.
   4. Wählen Sie den Radioknopf Neu für Enterprise Application-Projekt aus und geben Sie einen Namen für die EAR-Datei ein. Die EAR-Datei hat den Standardnamen DefaultEAR. Sie können diesen Namen ändern, um ihn problemlos Ihrem neuen Projekt zuordnen zu können. Lautet beispielsweise der Name Ihres neuen Projekts meinproj, können Sie der EAR-Datei den Namen meinprojEAR zuordnen.
   5. Klicken Sie Fertig stellen an, um die JAR-Datei zu entpacken und das Webprojekt zu erstellen.
5. Um die Initialisierung des Webprojekts abzuschließen, führen Sie den Assistenten für die Laufzeitkonfiguration für iSeries-Webtools aus.
   1. Klicken Sie mit der rechten Maustaste den Webprojektnamen in der J2EE-Sicht "Navigator" an und wählen Sie Laufzeitkonfiguration für iSeries-Webtools angeben aus.
   2. Klicken Sie auf der Assistentenseite Fertig stellen an, ohne eine Eingabe in den Feldern vorzunehmen. Mit dieser Aktion werden die für iSeries-Webtools erforderlichen JAR-Dateien in Web-INF > lib in das Webprojekt kopiert.
6. Möglicherweise haben Sie mehrere unaufgelöste Verweise oder fehlende Importdateien. Diese werden in der Sicht "Tasks" angezeigt. Um diesen Fehler zu beheben, müssen Sie den Java-Erstellungspfad für das Webprojekt ändern:
   1. Klicken Sie mit der rechten Maustaste den Projektnamen an und klicken Sie Merkmale an, um das Fenster "Merkmale" zu öffnen.
   2. Klicken Sie Java-Erstellungspfad an und klicken Sie die Registerkarte Bibliotheken an.
   3. Klicken Sie Externe JARs hinzufügen an.
   4. Importieren Sie alle erforderlichen JARs aus den folgenden Verzeichnissen:
      x:\WS*D\runtimes\base_v5\lib,
      x:\WS*D\runtimes\aes_v4\lib und
      x:\WS*D\wstools\eclipse\plugins\com.ibm.etools.websphere.tools\runtime
      Dabei ist x:\WS*D das Installationsverzeichnis für das Basisprodukt.
7. Klicken Sie in der J2EE-Sicht "Navigator" mit der rechten Maustaste das Projekt an und wählen Sie Projekt erneut erstellen aus.

Schritt 5 - Abschließen der iSeries-Webprojektmigration

Folgen Sie den in den Phasen 2, 3 und 4 unter Migration von iSeries-Webprojekten von Version 4.0 auf Version 5.0 beschriebenen Tasks, um die Projektmigration abzuschließen:

1. Optional: Die Tasks in Phase 2 sind nicht erforderlich, wenn Ihre Webanwendung unter Version 4.x von WebSphere Application Server ausgeführt werden soll. Soll Ihre Webanwendung jedoch unter WebSphere Application Server, Version 5.0, ausgeführt werden, müssen Sie die Tasks in Phase 2 ausführen, um Ihr Webprojekt von J2EE 1.2 auf J2EE 1.3 zu migrieren.
2. Phase 3 beschreibt die Vorgehensweise bei der Migration des Webprojektinhalts.
3. Phase 4 liefert Informationen zur Adressierung von Fehlern und Warnmeldungen, die beim Migrieren des Webprojektinhalts generiert werden.

Sind diese Tasks abgeschlossen, fahren Sie mit Schritt 6 (siehe unten) fort.

Schritt 6 - Testen Ihrer migrierten Anwendung auf einem Testserver

Jetzt kann Ihre Anwendung getestet werden. Um sie auf dem Standardtestserver zu testen, führen Sie diese Schritte aus:

1. Klicken Sie mit der rechten Maustaste die Anfangsseite Ihrer Webanwendung an.
2. Wählen Sie Auf Server ausführen aus.

Um Ihre Anwendung in anderen Serverlaufzeitumgebungen zu testen, ziehen Sie die Onlinehilfe für die Servertools zu Rate.

Migration von iSeries-Projekten von Version 4.0 auf Version 5.0

Haben Sie noch Development Studio Client für iSeries Version 4.0 installiert, gehen Sie wie folgt vor:

Bevor Sie Development Studio Client Version 4.0 deinstallieren, sollten Sie Ihren Projektinhalt auf die Hostmaschine exportieren. Installieren Sie dann Development Studio Client Version 5.0. Nach der Installation können die Projekte erneut erstellt werden, indem eine Aktion von Remote System Explorer ausgeführt wird:

1. In Version 4.0: Klicken Sie mit der rechten Maustaste das iSeries-Projekt an und wählen Sie Änderungen hinzufügen aus. Damit sollten alle Ihre Codeänderungen in die diesem Projekt zugeordnete Bibliothek hochgeladen werden. (Sind Sie nicht sicher, welchen Host und welche Bibliothek dieses Projekt als Ziel hat, klicken Sie mit der rechten Maustaste das Projekt an und wählen Sie Merkmale > iSeries-Projekt aus.)
2. Schließen Sie Version 4.0 und deinstallieren Sie diese Version.
3. Fahren Sie mit der Installation von Development Studio Client für iSeries Version 5.0 fort.

1. In Version 5.0: Öffnen Sie die Remote System Explorer-Perspektive: Klicken Sie Fenster > Perspektive öffnen > Remote System Explorer an.
2. Navigieren Sie zu der zugehörigen Bibliothek Ihres iSeries-Projekts. Diese Bibliothek enthält die gesamte Quelle, die Sie aus dem iSeries-Projekt hochgeladen haben.
3. Wählen Sie in dieser Bibliothek die physischen Quellendateien, die Teil Ihres iSeries-Projekts waren, aus, klicken Sie sie mit der rechten Maustaste an und wählen Sie Offline verfügbar machen aus. Damit wird das iSeries-Projekt, das dieser Bibliothek zugeordnet ist, erneut erstellt und alle Quellenteildateien werden lokal in Ihr Projekt heruntergeladen. Sie können jetzt die Entwicklung fortsetzen.

   Anmerkung: Die Auswahl von iSeries-Projekt erstellen aus einer Bibliothek in Remote System Explorer ist eine andere, schnelle Möglichkeit, Ihr Projekt erneut zu erstellen; dabei werden jedoch keine Quellenteildateien aus dieser Bibliothek heruntergeladen. Vielmehr wird einfach ein iSeries-Projekt erstellt und konfiguriert, das dieser Bibliothek und diesem Host zugeordnet ist.

Haben Sie bereits Development Studio Client für iSeries Version 5.0 installiert und wissen Sie, dass Sie Ihre Projekte noch nicht auf den fernen Host hochgeladen haben, gehen Sie wie folgt vor:

1. Starten Sie Version 5.0.
2. Klicken Sie im Hauptmenü Fenster > Perspektive öffnen > Ressource an. Klicken Sie OK an.
3. Erstellen Sie ein einfaches Projekt, indem Sie Datei > Neu > Andere > Einfach > Projekt anklicken und ordnen Sie dem Projekt den Namen Temp zu. Dieses Projekt ist ein Container zum Importieren Ihres Projekts der Version 4.0 in den Arbeitsbereich der Version 5.0.
4. Wählen Sie Datei > Import > Dateisystem aus. Klicken Sie Weiter an.
5. Navigieren Sie zu Ihrem alten Arbeitsbereich (beispielsweise X:\WDSC\WSSD\workspace; dabei ist X das Laufwerk, auf dem Sie Version 4.0 installiert haben) und importieren Sie das Projekt, das erneut erstellt werden soll.
6. Erstellen Sie ein iSeries-Projekt, das der Bibliothek und dem Host des Projekts der Version 4.0 zugeordnet ist, das Sie soeben importiert haben.
   • Klicken Sie mit der rechten Maustaste eine beliebige Stelle in der Sicht "Navigator" an und wählen Sie Neu > Projekt > iSeries > Lokal > iSeries-Projekt aus.
   • Erinnern Sie sich nicht mehr an den Namen der Bibliothek und des Hosts, können Sie diese Angaben in einer XML-Datei mit dem Namen .iseries_project_properties unter dem Projekt Temp finden.
7. Erstellen Sie die physische Quellendatei, die in Ihrem Projekt der Version 4.0 vorhanden war, erneut:
   • Klicken Sie Datei > Neu > Andere > iSeries > Lokal > Physische iSeries-Quellendatei an.
   • Sind Sie sich nicht sicher, welche CCSID und welche Satzlänge Ihre Dateien hatten, können Sie diese Angaben in einer XML-Datei mit dem Namen .iseries_srcpf_properties unmittelbar unter jeder physischen Quellendatei finden.
8. Ziehen und übergeben Sie jetzt Quellenteildateien aus dem alten Projekt der Version 4.0 in das neue Projekt der Version 5.0.
9. Löschen Sie das Projekt Temp, das Sie nicht mehr benötigen, und öffnen Sie die Perspektive "iSeries-Projekte": Fenster > Perspektive öffnen > iSeries-Projekte.