Nachrichtenfluss mit Datendefinitionen migrieren

Bei der Migration eines Nachrichtenflusses, der Datendefinitionen verwendet, werden die Definitionen in Version 6.1 konvertiert und ersetzt.

WebSphere Nachrichtenbroker Version 6.1 verwaltet die Datendefinitionen in einem Datenentwurfsprojekt. Eine einzelne Datei im Projekt (eine Datei mit der Erweiterung.dbm) repräsentiert die Datenbank. Diese Datei ersetzt die Gruppe der .xmi-Dateien, die für jede Datendefinition in der Workbench der Version 5.0, Version 5.1 oder Version 6.0 erstellt wurden.

Wie die Migration gestartet werden kann, hängt von der Version ab, die Ausgangspunkt für die Migration ist:

Da die Projektdateien vom Migrationsprozess geändert und die alten Formatdateien gelöscht werden, müssen Sie Ihre Ressourcen sichern, bevor Sie bestehende Ressourcen in der Workbench von Version 6.1 verwenden.

Sobald die Migration abgeschlossen ist, können Sie Datenentwurfsprojekte in der Ansicht 'Brokeranwendungsentwicklung' anzeigen und den Inhalt der Dateien mit der Erweiterung .dbm in den Ansichten für Datenprojekte und den Datenbank-Explorer aufrufen.

Falls eine Datendefinition nicht erfolgreich migriert wird, ist eine Unterstützung der Datenbank möglicherweise nicht mehr möglich. Überprüfen Sie die Version der Datenbank, auf die in der Datendefinition verwiesen wird, anhand der Anweisungen im Abschnitt Unterstützte Datenbanken, und führen Sie, falls erforderlich, eine Aktualisierung der Datenbank durch.

Datendefinitionen in der Workbench migrieren

Führen Sie dazu die folgenden Schritte aus:

  1. Starten Sie die Version 6.1 Workbench, und wechseln Sie zur Ansicht 'Brokeranwendungsentwicklung'.
  2. Importieren Sie den Nachrichtenfluss mit Datendefinitionen in den Dateien .xmi. Sie werden zur Bestätigung aufgefordert, dass Sie eine Migration durchführen möchten.
  3. Wählen Sie Diese Nachricht nicht mehr anzeigen aus, wenn alle Projekte automatisch bei deren Import oder Neuerstellung migriert werden sollen, und klicken Sie auf Ja, um mit der Migration fortzufahren. Das Projekt wird erneut erstellt, alle Datendefinitionen werden in das Dateiformat von .dbm konvertiert, und alle Datenbankverweise aus ESQL-Modulen und -Zuordnungen werden ersetzt.

    Klicken Sie zum Zurücksetzen der Option, mit der der Bestätigungsdialog unterdrückt wird, auf Fenster > Einstellungen, öffnen Sie dann Brokerentwicklung, und klicken Sie auf Datenbankdefinition. Ändern Sie die Einstellung in dieser Anzeige.

  4. Nach der Migration müssen Sie alle Ihre Projekte bereinigen. Gehen Sie dazu wie folgt vor:
    1. Klicken Sie auf Project (Projekt) > Clean (Bereinigen).
    2. Wählen Sie Clean all projects (Alle Projekte bereinigen) aus.
    3. Klicken Sie auf OK.
  5. Überprüfen Sie die Ergebnisse der Migration. In der Taskansicht werden Fehler und Warnungen angezeigt.

Wenn Sie die Migration nicht fortsetzen möchten, werden möglicherweise in den ESQL-Modulen (.esql-Dateien) und in Zuordnungen (.msgmap-Dateien) Fehler in Bezug auf Datenbanken generiert. Vor der Implementierung des Projekts müssen de Datenbankressourcen im Projekt migriert werden. Sie können die Migration später starten, indem Sie das Nachrichtenflussprojekt erneut erstellen, oder indem Sie mit der rechten Maustaste auf den Ordner mit den Datenbankverbindungen klicken und Migration der Datenbankdefinition auswählen. (Der Ordner für Datenbankverbindungen wird nur im Toolkit angezeigt, wenn Sie nicht alle Datenbankdefinitionen migriert haben, und er wird entfernt, sobald die gesamte Migration abgeschlossen ist.)

Im Abschnitt Durchführung der Migration finden Sie ausführliche Informationen zu den Änderungen, die am Inhalt des Arbeitsbereichs vorgenommen werden.

Datendefinitionen mit dem Befehl mqsimigratemfmaps migrieren

Wenn Sie eine Migration von Version 5.0 durchführen, verwenden Sie den Befehl mqsimigratemfmaps für die Migration von Nachrichtenflussprojekten, die Zuordnungen und/oder Datendefinitionen enthalten.

