Ajout de nœuds ZooKeeper

Edge pour Private Cloud version 4.16.09

Ce document explique comment ajouter trois nouveaux nœuds ZooKeeper à un Edge for Private existant l'installation dans le cloud.

Vous pouvez ajouter un ou deux nœuds ZooKeeper à une installation Edge existante, mais vous devez Veillez à toujours disposer d'un nombre impair de nœuds de vote ZooKeeper, comme décrit ci-dessous.

Configuration périphérique existante

Toutes les topologies Edge compatibles avec un système de production spécifient l'utilisation de trois ZooKeeper nœuds. Les trois nœuds sont spécifiés sous ZK_HOSTS et ZK_CLIENT_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@apigee.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" 
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1" 
SKIP_SMTP=n
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
SMTPPASSWORD=smtppwd       

où :

  • ZK_HOSTS spécifie les adresses IP ou noms DNS des nœuds ZooKeeper. Les adresses IP ou noms DNS doivent être répertoriés dans le même ordre sur tous les nœuds ZooKeeper. Dans un environnement de plusieurs centres de données, lister tous les nœuds ZooKeeper des deux centres de données.
  • ZK_CLIENT_HOSTS spécifie les adresses IP ou noms DNS des nœuds ZooKeeper utilisés par ce centre de données. Les adresses IP ou DNS doivent être répertoriés dans le même ordre sur tous les nœuds ZooKeeper.

    Dans une installation de centre de données unique, il s'agit des mêmes nœuds que ceux spécifiés par ZK_HOSTS. Dans un entrepôt de données de l'environnement de centre de données, affichez uniquement les nœuds ZooKeeper de ce centre de données.

Modifier le fichier de configuration à ajouter les trois nouveaux nœuds ZooKeeper

Dans cet exemple, les trois nouveaux nœuds ZooKeeper sont associés 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@apigee.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" 

Marquez le dernier nœud de ZK_HOSTS avec le signe "with" modificateur ":observer". Les nœuds sans modificateur ":observer" sont appelés « voters ». Vous devez avoir un nombre impair d'"votants" dans votre configuration. Par conséquent, dans cette vous avez cinq votants et un observateur.

Veillez à ajouter les nœuds à ZK_HOSTS et ZK_CLIENT_HOSTS dans le même commande. Cependant, omettez le modificateur ":observer" lorsque vous définissez ZK_CLIENT_HOSTS.

Configurer Edge

Après avoir modifié le fichier de configuration, vous devez effectuer toutes les tâches suivantes.

Installer ZooKeeper sur les nouveaux nœuds

  1. Installez apigee-setup sur le premier nœud comme décrit dans la section Installer Edge utilitaire de configuration apigee.
  2. Installez ZooKeeper sur le premier nœud à l'aide des commandes suivantes:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper installer
    > /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper configuration -f updatedConfigFile
  3. Répétez les étapes 1 et 2 pour les nouveaux nœuds ZooKeeper restants.

Reconfigurer le ZooKeeper existant nœuds

Sur les nœuds ZooKeeper existants:

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

Redémarrer tous les nœuds ZooKeeper

Sur tous les nœuds ZooKeeper:

  1. Redémarrez le nœud:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart

    Vous devez redémarrer tous les nœuds ZooKeeper, mais l'ordre de redémarrage n'a pas d'importance.

Reconfigurer le serveur de gestion nœud

Sur le nœud du serveur de gestion:

  1. Exécutez la commande d'installation:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-management-server configuration -f updatedConfigFile
  2. Redémarrez le serveur de gestion:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-management-server restart

Reconfigurer tous les routeurs

Sur tous les nœuds de routeur:

  1. Exécutez la commande d'installation:
    > /opt/apigee/apigee-service/bin/apigee-service configuration de routeur périphérique -f updatedConfigFile
  2. Redémarrez le routeur:
    > /opt/apigee/apigee-service/bin/apigee-service redémarrage du routeur périphérique

Reconfigurer tout le message Processeurs

Sur tous les nœuds du processeur de messages:

  1. Exécutez la commande d'installation:
    /opt/apigee/apigee-service/bin/apigee-service configuration du processeur de messages Edge -f updatedConfigFile
  2. Redémarrez le processeur de messages:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-message-processor redémarrage

Reconfigurer tous les nœuds Qpid

Sur tous les nœuds Qpid:

  1. Exécutez la commande d'installation:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server configuration -f updatedConfigFile
  2. Redémarrez Qpid:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server restart

Reconfigurer tous les nœuds Postgres

Sur tous les nœuds Postgres:

  1. Exécutez la commande d'installation:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server configuration -f updatedConfigFile
  2. Redémarrez Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server restart

Valider l'installation

Vous pouvez valider l'installation des nouveaux nœuds ZooKeeper en envoyant des commandes au port 2181. à l'aide de netcat (nc) ou telnet. Pour en savoir plus sur les commandes ZooKeeper, consultez la page http://zookeeper.apache.org/doc/r3.1.2/zookeeperAdmin.html#sc_zkCommands.

Pour procéder à la validation :

  1. Si ce n'est pas déjà fait sur le nœud ZooKeeper, installez nc:
    > sudo yum install nc
  2. Exécutez la commande nc suivante:
    > echo stat | nc localhost 2181
  3. Répétez les étapes 1 et 2 sur chaque nœud ZooKeeper.
    Dans la ligne Mode de la sortie relative aux nœuds, un nœud doit être désigné comme un observateur, un nœud en tant que leader et les autres comme followers.