Qpid-Knoten hinzufügen oder entfernen

In diesem Dokument wird beschrieben, wie Sie einen Qpid-Server in einer vorhandenen Edge-Installation hinzufügen und entfernen.

Informationen zum Entfernen eines Verwaltungsservers, eines Nachrichtenprozessors oder eines Routers finden Sie unter Server entfernen.

Qpid-Server hinzufügen

So fügen Sie einen Qpid-Server hinzu:

  1. Ermitteln Sie auf dem Verwaltungsserver den Namen der Analyse- und Verbrauchergruppen.

    Viele der folgenden Befehle erfordern diese Informationen. Standardmäßig lautet der Name der Analysegruppe axgroup-001 und der Name der Nutzergruppe consumer-group-001. In der stillen Konfigurationsdatei für eine Region können Sie den Namen der Analysegruppe mithilfe des Attributs AXGROUP festlegen.

    Wenn Sie sich in Bezug auf die Namen der Analyse- und Nutzergruppen nicht sicher sind, können Sie sie mit dem folgenden Befehl anzeigen lassen:

    apigee-adminapi.sh analytics groups list --admin adminEmail --pwd adminPword --host localhost

    Dieser Befehl gibt den Analysegruppennamen im Feld name und den Namen der Verbrauchergruppe im Feld consumer-groups zurück.

  2. Installieren Sie das Edge-apigee-setup-Dienstprogramm auf dem Knoten mithilfe des Internet- oder Nicht-Internet-Verfahrens, wie unter Edge-Dienstprogramm für Apigee-Einrichtung installieren beschrieben.
  3. Verwenden Sie apigee-setup.sh, um Qpid auf dem Knoten zu installieren:
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile

    Die Option "-p qs" gibt an, dass Qpid installiert werden soll. Informationen zum Erstellen von configFile finden Sie unter Edge-Komponenten auf einem Knoten installieren.

    Nach Abschluss der Installation zeigt das Skript die UUID des Qpid-Servers an. Wenn Sie die UUID später ermitteln müssen, verwenden Sie den folgenden cURL-Befehl auf dem Host, auf dem Sie Qpid installiert haben:

    curl http://qpid_IP:8083/v1/servers/self
  4. Qpid zur Analysegruppe hinzufügen:
    curl -u adminEmail:pword -H "Content-Type: application/json"
      -X POST "http://ms_IP:8080/v1/analytics/groups/ax/AX_GROUP/servers?uuid=QPID_UUID&type=qpid-server"

    In der Ausgabe sehen Sie die UUID des Qpid-Knotens, die dem Attribut qpid-server unter axgroup-001 hinzugefügt wurde:

    {
      "name" : "axgroup-001",
      "properties" : {},
      "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
      "uuids" : {
        "qpid-server" : [
          "d6d0480f-8393-465d-a2a1-b4a16a033c55",
          "8398a95c-3640-4bd9-bf7e-1eb89155810a"
        ]
      }
    }
    

  5. Qpid zur Verbrauchergruppe hinzufügen:
    curl -u adminEmail:pword -H "Content-Type: application/json"
      -X POST "http://ms_IP:8080/v1/analytics/groups/ax/AX_GROUP/consumer-groups/CONSUMER_GROUP/consumers?uuid=QPID_UUID"

    In der Ausgabe sehen Sie die UUID des Qpid-Knotens, die dem Attribut consumer-groups unter consumer-group-001 hinzugefügt wurde:

    "consumer-groups" : [ {
      "name" : "consumer-group-001",
      "consumers" : [
        "d6d0480f-8393-465d-a2a1-b4a16a033c55",
        "8398a95c-3640-4bd9-bf7e-1eb89155810a"
      ]
    } ]
  6. Starten Sie alle edge-qpid-server-Komponenten auf allen Knoten neu, damit die Änderung von diesen Komponenten übernommen wird:
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server wait_for_ready

Die Installation ist abgeschlossen.

Qpid-Server entfernen

So entfernen Sie einen Qpid-Knoten:

  1. Ermitteln Sie auf dem Verwaltungsserver den Namen der Analyse- und Verbrauchergruppen. Viele der folgenden Befehle erfordern diese Informationen.

    Standardmäßig lautet der Name der Analysegruppe axgroup-001 und der Name der Nutzergruppe consumer-group-001. In der stillen Konfigurationsdatei für eine Region können Sie den Namen der Analysegruppe mithilfe des Attributs AXGROUP festlegen.

    Wenn Sie die Namen der Analyse- und Nutzergruppen nicht kennen, können Sie sie mit dem folgenden Befehl anzeigen lassen:

    apigee-adminapi.sh analytics groups list --admin adminEmail --pwd adminPword --host localhost

    Dieser Befehl gibt den Namen der Analysegruppe im Namensfeld und den Namen der Verbrauchergruppe im Feld „Nutzergruppen“ zurück.

  2. Qpid aus der Verbrauchergruppe entfernen:
    curl -u adminEmail:pword -H "Content-Type: application/json"
      -X DELETE "http://ms_IP:8080/v1/analytics/groups/ax/AX_GROUP/consumer-groups/CONSUMER_GROUP/consumers/QPID_UUID"
  3. Qpid aus der Analysegruppe entfernen:
    curl -v -u adminEmail:pword
      -X DELETE "http://ms_IP:8080/v1/analytics/groups/ax/AX_GROUP/servers?uuid=QPID_UUID&type=qpid-server"
  4. Heben Sie die Registrierung des Qpid-Servers bei der Edge-Installation auf:
    curl -u adminEmail:pword
      -X POST http://ms_IP:8080/v1/servers -d "type=qpid-server&region=dc-1&pod=central&uuid=QPID_UUID&action=remove"
  5. Entfernen Sie den Qpid-Server aus der Edge-Installation:
    curl -u adminEmail:pword -X DELETE http://ms_IP:8080/v1/servers/QPID_UUID
  6. Starten Sie alle edge-qpid-server-Komponenten auf allen Knoten neu, damit die Änderung von diesen Komponenten übernommen wird:
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server wait_for_ready
  7. Deinstallieren Sie Qpid wie unter Edge deinstallieren beschrieben.