Edge for Private Cloud v4.18.05
Les composants Apigee utilisent des adresses IP pour communiquer entre eux. Le déplacement de composants d'une machine à une autre peut entraîner une incompatibilité de configuration. Pour corriger les incohérences de configuration, suivez les instructions correspondantes ci-dessous.
Modifier l'adresse IP d'un nœud Cassandra
Pour modifier l'adresse IP d'un nœud Cassandra, procédez comme suit :
Pour les configurations avec un seul nœud Cassandra
- Modifiez
/opt/apigee/customer/application/cassandra.propertiessur le système en cours de modification. Si le fichier n'existe pas, créez-le. - Modifiez les paramètres suivants :
- Définissez les paramètres
conf_cassandra_seedsetconf_cassandra_listen_addresspour spécifier la nouvelle adresse IP du système. - Modifiez
conf_cassandra_rpc_addresspour utiliser la nouvelle adresse IP ou 0.0.0.0 (ce qui permet à Cassandra Thrift d'écouter sur toutes les interfaces).
- Définissez les paramètres
- Ouvrez
/opt/apigee/apigee-cassandra/conf/cassandra-topology.propertiesdans un éditeur. L'ancienne adresse IP et le paramètre par défaut doivent s'afficher dans le formulaire :192.168.56.101=dc-1:ra-1 default=dc-1:ra-1
Enregistrez ces informations.
- Modifiez
/opt/apigee/customer/application/cassandra.propertiespour remplacer l'ancienne adresse IP spécifiée par la nouvelle :conf_cassandra-topology_topology=192.168.56.103=dc-1:ra-1\ndefault=dc-1:ra-1\n
Veillez à insérer "\n" après l'adresse IP et à spécifier les mêmes paramètres par défaut que ceux que vous avez trouvés à l'étape 3 ci-dessus.
- Redémarrez Cassandra :
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
- Si nécessaire, réparez également ZooKeeper (voir ci-dessous), sinon redémarrez chaque composant de la plate-forme Apigee en commençant par le serveur de gestion.
Pour les configurations avec plusieurs nœuds Cassandra (anneau)
- Si le nœud modifié est un nœud d'amorçage, modifiez le fichier
/opt/apigee/customer/application/cassandra.propertiessur chaque système de l'anneau, puis modifiez le paramètreconf_cassandra_seedspour inclure la nouvelle adresse IP du système modifié. Si le fichier cassandra.properties n'existe pas, créez-le. - Modifiez
/opt/apigee/customer/application/cassandra.propertiessur le système en cours de modification, puis modifiez les paramètres suivants :- Définissez
conf_cassandra_listen_addresspour utiliser la nouvelle adresse IP. - Définissez
conf_cassandra_rpc_addresspour utiliser la nouvelle adresse IP ou "0.0.0.0" (ce qui permet à Cassandra Thrift d'écouter sur toutes les interfaces).
- Définissez
- Ouvrez
/opt/apigee/apigee-cassandra/conf/cassandra-topology.propertiesdans un éditeur. Vous devriez voir toutes les adresses IP Cassandra et le paramètre par défaut sous la forme suivante :192.168.56.101=dc-1:ra-1 192.168.56.102=dc-1:ra-1 192.168.56.103=dc-1:ra-1 default=dc-1:ra-1
Enregistrez ces informations.
- Modifiez
/opt/apigee/customer/application/cassandra.propertiespour remplacer l'ancienne adresse IP spécifiée par la nouvelle :conf_cassandra-topology_topology=192.168.56.101=dc-1:ra-1\n192.168.56.102=dc-1:ra-1\n192.168.56.104=dc-1:ra-1\ndefault=dc-1:ra-1\n
Veillez à insérer "\n" après chaque adresse IP et à utiliser les mêmes paramètres par défaut que ceux que vous avez enregistrés à l'étape 3 ci-dessus.
- Redémarrez Cassandra sur le système modifié. Si le système modifié est un nœud d'amorçage, redémarrez également chaque système qui l'utilisait.
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
- Exécutez la commande
nodetool ringsur le nœud modifié pour vous assurer que l'anneau est complet. L'utilitaire est disponible à l'adresse/opt/apigee/apigee-cassandra/bin.nodetool -h localhost ring
- Exécutez
nodetool repairsur le nœud modifié. Notez que ce processus peut prendre un certain temps. Il est donc vivement recommandé de ne pas l'effectuer pendant les heures de pointe du trafic de l'API.nodetool -h localhost repair
- Si nécessaire, réparez ZooKeeper (voir ci-dessous), puis redémarrez chaque composant de la plate-forme Apigee, en commençant par le serveur de gestion.
Mettre à jour les enregistrements de datastores
- Recherchez les UUID des enregistrements de datastores spécifiant l'ancienne adresse IP à l'aide des commandes ci-dessous. Notez les paramètres "type" et "UUID" :
-
curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=central®ion=DC" | egrep -i '[type|internalip|uuid|region]'
-
curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=gateway®ion=DC" | egrep -i '[type|internalip|uuid|region]'
-
curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=analytics®ion=DC" | egrep -i '[type|internalip|uuid|region]'
Où DC est le nom du centre de données. Dans une installation à un seul centre de données, la valeur est généralement "dc-1".
-
- Enregistrez les nouvelles adresses IP à l'aide de l'une des commandes ci-dessous. La commande nécessaire dépend du type de nœud modifié.
- Pour type="application-datastore" :
curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers -d \ "Type=application-datastore&Type=audit-datastore&InternalIP=NEWIP®ion=REGION&pod=central" \ -H 'content-type: application/x-www-form-urlencoded' -X POST
- Pour type="kms-datastore" :
curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers -d \ "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore&Type=counter-datastore&Type=cache-datastore \ &InternalIP=NEWIP®ion=REGION&pod=GATEWAY_POD" -H 'content-type: \ application/x-www-form-urlencoded' -X POST
- Pour type="reportcrud-datastore" :
curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers" -d \ "Type=reportcrud-datastore&InternalIP=NEW_IP®ion=REGION&pod=analytics" \ -H 'content-type: application/x-www-form-urlencoded' -X POST
- Pour type="application-datastore" :
- Supprimez les anciens enregistrements de l'UUID du système sur lequel l'adresse IP a été modifiée. Pour chacun de ces UUID, exécutez la commande suivante :
curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers/OLD_UUID" -X DELETE
Modifier l'adresse IP d'un nœud ZooKeeper
Pour modifier l'adresse IP d'un nœud ZooKeeper, procédez comme suit :
Modifier l'adresse IP et redémarrer l'ensemble ZooKeeper (pour les configurations d'ensemble multinœud uniquement)
- Ouvrez
/opt/apigee/apigee-zookeeper/conf/zoo.cfgdans un éditeur. Toutes les adresses IP ZooKeeper et les paramètres par défaut doivent s'afficher sous la forme suivante :server.1=192.168.56.101:2888:3888 server.2=192.168.56.102:2888:3888 server.3=192.168.56.103:2888:3888
Enregistrez ces informations.
- Sur chaque nœud ZooKeeper, modifiez le fichier
/opt/apigee/customer/application/zookeeper.propertiespour définir la propriétéconf_zoo_quorumsur les adresses IP appropriées. Si le fichier n'existe pas, créez-le.conf_zoo_quorum=server.1=192.168.56.101:2888:3888\nserver.2=192.168.56.102:2888:3888\nserver.3=192.168.56.104:2888:3888\n
Veillez à insérer "\n" après chaque adresse IP et à ce que les entrées soient dans le même ordre sur chaque nœud.
- Recherchez le leader de l'ensemble ZooKeeper à l'aide de la commande suivante (remplacez node par l'adresse IP de la machine Zookeeper) :
echo srvr | nc node 2181
La ligne "Mode" de la sortie doit indiquer "leader".
- Redémarrez un ZooKeeper après l'autre, en commençant par le leader et en terminant par le nœud sur lequel l'adresse IP a été modifiée. Si plusieurs nœuds ZooKeeper ont changé d'adresse IP, il peut être nécessaire de redémarrer tous les nœuds.
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
- Utilisez la commande
echodécrite ci-dessus pour vérifier chaque nœud ZooKeeper.
Informer les nœuds Apigee de la modification de la configuration
- Sur chaque nœud de routeur, modifiez le fichier
/opt/apigee/customer/application/router.propertiescomme suit. Si le fichier n'existe pas, créez-le.- Modifiez le paramètre
conf_zookeeper_connection.stringpour inclure la nouvelle adresse IP. - Modifiez le paramètre
conf_zookeeper_zk1.hostpour inclure la nouvelle adresse IP.
- Modifiez le paramètre
- Sur chaque nœud de processeur de messages, modifiez le fichier
/opt/apigee/customer/application/message-processor.propertiescomme suit. Si le fichier n'existe pas, créez-le.- Modifiez le paramètre
conf_zookeeper_connection.stringpour inclure la nouvelle adresse IP. - Modifiez le paramètre
conf_zookeeper_zk1.hostpour inclure la nouvelle adresse IP.
- Modifiez le paramètre
- Sur le nœud du serveur de gestion, modifiez le fichier
/opt/apigee/customer/application/management-server.propertiescomme suit. Si le fichier n'existe pas, créez-le.- Modifiez le paramètre
conf_zookeeper_connection.stringpour inclure la nouvelle adresse IP. - Modifiez le paramètre
conf_zookeeper_zk1.hostpour inclure la nouvelle adresse IP.
- Modifiez le paramètre
- Redémarrez tous les composants de la plate-forme Apigee en exécutant la commande suivante sur chaque nœud :
/opt/apigee/apigee-service/bin/apigee-all restart
Modifier l'adresse IP d'un serveur LDAP (OpenLDAP)
Pour modifier l'adresse IP d'un nœud OpenLDAP, procédez comme suit :
- Sur le nœud du serveur de gestion, modifiez le fichier
/opt/apigee/customer/application/management-server.properties. Si le fichier n'existe pas, créez-le. - Dans le fichier
management-server.properties, définissez le paramètreconf_security_ldap.server.hostsur la nouvelle adresse IP. - Redémarrez le serveur de gestion :
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
Modifier l'adresse IP d'autres types de nœuds Apigee
Pour modifier l'adresse IP de l'un de ces types de nœuds (routeur, processeur de messages, serveur Postgres (et non postgresql) et serveur Qpid (et non qpidd) :
- Utilisez la commande
curlsuivante pour enregistrer la nouvelle adresse IP interne et externe :curl -u ADMINEMAIL:PW -X PUT \ http://MSIP:8080/v1/servers/uuid -d ExternalIP=ip
curl -u ADMINEMAIL:PW -X PUT \ http://$MSIP:8080/v1/servers/uuid -d InternalIP=ipOù uuid est l'UUID du nœud.
Si vous ne connaissez pas l'UUID du nœud, vous pouvez utiliser la commande suivante pour l'afficher :
- Routeur :
curl http://router_IP:8081/v1/servers/self
- Processeur de messages :
curl http://mp_IP:8082/v1/servers/self
- Qpid :
curl http://qp_IP:8083/v1/servers/self
- Postgres :
curl http://pg_IP:8084/v1/servers/self