Cómo agregar o quitar nodos Qpid

Edge para la nube privada v4.18.05

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

Agrega un servidor Qpid

Para agregar un servidor Qpid:

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

    Muchos de los siguientes comandos 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 silencioso 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 muestra 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 mediante el procedimiento de Internet o sin Internet, como se describe en Instala la utilidad de Edge apigee-setup.
  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 la instalación de Qpid. Consulta Instala componentes de Edge en un nodo para obtener información sobre cómo crear un configFile.

    Cuando se complete la instalación, la secuencia de comandos mostrará el UUID del servidor de Qpid. Si necesitas determinar el UUID más adelante, usa el siguiente comando 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 edge-qpid-server en todos los nodos para asegurarte de que esos componentes capten 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.

Cómo quitar un servidor Qpid

Para quitar un nodo de Qpid:

  1. En el servidor de administración, determina el nombre de los grupos de consumidores y de estadísticas. Muchos de los siguientes comandos 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 silencioso 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 muestra el nombre del grupo de estadísticas en el campo de nombre y el nombre del grupo de consumidores en el campo de grupos de consumidores.

  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 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 edge-qpid-server en todos los nodos para asegurarte de que esos componentes capten 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 Cómo desinstalar Edge.