Mit dem Befehl mqsimigratecomponents können Sie eine Komponente aus einer zuvor installierten 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 7.0 durchführen können.
Wenn Sie WebSphere Application Server mit WebSphere Message Broker verwenden oder über Publish/Subscribe-Anwendungen verfügen, die die Option 'SubIdentity' verwenden, müssen Sie vor der Migration auf WebSphere Message Broker Version 7.0 ein Upgrade von WebSphere Message Broker Version 6.0 oder WebSphere Event Broker Version 6.0 auf Fixpack 10 durchführen.
Bei der Migration eines Brokers auf Version 7.0 wird die Brokerkonfiguration aus der Brokerdatenbank gelesen und in ein internes Repository migriert, das von dem migrierten Broker verwaltet wird. Die vom Broker der Version 6.1 oder Version 6.0 verwendete Brokerdatenbank wird vom Broker der Version 7.0 nicht mehr benötigt. Daher können Sie nach der Migration die Datenbank löschen oder das Datenbankprodukt deinstallieren, wenn es nicht mehr eingesetzt werden soll.
Sie können mit dem Befehl mqsimigratecomponents auch einen Broker von Version 7.0 auf eine frühere Version zurücksetzen und damit eine vorgenommene Migration umkehren; allerdings wird in diesem Fall die Brokerkonfiguration wiederhergestellt, die zum Zeitpunkt der Migration auf die aktuelle Version aktiv war; alle Aktualisierungen, die nach der Migration vorgenommen wurden, sind nicht mehr in der Datenbank der früheren Brokerversion vorhanden. Sie müssen daher die betreffende Brokerdatenbank beibehalten, damit sie zusammen mit dem Broker der früheren Version eingesetzt werden kann.
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 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 7.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 7.0.
(Erforderlich) Der Name der zu migrierenden Komponente.
Auf Systemen unter Windows XP und Windows Server 2003 muss die Benutzer-ID, unter der dieser Befehl ausgeführt wird, Mitglied der Gruppe Administratoren auf dem lokalen System sein.
Diese Konsole wird mit der richtigen mqsiprofile-Umgebung gestartet, von der aus Befehle ausgeführt werden können, die erhöhte Rechte erfordern.
Wenn Sie den Befehl nicht von einer entsprechend berechtigten Befehlskonsole aus ausführen, wird der Befehl nicht erfolgreich verarbeitet.
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 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 6.1 auf Version 7.0:
mqsimigratecomponents BROKER1 -1
mqsimigratecomponents BROKER1 -2
mqsimigratecomponents BROKER1 -3
Das folgende Beispiel zeigt eine Migration von Version 7.0 zurück nach Version 6.1:
mqsimigratecomponents MYBROKER -t 6.1.0.3