Befehl mqsimigratecomponents

Mit dem Befehl mqsimigratecomponents können Sie eine Komponente von einer zuvor installierten Version des Produkts auf eine andere Version auf demselben Computer migrieren, 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 2.1 oder Version 5.0 auf WebSphere Event Broker Version 6.0.
  • Bei Version 2.1 des Produkts ist Version 2.1 CSD02 (2.1.0.3) das früheste Produktrelease, das unterstützt wird.
  • Bei Version 5.0 des Produkts ist Version 5.0.0.4 (Fixpack 4) das früheste Produktrelease, das unterstützt wird.

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.

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.

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 Brokers Toolkitoder Steuerzentrale 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).
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) Prüfen Sie eine angegebene Komponente vor der Migration, um Folgendes sicherzustellen:
  • Die automatisch ermittelte Brokerversion stimmt mit der in der Befehlszeile angegebenen Version überein.
  • 64-Bit-Ausführungsgruppen werden nicht unterstützt, wenn Sie eine Migration von Version 6.0 auf ein früheres Release durchführen.
  • Datenbanktabellen, die aus einem früheren Release kopiert werden, dürfen keine Zeilen enthalten, die nicht ordnungsgemäß indexiert sind.

Sie können eine aktive Komponente prüfen. 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-Konfigurationsdatei (die Datei, in der Sie die Datenquellen definiert haben, z. B. .odbc.ini) migrieren, bevor Sie die Prüfung durchführen, denn der Prüfbefehl muss auf die Brokerdatenbank zugreifen können.

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

-v
(Optional) Prüfen Sie eine angegebene Komponente nach der Migration, um Folgendes sicherzustellen:
  • 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.0 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.0.0.1 
  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. Verwenden Sie diese Option nur, 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.0 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.0 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

Mit dem Befehl mqsimigratecomponents werden die Registry und das Dateisystem sowie die WebSphere MQ-Definitionen und Datenbankdefinitionen aktualisiert. Wenn die Benutzer-ID, unter der dieser Befehl ausgeführt wird, nicht zur Ausführung all dieser Schritte berechtigt ist, können Sie den Befehl auch immer nur teilweise ausführen. 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 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überhinaus 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

Mit dem folgenden Befehl wird die Migration von BROKER1 von Version 2.1 auf Version 6.0 überprüft:

mqsimigratecomponents –c BROKER1
BIP8849I: Broker 'BROKER1' (Version 2.1) with Queue Manager 'brkqm1' and Data Source 'brkdb1' specified for migration. (Broker 'BROKER1' (Version 2.1) mit Warteschlangenmanager 'brkqm1' und Datenquelle 'brkdb1' für die Migration angegeben.)
BIP8791I: Die Überprüfung auf doppelte Zeilen wurde gestartet.
BIP8794I: In Tabelle BRMINFO sind keine doppelten Zeilen.
BIP8794I: In Tabelle BRMRTDDEPINFO sind keine doppelten Zeilen.
BIP8794I: In Tabelle BROKERRESOURCES sind keine doppelten Zeilen.
BIP8794I: In Tabelle BRMRTDINFO sind keine doppelten Zeilen.
BIP8794I: In Tabelle BRMWFDINFO sind keine doppelten Zeilen.
BIP8792I: Die Prüfung auf doppelte Zeilen wurde bestanden.
BIP8791I: Die Überprüfung auf doppelte Zeilen wurde gestartet.
BIP8800W: No invalid topic syntax was detected in table BSUBSCRIPTIONS. (Es wurde keine ungültige Themensyntax in Tabelle BSUBSCRIPTIONS gefunden).
BIP8800W: No invalid topic syntax was detected in table BPUBLISHERS. (Es wurde keine ungültige Themensyntax in Tabelle BPUBLISHERS gefunden).
BIP8800W: No invalid topic syntax was detected in table BRETAINEDPUBS. (Es wurde keine ungültige Themensyntax in Tabelle BRETAINEDPUBS gefunden).
BIP8797I: Topic syntax check succeded. (Themensyntaxprüfung erfolgreich.)
BIP8680I: Vormigrationsprüfung war erfolgreich.
BIP8071I: Befehl wurde erfolgreich ausgeführt.

Bei dem folgenden Beispiel wird eine automatische Migration von BROKER1 von Version 2.1 auf Version 6.0 unter Windows XP ausgeführt:

