Como mover servidores da Apigee

Edge para nuvem privada v. 4.16.05

Os componentes da Apigee usam endereços IP para se comunicar entre si. Mover componentes de uma máquina para outra pode causar uma incompatibilidade de configuração. Para corrigir inconsistências de configuração, siga as instruções relevantes abaixo.

Como alterar o endereço IP de um nó do Cassandra

Para alterar o endereço IP de um nó do Cassandra, siga estas etapas:

Para configurações com um único nó do Cassandra

  1. Edite /<inst_root>/apigee/customer/application/cassandra.properties no sistema que está sendo modificado. Se o arquivo não existir, crie-o.
  2. Mude os seguintes parâmetros:
    • Defina os parâmetros conf_cassandra_seeds e conf_cassandra_listen_address para especificar o novo endereço IP do sistema.
    • Altere conf_cassandra_rpc_address para usar o novo endereço IP ou 0.0.0.0, que permite que o Cassandra Thrift detecte em todas as interfaces.
  3. Abra /<inst_root>/apigee/apigee-cassandra/conf/cassandra-topology.properties em um editor. Você verá o endereço IP antigo e a configuração padrão no formato:
    192.168.56.101=dc-1:ra-1
    default=dc-1:ra-1

    Salve essas informações.
  4. Edite /<inst_root>/apigee/customer/application/cassandra.properties para alterar o endereço IP antigo especificado para o novo:
    conf_cassandra-topology_topology=192.168.56.103=dc-1:ra-1\ndefault=dc-1:ra-1\n

    Depois de inserir o endereço IP padrão, digite "3" como padrão e insira o endereço IP "padrão" em "3"\n

  5. Reinicie o Cassandra:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. Se necessário, repare também o ZooKeeper (veja abaixo). Caso contrário, reinicie todos os componentes da plataforma Apigee, começando com o Servidor de gerenciamento.

Para configurações com vários nós do Cassandra (anel)

  1. Se o nó que está sendo alterado for um nó seed, edite o arquivo /<inst_root>/apigee/customer/application/cassandra.properties em cada sistema no anel e altere o parâmetro conf_cassandra_seeds para incluir o novo IP do sistema modificado. Se o arquivo cassandra.properties não existir, crie-o.
  2. Edite /<inst_root>/apigee/customer/application/cassandra.properties no sistema que está sendo modificado e altere os seguintes parâmetros:
    • Defina conf_cassandra_listen_address para usar o novo endereço IP.
    • Configure o conf_cassandra_RPC_address para usar o novo endereço IP ou 0.0.0.0, que permite que o Cassandra Thrift detecte em todas as interfaces.
  3. Abra /<inst_root>/apigee/apigee-cassandra/conf/cassandra-topology.properties em um editor. Você verá todos os endereços IP do Cassandra e a configuração padrão no formato:
    192.168.56.101=dc-1:ra-1
    192.168.56.102=dc-1:ra-1
    192.168.56.103=dc-1:ra-1 informações
    padrão

  4. Edite /<inst_root>/apigee/customer/application/cassandra.properties para alterar o endereço IP antigo especificado para o novo endereço IP:
    /<inst_root>/apigee/customer/application/cassandra.properties

    n192.168.56.104
  5. Reinicie o Cassandra no sistema modificado. Se o sistema modificado for um nó de sugestão, reinicie também cada sistema que usou esse nó.
    > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-cassandra reiniciadas
  6. Execute o comando nodetool ring no nó modificado para garantir que o anel esteja concluído. O utilitário pode ser encontrado em <inst_root>/apigee/apigee-cassandra/bin.
    > nodetool -h localhost ring
  7. Execute o reparo do Nodetool no nó modificado. Esse processo pode levar algum tempo, por isso é altamente recomendável que não seja feito durante os horários de pico de tráfego da API.
    > reparo do nodetool -h localhost
  8. Se necessário, repare o ZooKeeper (veja abaixo) e reinicie todos os componentes da plataforma Apigee, começando com o Servidor de gerenciamento

Atualizar registros do repositório de dados

  1. Use os comandos abaixo para encontrar os UUIDs de registros de repositório de dados que especificam o endereço IP antigo. Anote os parâmetros "type" e "UUID":
    • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=central" | egrep -i '(type|internalip|uuid|region)'
    • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=gateway" | egrep -i '(type|internalip|uuid|region)'
    • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=analytics" | egrep -i '(type|internalip|uuid|region)'
  2. Registre os novos endereços IP usando um dos comandos abaixo. O comando necessário vai depender do tipo do nó alterado.

    Observação: o parâmetro REGION abaixo se refere ao data center em que o cluster está. Por exemplo, para alta disponibilidade, você geralmente teria um cluster em dc-1 (Dater Center 1) e outro em dc-2 (data center 2). Esse parâmetro é definido no momento da instalação. O valor padrão é dc-1.
    • Para type="application-datastore":
      curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers -d "Type=application-datastore&Type=audit-datastore&InternalIP=${NEWIP}&region=${REGION}&pod=central" -H 'content-type: application/x-www-Xform-urlencoded' -H 'content-type: application/x-www-Xform-urlencoded' -H
    • Para type="kms-datastore":
      curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers -d "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore&Type=counter-datastore&Type=cache-datastore &InternalIP=${NEWIP}&region=${GATE WAY_WAY}
    • Para type="reportcrud-datastore":
      curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers" -d "Type=reportcrud-datastore&InternalIP=${NEW_IP}&region=${REGION}&pod=analytics" -H 'content-type: application/x-www-Xform-urlencoded' -H 'content-type: application/x-www-Xform-urlencoded' -H
  3. Excluir registros antigos do UUID do sistema em que o endereço IP foi alterado. Para cada problema de UUIDs:
    curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers/${OLD_UUID}" -X DELETE

