Déplacer des serveurs Apigee

Edge pour Private Cloud v4.18.05

Les composants Apigee utilisent des adresses IP pour communiquer entre eux. Déplacer des composants depuis un d'une machine à une autre peut entraîner une incohérence au niveau de la configuration. Pour corriger les incohérences de configuration, procédez comme suit : les instructions appropriées 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 avec un seul nœud Cassandra

  1. Modifier /opt/apigee/customer/application/cassandra.properties sur le système en cours de modification. Si le fichier n'existe pas, créez-le.
  2. Modifiez les paramètres suivants: <ph type="x-smartling-placeholder">
      </ph>
    • Définir les éléments conf_cassandra_seeds et conf_cassandra_listen_address pour spécifier la nouvelle adresse IP du système.
    • Modifiez conf_cassandra_rpc_address pour l'utiliser. soit la nouvelle adresse IP, soit 0.0.0.0 (ce qui permet à Cassandra Thrift d'écouter sur tous interfaces Google Cloud).
  3. Ouvrir /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties dans un éditeur. L'ancienne adresse IP et le paramètre par défaut devraient apparaître sous la forme suivante:
    192.168.56.101=dc-1:ra-1
    default=dc-1:ra-1

    Enregistrez ces informations.

  4. Modifier /opt/apigee/customer/application/cassandra.properties pour 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écifiez les mêmes paramètres par défaut que de l'étape 3 ci-dessus.

  5. Redémarrez Cassandra :
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. Si nécessaire, réparez également ZooKeeper (voir ci-dessous). Sinon, redémarrez chaque plate-forme Apigee. en commençant par Management Server.

