mqsimigratecomponents-Befehl

Der Befehl mqsimigratecomponents migriert eine Komponente von einer zuvor installierten Version des Produkts auf eine andere Version auf demselben Computer, um sie auf die Teilnahme in der Brokerdomäne der Zielversion vorzubereiten.

Unterstützte Plattformen

  • Windows
  • Linux- und UNIX-Systeme
  • z/OS Führen Sie diesen Befehl aus, indem Sie BIPMGCMP anpassen und übergeben.

Zweck

Migrieren Sie Komponenten von Version 6.0 oder Version 5.0 auf WebSphere Nachrichtenbroker Version 6.1.

Sie können mit diesem Befehl auch eine Komponente von einer höheren Version auf eine frühere Version zurücksetzen, um die Auswirkungen einer Aufwärtsmigration rückgängig zu machen. Dies gilt mit einer einzigen Ausnahmen. Ein Konfigurationsmanager kann nicht von Version 6.1 auf Version 5.0 zurückgesetzt werden.

Dieser Befehl muss immer von der höchsten installierten Version aus ausgeführt werden, unabhängig davon, ob es sich um die Quell- oder die Zielversion handelt.

Bei Version 5.0 des Produkts ist Version 5.0.0.4 (Fixpack 4) das früheste Produktrelease, das unterstützt wird.

Damit dieser Befehl erfolgreich ausgeführt wird, muss das Produkt mit der erforderlichen Version, einschließlich des erforderlichen Komponentencodes, installiert sein.

Stoppen Sie vor Beginn der Migration alle aktiven Debugsitzungen im Message Broker Toolkit der Version 2.1. Nachrichtenflüsse, für die gerade ein Debug ausgeführt wird, können nicht migriert werden.

Geben Sie in diesem Befehl die entsprechenden Optionen an, um eine der folgenden Aktionen auszuführen:
  • Eine Komponente überprüfen, ohne Änderungen vorzunehmen, um sicherzustellen, dass die Komponente für die erforderliche Migration geeignet ist (-c).
  • Eine Komponente teilweise oder vollständig in eine andere Version versetzen (-s und -t).
  • Einen fehlgeschlagenen Migrationsschritt rückgängig machen (-u).
  • Überprüfen, ob die Versetzung erfolgreich ausgeführt wurde (-v).

Mit dem Befehl mqsimigratecomponents werden die Registry und das Dateisystem sowie die WebSphere MQ-Definitionen und Datenbankdefinitionen aktualisiert. Wenn der Benutzer, der den Befehl absetzt, nicht zur Ausführung all dieser Schritte berechtigt ist, kann der Befehl auch immer nur teilweise ausgeführt werden. Damit das Gesamtergebnis erzielt wird, können die übrigen Teile von anderen Benutzern mit den entsprechenden Berechtigungen ausgeführt werden. Diese Vorgehensweise wird als geteilte Migration bezeichnet und unter Angabe der Parameter -1, -2 und -3 ausgeführt.

Wenn Sie mit dem Befehl mqsimigratecomponents einen Broker migrieren, der eine Sybase-Datenbank verwendet, müssen Sie die Datenbank wie folgt ändern:
  1. Melden Sie sich unter Verwendung eines Systemadministratorkontos bei ISQL an.
  2. Geben Sie folgende Befehlsreihe aus:
    1> use master
    2> go
    1> sp_dboption "BROKER1","ddl in tran",TRUE
    2> go
    Database option 'ddl in tran' turned ON for database 'BROKER1'.
    Run the CHECKPOINT command in the database that was changed.
    (return status = 0)
    1> use BROKER1
    2> go
    1> checkpoint
    2> go
    Dabei ist BROKER1 der Name der Sybase-Brokerdatenbank.

Syntax

Parameter

