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.
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.
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.
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> goDabei ist BROKER1 der Name der Sybase-Brokerdatenbank.
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.
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.
mqsimigratecomponents FIRSTBROKER -t 6.1.0.0
mqsimigratecomponents BROKERB -1 -2
mqsimigratecomponents BROKERB -1 mqsimigratecomponents BROKERB -2
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.
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