WebSphere MQ-Befehl 'migmbbrk'

Migrieren Sie die Publish/Subscribe-Informationen von WebSphere Message Broker Version 6.1 auf WebSphere MQ.

Zweck

Mit dem WebSphere MQ-Befehl migmbbrk können Sie die Publish/Subscribe-Informationen von einem WebSphere Message Broker Version 6.1-Broker auf einen WebSphere MQ-Warteschlangenmanager migrieren. Der Befehl führt einen Migrationsprozess aus, mit dem die folgenden Publish/Subscribe-Informationen auf den dem angegebenen Broker zugeordneten Warteschlangenmanager migriert werden:
  • Subskriptionen
  • Subskriptionspunkte (werden nur bei Verwendung von RFH2-Nachrichten unterstützt)
  • Datenströme
  • Ständige Veröffentlichungen

Bei Ausführung des Befehls migmbbrk müssen Sie das Profil für die WebSphere Message Broker-Version verwenden, von der aus die Migration ausgeführt wird.

Mit dem Befehl migmbbrk wird die Zugriffssteuerungsliste (Access Control List, ACL) nicht migriert. Stattdessen wird bei Ausführung der Migration unter Angabe des Parameters -t oder -r eine Datei generiert, in der Befehle setmqaut vorgeschlagen werden, mit denen im Warteschlangenmanager eine gleichwertige Sicherheitsumgebung wie bisher im Broker eingerichtet werden kann. Die Datei mit den Befehlen für die Sicherheitsfunktionen muss geprüft und nach Bedarf geändert werden und es müssen die Befehle ausgeführt werden, mit denen im Warteschlangenmanager eine gleichwertige Sicherheitsumgebung wie bisher im Broker eingerichtet werden kann, bevor die Migration zum Abschluss mit dem Parameter -c ausgeführt wird.

Anmerkung: Auf UNIX-Systemen sind alle Berechtigungen intern Benutzergruppen, nicht Principals zugeordnet. Dies wirkt sich wie folgt aus:
  • Wird mit dem Befehl setmqaut einem Principal eine Berechtigung erteilt, so wird die Berechtigung der primären Benutzergruppe des Principals erteilt. Somit erhalten effektiv alle Mitglieder dieser Benutzergruppe die Berechtigung.
  • Wird mit dem Befehl setmqaut einem Principal eine Berechtigung entzogen, so gilt der Berechtigungsentzug für die primäre Benutzergruppe des Principals. Somit wird effektiv allen Mitgliedern dieser Benutzergruppe die Berechtigung entzogen.

Der Befehl migmbbrk muss von einer Befehlsumgebung aus ausgegeben werden, in der sowohl WebSphere MQ- als auch WebSphere Message Broker-Befehle erfolgreich verarbeitet werden können. In der Regel können diese Befehle von einer WebSphere Message Broker-Befehlskonsole aus abgesetzt werden.

Die in den Subskriptionsdatenbanktabellen gespeicherten Publish/Subscribe-Konfigurationsdaten von WebSphere Message Broker Version 6.1 werden im Rahmen des Migrationsprozesses nicht gelöscht. Diese Konfigurationsdaten stehen daher so lange zur Verfügung, bis sie explizit gelöscht werden.

Syntax

Syntaxdiagramm lesenSyntaxdiagramm überspringen
                       .----------.                     
                       V          |                     
>>-migmbbrk--+- -c -+----+------+-+-- -b --Brokername----------><
             +- -r -+    +- -l -+                       
             '- -t -'    +- -o -+                       
                         +- -s -+                       
                         '- -z -'                       

Parameters

-b Brokername
(Erforderlich) Der Name des Brokers, der die Quelle der zu migrierenden Publish/Subscribe-Informationen darstellt. Die Publish/Subscribe-Informationen werden auf den dem angegebenen Broker zugeordneten Warteschlangenmanager migriert.
-c
(Erforderlich) Schließt die Migration der Publish/Subscribe-Konfigurationsdaten ab. In der Abschlussphase der Migration werden die in der Anfangsphase -t erstellten Themenobjekte verwendet. Möglicherweise hat sich der Brokerstatus seit Ausführung der Anfangsphase geändert, somit könnten jetzt zusätzlich neue Themenobjekte erforderlich sein. Ist dies der Fall, werden in der Abschlussphase diese neuen Themenobjekte nach Bedarf erstellt. In der Abschlussphase werden nicht mehr benötigte Themenobjekte nicht gelöscht; Sie müssen unter Umständen nicht erforderliche Themenobjekte selbst löschen.

Vor Abschluss der Migration muss die in der Phase der Parameter -r bzw. -t erstellte Datei mit den Befehlen für die Sicherheitsfunktionen geprüft und nach Bedarf geändert werden und es müssen die Befehle ausgeführt werden, mit denen im Warteschlangenmanager eine gleichwertige Sicherheitsumgebung wie bisher im Broker eingerichtet werden kann.

Vor Ausführung dieser Abschlussphase muss die Anfangsphase -t ausgeführt werden. Es ist nicht möglich, den Parameter -c zusammen mit dem Parameter -r oder -t zu verwenden. In dieser Phase wird auch ein Migrationsprotokoll erstellt.

-r
(Erforderlich) Testet den Migrationsprozess, ohne Änderungen vorzunehmen. Mit diesem Parameter kann vor Ausführung der Migration mit dem Parameter -t ein Migrationsprotokoll mit allen Fehlern erstellt werden. Sie können somit den Ausgang des Migrationsprozesses prüfen, ohne die aktuelle Konfiguration zu ändern.

