Edge para nuvem privada v4.18.05
Os componentes da Apigee usam endereços IP para se comunicarem uns com os outros. Movendo componentes de um 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 com um único nó do Cassandra
- Editar
/opt/apigee/customer/application/cassandra.properties
no sistema que está sendo modificado. Crie o arquivo se ele não existir. - Altere os seguintes parâmetros:
- Defina
conf_cassandra_seeds
econf_cassandra_listen_address
. para especificar o novo endereço IP do sistema. - Mude a
conf_cassandra_rpc_address
para usar o novo endereço IP ou 0.0.0.0 (que permite que o Cassandra Thrift escute todos ).
- Defina
- Abrir
/opt/apigee/apigee-cassandra/conf/cassandra-topology.properties
em um editor. Você verá o endereço IP antigo e a configuração padrão no formulário:192.168.56.101=dc-1:ra-1 default=dc-1:ra-1
Salve essas informações.
- Editar
/opt/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
Não se esqueça de inserir "\n" após o endereço IP e especifique as mesmas configurações padrão que você encontrou na Etapa 3.
- Reinicie o Cassandra:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
- Se necessário, repare também o ZooKeeper (veja abaixo) ou reinicie todas as plataformas da Apigee que começa com o Management Server.
Para configurações com vários nós do Cassandra (anel)
- Se o nó que está sendo alterado for um nó de origem, edite
/opt/apigee/customer/application/cassandra.properties
. em cada sistema no ring e mudar o parâmetroconf_cassandra_seeds
para incluir o novo IP do sistema modificado. Se o arquivo cassandra.properties não existir, crie reimplantá-lo. - Editar
/opt/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. - Defina
conf_cassandra_rpc_address
para usar o novo endereço IP ou "0.0.0.0" (o que permite ao Cassandra Thrift escutar em todas as interfaces).
- Defina
- Abrir
/opt/apigee/apigee-cassandra/conf/cassandra-topology.properties
em um editor. Todos os endereços IP e a configuração padrão do Cassandra vão aparecer na formulário:192.168.56.101=dc-1:ra-1 192.168.56.102=dc-1:ra-1 192.168.56.103=dc-1:ra-1 default=dc-1:ra-1
Salve essas informações.
- Editar
/opt/apigee/customer/application/cassandra.properties
para alterar o endereço IP antigo especificado para o novo:conf_cassandra-topology_topology=192.168.56.101=dc-1:ra-1\n192.168.56.102=dc-1:ra-1\n192.168.56.104=dc-1:ra-1\ndefault=dc-1:ra-1\n
Não se esqueça de inserir "\n" depois de cada endereço IP e usam as mesmas configurações padrão que você acima na Etapa 3.
- Reinicie o Cassandra no sistema modificado. Se o sistema modificado for um nó de origem,
reinicie cada sistema que usou o nó de origem modificado.
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
- Executar o
nodetool ring
no nó modificado para garantir que o anel esteja completo. O utilitário pode ser encontrado em/opt/apigee/apigee-cassandra/bin
:nodetool -h localhost ring
- Executar
nodetool repair
no nó modificado. Esse processo pode levar algum tempo, por isso é altamente recomendado que isso não seja feito durante horários de pico de tráfego da API.nodetool -h localhost repair
- Se necessário, repare o ZooKeeper (veja abaixo) e reinicie todos os componentes da plataforma Apigee começando com o Management Server.
Atualizar repositório de dados inscrições
- Encontre os UUIDs de registros do armazenamento de dados que especificam o endereço IP antigo usando o
comandos abaixo. Anote o "tipo" e "UUID" parâmetros:
-
curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=central®ion=DC" | egrep -i '[type|internalip|uuid|region]'
-
curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=gateway®ion=DC" | egrep -i '[type|internalip|uuid|region]'
-
curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=analytics®ion=DC" | egrep -i '[type|internalip|uuid|region]'
Em que DC é o nome do data center. Em uma única instalação de data center, o valor normalmente é "dc-1".
-
- Registre os novos endereços IP usando um dos comandos abaixo. O comando necessário
dependem do tipo de nó alterado.
- Para type="application-datastore":
curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers -d \ "Type=application-datastore&Type=audit-datastore&InternalIP=NEWIP®ion=REGION&pod=central" \ -H 'content-type: application/x-www-form-urlencoded' -X POST
- 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®ion=REGION&pod=GATEWAY_POD" -H 'content-type: \ application/x-www-form-urlencoded' -X POST
- Para type="reportcrud-datastore":
curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers" -d \ "Type=reportcrud-datastore&InternalIP=NEW_IP®ion=REGION&pod=analytics" \ -H 'content-type: application/x-www-form-urlencoded' -X POST
- Para type="application-datastore":
- Exclua registros antigos para o UUID do sistema em que o endereço IP foi
mudou. Para cada um desses 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:
Alterar o endereço IP e reiniciar o ensemble ZooKeeper (para configurações de ensemble de vários nós )
- Abra
/opt/apigee/apigee-zookeeper/conf/zoo.cfg
em um editor. Aparecerá todos os endereços IP do ZooKeeper e a configuração padrão no formulário:server.1=192.168.56.101:2888:3888 server.2=192.168.56.102:2888:3888 server.3=192.168.56.103:2888:3888
Salve essas informações.
- Em cada nó do ZooKeeper, edite o arquivo
/opt/apigee/customer/application/zookeeper.properties
para definir a propriedadeconf_zoo_quorum
com os endereços IP corretos. Se o arquivo não existe, 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\n
Não se esqueça de inserir "\n" depois de cada endereço IP e que as entradas estejam na mesma ordem cada nó.
- Encontre o líder do conjunto do 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".
- Reinicie um ZooKeeper após o outro, começando com o líder e terminando com o nó ativado.
em que o endereço IP foi alterado. Se mais de um nó do Zookeeper alterou os endereços IP, ele pode
reiniciar todos os nós.
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
- Use o comando
echo
descrito acima para verificar cada nó do ZooKeeper.
Informe os nós da Apigee sobre a configuração alterada
- Em cada nó do Roteador, edite o arquivo
/opt/apigee/customer/application/router.properties
. da seguinte forma. Crie o arquivo se ele não existir.- Altere o parâmetro
conf_zookeeper_connection.string
para incluir o novo IP. endereço - Altere o parâmetro
conf_zookeeper_zk1.host
para incluir o novo IP. endereço
- Altere o parâmetro
- Em cada nó do processador de mensagens, edite o arquivo
/opt/apigee/customer/application/message-processor.properties
da seguinte forma. Crie o arquivo se ele não existir.- Mude o parâmetro
conf_zookeeper_connection.string
para incluir o novo valor. Endereço IP - Altere o parâmetro
conf_zookeeper_zk1.host
para incluir o novo IP. endereço
- Mude o parâmetro
- No nó do servidor de gerenciamento, edite o arquivo
/opt/apigee/customer/application/management-server.properties
. da seguinte forma. Crie o arquivo se ele não existir.- Mude o parâmetro
conf_zookeeper_connection.string
para incluir o novo valor. Endereço IP - Altere o parâmetro
conf_zookeeper_zk1.host
para incluir o novo IP. endereço
- Mude o parâmetro
- Reinicie todos os componentes da plataforma Apigee executando o seguinte comando em cada nó:
/opt/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:
- No nó do servidor de gerenciamento, edite o arquivo
/opt/apigee/customer/application/management-server.properties
. . Crie o arquivo se ele não existir. - No arquivo
management-server.properties
, defina oconf_security_ldap.server.host
para o novo endereço IP. - Reinicie o servidor de gerenciamento:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
Como alterar o endereço IP de outro nó da Apigee tipos
Para alterar o endereço IP de qualquer um destes tipos de nó (Roteador, Processador de mensagens, Postgres, Server (não postgresql) e Qpid Server (não qpidd):
- Use o seguinte comando
curl
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 PUT \ http://$MSIP:8080/v1/servers/uuid -d InternalIP=ip
Em que uuid é o UUID do nó.
Se você não souber o UUID do nó, use o seguinte comando para exibi-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