[IBM MQ Advanced][Linux]

Warteschlangenmanager als HA-RDQM-Warteschlangenmanager migrieren

Sie können einen vorhandenen Warteschlangen migrieren, um einen replizierten Datenwarteschlangenmanager (RDQM) mit hoher Verfügbarkeit (HA) zu erhalten, indem Sie die zugehörigen persistenten Daten sichern und diese Daten anschließend in einem neu erstellten RDQM-Warteschlangenmanager mit dem gleichen Namen wiederherstellen.

Informationen zu dieser Task

Für replizierte Datenwarteschlangenmanager mit hoher Verfügbarkeit ist ein dedizierter logischer Datenträger (Dateisystem) und die Konfiguration der Plattenreplikation und HA-Steuerung erforderlich. Diese Komponenten werden nur konfiguriert, wenn ein neuer Warteschlangenmanager erstellt wird. Ein vorhandener Warteschlangenmanager kann migriert werden, damit ein RDQM verwendet wird, indem die zugehörigen persistenten Daten gesichert und anschließend in einem neu erstellten RDQM-Warteschlangenmanager mit dem gleichen Namen wiederhergestellt werden. Durch diese Vorgehensweise bleiben die Konfiguration, der Status und die persistenten Nachrichten des Warteschlangenmanagers so erhalten, wie sie zum Zeitpunkt der Sicherungserstellung waren.

Hinweis Sie können einen WS-Manager nur von einer Version von IBM® MQ migrieren, die mit der Version identisch oder älter ist, in der RDQM installiert ist. Das Betriebssystem und die Architektur müssen ebenfalls identisch sein. Andernfalls müssen Sie einen neuen Warteschlangenmanager auf Ihrer Zielplattform erstellen, siehe Verschieben eines Warteschlangenmanagers auf ein anderes Betriebssystem.
Die folgenden Bedingungen sollten vor der Migration eines Warteschlangenmanagers erfüllt sein:
  • Beurteilen Sie Ihre Anforderungen an die Hochverfügbarkeit und sehen Sie sich RDQM-Hochverfügbarkeit an.
  • Überprüfen Sie die Anwendungen und Warteschlangenmanager, die eine Verbindung zum Warteschlangenmanager herstellen. Beachten Sie dabei die Änderungen, die für die Weiterleitung der Verbindungen an den RDQM-Knoten erforderlich sind, auf dem der Warteschlangenmanager ausgeführt wird. Wenn Sie beispielsweise die Hochverfügbarkeit von RDQM konfigurieren, können Sie die Verwendung einer schwebenden IP-Adresse in Betracht ziehen, siehe Erstellen und Löschen einer schwebenden IP-Adresse.
  • Stellen Sie RDQM-Knoten für die von Ihnen ausgewählte Konfiguration bereit oder geben Sie diese an. Informationen zu den Systemanforderungen für RDQM finden Sie unter Anforderungen für die RDQM HA-Lösung.
  • Installieren Sie IBM MQ Advanced, das die RDQM-Funktion enthält, auf jedem Knoten.
  • Konfigurieren Sie die Konfiguration der RDQM-HA-Gruppe, siehe Definieren des Pacemaker (HA-Gruppe).
  • Überprüfen Sie optional die RDQM-Konfiguration mit einem Testwarteschlangenmanager, der anschließend gelöscht werden kann. Das Überprüfen der Konfiguration wird empfohlen, um mögliche Probleme vor der Migration des Warteschlangenmanagers zu ermitteln und zu beheben.
  • Überprüfen Sie die Sicherheitskonfiguration für den Warteschlangenmanager und replizieren Sie anschließend die erforderlichen lokalen Benutzer und Gruppen auf jedem RDQM-Knoten.
  • Überprüfen Sie die Warteschlangenmanager- und Kanalkonfiguration, um zu ermitteln, ob API-Exits, Kanalexits oder Exits zur Datenkonvertierung verwendet werden. Installieren Sie die erforderlichen Exits auf jedem RDQM-Knoten.
  • Überprüfen Sie alle Warteschlangenmanagerservices, die definiert wurden, und installieren und konfigurieren Sie anschließend die erforderlichen Prozesse auf jedem RDQM-Knoten.