Como alterar o endereço IP de um nó do ZooKeeper

Siga as etapas abaixo para alterar o endereço IP de um nó do ZooKeeper:

Mudar o endereço IP e reiniciar o conjunto do ZooKeeper (somente para configurações do conjunto de vários nós)

  1. Abra /<inst_root>/apigee/apigee-zookeeper/conf/zoo.cfg em um editor. Você verá todos os endereços IP do ZooKeeper e a configuração padrão no formato:
    server.1=192.168.56.101:2888:3888
    server.2=192.168.56.102:2888:3888
    server.3=192.168.58.10

  2. Em cada nó do ZooKeeper, edite o arquivo /<inst_root>/apigee/customer/application/zookeeper.properties para definir a propriedade conf_zoo_quorum com os endereços IP corretos. Se o arquivo não existir, crie-o.
    conf_zoo_quorum=server.1=192.168.56.101:2888:3888\nserver.2=192.168.56.102:2888:3888\nserver.3=192.168.56.104:2888:3888\nserver.2=192.168.56.102:2888:3888\nserver.3=192.168.56.104:2888:388
    Verifique se as entradas "8" do endereço IP são a mesma após cada nó
    .
  3. Encontre o líder do conjunto ZooKeeper usando o seguinte comando (substitua <node> pelo endereço IP da máquina Zookeeper):
    echo srvr | nc <node> 2181

    A linha Mode na saída deve dizer "leader".
  4. Reinicie um ZooKeeper após o outro, começando com o líder e terminando com o nó em que o endereço IP foi alterado. Se mais de um nó do zookeeper tiver alterado os endereços IP, talvez seja necessário reiniciar todos os nós.
    > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-zookeeper reiniciadas
  5. Use o comando echo descrito acima para verificar cada nó do ZooKeeper.

Informe os nós da Apigee sobre a configuração alterada.

  1. Em cada nó do roteador, edite o arquivo /<inst_root>/apigee/customer/application/router.properties conforme mostrado a seguir. Se o arquivo não existir, crie-o.
    • Altere o parâmetro conf_zookeeper_connection.string para incluir o novo endereço IP
    • Altere o parâmetro conf_zookeeper_zk1.host para incluir o novo endereço IP
  2. Em cada nó do processador de mensagens, edite o arquivo /<inst_root>/apigee/customer/application/message-processor.properties conforme mostrado a seguir. Se o arquivo não existir, crie-o.
    • Altere o parâmetro conf_zookeeper_connection.string para incluir o novo endereço IP
    • Altere o parâmetro conf_zookeeper_zk1.host para incluir o novo endereço IP.
  3. No nó do Servidor de gerenciamento, edite o arquivo /<inst_root>/apigee/customer/application/management-server.properties conforme mostrado a seguir. Se o arquivo não existir, crie-o.
    • Altere o parâmetro conf_zookeeper_connection.string para incluir o novo endereço IP
    • Altere o parâmetro conf_zookeeper_zk1.host para incluir o novo endereço IP.
  4. Reinicie todos os componentes da plataforma Apigee executando o seguinte comando em cada nó:
    /<inst_root>/apigee/apigee-service/bin/apigee-all restart

Como alterar o endereço IP de um servidor LDAP (OpenLDAP)

Para alterar o endereço IP de um nó do OpenLDAP, faça o seguinte:

  1. No nó "Servidor de gerenciamento", edite o arquivo /<inst_root>/apigee/customer/application/management-server.properties. Se o arquivo não existir, crie-o.
  2. No arquivo management-server.properties, defina o parâmetro conf_security_ldap.server.host como o novo endereço IP.
  3. Reinicie o servidor de gerenciamento:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server restart

Como alterar o endereço IP de outros tipos de nós da Apigee

Para alterar o endereço IP de qualquer um desses tipos de nó (roteador, processador de mensagens, servidor Postgres (não postgresql) e servidor Qpid (não qpidd):

  1. Use o comando cURL a seguir para registrar o novo endereço IP interno e externo:
    curl -u $ADMINEMAIL:$PW -X PUT http://$MSIP:8080/v1/servers/<uuid> -d ExternalIP=<ip>
    curl -u $ADMINEMAIL:$PW -X PUT1/serverIP8 http://$.uidIP8> o UUID1

Se você não souber o UUID do nó, use o seguinte comando para mostrá-lo:

  • Roteador: curl http://<router_IP>:8081/v1/servers/self
  • Processador de mensagens: curl http://<mp_IP>:8082/v1/servers/self
  • Qpid: curl http://<qp_IP>:8083/v1/servers/self
  • Postgres: curl http://<pg_IP>:8084/v1/servers/self