Como adicionar ou remover nós Qpid

Edge para nuvem privada v4.18.05

Neste documento, descrevemos como adicionar e remover um servidor Qpid em uma instalação do Edge.

Adicionar um servidor Qpid

Para adicionar um servidor Qpid:

  1. No servidor de gerenciamento, determine o nome dos grupos de análise e de consumidor.

    Muitos dos comandos abaixo exigem essas informações. Por padrão, o nome do grupo de análise é axgroup-001, e o nome do grupo de consumidores é consumer-group-001. No arquivo de configuração silenciosa de uma região, defina o nome do grupo de análise usando a propriedade AXGROUP.

    Se você não tiver certeza dos nomes dos grupos de análise e consumidor, use o seguinte comando para mostrá-los:

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

    Esse comando retorna o nome do grupo de análise no campo name e o nome do grupo de consumidores no campo consumer-groups.

  2. Instale o utilitário apigee-setup do Edge no nó usando o procedimento on-line ou não, conforme descrito em Instalar o utilitário de configuração da Apigee do Edge.
  3. Use apigee-setup.sh para instalar o Qpid no nó:
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile

    A opção "-p qs" especifica a instalação do Qpid. Consulte Instalar componentes do Edge em um nó para informações sobre como criar um configFile.

    Quando a instalação for concluída, o script vai mostrar o UUID do servidor Qpid. Se você precisar determinar o UUID mais tarde, use o seguinte comando cURL no host em que instalou o Qpid:

    curl http://qpid_IP:8083/v1/servers/self
  4. Adicione Qpid ao grupo de análise:
    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"

    Na saída, você vê o UUID do nó Qpid adicionado à propriedade qpid-server em 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. Adicione o Qpid ao grupo para 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"

    Na saída, você vê o UUID do nó Qpid adicionado à propriedade consumer-groups em consumer-group-001:

    "consumer-groups" : [ {
      "name" : "consumer-group-001",
      "consumers" : [
        "d6d0480f-8393-465d-a2a1-b4a16a033c55",
        "8398a95c-3640-4bd9-bf7e-1eb89155810a"
      ]
    } ]
  6. Reinicie os componentes edge-qpid-server em todos os nós para garantir que a alteração seja detectada por esses componentes:
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server wait_for_ready

A instalação foi concluída.

Remover um servidor Qpid

Para remover um nó Qpid:

  1. No servidor de gerenciamento, determine o nome dos grupos de análise e de consumidor. Muitos dos comandos abaixo exigem essas informações.

    Por padrão, o nome do grupo de análise é axgroup-001, e o nome do grupo de consumidores é consumer-group-001. No arquivo de configuração silenciosa de uma região, é possível definir o nome do grupo de análise usando a propriedade AXGROUP.

    Se você não tiver certeza dos nomes dos grupos de análise e consumidor, use o comando a seguir para mostrá-los:

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

    Esse comando retorna o nome do grupo de análise no campo name e o nome do grupo de consumidores no campo consumer-groups.

  2. Remova o Qpid do 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. Remova o Qpid do grupo de análise:
    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. Cancele o registro do servidor Qpid na instalação do 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. Remova o servidor Qpid da instalação do Edge:
    curl -u adminEmail:pword -X DELETE http://ms_IP:8080/v1/servers/QPID_UUID
  6. Reinicie os componentes edge-qpid-server em todos os nós para garantir que a alteração seja detectada por esses componentes:
    /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. Desinstale o Qpid conforme descrito em Como desinstalar o Edge.