Einen Nachrichtenfluss migrieren

Nachrichtenflüsse, die in WebSphere MQ Event Broker Version 2.1 erstellt wurden, können migriert und in WebSphere Event Broker Version 6.0 verwendet werden.

Sie können die Nachrichtenflüsse, die Sie migrieren, ändern, um die neuen Knoten und Funktionen in Version 6.0 zu nutzen.

Es kann mehr als ein Nachrichtenfluss auf einmal migriert werden, wenn sie im gleichen Nachrichtenflussprojekt definiert werden sollen. Sie müssen untergeordnete Flüsse mit den Nachrichtenflüssen migrieren, in denen sie enthalten sind, um konsistente Verweise sicherzustellen.

Wenn mehrere Nachrichtenflüsse mit demselben Namen definiert wurden oder ein Nachrichtenfluss in mehrere Exportdateien exportiert wurde, überschreibt die Migrationstask ohne Vorwarnung jeden vorhandenen Nachrichtenfluss mit dem nächsten Fluss des gleichen Namens. Seien Sie deshalb vorsichtig, um solche Konflikte zu vermeiden. Stellen Sie sicher, dass die aktuellste Version eines mehrmals definierten Nachrichtenflusses als letzte Version migriert wird.

Wenn mehrere Versionen desselben Nachrichtenflusses vorliegen, den Sie als untergeordneten Fluss in anderen Flüssen desselben Migrationsverzeichnisses verwenden, sind die Folgen des Importvorgangs unvorhersehbar.

So migrieren Sie einen Nachrichtenfluss:

  1. Bevor Sie Version 2.1 deinstallieren, exportieren Sie den Nachrichtenfluss (oder die Nachrichtenflüsse) mithilfe der Version 2.1-Tools aus der Steuerzentrale (Einzelheiten dazu finden Sie in der Dokumentation von Version 2.1).

    Der Migrationsprozess ist am effektivsten, wenn alle referenzierten untergeordneten Flüsse in der gleichen Exportdatei enthalten sind. Exportieren Sie deshalb alle zu migrierenden Nachrichtenflüsse, die Sie in ein einzelnes Nachrichtenflussprojekt migrieren möchten, in eine einzelne Exportdatei.

  2. Übertragen Sie die Exportdatei(en) an das neue System, auf dem Sie die Workbench ausführen.
    • Prüfen Sie, ob das Verzeichnis, in dem Sie diese Dateien speichern, keine weiteren Dateien enthält.
    • Speichern Sie die Dateien, die Sie in einem einzelnen Nachrichtenflussprojekt importieren möchten, in einem separaten Verzeichnis, und migrieren Sie jedes Verzeichnis einzeln.
    • Stellen Sie sicher, dass Sie keine Dateien in Unterverzeichnisse des Projektverzeichnisses speichern, da diese Dateien vom Migrationsbefehl ignoriert werden.
  3. Wenn eine Workbench-Sitzung aktiv ist, muss diese geschlossen werden. Der Migrationsbefehl kann nicht ausgeführt werden, wenn die Workbench läuft.
  4. Rufen Sie bei einer Eingabeaufforderung den Befehl mqsimigratemsgflows auf, und geben Sie den neuen Projektnamen und das Verzeichnis an, in dem Sie die Exportdateien gespeichert haben. Nach Abschluss des Befehls:
    • Die Nachrichtenflüsse aus den Exportdateien des angegebenen Verzeichnisses wurden in das angegebene Nachrichtenflussprojekt importiert. Falls das Projekt bereits vorhanden war, werden die zusätzlichen Nachrichtenflüsse mit dem aktuellen Inhalt (falls vorhanden) eingeschlossen. Falls das Projekt vor Aufrufen des Befehls nicht vorhanden war, wird es für Sie erstellt. Der Befehl arbeitet am effektivsten, wenn er das Nachrichtenflussprojekt für Sie erstellen kann.
    • Es werden Nachrichtenflüsse und untergeordnete Flüsse erstellt und ihre Definitionen in Dateien mit dem Namen Flussname.msgflow gespeichert.

      Wenn Sie Nachrichtenflüsse oder Knoten nach ihrem Import umbenennen möchten, damit sie ihren lokalen Namenskonventionen entsprechen, müssen Sie die Funktionen der Workbench verwenden, um die Konsistenz und Integrität aller Verweise sicherzustellen. Benennen Sie keine Dateien innerhalb des Dateisystems um.

  5. Überprüfen Sie die Berichtsdatei mqsimigratemsgflows.report.txt, die in das Verzeichnis geschrieben wird, aus dem Sie den Befehl aufgerufen haben. Der Befehl stellt die folgenden Informationen bereit:
    • Der Name jedes Nachrichtenflusses und untergeordneten Nachrichtenflusses, der migriert wurde. Falls eine dieser Ressourcen einen Namen hatte, der nicht mit Version 6.0 kompatibel ist, aktualisiert der Befehl den Namen und alle Verweise auf ihn, um Konsistenz zu gewährleisten. (Wenn Sie eine Ressource mit einem ungültigen Namen mehr als einmal migrieren, ist die am Namen vorgenommene Korrektur immer die gleiche.)
    • Der Erfolg oder Fehler bei jeder migrierten Ressource.
    • Der Hinweis auf einen untergeordneten Fluss, der nicht gefunden werden kann (seine Definition ist in keiner Exportdatei, aber in einem oder mehreren migrierten Nachrichtenflüssen enthalten). Ist dies der Fall, machen Sie den fehlenden untergeordneten Fluss ausfindig, und importieren Sie ihn in das entsprechende Projekt. Wenn Sie den fehlenden untergeordneten Fluss aus irgendeinem Grund nicht abrufen können, erstellen Sie ihn erneut mit dem ursprünglichen Namen. Alle betroffenen Flüsse können dann zum neuen untergeordneten Fluss eine Verknüpfung erstellen.

      Sie müssen nicht den gesamten Export- und Importprozess wiederholen.

  6. Starten Sie die Workbench, und wechseln sie zur Ansicht 'Brokeranwendungsentwicklung'.
  7. Öffnen Sie das durch den Migrationsbefehl erstellte oder aktualisierte Nachrichtenflussprojekt.

    Falls das Projekt bereits geöffnet ist, klicken Sie mit der rechten Maustaste, und wählen Sie Aktualisieren und anschließend Projekt erneut erstellen aus, um sicherzustellen, dass die Brokerentwicklungsansicht den neuen Inhalt zeigt. Bei der erneuten Erstellung wird auch eine Prüfung der Inhalte des Nachrichtenflussprojekts durchgeführt.

Lesen Sie nach der Migration Ihrer Ressourcen den Abschnitt Tasks nach der Migration in Version 2.1. Hier finden Sie Informationen zu den Tasks, die im Anschluss an eine Migration gegebenenfalls auszuführen sind.
Zugehörige Konzepte
Nachrichtenflüsse - Übersicht
Zugehörige Tasks
Vorhandene Nachrichtenflüsse öffnen
Nachrichtenflussinhalte definieren
Zugehörige Verweise
Ansicht 'Brokeranwendungsentwicklung'
Integrierte Knoten
Befehl 'mqsimigratemsgflows'
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. Alle Rechte vorbehalten.
Letzte Aktualisierung : 2009-02-17 15:49:21

ac02355_