Edge para nuvem privada v4.19.01
Neste documento, descrevemos como adicionar três novos nós do Cassandra a um Edge para instalação de nuvem privada.
Embora seja possível adicionar um ou dois nós do Cassandra a uma instalação do Edge, a Apigee recomenda adicionar três nós por vez.
Para conferir uma lista dos requisitos do sistema para um nó do Cassandra, consulte Requisitos de instalação.
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
Cassandra. Os três nós são especificados para a propriedade CASS_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" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1" SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com SMTPPASSWORD=smtppwd
Observe que a propriedade REGION
especifica o nome da região como "dc-1". Você precisa dessas
informações ao adicionar os novos nós do Cassandra.
Modificar o arquivo de configuração para adicionar os três novos nós do Cassandra
Neste exemplo, os três novos nós do Cassandra 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 CASS_HOSTS to add each new node after an existing nodes. # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1:1,1 $IP14:1,1 $IP2:1,1 $IP15:1,1 $IP3:1,1 $IP16:1,1"
Isso garante que os nós atuais mantenham as configurações iniciais de token e que o token inicial de cada novo nó esteja entre os valores de token dos nós atuais.
Configurar Edge
Depois de editar o arquivo de configuração, faça o seguinte:
- Reconfigurar os nós do Cassandra
- Instalar o Cassandra nos novos nós
- Reconfigurar o servidor de gerenciamento
Reconfigure os nós atuais do Cassandra
Nos nós atuais do Cassandra:
- Execute novamente setup.sh com o perfil "-p c" e o novo arquivo de configuração:
/opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
Instalar o Cassandra nos novos nós
Em cada novo nó do Cassandra:
- Instale o Cassandra nos três nós:
- Instale
apigee-setup
no primeiro nó, conforme descrito em Instalar o utilitário de configuração da Apigee Apigee. - Instale o Cassandra no primeiro nó usando o arquivo de configuração atualizado:
/opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
- Repita essas duas etapas para os novos nós restantes do Cassandra.
- Instale
- Recrie os três novos nós do Cassandra, especificando o nome da região definido no arquivo de configuração pela propriedade
REGION
. Neste exemplo, é "dc-1":- No primeiro nó, execute:
/opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h nodeIP rebuild dc-1
Em que nodeIP é o endereço IP do nó do Cassandra.
Você só precisará passar seu nome de usuário e senha se ativar a autenticação JMX para o Cassandra.
- Repita essa etapa nos novos nós restantes do Cassandra.
- No primeiro nó, execute:
Reconfigurar o servidor de gerenciamento
Em um nó do servidor de gerenciamento
- Execute setup.sh novamente para atualizar o servidor de gerenciamento dos nós do Cassandra recém-adicionados:
/opt/apigee/apigee-setup/bin/setup.sh -p ms -f updatedConfigFile
Reiniciar todos os roteadores e processadores de mensagens
- Em todos os roteadores:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
- Em todos os processadores de mensagens:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
Liberar espaço em disco nos nós do Cassandra
Depois de adicionar um novo nó, use o comando nodetool cleanup
nos nós pré-existentes para liberar espaço em disco. Esse comando limpa os tokens de configuração que não pertencem mais ao nó preexistente do Cassandra.
Para liberar espaço em disco nos nós pré-existentes do Cassandra após adicionar um novo nó, execute o seguinte comando:
/opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h cassandraIP cleanup
Você só precisará passar seu nome de usuário e senha se ativar a autenticação JMX para o Cassandra.
Verificar a recriação
Use os seguintes comandos para verificar se a recriação foi bem-sucedida:
nodetool [-u username -pw password] -h nodeIP netstats
Esse comando precisa indicar MODE: Normal
quando o nó estiver ativo e os índices forem criados.
nodetool [-u username -pw password] -h nodeIP statusthrift
Precisa indicar que o servidor thrift está em execução, o que permite que o Cassandra aceite novas solicitações do cliente.
nodetool [-u username -pw password] -h nodeIP statusbinary
Indica que o transporte nativo (ou o protocolo binário) está em execução.
nodetool describecluster
Deve mostrar que novos nós estão usando a mesma versão de esquema que os nós mais antigos.
Para mais informações sobre como usar nodetool
, consulte a
documentação de uso do Nodetool.