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 Management Servers, Message Processors oder 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 Nutzergruppen.

   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 Konfigurationsdatei für die unbeaufsichtigte Installation für eine Region können Sie den Namen der Analysegruppe mit dem Attribut AXGROUP festlegen.

   Wenn Sie sich bei den 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 Namen der Analysegruppe im Feld name und den Namen der Nutzergruppe im Feld consumer-groups zurück.

2. Installieren Sie das Edge-Dienstprogramm apigee-setup auf dem Knoten. Verwenden Sie dazu das Internet- oder Nicht-Internet-Verfahren, wie unter Edge-Dienstprogramm „apigee-setup“ 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

   Mit der Option „-p qs“ wird Qpid installiert. Informationen zum Erstellen einer configFile finden Sie unter Edge-Komponenten auf einem Knoten installieren.

   Wenn die Installation abgeschlossen ist, wird im Skript die UUID des Qpid-Servers angezeigt. 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. Fügen Sie Qpid der Analysegruppe hinzu:

   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, der 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. Fügen Sie Qpid der Consumer-Gruppe hinzu:

   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, der 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 Nutzergruppen. 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 Konfigurationsdatei für die unbeaufsichtigte Installation für eine Region können Sie den Namen der Analysegruppe mit dem Attribut AXGROUP festlegen.

   Wenn Sie sich bei den 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 Namen der Analysegruppe im Feld „name“ und den Namen der Nutzergruppe im Feld „consumer-groups“ zurück.

2. Entfernen Sie Qpid aus der Nutzergruppe:

   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. Entfernen Sie Qpid aus der Analysegruppe:

   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. Melden Sie den Qpid-Server von der Edge-Installation ab:

   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.