Adicionar ou remover nós Qpid

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

Para informações sobre como remover um servidor de gerenciamento, um processador de mensagens ou um roteador, consulte Remover um servidor.

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.