Pour Configurations avec plusieurs nœuds Cassandra (anneau)

  1. Si le nœud en cours de modification est un nœud source, modifiez /opt/apigee/customer/application/cassandra.properties sur chaque système de l'anneau, puis modifiez le paramètre conf_cassandra_seeds pour inclure la nouvelle adresse IP du système modifié. Si le fichier cassandra.properties n'existe pas, créez
  2. Modifier /opt/apigee/customer/application/cassandra.properties sur le système en cours de modification, puis modifiez les paramètres suivants: <ph type="x-smartling-placeholder">
      </ph>
    • Définissez conf_cassandra_listen_address pour utiliser la nouvelle adresse IP.
    • Définissez conf_cassandra_rpc_address pour utiliser la nouvelle adresse IP ou "0.0.0.0". (ce qui permet à Cassandra Thrift d'écouter sur toutes les interfaces).
  3. Ouvrir /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties dans un éditeur. Vous devriez voir toutes les adresses IP de Cassandra et les paramètres par défaut dans le formulaire:
    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.

  4. Modifier /opt/apigee/customer/application/cassandra.properties pour 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 utilisez les mêmes paramètres par défaut que de l'étape 3 ci-dessus.

  5. Redémarrez Cassandra sur le système modifié. Si le système modifié est un nœud source, redémarrer chaque système qui a utilisé le nœud source modifié.
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. Exécuter l'nodetool ring sur le nœud modifié pour vous assurer que l'anneau est terminé. Vous trouverez cet utilitaire à l'adresse /opt/apigee/apigee-cassandra/bin
    nodetool -h localhost ring
  7. Exécutez nodetool repair sur le un nœud modifié. Notez que ce processus peut prendre un certain temps, c'est pourquoi nous vous recommandons vivement que cela ne soit pas effectué pendant les heures de pointe du trafic API.
    nodetool -h localhost repair
  8. Si nécessaire, réparez ZooKeeper (voir ci-dessous), puis redémarrez chaque composant de la plate-forme Apigee. à commencer par Management Server.

Mettre à jour le datastore inscriptions

  1. Recherchez les UUID des enregistrements de datastore spécifiant l'ancienne adresse IP à l'aide de la méthode commandes ci-dessous. Notez le "type" et "UUID" paramètres: <ph type="x-smartling-placeholder">
      </ph>
    • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=central&region=DC" | egrep -i '[type|internalip|uuid|region]'
    • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=gateway&region=DC" | egrep -i '[type|internalip|uuid|region]'
    • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=analytics&region=DC" | egrep -i '[type|internalip|uuid|region]'

      DC est le nom du centre de données. Dans une installation de centre de données unique, est généralement "dc-1".

  2. Enregistrez les nouvelles adresses IP à l'aide de l'une des commandes ci-dessous. La commande nécessaire dépendent 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&region=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&region=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&region=REGION&pod=analytics" \
        -H 'content-type: application/x-www-form-urlencoded' -X POST 
  3. Supprimer les anciens enregistrements de l'UUID du système sur lequel se trouvait l'adresse IP modifié. Pour chacun de ces problèmes d'UUID:
    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:

Modifiez l'adresse IP et redémarrez l'ensemble ZooKeeper (pour les configurations d'ensemble multinœuds). uniquement)

  1. Ouvrez /opt/apigee/apigee-zookeeper/conf/zoo.cfg dans un éditeur. Vous devriez voir toutes les adresses IP de ZooKeeper et le paramètre par défaut 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.

  2. Sur chaque nœud ZooKeeper, modifiez le fichier /opt/apigee/customer/application/zookeeper.properties. pour définir la propriété conf_zoo_quorum sur les bonnes adresses IP. 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 que les entrées sont dans le même ordre sur chaque nœud.

  3. Trouvez la variante optimale 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".

  4. Redémarrer un ZooKeeper après l'autre en commençant par la variante optimale et en terminant par le nœud activé dont l'adresse IP a été modifiée. Si plusieurs nœuds zookeeper ont changé d'adresses IP, pour redémarrer tous les nœuds.
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
  5. Utilisez la commande echo décrite ci-dessus pour vérifier chaque nœud ZooKeeper.

Informer les nœuds Apigee de la configuration modifiée

  1. Sur chaque nœud de routeur, modifiez le fichier /opt/apigee/customer/application/router.properties. comme suit. Si le fichier n'existe pas, créez-le.
    • Modifiez le paramètre conf_zookeeper_connection.string pour inclure la nouvelle adresse IP. adresse
    • Modifiez le paramètre conf_zookeeper_zk1.host pour inclure la nouvelle adresse IP. adresse
  2. Sur chaque nœud du processeur de messages, modifiez le fichier /opt/apigee/customer/application/message-processor.properties. comme suit. Si le fichier n'existe pas, créez-le.
    • Modifiez le paramètre conf_zookeeper_connection.string pour inclure le nouveau Adresse IP
    • Modifiez le paramètre conf_zookeeper_zk1.host pour inclure la nouvelle adresse IP. adresse
  3. Sur le nœud du serveur de gestion, modifiez le fichier /opt/apigee/customer/application/management-server.properties. comme suit. Si le fichier n'existe pas, créez-le.
    • Modifiez le paramètre conf_zookeeper_connection.string pour inclure le nouveau Adresse IP
    • Modifiez le paramètre conf_zookeeper_zk1.host pour inclure la nouvelle adresse IP. adresse
  4. 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

Modification de l'adresse IP d'un serveur LDAP (OpenLDAP)

Pour modifier l'adresse IP d'un nœud OpenLDAP, procédez comme suit:

  1. 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.
  2. Dans le fichier management-server.properties, définissez le conf_security_ldap.server.host à la nouvelle adresse IP.
  3. Redémarrez le serveur de gestion:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Modifier l'adresse IP d'un autre nœud Apigee Types

Modifier l'adresse IP de l'un de ces types de nœuds (routeur, processeur de messages, Postgres) Server (pas postgresql) et serveur Qpid (pas qpidd):

  1. Exécutez la commande curl suivante pour enregistrer les nouvelles adresses 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=ip

    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