Verfahren

  1. Sichern Sie den vorhandenen Warteschlangenmanager:
    1. Stoppen Sie den vorhandenen Warteschlangenmanager, indem Sie einen Befehl zum Warten auf Beendigung endmqm -woder einen Befehl zum sofortigen Beenden endmqm -iausgeben. Dieser Schritt ist wichtig, um sicherzustellen, dass die Daten in der Sicherung konsistent sind.
    2. Ermitteln Sie die Position des Datenverzeichnisses des Warteschlangenmanagers, indem Sie die IBM MQ -Konfigurationsdatei mqs.inianzeigen. Unter Linux befindet sich diese Datei im Verzeichnis /var/mqm. Weitere Informationen zumqs.ini , sehenIBMMQ Konfigurationsdatei,mqs.ini .

      Suchen Sie die Zeilengruppe QueueManager für den Warteschlangenmanager in der Datei. Wenn die Zeilengruppe einen Schlüssel mit der Bezeichnung DataPath enthält, handelt es sich bei dem zugehörigen Wert um das Datenverzeichnis für den Warteschlangenmanager. Wenn der Schlüssel nicht vorhanden ist, kann das Datenverzeichnis für den Warteschlangenmanager mithilfe der Werte für die Schlüssel Prefix und Directory ermittelt werden. Das Datenverzeichnis für den Warteschlangenmanager ist eine Verknüpfung dieser Werte im Format Präfix/qmgrs/Verzeichnis. Weitere Informationen zurQueueManager Strophe, sieheQueueManager Strophe desmqs.ini Datei .

    3. Erstellen Sie eine Sicherung des Warteschlangenmanager-Datenverzeichnisses. Unter Linuxkönnen Sie dazu den Befehl tar verwenden. Wenn Sie zum Beispiel das Datenverzeichnis für einen Warteschlangenmanager sichern möchten, können Sie den folgenden Befehl verwenden. Beachten Sie den letzten Parameter des Befehls, bei dem es sich um einen einzelnen Punkt (.) handelt:
      tar -cvzf qm-data.tar.gz -C queue_manager_data_dir .
    4. Ermitteln Sie die Position des Protokollverzeichnisses des Warteschlangenmanagers, indem Sie die IBM MQ Konfigurationsdatei des Warteschlangenmanagers qm.inianzeigen. Diese Datei befindet sich im Datenverzeichnis des Warteschlangenmanagers. Weitere Informationen zur Datei finden Sie unter Warteschlangenmanager-Konfigurationsdateien,qm.ini .

      Das Protokollverzeichnis für den Warteschlangenmanager wird als Wert des Schlüssels LogPath in der Zeilengruppe Log definiert. Informationen zur Strophe finden Sie unter Protokollstrophe derqm.ini Datei .

    5. Erstellen Sie eine Sicherung des Warteschlangenmanager-Protokollverzeichnisses. Unter Linuxkönnen Sie dies mit dem Befehl tar tun. Wenn Sie z. B. das Protokollverzeichnis für einen Warteschlangenmanager sichern möchten, können Sie den folgenden Befehl verwenden. Beachten Sie den letzten Parameter des Befehls, bei dem es sich um einen einzelnen Punkt (.) handelt:
      tar -cvzf qm-log.tar.gz -C queue_manager_log_dir .
    6. Erstellen Sie eine Sicherungskopie aller Zertifikatsrepositorys, die vom Warteschlangenmanager verwendet werden, wenn diese sich nicht im Datenverzeichnis für den Warteschlangenmanager befinden. Stellen Sie sicher, dass die Schlüsseldatenbankdatei und die Kennwortstashdatei gesichert werden. Informationen zum Schlüsselrepository des Warteschlangenmanagers finden Sie unter SSL/TLS-Schlüsselrepository und Schlüsselrepository für einen Warteschlangenmanager suchen. Informationen zum Suchen des AMS-Schlüsselspeichers, wenn der WS-Manager für die Verwendung des Abfangens von AMS Message Channel Agent (MCA) konfiguriert ist, finden Sie im Abschnitt Abfangen von Message Channel Agent (MCA).
    7. Der vorhandene Warteschlangenmanager ist nicht mehr erforderlich und kann deshalb gelöscht werden. Wo dies möglich ist, sollten Sie den vorhandenen Warteschlangenmanager allerdings erst dann löschen, wenn er auf dem Zielsystem erfolgreich wiederhergestellt wurde. Durch das Zurückstellen des Löschvorgangs wird sichergestellt, dass der Warteschlangenmanager erneut gestartet werden kann, wenn der Migrationsprozess nicht erfolgreich abgeschlossen wird.
      Hinweis: Wenn Sie das Löschen des vorhandenen Warteschlangenmanagers verzögern, starten Sie ihn nicht neu. Es ist wichtig, dass der Warteschlangenmanager beendet bleibt, da weitere Änderungen an der Konfiguration oder dem Status während der Migration verloren gehen.
  2. Bereiten Sie den primären RDQM-Knoten vor:
    1. Erstellen Sie einen neuen RDQM-Warteschlangenmanager mit dem gleichen Namen wie der Warteschlangenmanager, den Sie gesichert haben. Stellen Sie sicher, dass das Dateisystem, das dem RDQM-Warteschlangenmanager durch crtmqm zugeordnet wurde, ausreichend ist für die Daten, primären und sekundären Protokolle für den vorhandenen Warteschlangenmanager sowie für einen zusätzlichen Speicherbereich für zukünftige Erweiterungen. Informationen zum Erstellen eines RDQM-Warteschlangenmanagers finden Sie unter Erstellen eines HA RDQM .
    2. Bestimmen Sie den primären RDQM-Knoten für den Warteschlangenmanager. Informationen zum Bestimmen des Primärknotens finden Sie in rdqmstatus (RDQM-Status anzeigen).
    3. Wenn der RDQM-Warteschlangenmanager auf dem primären RDQM-Knoten gestartet ist, stoppen Sie ihn mit dem Befehl endmqm -w oder endmqm -i .
    4. Ermitteln Sie auf dem primären RDQM-Knoten die Daten- und Protokollverzeichnisse für den RDQM-Warteschlangenmanager (verwenden Sie die in den Schritten 1b und 1d beschriebenen Methoden).
    5. Löschen Sie auf dem primären RDQM-Knoten den Inhalt der RDQM-Warteschlangenmanager-Daten- und -Protokollverzeichnisse, aber nicht die Verzeichnisse selbst.
  3. Stellen Sie den Warteschlangenmanager auf dem primären RDQM-Knoten wieder her:
    1. Kopieren Sie die Sicherungsdateien aus den Daten- und Protokollverzeichnissen des Warteschlangenmanagers auf den primären RDQM-Knoten ebenso wie alle separaten Sicherungen von Zertifikatsrepositorys, die vom Warteschlangenmanager verwendet werden.
    2. Stellen Sie die Sicherung des Datenverzeichnisses des Warteschlangenmanagers im leeren Datenverzeichnis für den neuen RDQM-Warteschlangenmanager wieder her und stellen Sie dabei sicher, dass das Eigentumsrecht und die Berechtigungen der Dateien beibehalten werden. Wenn die Sicherungsdateien mithilfe des Beispiels für den Befehl 'tar' in Schritt 1c erstellt wurde, kann der folgende Befehl vom Rootbenutzer für die Wiederherstellung verwendet werden:
      tar -xvzpf qm-data.tar.gz -C queue_manager_data_dir
    3. Stellen Sie die Sicherung des Protokollverzeichnisses des Warteschlangenmanagers im leeren Protokollverzeichnis für den neuen RDQM-Warteschlangenmanager wieder her und stellen Sie dabei sicher, dass das Eigentumsrecht und die Berechtigungen der Dateien beibehalten werden. Wenn die Sicherungsdateien mithilfe des Beispiels für den Befehl 'tar' in Schritt 1e erstellt wurde, kann der folgende Befehl vom Rootbenutzer für die Wiederherstellung verwendet werden:
      tar -xvzpf qm-log.tar.gz -C queue_manager_log_dir
    4. Bearbeiten Sie die wiederhergestellte Konfigurationsdatei des Warteschlangenmanagers qm.iniim Datenverzeichnis für den RDQM-Warteschlangenmanager. Aktualisieren Sie den Wert des Schlüssels LogPath in der Zeilengruppe Log , um das Protokollverzeichnis für den RDQM-Warteschlangenmanager anzugeben.
      Überprüfen Sie weitere in der Konfigurationsdatei definierte Dateipfade und aktualisieren Sie diese, falls erforderlich. Sie müssen z. B. möglicherweise die folgenden Pfade aktualisieren:
      • Den Pfad für Fehlerprotokolldateien, die von Diagnosenachrichtenservices generiert werden.
      • Den Pfad für Exits, die vom Warteschlangenmanager benötigt werden.
      • Den Pfad für Switchloaddateien, wenn der Warteschlangenmanager ein XA-Transaktionskoordinator ist.
    5. Wenn der Warteschlangenmanager für die Verwendung des Abfangprozesses für den Nachrichtenkanalagenten (MCA) in AMS konfiguriert ist, kopieren Sie den AMS-Schlüsselspeicher in die neue RDQM-Installation und prüfen und aktualisieren anschließend die Konfiguration. Der Schlüsselspeicher muss in jedem RDQM-Knoten verfügbar sein; wenn er sich also nicht im replizierten Dateisystem für den Warteschlangenmanager befindet, muss er stattdessen auf jeden Knoten kopiert werden. Weitere Informationen finden Sie im Abschnitt Abfangen von Nachrichtenkanalagenten.
    6. Überprüfen Sie, ob der WS-Manager vom dspmq -Befehl angezeigt wird und sein Status als beendet gemeldet wird. Das folgende Beispiel zeigt eine Beispielausgabe für einen RDQM-HA-Warteschlangenmanager:
      $ dspmq -o status -o ha 