Führen Sie dazu die folgenden Schritte aus:

  1. Öffnen Sie ein Befehlsfenster, das für Ihre Version 6.1-Installation konfiguriert ist.
    • Linux platform Führen Sie unter Linux (x86-Plattform) den Befehl mqsiprofile aus.
    • Windows platform Klicken Sie unter Windows aufStart > Programme > IBM WebSphere Message Brokers 6.1 > Befehlskonsole.
  2. Befehl mqsimigratemfmaps ausführen Geben Sie die Parameter für die gewünschte Operation an. Sie können beispielsweise alle Projekte im Quellenverzeichnis migrieren, oder nur ein spezielles Projekt bzw. mehrere spezielle Projekte. Sie können auch den Pfad und Namen der Protokolldatei angeben, in der der Fortschritt festgehalten wird.
  3. Überprüfen Sie den Inhalt der Protokolldatei. Wenn Sie keine andere Protokolldatei angegeben haben, werden die Migrationsergebnisse in der Datei mqsimigratemfmaps.report.txt festgehalten, die sich in dem Ordner befindet, von dem aus Sie den Befehl ausgeführt haben.
  4. Starten Sie die Workbench der Version 6.1, und wechseln Sie in die Ansicht 'Brokeranwendungsentwicklung', um die migrierten Ressourcen anzuzeigen.
  5. Nach der Migration müssen Sie alle Ihre Projekte bereinigen. Gehen Sie dazu wie folgt vor:
    1. Klicken Sie auf Project (Projekt) > Clean (Bereinigen).
    2. Wählen Sie Clean all projects (Alle Projekte bereinigen) aus.
    3. Klicken Sie auf OK.

Im Abschnitt Durchführung der Migration finden Sie ausführliche Informationen zu den Änderungen, die am Inhalt des Arbeitsbereichs vorgenommen werden.

Durchführung der Migration

Die Migration wird folgendermaßen durchgeführt:

  • Ein neues Datenentwurfsprojekt wird erstellt, wenn im Projekt Datenbankdefinitionen festgestellt werden. Der Name des ersten Datenentwurfsprojekts wird auf den Namen des Nachrichtenflussprojekts mit dem Zusatz_DDP gesetzt. Beispiel: Flussprojekt1_DDP.

    Jede Datenbankdefinition wird in das Format der Version 6.1 konvertiert (die Gruppe der Dateien mit der Erweiterung .xmi wird also konvertiert und als einzelne Datei namens Datenbankname.dbm gespeichert). In einem einzelnen Datenentwurfsprojekt werden mehrere eindeutige Datenbankdefinitionen konvertiert und gespeichert.

    Sie können die Datei mit der Erweiterung .dbm oder das Datenentwurfsprojekt umbenennen.

  • Wenn Sie doppelt vorhandene Datenbankdefinitionen für dieselbe Datenbank im Nachrichtenflussprojekt erstellt haben, wird für jede Definition ein weiteres Datenentwurfsprojekt erstellt.

    In Version 5.0, Version 5.1 und Version 6.0 können Sie mehrere Datenbankdefinitionen für dieselbe Datenbank innerhalb eines einzelnen Nachrichtenflussprojekts erstellen. In Version 6.1 ist für jede Datenbank nur eine Definition möglich; auf diese Weise wird die Eindeutigkeit der Zuordnungen gewährleistet.

    Sie können zwar für dieselbe Datenbank in jeweils eigenen Datenentwurfsprojekten separate Datendefinitionen erstellen, aber Sie können über ein einzelnes Nachrichtenflussprojekt nur auf eine dieser Definitionen verweisen.

    Die Dateien .xmi werden in eine einzelne Datei mit der Erweiterung .dbm konvertiert, und jede doppelt vorhandene Definition wird in einem eigenen Datenentwurfsprojekt gespeichert. Die Namen der zusätzlichen Datenentwurfsprojekte basieren ebenfalls auf dem Namen des Nachrichtenflussprojekts und haben den Zusatz _DDP2, _DDP3 usw.

    Möglicherweise müssen Sie Ihre Nachrichtenflussprojekte ändern, um sicherzustellen, dass alle Datenbankverweise für dieselbe Datenbankdefinition gelten.

  • Alle alten Datenbankdefinitionsdateien werden aus dem Nachrichtenflussprojekt und aus dem Dateisystem gelöscht.
  • Das erste Datenentwurfsprojekt, das erstellt wird, wird dem Nachrichtenflussprojekt als Projektverweis hinzugefügt.

    Wenn Datenentwurfsprojekte für doppelt vorhandene Datenbankdefinitionen erstellt wurden, können Sie nicht aus demselben Nachrichtenflussprojekt heraus auf diese Projekte verweisen.

    Wenn Sie den Namen des Datenentwurfsprojekts ändern, müssen Sie den Projektverweis im Nachrichtenflussprojekt modifizieren.

  • Während der Konvertierung werden Informationen und Fehler in einem Protokoll aufgezeichnet. Die Fehler werden auch in einem Dialogfenster angezeigt und weisen darauf hin, dass die Migration für eine Definition fehlgeschlagen ist; dabei wird auch die Fehlerursache genannt. Rufen Sie nach der Migration die Protokolldatei migratedbdefinitions.log im Verzeichnis .metadata/.plugins/com.ibm.etools.mft.rdb auf.

    Das Protokoll enthält Einzelangaben zu den erstellten Datenentwurfsprojekten, den Dateien mit der Erweiterung .dbm, die diesen Projekten hinzugefügt wurden, und den Dateien mit der Erweiterung .xmi, die gelöscht wurden.

    Wenn Sie diese Ressourcen zu einem späteren Zeitpunkt migrieren (beispielsweise beim Import eines anderen Nachrichtenflussprojekts), werden die Protokollsätze an den bestehenden Inhalt angehängt.

Zugehörige Konzepte
Ressourcen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ah61210_