Befehl 'mqsimigratecomponents'

Unterstützte Plattformen

  • Windows
  • Linux- und UNIX-Systeme
  • z/OS

Zweck

Mit dem Befehl mqsimigratecomponents können Sie eine Komponente einer älteren installierten Produktversion (nur Version 2.1 oder 5) auf eine andere migrieren. Dieser Befehl muss immer von der aktuellsten installierten Version aus ausgeführt werden, unabhängig davon, ob es sich um die Quell- oder die Zielversion handelt.
Anmerkung:
  1. Bei Version 2.1 des Produkts ist Version 2.1 CSD02 (2.1.0.3) das früheste Produkt-Release, das unterstützt wird. (Weitere Informationen hierzu finden Sie unter Migrieren und aktualisieren.)
  2. Produktversion 5 wird ab Release 5.0.0.4 unterstützt.

Version 6.0 des Produkts muss installiert sein, einschließlich des Codes aller erforderlichen Komponenten (d. h., der Broker muss installiert sein, falls er benötigt wird, usw.).

Vor der Migration müssen Sie alle aktiven Debugsitzungen in der Steuerzentrale stoppen. Nachrichtenflüsse, für die ein Debug ausgeführt wird, können nicht migriert werden.

Sie können den Befehl mit verschiedenen Optionen zur Ausführung folgender Aktionen absetzen:
  • 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).

Mit dem Befehl mqsimigratecomponents werden Ihre Registry und das Dateisystem, 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. Dies wird als geteilte Migration bezeichnet und unter Verwendung der Parameter -1, -2 und -3 ausgeführt.

Wenn Sie den Befehlmqsimigratecomponents in einer Sybase-Datenbank verwenden, 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) Überprüfen Sie die ausgewählte Komponente vor der Migration auf Folgendes:
  • Die automatisch ermittelte Brokerversion muss mit der in der Befehlszeile angegebenen Version übereinstimmen.
  • Bei einer Migration von Version 6.0 auf ein früheres Release gibt es keine 64-Bit-Ausführungsgruppen.
  • Datenbanktabellen, die aus einem älteren Release kopiert werden, dürfen keine Zeilen enthalten, die die Indexvoraussetzungen von Version 6.0 verletzen.
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. Dadurch werden die Datenbanktabellen für alle Broker sowie das Dateisystem und 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

Die Migrationsprüfung kann für eine aktive Komponente ausgeführt werden. Abgesehen von einer geringfügigen Leistungsabschwächung ergeben sich keine Auswirkungen auf die Komponente. Auf UNIX-Systemen muss vor Ausführung dieser Prüfung die Datei odbc.ini migriert werden (d. h., es muss eine odbc.ini-Datei im neuen Format mit denselben Datenquellen wie die alte Datei erstellt werden); dies ist notwendig, da der Befehl für die Prüfung Zugriff auf die Brokerdatenbank haben muss.

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

-v
(Optional) Überprüfen Sie die ausgewählte Komponente nach der Migration auf Folgendes:
  • 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 der 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.
-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. Diese Option wird verwendet, wenn die Migration sowie eine automatische Wiederherstellung fehlgeschlagen sind (beispielsweise bei einer Teilmigration).
-sAusgangsversion
(Optional) Die vorhergehende Version der Komponente.
  • Erfolgt keine Angabe, wird die Version 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. Diese Task wird im Beispiel einer geteilten Migration beschrieben.
  • Hinweise zu Einschränkungen bei den unterstützten Produktversionen finden Sie unter Zweck.
-tZielversion
(Optional) Die Zielversion der Komponente.
  • Erfolgt keine Angabe, wird automatisch die aktuelle Version übernommen.
  • Bei Ausführung einer geteilten Migration von Version 6.0 auf eine frühere Version ist der Parameter -t obligatorisch. Diese Task wird im Beispiel einer geteilten Migration beschrieben.
  • Hinweise zu Einschränkungen bei den unterstützten Produktversionen finden Sie unter Zweck.
Komponentenname
(Erforderlich) Der Name der zu migrierenden Komponente.

Autorisierung

Bei Ausführung einer Migration mit nur einem einzigen Schritt muss die Benutzer-ID, unter der dieser Befehl aufgerufen wird, folgende Berechtigungen haben:
  • Schreibzugriff auf Registry und Dateisystem des Produkts
  • Berechtigung zum Ändern der Komponentendatenbanken
  • Berechtigung zum Ändern von Warteschlangendefinitionen
Bei einer Migration, die in mehreren Schritten erfolgt, muss die Benutzer-ID, unter der dieser Befehl aufgerufen wird, auf jeden Fall die Berechtigung haben, Daten aus dem Registry des Produkts auszulesen; darüber hinaus 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

Beginn der ÄnderungDieser Befehl kann eine ganze Reihe von möglichen Antworten generieren, je nach Ausgang der verschiedenen Operationen. Dieser Befehl unterscheidet sich von anderen Befehlen hinsichtlich der Art und Weise, wie Nachrichten generiert werden: sie werden immer dann angezeigt, wenn es erforderlich ist, nicht erst zusammen am Ende des Programms. Beim Migrieren von Datenbanktabellen erzeugt z/OS eine größere Ausgabe als verteilte Systeme. Ende der Änderung

Beispiele

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

Beginn der Änderung
mqsimigratecomponents –c BROKER1
BIP8849I: roker '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 Prüfung auf doppelte Zeilen wurde bestanden.
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: Pre-migration check succeeded. (Vormigrationsprüfung erfolgreich.)
BIP8071I: Befehl wurde erfolgreich ausgeführt. 
Ende der Änderung

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

Beginn der Änderung
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: igration 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. 
Ende der Änderung

Das folgende Beispiel veranschaulicht 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 veranschaulicht 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
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
an26150_