Cómo agregar o quitar nodos Qpid

En este documento, se describe cómo agregar y quitar un servidor de Qpid en una instalación de Edge existente.

Para obtener información sobre cómo quitar un servidor de administración, un Message Processor o un router, consulta Quita un servidor.

Agrega un servidor de Qpid

Para agregar un servidor de Qpid, haz lo siguiente:

  1. En el servidor de administración, determina el nombre de los grupos de consumidores y de estadísticas.

    Muchos de los comandos que se indican a continuación requieren esa información. De forma predeterminada, el nombre del grupo de estadísticas es axgroup-001 y el nombre del grupo de consumidores es consumer-group-001. En el archivo de configuración silenciosa de una región, puedes establecer el nombre del grupo de estadísticas con la propiedad AXGROUP.

    Si no estás seguro de los nombres de los grupos de consumidores y de estadísticas, usa el siguiente comando para mostrarlos:

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

    Este comando devuelve el nombre del grupo de estadísticas en el campo name y el nombre del grupo de consumidores en el campo consumer-groups.

  2. Instala la utilidad apigee-setup de Edge en el nodo con el procedimiento de Internet o sin Internet, como se describe en Instala la utilidad apigee-setup de Edge.
  3. Usa apigee-setup.sh para instalar Qpid en el nodo:
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile

    La opción "-p qs" especifica que se instale Qpid. Consulta Instala componentes de Edge en un nodo para obtener información sobre cómo crear un configFile.

    Cuando se completa la instalación, la secuencia de comandos muestra el UUID del servidor de Qpid. Si necesitas determinar el UUID más adelante, usa el siguiente comando de cURL en el host en el que instalaste Qpid:

    curl http://qpid_IP:8083/v1/servers/self
  4. Agrega Qpid al grupo de estadísticas:
    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"

    En el resultado, verás el UUID del nodo de Qpid agregado a la propiedad qpid-server en axgroup-001:

    {
      "name" : "axgroup-001",
      "properties" : {},
      "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
      "uuids" : {
        "qpid-server" : [
          "d6d0480f-8393-465d-a2a1-b4a16a033c55",
          "8398a95c-3640-4bd9-bf7e-1eb89155810a"
        ]
      }
    }
  5. Agrega Qpid al grupo de consumidores:
    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"

    En el resultado, verás el UUID del nodo de Qpid agregado a la propiedad consumer-groups en consumer-group-001:

    "consumer-groups" : [ {
      "name" : "consumer-group-001",
      "consumers" : [
        "d6d0480f-8393-465d-a2a1-b4a16a033c55",
        "8398a95c-3640-4bd9-bf7e-1eb89155810a"
      ]
    } ]
  6. Reinicia todos los componentes de edge-qpid-server en todos los nodos para asegurarte de que esos componentes detecten el cambio:
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server wait_for_ready

Se completó la instalación.

Quita un servidor de Qpid

Para quitar un nodo de Qpid, haz lo siguiente:

  1. En el servidor de administración, determina el nombre de los grupos de consumidores y de estadísticas. Muchos de los comandos que se indican a continuación requieren esa información.

    De forma predeterminada, el nombre del grupo de estadísticas es axgroup-001 y el nombre del grupo de consumidores es consumer-group-001. En el archivo de configuración silenciosa de una región, puedes establecer el nombre del grupo de estadísticas con la propiedad AXGROUP.

    Si no estás seguro de los nombres de los grupos de consumidores y de estadísticas, usa el siguiente comando para mostrarlos:

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

    Este comando devuelve el nombre del grupo de estadísticas en el campo de nombre y el nombre del grupo de consumidores en el campo consumer-groups.

  2. Quita Qpid del grupo de consumidores:
    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. Quita Qpid del grupo de estadísticas:
    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. Anula el registro del servidor de Qpid de la instalación de Edge:
    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. Quita el servidor de Qpid de la instalación de Edge:
    curl -u adminEmail:pword -X DELETE http://ms_IP:8080/v1/servers/QPID_UUID
  6. Reinicia todos los componentes de edge-qpid-server en todos los nodos para asegurarte de que esos componentes detecten el cambio:
    /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. Desinstala Qpid como se describe en Desinstala Edge.