Bei diesem Migrationstest wird außerdem eine Datei mit Vorschlägen für Befehle setmqaut erstellt, mit denen im Warteschlangenmanager eine Sicherheitsumgebung ähnlich der im Broker eingerichtet werden kann. Vor Abschluss der Migration mit dem Parameter -c muss die Datei mit den Befehlen für die Sicherheitsfunktionen geprüft und nach Bedarf geändert werden und es müssen die Befehle ausgeführt werden, mit denen im Warteschlangenmanager eine gleichwertige Sicherheitsumgebung wie bisher im Broker eingerichtet werden kann.

Es ist nicht möglich, den Parameter -r zusammen mit dem Parameter -c oder -t zu verwenden.

-t
(Erforderlich) Erstellt Themenobjekte, die möglicherweise im Warteschlangenmanager erforderlich sind, und zwar auf Basis der im Broker definierten Einträge der Zugriffssteuerungsliste.

Bei Verwendung des Parameters -t wird außerdem eine Datei mit Vorschlägen für setmqaut-Befehle erstellt, mit denen im Warteschlangenmanager eine gleichwertige Sicherheitsumgebung wie bisher im Broker erstellt werden kann. Die Themenobjekte werden unter der Voraussetzung erstellt, dass Sie die Sicherheitsbefehle zur Erstellung der ACLs für die Themenobjekte tatsächlich ausführen. Vor Abschluss der Migration mit dem Parameter -c muss die Datei mit den Befehlen für die Sicherheitsfunktionen geprüft und nach Bedarf geändert werden und es müssen die Befehle ausgeführt werden, mit denen im Warteschlangenmanager eine gleichwertige Sicherheitsumgebung wie bisher im Broker eingerichtet werden kann.

Diese Phase muss vor der Abschlussphase mit dem Parameter -c ausgeführt werden. Es ist nicht möglich, den Parameter -t zusammen mit dem Parameter -c oder -r zu verwenden. In dieser Phase wird auch ein Migrationsprotokoll erstellt.

-l
(Optional) Lässt den Broker aktiv. Wenn Sie diesen Parameter nicht angeben, wird der Broker am Ende des Migrationsprozesses standardmäßig heruntergefahren.
-o
(Optional) Überschreibt bereits vorhandene Subskriptionen oder ständige Veröffentlichungen im Warteschlangenmanager, deren Name mit einer vom Broker zu migrierenden Subskription bzw. ständigen Veröffentlichung übereinstimmt, mit den vom Broker abgerufenen Publish/Subscribe-Informationen. Wenn gleichzeitig auch der Parameter -r angegeben ist, hat der Parameter -o keine Auswirkung.
-s
(Optional) Löscht temporäre Informationen, die aus einer gescheiterten oder abgebrochenen früheren Instanz des Migrationsprozesses beibehalten wurden. Während des Migrationsprozesses werden temporäre Daten in persönliche Warteschlangen geschrieben. Nach einer vollständigen und erfolgreichen Ausführung des Migrationsprozesses werden diese temporären Daten gelöscht. Wenn Sie diesen Parameter nicht angeben und der Migrationsprozess fehlschlägt oder abgebrochen wird, bleiben die temporären Daten erhalten. Sie werden bei einer erneuten Ausführung des Migrationsprozesses wieder verwendet, d. h., der Prozess setzt seine Arbeit an der Stelle fort, an der er zuvor fehlgeschlagen ist oder abgebrochen wurde.
-z
(Optional) Führt den Migrationsprozess aus, auch wenn er bereits erfolgreich und vollständig ausgeführt wurde. Wenn Sie diesen Parameter nicht angeben und der Migrationsprozess zuvor schon einmal erfolgreich abgeschlossen wurde, wird dies erkannt und der Prozess wird beendet. Zusammen mit dem Parameter -z kann der Parameter -o angegeben werden, dies ist jedoch nicht obligatorisch. Ein vorheriger Migrationstest mit dem Parameter -r gilt nicht als erfolgreiche Ausführung.

Rückkehrcodes

Ausgabedateien

Der Migrationsprozess erstellt im aktuellen Verzeichnis zwei Ausgabedateien:
amqmigrateacl.txt
Eine Datei mit einer Liste von setmqaut-Befehlen, die Sie überprüfen, ändern und bei Bedarf ausführen können, um Ihre Zugriffssteuerungsliste wiederherzustellen.
amqmigmbbrk.log
Eine Protokolldatei mit den Details der Migration.

Beispiele

Dieser Befehl migriert die Publish/Subscribe-Informationen des Brokers BRK1 in den dem Broker zugeordneten Warteschlangenmanager. Der Migrationsprozess wird unabhängig von einer früheren erfolgreichen Ausführung ausgeführt. Außerdem wird jede Subskription oder ständige Veröffentlichung, die bereits im Warteschlangenmanager vorhanden ist und den gleichen Namen wie eine vom Broker migrierte Subskription oder ständige Veröffentlichung hat, mit den vom Broker abgerufenen Publish/Subscribe-Informationen überschrieben.
migmbbrk -r -z -o -b BRK1

Unterstützte Betriebssysteme

Der Befehl migmbbrk wird nur auf den folgenden Plattformen unterstützt, die WebSphere Message Broker Version 6.1 unterstützen:

Unter z/OS wird eine mit dem Befehl 'migmbbrk' äquivalente Funktion durch das Dienstprogramm CSQUMGMB bereitgestellt.

Beginn der ÄnderungDie neuesten Informationen zu allen unterstützten Hardware- und Softwareversionen erhalten Sie auf der Website WebSphere Message Broker - Anforderungen. Ende der Änderung

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-07-16 12:23:58


ReferenzthemaReferenzthema | Version 8.0.0.1 | bq13060_