Eine JSON-CCDT-Datei herunterladen oder erstellen, die den Warteschlangenmanager beschreibt, zu dem eine Verbindung hergestellt werden soll.

Sie können eine JSON-CCDT von der Seite für Warteschlangenmanagerdetails herunterladen, indem Sie auf die Schaltfläche "Verbindungsinformationen" klicken und dann das Format "JSON-CCDT" auswählen. Beachten Sie, dass die heruntergeladene JSON-CCDT nicht die Verschlüsselungsspezifikation enthält, die Sie dem Kanal zugeordnet haben. Daher müssen Sie diese manuell hinzufügen, indem Sie eine TransmissionSecurity-Definition für jeden Kanal hinzufügen, wie im Beispiel unten gezeigt.

Alternativ können Sie die hier bereitgestellte Beispielvorlage einfach kopieren und die Werte für den Host, den Port, den Warteschlangenmanager und die Kanalwerte so aktualisieren, dass sie mit Ihrem Warteschlangenmanager übereinstimmen.

{
  "channel": [
  {
    "name": "CLOUD.ADMIN.SVRCONN",
    "clientConnection": {
      "connection": [
      {
      "host": "qm1-1234.qm.us-south.mq.appdomain.cloud",
      "port": 31500
      }
      ],
      "queueManager": "QM1"
    },
    "transmissionSecurity": {
      "cipherSpecification": "ANY_TLS12_OR_HIGHER"
    },
    "type": "clientConnection"
  }
  ]
}

Die Verschlüsselungsspezifikation im obigen JSON-CCDT-Beispiel wurde als ANY_TLS12_OR_HIGHER angegeben, was dem runmqsc-Client ermöglicht, eine zulässige Verschlüsselung mit dem Warteschlangenmanager innerhalb der Familie von TLS v1.2-Verschlüsselungen, basierend auf den Verschlüsselungen, die der Kanal zulässt, auszuhandeln. Für maximale Flexibilität kann der Warteschlangenmanagerkanal auch als ANY_TLS12_OR_HIGHER konfiguriert werden, was dem Client und dem Server ermöglicht, zwischen ihnen zu verhandeln.

Erforderliche Umgebungsvariablen für die runmqsc-Umgebung konfigurieren

Wir werden Umgebungsvariablen so konfigurieren, dass sie den 'runmqsc'-Client anweisen, die JSON-CCDT zu verwenden, um die Details der Warteschlangenmanagerverbindung abzurufen. Dies schließt den Namen der Kanal-Verschlüsselungsspezifikation ein, die wir im vorherigen Schritt definiert haben.

1. Öffnen Sie ein Fenster mit Eingabeaufforderung und navigieren Sie zum Verzeichnis MQ bin Ihrer Installation. Seine Position hängt von Ihrem Betriebssystem ab, z. B.:

   Tabelle 1. Speicherort der Installationsdatei für verschiedene Betriebssysteme

   Betriebssystem	Dateispeicherort
   Linux vollständige MQ-Installation	/var/mqm/bin
   Windows	C:\Program Files\IBM\MQ\bin
   Linux/Mac, Verwenden der Clientinstallation	~/mytoolkit/IBM-MQ-Toolkit-Mac-x64-9.1.2.0/bin

2. Legen Sie die Umgebungsvariable MQCCDTURL fest, um den runmqsc-Client anzuweisen, die JSON-CCDT einzulesen. Die Variable MQCCDTURL ist eine URL, die auf die JSON-CCDT-Datei verweist.

   • MQCCCDTURL ist der vollständige Dateipfad vom Systemstammverzeichnis zur CCDT-Datei.

     # Linux/MacOS
     export MQCCDTURL=file:///Users/myuser/connection_info_ccdt.json    
     unset MQSERVER
     
     # Windows
     set MQCCDTURL=file:///c:/temp/connection_info_ccdt.json    
     set MQSERVER=        
     

     Sie DÜRFEN die MQSERVER-Variable NICHT festgelegt haben, andernfalls hat sie Vorrang vor den Einstellungen aus der JSON-CCDT

   • Es gibt zwei Möglichkeiten, die Position Ihrer CCDT-Datei anzugeben: Wenn MQCCDTURL bei Ihnen nicht funktioniert, versuchen Sie, MQCHLTAB und MQCHLLIB wie unten beschrieben festzulegen.

     MQCHLLIB ist der vollständige Pfad vom Systemstammverzeichnis zu dem Verzeichnis, das die CCDT-Datei enthält.

     export MQCHLLIB=/path/to/ccdt
     set MQCHLLIB=c:\path\to\ccdt
     

     MQCHLTAB ist der Dateiname der CCDT-Datei.

     export MQCHLTAB=connection_info_ccdt.json
     set MQCHLTAB=connection_info_ccdt.json
     

3. Legen Sie die Umgebungsvariable MQSSLKEYR fest, damit der runmqsc-Client dem vom Warteschlangenmanager vorgelegten TLS-Zertifikat vertrauen kann.

   Die Variable MQSSLKEYR muss auf den vollständigen Pfad vom Systemstammverzeichnis zu einer Keystore-Datei, die das vom Warteschlangenmanager präsentierte TLS-Zertifikat enthält, festgelegt werden.

   Wenn Sie noch keine Keystore-Datei haben, können Sie eine erstellen, indem Sie den Anweisungen im Thema Keystore erstellen folgen. Dies schließt das Herunterladen des öffentlichen Zertifikats für den Warteschlangenmanager über die Benutzerschnittstelle der Servicekonsole ein.

   Beachten Sie, dass das Suffix .kdb der Datei NICHT im Wert MQSSLKEYR enthalten sein darf. Geb en Sie also für einen Keystore mit dem Namen key.kdb nur key an.

   # Linux/MacOS
   export MQSSLKEYR=/Users/myuser/key
   
   # Windows
   set MQSSLKEYR=c:\temp\key
   

Führen Sie den Befehl runmqsc aus, um eine Verbindung zum Warteschlangenmanager herzustellen.

Nach der Einrichtung der erforderlichen Umgebung können Sie den Befehl runmqsc ausführen, um eine Verbindung zum Warteschlangenmanager herzustellen.

Normalerweise benötigen Sie die folgenden Eingaben für den Befehl runmqsc:

• MQ-Administratorbenutzername und -API-Schlüssel, den Sie über die Servicekonsole erhalten, wie unter Erforderliche Verbindungsdetails zusammenstellen beschrieben. Beachten Sie, dass dies ein Administratorbenutzername und -API-Schlüssel sein müssen, nicht ein Anwendungsbenutzername und -API-Schlüssel.
• Name des Warteschlangenmanagers, der mit der Angabe in der JSON-CCDT-Datei übereinstimmen muss, zum Beispiel "QM1".

<Path to MQ/bin directory>/runmqsc -c -u mqusername QM1

Alle Operationen in diesem 'runmqsc'-Befehl werden nun auf einem gesicherten Kanal ausgeführt.