Mit dem Befehl mqsimigratecomponents können Sie eine Komponente aus einer Version des Produkts auf eine andere Version auf demselben Computer migrieren.
Wenn Sie WebSphere Application Server zusammen mit WebSphere Message Broker verwenden oder über Publish/Subscribe-Anwendungen verfügen, die die Option 'SubIdentity' verwenden, müssen Sie für WebSphere Message Broker Version 6.1 ein Upgrade auf Fixpack 4 durchführen, bevor Sie die Migration auf WebSphere Message Broker Version 8.0 durchführen können.
Sie können auch einen Broker mit dem Befehl mqsimigratecomponents von WebSphere Message Broker Version 8.0 auf WebSphere Message Broker Version 7.0 oder Version 6.1 zurücksetzen und damit eine Migration auf eine höhere Version rückgängig machen. Bei Rücksetzung eines Brokers auf Version 6.1 wird für den Broker die Konfiguration wiederhergestellt, die zum Zeitpunkt der Migration auf die höhere Version aktiv war; die Aktualisierungen, die Sie nach der Migration vorgenommen haben, werden nicht in die Datenbank des Brokers der älteren Version übernommen. Sie müssen daher die betreffende Brokerdatenbank beibehalten, damit sie zusammen mit dem Broker der früheren Version eingesetzt werden kann.
Bei der Wiederherstellung eines Brokers auf Version 7.0 werden die Änderungen am Brokerstatus, die mit Version 7.0 kompatibel sind, beibehalten. Änderungen, die nicht mit Version 7.0 kompatibel sind, werden dagegen nicht für den Broker übernommen, was zu Fehlern führen kann.
Dieser Befehl muss immer von der höheren Version des Produkts aus ausgeführt werden, unabhängig davon, ob es sich um die Quell- oder die Zielversion handelt.
Damit dieser Befehl erfolgreich ausgeführt werden kann, müssen die Ziel- und Quellenversion des Produkts und der erforderliche Komponentencode installiert sein.
Vor der Migration müssen Sie den Broker und alle aktiven Debugsitzungen im WebSphere Message Broker Toolkit beenden. Nachrichtenflüsse, für die gerade ein Debug ausgeführt wird, können nicht migriert werden.
Wenn Sie im Befehl mqsicreatebroker für den Broker, der migriert werden soll, ein Benutzer-ID/Kennwort-Paar für Datenquellen angegeben haben, werden die Werte dieser Parameter ebenfalls migriert und in dem Format gespeichert, in dem sie im Befehl mqsisetdbparms angegeben wurden. Mit diesen Werten greift der Broker auf die Datenbank zu, für die mit dem Befehl mqsisetdbparms keine alternativen Werte definiert wurden. Wenn Sie die Benutzer-IDs und Kennwörter, mit denen der Broker auf Benutzerdatenbanken zugreift, nach der Migration ändern möchten, ist dies nur mit dem Befehl mqsisetdbparms möglich.
Wenn Sie die Benutzer-IDs und Kennwörter aktualisieren und der Broker anschließend auf eine frühere Version zurückgesetzt wird, werden die neuen Benutzer-IDs und Kennwörter ebenfalls auf die ursprünglichen Brokerwerte zurückgesetzt.
.-| Verschieben |-. >>-mqsimigratecomponents--+-| Check |-------+-------------------> +-| Rückgängig |--+ '-| Prüfen |------' >----Komponentenname----+-----+-------------------------------->< '- -q-' Prüfen |-- -c --+---------------------+--+------------------+----------| '- -s--Quellenversion-' '- -t--Zielversion-' Verschieben .-------------. V | |----+---------+-+--+---------------------+---------------------> +- -1-----+ '- -s--Quellenversion-' +- -2-----+ | (1) | '- -3-----' >--+------------------+-----------------------------------------| '- -t--Zielversion-' Rückgängig .-------------. V | |-- -u----+- -1-----+-+-- -s--Quellenversion--------------------> +- -2-----+ | (1) | '- -3-----' >-- -t--Zielversion---------------------------------------------| Prüfen |-- -v--+------------------+------------------------------------| '- -t--Zielversion-'
Sie können eine aktive Komponente prüfen. Die Prüfung betrifft nicht die Komponenten, mit Ausnahme einer geringen Verschlechterung auf die Systemleistung.
Der Prüfbefehl ist entweder erfolgreich oder nicht und meldet, ob die Migration erfolgreich sein wird; er nimmt jedoch keine Änderungen vor.
Die Parameter -c und -v schließen sich gegenseitig aus. Außerdem können Sie bei der Angabe einer dieser Parameter bei der Ausführung dieses Befehls keine anderen Parameter angeben.
Die Parameter -c und -v schließen sich gegenseitig aus. Außerdem können Sie bei der Angabe einer dieser Parameter bei der Ausführung dieses Befehls keine anderen Parameter angeben.
(Optional) Gibt an, dass weniger Statusnachrichten während des Vorgangs ausgegeben werden sollen.
(Optional) Gibt an, dass nur Tasks in Zusammenhang mit WebSphere MQ ausgeführt werden sollen.
Diese Option ist nur gültig für eine Migration von einer früheren Version auf Version 8.0. Bei einer Abwärtsmigration auf eine frühere Version wird dieser Parameter ignoriert; Änderungen am Brokerstatus können nicht auf einen früheren Stand zurück migriert und auf die Datenbank des Brokers der früheren Version angewendet werden.
Der Parameter -3 ist nur gültig für eine Migration von einer früheren Version auf Version 8.0.
(Erforderlich) Der Name der zu migrierenden Komponente.
Mit dem Befehl mqsimigratecomponents werden Ihre Registry, das Dateisystem und die WebSphere MQ-Definitionen aktualisiert.
Wenn die Benutzer-ID, unter der dieser Befehl ausgeführt wird, nicht zur Ausführung aller Schritte berechtigt ist, können Sie den Befehl auch in mehreren Teilschritten 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 Teilmigration bezeichnet; sie wird unter Angabe der Parameter -1, -2 und -3 durchgeführt
Bei einer aufgeteilten Migration muss die Benutzer-ID immer Leseberechtigung für die Produktregistry haben.
Dieser Befehl kann, je nach Ausgang der einzelnen Operationen, sehr viele Antworten generieren. Im Unterschied zu anderen Befehlen werden die bei der Ausführung dieses Befehls generierten einzelnen Nachrichten sofort angezeigt und nicht erst zusammen nach Abschluss des Programms.
Bei einer Migration der Datenbanktabellen von Version 6.1 wird von z/OS eine umfangreichere Ausgabe als von verteilten Systemen generiert. Mit dem Parameter -q können Sie die Anzahl der angezeigten Nachrichten reduzieren.
Das folgende Beispiel zeigt eine geteilte Migration von Version 7.0 auf Version 8.0:
mqsimigratecomponents BROKER1 -1
mqsimigratecomponents BROKER1 -2
mqsimigratecomponents BROKER1 -3
Das folgende Beispiel zeigt eine Migration von Version 8.0 zurück nach Version 7.0:
mqsimigratecomponents MYBROKER -t 7.0.0.3