Ajout de nœuds ZooKeeper

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 dans 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@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

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 environnement de plusieurs centres de données, listez uniquement les nœuds ZooKeeper dans ce dans un 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@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"

Marquer le dernier nœud de ZK_HOSTS avec l'opérateur "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 ordre. Cependant, omettez le modificateur :observer lorsque vous configurez 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 Installez l'utilitaire de configuration Edge Apigee.
  2. Installez ZooKeeper sur le premier nœud à l'aide des commandes suivantes:
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -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. Exécutez à nouveau la commande d'installation avec le nouveau fichier de configuration:
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -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 setup -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 edge-router setup -f updatedConfigFile
  2. Redémarrez le routeur:
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart

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 edge-message-processor setup -f updatedConfigFile
  2. Redémarrez le processeur de messages:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

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 setup -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 setup -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 du résultat pour nœuds, un nœud doit être désigné comme observateur, un nœud principal et les autres comme nœud principal abonnés.