Adicionar ou remover nós Qpid

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

Para saber como remover um servidor de gerenciamento, processador de mensagens ou 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 consumidores.

    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 de consumidores, use o seguinte comando para exibi-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 com ou sem Internet, conforme descrito em Instalar o utilitário apigee-setup 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 é concluída, o script exibe o UUID do servidor Qpid. Se você precisar determinar o UUID mais tarde, use o seguinte comando cURL no host em que você instalou o Qpid:

    curl http://qpid_IP:8083/v1/servers/self
  4. Adicione o 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ê verá o UUID do nó do 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 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"

    Na saída, você verá o UUID do nó do 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 todos 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ó do Qpid:

  1. No servidor de gerenciamento, determine o nome dos grupos de análise e de consumidores. 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 de consumidores, use o seguinte comando para exibi-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 todos 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.