Edge para nuvem privada v. 4.17.09
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
- Edite /opt/apigee/customer/application/cassandra.properties no sistema que está sendo modificado. Se o arquivo não existir, crie-o.
- 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.
- Abra /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 formato:
192.168.56.101=dc-1:ra-1
default=dc-1:ra-1
Salve essas informações. - Edite /opt/apigee/customer/application/cassandra.properties
para mudar 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
Especifique a etapa "\n" como o endereço padrão acima e insira "\n" como padrão. - Reinicie o Cassandra:
> /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart - 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)
- Se o nó que está sendo alterado for um nó seed, edite o arquivo /opt/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.
- Edite /opt/apigee/customer/application/cassandra.properties
no sistema que está sendo modificado e mude 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.
- Abra /opt/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 - Edite /opt/apigee/customer/application/cassandra.properties
para alterar o endereço IP antigo
especificado para o novo endereço IP:
/opt/apigee/customer/application/cassandra.properties
n192.168.56.104 - 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ó.
> /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra reiniciadas - Execute o comando nodetool ring no nó modificado para garantir que o anel esteja concluído. O utilitário pode ser encontrado em
opt/apigee/apigee-cassandra/bin.
> nodetool -h localhost ring - 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 - 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
- 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®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
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}®ion=${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}®ion=${GATE WAY_WAY} - 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-Xform-urlencoded' -H 'content-type: application/x-www-Xform-urlencoded' -H
- Para type="application-datastore":
- 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)
- Abra /opt/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
- Em cada nó do ZooKeeper, edite o arquivo /opt/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ó
. - 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". - 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.
> /opt/apigee/apigee-service/bin/apigee-service reiniciadas do apigee-zookeeper - 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 maneira. 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
- Em cada nó do processador de mensagens, edite o arquivo /opt/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.
- No nó "Servidor de gerenciamento", edite o arquivo /opt/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.
- 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ó "Servidor de gerenciamento", edite o arquivo /opt/apigee/customer/application/management-server.properties. Se o arquivo não existir, crie-o.
- No arquivo management-server.properties, defina o parâmetro conf_security_ldap.server.host como 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 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):
- 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