mqsimigratecomponents BROKER1
BIP8849I: Für die Migration wurde Broker 'BROKER1' (Version 2.1) mit WS-Manager 'BROKER1' und Datenquelle 'BROKERDB' angegeben.
BIP8755I: Wert 'QueueManagerName' wurde an die neue Position kopiert.
BIP8755I: Wert 'DataSourceName' wurde an die neue Position kopiert.
BIP8755I: Wert 'DataSourceUserId' wurde an die neue Position kopiert.
BIP8755I: Wert 'DataSourcePassword' wurde an die neue Position kopiert.
BIP8755I: Wert 'LilPath' wurde an die neue Position kopiert.
BIP8755I: Wert 'ConfigurationTimeout' wurde an die neue Position kopiert.
BIP8755I: Wert 'ConfigurationDelayTimeout' wurde an die neue Position kopiert.
BIP8755I: Wert 'MigrationNeeded' wurde an die neue Position kopiert.
BIP8755I: Wert 'MQTrustedQueueManager' wurde an die neue Position kopiert.
BIP8755I: Wert 'UserNameServerQueueManagerName' wurde an die neue Position kopiert.
BIP8755I: Wert 'BrokerUUID' wurde an die neue Position kopiert.
BIP8755I: Wert 'AdminAgentPID' wurde an die neue Position kopiert.
BIP8763I: Wert 'QueueManagerName' an der alten Position wurde gelöscht.
BIP8763I: Wert 'DataSourceName' an der alten Position wurde gelöscht.
BIP8763I: Wert 'DataSourceUserId' an der alten Position wurde gelöscht.
BIP8763I: Wert 'DataSourcePassword' an der alten Position wurde gelöscht.
BIP8763I: Wert 'LilPath' an der alten Position wurde gelöscht.
BIP8763I: Wert 'ConfigurationTimeout' an der alten Position wurde gelöscht.
BIP8763I: Wert 'ConfigurationDelayTimeout' an der alten Position wurde gelöscht.
BIP8763I: Wert 'MigrationNeeded' an der alten Position wurde gelöscht.
BIP8763I: Wert 'MQTrustedQueueManager' an der alten Position wurde gelöscht.
BIP8763I: Wert 'UserNameServerQueueManagerName' an der alten Position wurde gelöscht.
BIP8763I: Wert 'BrokerUUID' an der alten Position wurde gelöscht.
BIP8763I: Wert 'AdminAgentPID' an der alten Position wurde gelöscht.
BIP8768I: Registry-Migration für Komponente 'BROKER1' ist beendet.
BIP8654I: Dateisystemartefakte werden von '' 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.
BIP8785I: WebSphere MQ-Warteschlangenmigration für Komponente 'BROKER1' wird gestartet.
Der Befehl 'setmqaut' wurde erfolgreich ausgeführt.
BIP8786I: WebSphere MQ-Warteschlange 'SYSTEM.BROKER.AGGR.REQUEST' wurde erstellt.
Der Befehl 'setmqaut' wurde erfolgreich ausgeführt.
BIP8786I: WebSphere MQ-Warteschlange 'SYSTEM.BROKER.AGGR.CONTROL' wurde erstellt.
Der Befehl 'setmqaut' wurde erfolgreich ausgeführt.
BIP8786I: WebSphere MQ-Warteschlange 'SYSTEM.BROKER.AGGR.REPLY' wurde erstellt.
Der Befehl 'setmqaut' wurde erfolgreich ausgeführt.
BIP8786I: WebSphere MQ-Warteschlange 'SYSTEM.BROKER.AGGR.TIMEOUT' wurde erstellt.
Der Befehl 'setmqaut' wurde erfolgreich ausgeführt.
BIP8786I: WebSphere MQ-Warteschlange 'SYSTEM.BROKER.AGGR.UNKNOWN' wurde erstellt.
Der Befehl 'setmqaut' wurde erfolgreich ausgeführt.
BIP8786I: WebSphere MQ-Warteschlange 'SYSTEM.BROKER.TIMEOUT.QUEUE' wurde erstellt.
Der Befehl 'setmqaut' wurde erfolgreich ausgeführt.
BIP8786I: WebSphere MQ-Warteschlange 'SYSTEM.BROKER.INTERBROKER.MODEL.QUEUE' wurde erstellt.
Der Befehl 'setmqaut' wurde erfolgreich ausgeführt.
BIP8786I: WebSphere MQ-Warteschlange 'SYSTEM.BROKER.WS.INPUT' wurde erstellt.
Der Befehl 'setmqaut' wurde erfolgreich ausgeführt.
BIP8786I: WebSphere MQ-Warteschlange 'SYSTEM.BROKER.WS.REPLY' wurde erstellt.
Der Befehl 'setmqaut' wurde erfolgreich ausgeführt.
BIP8786I: WebSphere MQ-Warteschlange 'SYSTEM.BROKER.WS.ACK' wurde erstellt.
Der Befehl 'setmqaut' wurde erfolgreich ausgeführt.
BIP8786I: WebSphere MQ-Warteschlange 'SYSTEM.BROKER.IPC.QUEUE' wurde erstellt.
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.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 geteilte Migration von Version 2.1 auf Version 6.0:

mqsimigratecomponents BROKER -1
mqsimigratecomponents BROKER -s 2.1.0.8 -2
mqsimigratecomponents BROKER -s 2.1.0.8 -3

Das folgende Beispiel zeigt eine geteilte Migration von Version 6.0 auf Version 2.1:

mqsimigratecomponents BROKER -t 2.1.0.8 -2
mqsimigratecomponents BROKER -t 2.1.0.8 -3
mqsimigratecomponents BROKER -t 2.1.0.8 -1
Zugehörige Verweise
Migration und Aktualisierung
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:54

an26150_