Edge for Private Cloud v4.19.01
This document describes how to add and remove a Qpid server in an existing Edge installation.
For information on how to remove a Management Server, Message Processor, or Router, see Remove a server.
Add a Qpid server
To add a Qpid server:
- On the Management Server, determine the name of the analytics and consumer groups.
Many of the commands below require that information. By default, the name of the analytics group is
axgroup-001
, and the name of the consumer group isconsumer-group-001
. In the silent config file for a region, you can set the name of the analytics group by using theAXGROUP
property.If you are unsure of the names of the analytics and consumer groups, use the following command to display them:
apigee-adminapi.sh analytics groups list --admin
adminEmail --pwdadminPword --host localhostThis command returns the analytics group name in the
name
field, and the consumer group name in theconsumer-groups
field. - Install the Edge
apigee-setup
utility on the node using the internet or non internet procedure as described in Install the Edge apigee-setup utility. - Use
apigee-setup.sh
to install Qpid on the node:/opt/apigee/apigee-setup/bin/setup.sh -p qs -f
configFile The "-p qs" option specifies to install Qpid. See Install Edge components on a node for information on creating a configFile.
When the installation completes, the script displays the UUID of the Qpid server. If you need to determine the UUID later, use the following cURL command on the host where you installed Qpid:
curl http://
qpid_IP :8083/v1/servers/self - Add Qpid to the analytics group:
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 the output, you see the UUID of the Qpid node added to the
qpid-server
property under axgroup-001:{ "name" : "axgroup-001", "properties" : {}, "scopes" : [ "VALIDATE~test", "sgilson~prod" ], "uuids" : { "qpid-server" : [ "d6d0480f-8393-465d-a2a1-b4a16a033c55", "8398a95c-3640-4bd9-bf7e-1eb89155810a" ] } }
- Add Qpid to the consumer group:
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 the output, you see the UUID of the Qpid node added to the
consumer-groups
property underconsumer-group-001
:"consumer-groups" : [ { "name" : "consumer-group-001", "consumers" : [ "d6d0480f-8393-465d-a2a1-b4a16a033c55", "8398a95c-3640-4bd9-bf7e-1eb89155810a" ] } ]
- Restart all
edge-qpid-server
components on all nodes to make sure the change is picked up by those components:/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server wait_for_ready
The installation is complete.
Remove a Qpid server
To remove a Qpid node:
- On the Management Server, determine the name of the analytics and consumer groups. Many of
the commands below require that information.
By default, the name of the analytics group is
axgroup-001
, and the name of the consumer group isconsumer-group-001
. In the silent config file for a region, you can set the name of the analytics group by using theAXGROUP
property.If you are unsure of the names of the analytics and consumer groups, use the following command to display them:
apigee-adminapi.sh analytics groups list --admin
adminEmail --pwdadminPword --host localhostThis command returns the analytics group name in the name field, and the consumer group name in the consumer-groups field.
- Remove Qpid from the consumer group:
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 " - Remove Qpid from the analytics group:
curl -v -u
adminEmail:pword -X DELETE "http://ms_IP :8080/v1/analytics/groups/ax/AX_GROUP /servers?uuid=QPID_UUID &type=qpid-server" - Deregister the Qpid server from the Edge installation:
curl -u
adminEmail:pword -X POST http://ms_IP :8080/v1/servers -d "type=qpid-server®ion=dc-1&pod=central&uuid=QPID_UUID &action=remove" - Remove the Qpid server from the Edge installation:
curl -u
adminEmail:pword -X DELETE http://ms_IP :8080/v1/servers/QPID_UUID - Restart all
edge-qpid-server
components on all nodes to make sure the change is picked up by those components:/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server wait_for_ready
- Uninstall Qpid as described at Uninstalling Edge.