-c
(Optional) Überprüfen Sie eine ausgewählte Komponente vor ihrer Migration, um Folgendes sicherzustellen:
  • Die automatisch ermittelte Brokerversion muss mit der in der Befehlszeile angegebenen Version übereinstimmen.
  • 64-Bit-Ausführungsgruppen werden nicht unterstützt, wenn Sie eine Migration von Version 6.1 auf Version 5.0 durchführen.
  • Datenbanktabellen, die aus einem früheren Release kopiert werden, dürfen keine Zeilen enthalten, die nicht ordnungsgemäß indexiert sind.

Die Migrationsprüfung kann für eine aktive Komponente ausgeführt werden. Die Prüfung betrifft nicht die Komponenten, mit Ausnahme einer geringen Auswirkung auf die Systemleistung. Auf Linux- und UNIX-Systemen müssen Sie die ODBC-Konfigurationsdateien (die Dateien, in denen Sie die Datenquellen definiert haben, auf die durch ODBCINI und ODBCINI64 verwiesen wird) vor der Durchführung der Prüfung migrieren, da der Prüfbefehl in der Lage sein muss, auf die Brokerdatenbank zuzugriefen.

Der Prüfbefehl ist entweder erfolgreich oder nicht und meldet, ob die Migration erfolgreich sein wird; er nimmt jedoch keine Änderungen vor.

-v
(Optional) Überprüfen Sie die ausgewählte Komponente nach der Migration auf Folgendes:
  • Für die angegebene Version sind die korrekten Datenbanktabellen und Warteschlangen vorhanden.
  • Das Registry hat das korrekte Format für die angegebene Version.
-q
(Optional) Gibt an, dass weniger Statusnachrichten während des Vorgangs ausgegeben werden sollen.
-1
(Optional) Gibt an, dass nur Tasks in Zusammenhang mit dem Registry und dem Dateisystem ausgeführt werden sollen.
  • Bei einer Migration auf Version 6.1 müssen Sie den Parameter -1 vor den Parametern -2 oder -3 verwenden.
  • Bei der Abwärtsmigration auf eine frühere Version müssen Sie die Parameter -2 oder -3 vor dem Parameter -1 verwenden.
-2
(Optional) Gibt an, dass nur Tasks in Zusammenhang mit WebSphere MQ ausgeführt werden sollen.
-3
(Optional) Gibt an, dass nur Tasks in Zusammenhang mit der Datenbank ausgeführt werden sollen.

Wenn ein zu migrierender Broker mit einem anderen Broker ein Datenbankschema gemeinsam nutzt, wird die Warnung BIP8678 ausgegeben, und die Überprüfung schlägt fehl. In diesem Fall müssen alle Broker, die ein Datenbankschema gemeinsam nutzen, zusammen migriert werden.

  1. Stoppen Sie alle Broker, die das Datenbankschema gemeinsam nutzen.
  2. Migrieren Sie den ersten Broker. Dabei werden die Datenbanktabellen für alle Broker sowie das Dateisystem, die Registry und die WebSphere MQ-Definitionen, die ausschließlich für diesen Broker gelten, migriert; Beispiel:
    mqsimigratecomponents FIRSTBROKER -t 6.1.0.0
  3. Migrieren Sie das Dateisystem und die Registry sowie die WebSphere MQ-Bereiche der einzelnen anderen Broker; der Datenbankbereich wurde bereist migriert. Verwenden Sie hierfür (in einem Schritt oder in zwei Schritten) die Parameter -1 und -2:
    • In einem Schritt:
      mqsimigratecomponents BROKERB -1 -2
    • In zwei Schritten:
      mqsimigratecomponents BROKERB -1
      mqsimigratecomponents BROKERB -2