QMNAME(QM1) STATUS(Ended normally) HA(Replicated)
    7. Überprüfen Sie, ob die wiederhergestellten Warteschlangenmanagerdaten auf den sekundären RDQM-Knoten repliziert wurden, indem Sie den Befehl rdqmstatus verwenden, um den Status für den Warteschlangenmanager anzuzeigen. Der HA-Status sollte auf jedem der Knoten als Normal gemeldet werden. Das folgende Beispiel zeigt eine Beispielausgabe für einen RDQM-HA-Warteschlangenmanager:
      $ rdqmstatus -m QM1 
Node:                           mqhavm10-adm 
Queue manager status:           Ended normally 
Queue manager file system:      50MB used, 0.2GB allocated [42%] 
HA role:                        Primary 
HA status:                      Normal 
HA control:                     Disabled 
HA current location:            This node 
HA preferred location:          This node 
HA floating IP interface:       None 
HA floating IP address:         None 

Node:                           mqhavm11-adm 
HA status:                      Normal 

Node:                           mqhavm12-adm 
HA status:                      Normal
    8. Starten Sie den Warteschlangenmanager auf dem primären RDQM-Knoten.
    9. Stellen Sie eine Verbindung zum Warteschlangenmanager her und aktualisieren Sie den Wert des Warteschlangenmanagerattributs SSLKEYR , um die neue Position des Zertifikatsrepositorys des Warteschlangenmanagers anzugeben. Standardmäßig ist der Wert dieses Attributs auf queue_manager_data_directory/ssl/keygesetzt. Das Zertifikatsrepository muss sich auf jedem RDQM-Knoten an der gleichen Position befinden. Wenn sich das Repository nicht im replizierten Dateisystem für den Warteschlangenmanager befindet, muss es stattdessen auf jeden Knoten kopiert werden.
    10. Überprüfen Sie die IBM MQ -Objektdefinitionen für den Warteschlangenmanager und aktualisieren Sie den Wert von Objektattributen, die auf geänderte Netzeinstellungen, das IBM MQ -Installationsverzeichnis oder das Datenverzeichnis des Warteschlangenmanagers verweisen, einschließlich der folgenden Objekte:
      • Lokale IP-Adressen, die von Listener verwendet werden (Attribut IPADDR).
      • Lokale IP-Adressen, die von Kanälen verwendet werden (Attribut LOCLADDR).
      • Lokale IP-Adressen, die für Clusterempfängerkanäle definiert werden (Attribut CONNAME).
      • Lokale IP-Adressen, die für Informationsobjekte zur Kommunikation definiert werden (AttributGRPADDR).
      • Systempfade, die für Prozess- und Serviceobjektdefinitionen definiert werden.
    11. Stoppen Sie den Warteschlangenmanager und starten Sie ihn erneut, um sicherzustellen, dass die Änderungen wirksam werden.
    12. Wiederholen Sie Schritt 3j für ferne Warteschlangenmanager und nehmen Sie entsprechende Einstellungen für Anwendungen vor, die eine Verbindung zum migrierten Warteschlangenmanager herstellen, einschließlich der Folgenden:
      • Kanalverbindungsnamen (Attribut CONNAME).
      • Kanalauthentifizierungsregeln, die eingehende Verbindungen vom Warteschlangenmanager auf Basis der IP-Adresse oder des Hostnamens einschränken.
      • Definitionstabellen für den Clientkanal (CCDTs), Einstellungen des Domänennamens (DNS), Netzweiterleitung oder entsprechende Verbindungsinformationen.
    13. Führen Sie ein verwaltetes Failover des Warteschlangenmanagers zu jedem RDQM-Knoten durch, um sicherzustellen, dass die erforderliche Konfiguration erfolgreich eingerichtet wurde. Weitere Informationen finden Sie unter Festlegen des bevorzugten Speicherorts für ein RDQM .