Este documento descreve como adicionar três novos nós do ZooKeeper a um Edge existente para instalação de nuvem privada.
É possível adicionar um ou dois nós do ZooKeeper a uma instalação do Edge atual. No entanto, você precisa sempre ter um número ímpar de nós eleitores do ZooKeeper, conforme descrito abaixo.
Configuração atual do Edge
Todas as topologias de borda compatíveis com um sistema de produção especificam o uso de três nós do
ZooKeeper. Os três nós são especificados para as propriedades ZK_HOSTS
e ZK_CLIENT_HOSTS
no arquivo de configuração, conforme mostrado abaixo:
IP1=10.10.0.1 IP2=10.10.0.2 IP3=10.10.0.3 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 USE_LDAP_REMOTE_HOST=n LDAP_TYPE=1 APIGEE_LDAPPW=secret MP_POD=gateway REGION=dc-1 ZK_HOSTS="$IP1 $IP2 $IP3" ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1" SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com SMTPPASSWORD=smtppwd
Em que:
ZK_HOSTS
especifica os endereços IP ou nomes DNS dos nós do ZooKeeper. Os endereços IP ou nomes DNS precisam ser listados na mesma ordem em todos os nós do ZooKeeper. Em um ambiente com vários data centers, liste todos os nós do ZooKeeper de ambos os data centers.ZK_CLIENT_HOSTS
especifica os endereços IP ou nomes DNS dos nós do ZooKeeper usados por esse data center. Os endereços IP ou nomes DNS precisam ser listados na mesma ordem em todos os nós do ZooKeeper.Em uma única instalação de data center, esses são os mesmos nós especificados por
ZK_HOSTS
. Em um ambiente de vários data centers, liste apenas os nós do ZooKeeper no data center.
Modificar o arquivo de configuração para adicionar os três novos nós do ZooKeeper
Neste exemplo, os três novos nós do ZooKeeper estão nos seguintes endereços IP:
- 10.10.0.14
- 10.10.0.15
- 10.10.0.16
Primeiro, atualize o arquivo de configuração do Edge para adicionar os novos nós:
IP1=10.10.0.1 IP2=10.10.0.2 IP3=10.10.0.3 # Add the new node IP addresses. IP14=10.10.0.14 IP15=10.10.0.15 IP16=10.10.0.16 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@google.com ... # Update ZK_HOSTS to add each new node after an existing nodes. ZK_HOSTS="$IP1 $IP2 $IP3 $IP14 $IP15 $IP16:observer" # Update ZK_Client_HOSTS to add each new node after an existing nodes. ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3 $IP14 $IP15 $IP16"
Marque o último nó em ZK_HOSTS
com o
modificador :observer
. Os nós sem o modificador :observer
são chamados de
"votadores". É preciso ter um número ímpar de "votantes" na configuração. Portanto, nessa
configuração, você tem cinco eleitores do ZooKeeper e um observador.
Adicione os nós a ZK_HOSTS
e ZK_CLIENT_HOSTS
na mesma ordem. No entanto, omita o modificador :observer
ao definir ZK_CLIENT_HOSTS
.
Configurar Edge
Depois de editar o arquivo de configuração, execute todas as tarefas a seguir.
Instalar o ZooKeeper nos novos nós
- Instale
apigee-setup
no primeiro nó, conforme descrito em Instalar o utilitário de configuração da Apigee do Edge. - Instale o ZooKeeper no primeiro nó usando os seguintes comandos:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -f updatedConfigFile
- Repita as etapas 1 e 2 para os novos nós restantes do ZooKeeper.
Reconfigurar os nós do ZooKeeper
Nos nós do ZooKeeper já existentes:
- Execute novamente o comando de configuração com o novo arquivo de configuração:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -f updatedConfigFile
Reiniciar todos os nós do Zookeeper
Em todos os nós do ZooKeeper:
- Reinicie o nó:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
É necessário reiniciar todos os nós do ZooKeeper, mas a ordem de reinicialização não importa.
Reconfigurar o nó do servidor de gerenciamento
No nó do servidor de gerenciamento:
- Execute o comando de configuração:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server setup -f updatedConfigFile
- Reinicie o servidor de gerenciamento:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
Reconfigurar todos os roteadores
Em todos os nós do roteador:
- Execute o comando de configuração:
/opt/apigee/apigee-service/bin/apigee-service edge-router setup -f updatedConfigFile
- Reinicie o roteador:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
Reconfigurar todos os processadores de mensagens
Em todos os nós do processador de mensagens:
- Execute o comando de configuração:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor setup -f updatedConfigFile
- Reinicie o processador de mensagens:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
Reconfigurar todos os nós Qpid
Em todos os nós Qpid:
- Execute o comando de configuração:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server setup -f updatedConfigFile
- Reinicie o Qpid:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
Reconfigurar todos os nós do Postgres
Em todos os nós do Postgres:
- Execute o comando de configuração:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server setup -f updatedConfigFile
- Reinicie o Postgres:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
Valide a instalação
É possível validar a instalação dos novos nós do ZooKeeper enviando comandos para a porta 2181 usando netcat (nc) ou telnet. Para mais informações sobre os comandos do ZooKeeper, consulte: http://zookeeper.apache.org/doc/r3.1.2/zookeeperAdmin.html#sc_zkCommands (em inglês).
Para validar uma página, siga estas etapas:
- Se não estiver instalado no nó do ZooKeeper, instale o nc:
sudo yum install nc
- Execute este comando nc:
echo stat | nc localhost 2181
- Repita as etapas 1 e 2 em cada nó do ZooKeeper. Na linha
Mode
da saída dos nós, um nó precisa ser designado como observador, outro como líder e o restante como seguidores.