-u
(Optional) Gibt an, dass ein fehlgeschlagener Migrationsschritt rückgängig gemacht werden soll; es muss mindestens einer der Parameter -1, -2 oder -3 angegeben worden sein. Diese Option wird verwendet, wenn die Migration sowie eine automatische Wiederherstellung fehlgeschlagen sind (beispielsweise bei einer Teilmigration).
-s Quellenversion
(Optional) Die vorhergehende Version der Komponente.
  • Erfolgt keine Angabe, wird dieser Wert automatisch ermittelt.
  • Bei einer geteilten Migration auf Version 6.1 ist der Parameter -s nach der Ausführung des Befehls mqsimigratecomponents mit dem Parameter -1 obligatorisch (siehe Beispiel für eine geteilte Migration).
  • Hinweise zu Einschränkungen bei den unterstützten Produktversionen finden Sie unter Zweck.
-t Zielversion
(Optional) Die Zielversion der Komponente.
  • Erfolgt keine Angabe, wird von der aktuellen Version ausgegangen.
  • Bei Ausführung einer geteilten Migration von Version 6.1 auf eine frühere Version ist der Parameter -t obligatorisch (siehe Beispiel für eine geteilte Migration).
  • Hinweise zu Einschränkungen bei den unterstützten Produktversionen finden Sie unter Zweck.
Komponentenname
(Erforderlich) Der Name der zu migrierenden Komponente.

Autorisierung

Wenn Sie die Migration in einem einzigen Schritt durchführen, muss Ihre Benutzer-ID folgende Berechtigungen besitzen:
  • Schreibzugriff auf Registry und Dateisystem des Produkts
  • Berechtigung zum Ändern der Komponentendatenbanken
  • Berechtigung zum Ändern von Warteschlangendefinitionen
Bei einer geteilten Migration muss Ihre Benutzer-ID auf jeden Fall die Berechtigung haben, Daten aus dem Registry des Produkts zu lesen; darüber hinaus muss sie für jeden Schritt über bestimmte Berechtigungen verfügen, damit eine erfolgreiche Ausführung möglich wird:
  • Für Schritt -1 ist ein Schreibzugriff auf Registry und Dateisystem des Produkts erforderlich
  • Für Schritt -2 ist die Berechtigung zum Ändern von Warteschlangendefinitionen erforderlich
  • Für Schritt -3 ist die Berechtigung zum Ändern der Komponentendatenbanken erforderlich

Antworten

Dieser Befehl kann eine ganze Reihe von möglichen Antworten generieren, je nach Ausgang der verschiedenen Operationen. Der Befehl unterscheidet sich von anderen Befehlen hinsichtlich der Art und Weise, wie Nachrichten erzeugt werden: sie werden sofort nach ihrer Generierung angezeigt und nicht erst als Stapelbericht am Ende des Programms. Beim Migrieren von Datenbanktabellen erzeugt z/OS eine umfangreichere Ausgabe als verteilte Systeme. Mit dem Parameter -q können Sie die Anzahl der angezeigten Nachrichten reduzieren.

Beispiele

Das folgende Beispiel zeigt eine geteilte Migration von Version 5.0 auf Version 6.1:

mqsimigratecomponents BROKER -1
mqsimigratecomponents BROKER -s 5.0.0.5 -2
mqsimigratecomponents BROKER -s 5.0.0.5 -3

Das folgende Beispiel zeigt eine Vormigrationsprüfung, gefolgt von einer Migration von BROKER1 von Version 6.0 auf Version 6.1:

mqsimigratecomponents -c BROKER1
BIP8849I: Für die Migration wurde Broker 'BROKER1' (Version 6.0) mit WS-Manager 'QM' und Datenquelle 'BROKERDB' angegeben.
BIP8680I: Vormigrationsprüfung war erfolgreich.
BIP8071I: Befehl wurde erfolgreich ausgeführt.

