Ajouter des nœuds Cassandra

Edge pour Private Cloud version 4.17.01

Ce document explique comment ajouter trois nouveaux nœuds Cassandra à une installation Edge pour le cloud privé.

Bien que vous puissiez ajouter un ou deux nœuds Cassandra à une installation Edge existante, Apigee vous recommande d'ajouter trois nœuds à la fois.

Pour obtenir la liste de la configuration système requise pour un nœud Cassandra, consultez la page Configuration requise.

Configuration périphérique existante

Toutes les topologies Edge compatibles avec un système de production spécifient l'utilisation de trois nœuds Cassandra. Les trois nœuds sont spécifiés dans la propriété CASS_HOSTS dans le fichier de configuration, comme indiqué ci-dessous:

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 
BIND_ON_ALL_INTERFACES=y
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

Notez que la propriété REGION spécifie le nom de la région comme "dc-1". Vous en aurez besoin lorsque vous ajouterez les nouveaux nœuds Cassandra.

Modifier le fichier de configuration pour ajouter les trois nouveaux nœuds Cassandra

Dans cet exemple, les trois nouveaux nœuds Cassandra se trouvent aux adresses IP suivantes:

  • 10.10.0.14
  • 10.10.0.15
  • 10.10.0.16

Vous devez d'abord mettre à jour le fichier de configuration Edge pour ajouter les nouveaux nœuds:

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"

Important: Ajoutez chaque nouveau nœud Cassandra à CASS_HOSTS après un nœud existant.

Ainsi, les nœuds existants conservent leurs paramètres de jeton initiaux et le jeton initial de chaque nouveau nœud se trouve entre les valeurs de jeton des nœuds existants.

Configurer Edge

Après avoir modifié le fichier de configuration, procédez comme suit:

  • Reconfigurer les nœuds Cassandra existants
  • Installer Cassandra sur les nouveaux nœuds
  • Reconfigurer le serveur de gestion

Reconfigurer les nœuds Cassandra existants

Sur les nœuds Cassandra existants:

  1. Exécutez à nouveau setup.sh avec le profil "-p c" et le nouveau fichier de configuration:
    > /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile

Installer Cassandra sur les nouveaux nœuds

Sur chaque nouveau nœud Cassandra:

  1. Installez Cassandra sur les trois nœuds :
    1. Installez apigee-setup sur le premier nœud, comme décrit dans la section Installer l'utilitaire de configuration d'Apigee Edge.
    2. Installez Cassandra sur le premier nœud à l'aide du fichier de configuration mis à jour:
      > /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
    3. Répétez ces deux étapes pour les nouveaux nœuds Cassandra restants.
  2. Recompilez les trois nouveaux nœuds Cassandra en spécifiant le nom de la région défini dans le fichier de configuration par la propriété REGION. Dans cet exemple, il s'agit de "dc-1" :
    1. Sur le premier nœud, exécutez la commande suivante:
      > /opt/apigee/apigee-cassandra/bin/nodetool -h nodeIP rebuild dc-1
      où nodeIP est l'adresse IP du nœud Cassandra.
    2. Répétez cette étape sur les nouveaux nœuds Cassandra restants.

Reconfigurer le serveur de gestion

Sur un nœud Management-Server

  1. Exécutez à nouveau setup.sh pour mettre à jour le serveur de gestion pour les nœuds Cassandra nouvellement ajoutés:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f updatedConfigFile

Redémarrer tous les routeurs et processeurs de messages

  1. Sur tous les routeurs:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-router restart
  2. Sur tous les processeurs de messages:
    > /opt/apigee/apigee-service/bin/apigee-serviceedge-message-processor restart

Mémoire disponible sur les nœuds Cassandra existants

Sur les nœuds Cassandra existants, exécutez la commande nodetool cleanup pour libérer de la mémoire:

> /opt/apigee/apigee-cassandra/bin/nodetool -h cassandraIP nettoyage