mqsimigratecomponents BROKER1
BIP8849I: Für die Migration wurde Broker 'BROKER1' (Version 6.0) mit WS-Manager 'QM' und Datenquelle 'BROKERDB' angegeben.
BIP8768I: Registry-Migration für Komponente 'BROKER1' ist beendet.
BIP8654I: Dateisystemartefakte werden von 'C:\Dokumente und Einstellungen\All Users\Anwendungsdaten\IBM\MQSI' nach 'C:\Dokumente und Einstellungen\All Users\Anwendungsdaten\IBM\MQSI' verschoben
BIP8670I: Datenbankmigration wurde gestartet.
BIP8663I: Temporäre neue Tabellen werden erstellt.
BIP8664I: Migration von vorhandenen Tabellen in temporäre neue Tabellen wird durchgeführt.
BIP8665I: Vorhandene Tabellen werden gelöscht.
BIP8666I: Neue Tabellen werden erstellt.
BIP8667I: Alle Zeilen aus temporären neuen Tabellen werden werden in neue Tabellen kopiert.
BIP8668I: Temporäre neue Tabellen werden gelöscht.
BIP8669I: Datenbankmigration war erfolgreich.
WebSphere MQ-Warteschlangenmanager ist aktiv.
BIP8785I: WebSphere MQ-Warteschlangenmigration für Komponente 'BROKER1' wird gestartet.
Der Befehl 'setmqaut' wurde erfolgreich ausgeführt.
BIP8786I: WebSphere MQ-Warteschlange 'SYSTEM.BROKER.EDA.COLLECTIONS' wurde erstellt.
Der Befehl 'setmqaut' wurde erfolgreich ausgeführt.
BIP8786I: WebSphere MQ-Warteschlange 'SYSTEM.BROKER.EDA.EVENTS' wurde erstellt.
BIP8787I: Inhalt der WebSphere MQ-Warteschlange 'SYSTEM.BROKER.AGGR.REQUEST' wurde gelöscht.
BIP8787I: Inhalt der WebSphere MQ-Warteschlange 'SYSTEM.BROKER.AGGR.CONTROL' wurde gelöscht.
BIP8787I: Inhalt der WebSphere MQ-Warteschlange 'SYSTEM.BROKER.AGGR.REPLY' wurde gelöscht.
BIP8787I: Inhalt der WebSphere MQ-Warteschlange 'SYSTEM.BROKER.AGGR.TIMEOUT' wurde gelöscht.
BIP8787I: Inhalt der WebSphere MQ-Warteschlange 'SYSTEM.BROKER.AGGR.UNKNOWN' wurde gelöscht.
BIP8787I: Inhalt der WebSphere MQ-Warteschlange 'SYSTEM.BROKER.TIMEOUT.QUEUE' wurde gelöscht.
BIP8787I: Inhalt der WebSphere MQ-Warteschlange 'SYSTEM.BROKER.ADMIN.QUEUE' wurde gelöscht.
BIP8787I: Inhalt der WebSphere MQ-Warteschlange 'SYSTEM.BROKER.EXECUTIONGROUP.QUEUE' wurde gelöscht.
BIP8787I: Inhalt der WebSphere MQ-Warteschlange 'SYSTEM.BROKER.EXECUTIONGROUP.REPLY' wurde gelöscht.
BIP8787I: Inhalt der WebSphere MQ-Warteschlange 'SYSTEM.BROKER.WS.INPUT' wurde gelöscht.
BIP8787I: Inhalt der WebSphere MQ-Warteschlange 'SYSTEM.BROKER.WS.REPLY' wurde gelöscht.
BIP8787I: Inhalt der WebSphere MQ-Warteschlange 'SYSTEM.BROKER.WS.ACK' wurde gelöscht.
BIP8787I: Inhalt der WebSphere MQ-Warteschlange 'SYSTEM.BROKER.IPC.QUEUE' wurde gelöscht.
BIP8789I: WebSphere MQ-Warteschlangenmigration für Komponente 'BROKER1' ist beendet.
BIP8071I: Befehl wurde erfolgreich ausgeführt.

Das folgende Beispiel zeigt eine Migration von Version 6.1 zurück nach Version 6.0:

mqsimigratecomponents BROKER -t 6.0.0.3
Zugehörige Verweise
Migration und Aktualisierung
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
an26150_