Mise à jour d'Apigee Edge 4.17.0x vers la version 4.18.01

Edge for Private Cloud v4.18.01

Quelles versions d'Edge pouvez-vous mettre à jour vers la version 4.18.01 ?

Vous pouvez mettre à jour Apigee Edge version 4.17.0x en suivant cette procédure.

Si vous disposez d'une version d'Edge antérieure à la version 4.16.01, vous devez d'abord migrer vers la version 4.16.01.x, puis passer à la version 4.18.01.

Qui peut effectuer la mise à jour ?

L'utilisateur exécutant la mise à jour doit être le même que celui qui a installé Edge ou un utilisateur s'exécutant en tant qu'utilisateur root.

Une fois que vous avez installé les RPM Edge, n'importe quel utilisateur peut les configurer.

Composants à mettre à jour

Vous devez mettre à jour tous les composants Edge. Edge n'est pas compatible avec une configuration contenant des composants de plusieurs versions.

Maintenir la compatibilité

Lors de la mise à niveau d'Apigee Edge pour Private Cloud vers la version 4.18.01, vous devez vous assurer que la mise en œuvre obtenue ne fait référence qu'aux propriétés compatibles dans ses fichiers de configuration.

Propriété Emplacement Description
conf_load_balancing_load.balancing.
  driver.nginx.server.retry
router.properties Supprimez cette propriété de votre fichier router.properties. Pour définir les options de nouvelle tentative dans la version 4.18.01, utilisez les propriétés de configuration de l'hôte virtuel.

Propagation automatique des paramètres de propriété

Si vous avez défini des propriétés en modifiant les fichiers .properties dans /opt/apigee/customer/application, ces valeurs sont conservées lors de la mise à jour.

Ajout du paramètre de configuration SMTPMAILFROM obligatoire

Edge 4.17.05 a ajouté un nouveau paramètre obligatoire au fichier de configuration utilisé lors de l'activation d'un serveur SMTP. Si vous effectuez une mise à jour depuis la version 4.17.01, vous devez définir SMTPMAILFROM dans le fichier de configuration lors de l'activation du serveur SMTP.

La version 4.17.09 de l'API BaaS est également compatible avec la propriété SMTPMAILFROM. Lorsque vous mettez à jour les BaaS de l'API à partir de la version 4.17.01 ou 4.17.05, vous devez définir SMTPMAILFROM dans le fichier de configuration.

Ce paramètre se présente sous la forme suivante:

SMTPMAILFROM="My Company <myco@company.com>"

Mise à niveau vers Postgres 9.6 requise

Cette version d'Edge inclut une mise à niveau vers Postgres 9.6. Dans le cadre de cette mise à niveau, toutes les données Postgres sont migrées vers Postgres 9.6.

La plupart des systèmes de production Edge utilisent deux nœuds Postgres configurés pour la réplication en attente maître. Pendant le processus de mise à jour, lorsque les nœuds Postgres sont arrêtés pour la mise à jour, les données d'analyse sont toujours écrites dans les nœuds Qpid. Une fois les nœuds Postgres mis à jour et remis en ligne, les données d'analyse sont ensuite transmises aux nœuds Postgres.

La manière dont vous effectuez la mise à jour de Postgres dépend de la configuration du stockage des données pour vos nœuds Postgres:

  • Si vous utilisez un stockage de données local pour vos nœuds Postgres, vous devez installer un nouveau nœud de secours Postgres pour la durée de la mise à niveau. Une fois la mise à niveau terminée, vous pouvez mettre hors service le nouveau nœud de secours Postgres.

    Le nœud de secours Postgres supplémentaire est nécessaire si vous devez effectuer un rollback de la mise à jour pour une raison quelconque. Si vous devez effectuer un rollback de la mise à jour, le nouveau nœud de secours Postgres devient le nœud Postgres maître après le rollback. Par conséquent, lorsque vous installez le nouveau nœud de secours Postgres, celui-ci doit se trouver sur un nœud qui répond à toutes les exigences matérielles d'un serveur Postgres, comme défini dans les Conditions d'installation Edge.

    Dans une installation d'Edge à un et deux nœuds, les topologies utilisées pour le prototypage et les tests ne comportent qu'un seul nœud Postgres. Vous pouvez mettre à jour ces nœuds Postgres directement sans avoir à créer un autre nœud Postgres.
  • Si vous utilisez un stockage réseau pour vos nœuds Postgres, comme recommandé par Apigee, vous n'avez pas besoin d'installer un nouveau nœud Postgres. Dans les procédures ci-dessous, vous pouvez ignorer les étapes qui spécifient l'installation et la mise hors service ultérieure d'un nouveau nœud de secours Postgres.

    Avant de commencer le processus de mise à jour, prenez un instantané réseau du datastore utilisé par Postgres. Ensuite, si des erreurs se produisent pendant la mise à jour et que vous êtes obligé d'effectuer un rollback, vous pouvez restaurer le nœud Postgres à partir de cet instantané.

Installer un nouveau nœud de secours Postgres

Cette procédure crée un serveur de secours Postgres sur un nouveau nœud. Veillez à installer un nouveau serveur de secours Postgres pour votre version existante d'Edge (4.17.0x), et non pour la version 4.18.01.

Pour effectuer l'installation, utilisez le même fichier de configuration que celui que vous avez utilisé pour installer votre version actuelle d'Edge.

Pour créer un nœud de secours Postgres:

  1. Sur le maître Postgres actuel, modifiez le fichier /opt/apigee/customer/application/postgresql.properties pour définir le jeton suivant :
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32
    trust\ \nhost replication apigee new_slave_ip/32 trust

    existing_slave_ip est l'adresse IP du serveur de secours Postgres actuel, et new_slave_ip est l'adresse IP du nouveau nœud de secours.

    Si le fichier postgresql.properties n'existe pas, créez-le et utilisez chown pour permettre à l'utilisateur apigee d'y accéder, comme le montre l'exemple suivant:

    chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
  2. Redémarrez apigee-postgresql sur le maître Postgres :
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Vérifiez que le nouveau nœud de secours a été ajouté en affichant le fichier /opt/apigee/apigee-postgresql/conf/pg_hba.conf sur le maître. Ce fichier doit contenir les lignes suivantes :
    host replication apigee existing_slave_ip/32 trust
    host replication apigee new_slave_ip/32 trust
  4. Installez le nouveau serveur de secours Postgres :
    1. Modifiez le fichier de configuration que vous avez utilisé pour installer votre version actuelle d'Edge afin de spécifier les éléments suivants :
      # IP address of the current master:
      PG_MASTER=192.168.56.103
      # IP address of the new standby node
      PG_STANDBY=192.168.56.102 
    2. Désactivez SELinux comme décrit dans la section Installer l'utilitaire de configuration Edge Apigee.
    3. Téléchargez le fichier Edge bootstrap_4.17.0x (où 4.17.0x correspond à 4.17.01, 4.17.05 ou 4.17.09) sur /tmp/bootstrap_4.17.0x.sh :
      curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
    4. Installez l'utilitaire et les dépendances Edge apigee-service :
      sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName
        apigeepassword=pWord
    5. Utilisez apigee-service pour installer l'utilitaire apigee-setup :
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. Installez Postgres :
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. Sur le nouveau serveur de secours, exécutez la commande suivante :
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Vérifiez qu'il s'agit bien d'une instance de secours.

Mettre hors service un nœud Postgres

Une fois la mise à jour terminée, mettez le nouveau nœud de secours hors service:

  1. Assurez-vous que Postgres est en cours d'exécution:
    > /opt/apigee/apigee-service/bin/apigee-all status

    Si Postgres n'est pas en cours d'exécution, démarrez-le:
    > /opt/apigee/apigee-service/bin/apigee-all start
  2. Obtenez l'UUID du nouveau nœud de secours en exécutant la commande cURL suivante sur le nouveau nœud de secours :
    > curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

    L'identifiant du nœud doit s'afficher à la fin du résultat, sous la forme suivante :

  3. Arrêtez le nouveau nœud de secours en exécutant la commande suivante sur le nouveau nœud de secours:
    > /opt/apigee/apigee-service/bin/apigee-all stop
  4. Sur le nœud maître Postgres, modifiez /opt/apigee/customer/application/postgresql.properties pour supprimer le nouveau nœud de secours de conf_pg_hba_réplication.connection:
    conf_pg_hba_réplication.connection=host réplication apigee existing_slave_ip/32 trust
  5. Redémarrez apigee-postgresql sur le maître Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Vérifiez que le nouveau nœud de secours a été supprimé en affichant le fichier /opt/apigee/apigee-postgresql/conf/pg_hba.conf sur le maître. Vous ne devriez voir que la ligne suivante dans ce fichier:
    host réplication apigee existing_slave_ip/32 trust
  7. Supprimez l'UUID du nœud de secours de ZooKeeper en effectuant l'appel d'API de gestion Edge suivant sur le nœud du serveur de gestion:
    > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

Mettre à jour les prérequis

Avant de mettre à niveau Apigee Edge, remplissez les conditions préalables suivantes:

  • Sauvegarder tous les nœuds
    Avant de procéder à la mise à jour, nous vous recommandons d'effectuer une sauvegarde complète de tous les nœuds pour des raisons de sécurité. Suivez la procédure correspondant à votre version actuelle d'Edge pour effectuer la sauvegarde.

    Cela vous permet de disposer d'un plan de sauvegarde au cas où la mise à jour vers une nouvelle version ne fonctionnerait pas correctement. Pour en savoir plus sur la sauvegarde, consultez la page Sauvegarde et restauration.
  • Assurez-vous qu'Edge est en cours d'exécution
    Assurez-vous qu'Edge est opérationnel pendant le processus de mise à jour à l'aide de la commande suivante:

    > /opt/apigee/apigee-service/bin/apigee-all status

Gérer les échecs de mise à jour

En cas d'échec de la mise à jour, vous pouvez essayer de corriger le problème, puis exécuter à nouveau update.sh. Vous pouvez exécuter la mise à jour plusieurs fois afin de la reprendre là où elle s'était arrêtée.

Si l'échec nécessite un rollback de la mise à jour vers la version précédente, voir 4.18.01 Processus de rollback pour plus d'informations.

Informations sur les mises à jour de Logging

Par défaut, l'utilitaire update.sh écrit les informations de journal dans:

/opt/apigee/var/log/apigee-setup/update.log

Si l'utilisateur qui exécute l'utilitaire update.sh n'a pas accès à ce répertoire, il écrit le journal dans le répertoire /tmp sous la forme d'un fichier nommé update_username.log.

Si l'utilisateur n'a pas accès à /tmp, l'utilitaire update.sh échoue.

Mise à jour sans temps d'arrêt

Une mise à jour sans temps d'arrêt ou une mise à jour progressive vous permet de mettre à jour votre installation Edge sans désactiver Edge.

La mise à jour sans temps d'arrêt n'est possible qu'avec une configuration à cinq nœuds ou plus.

La clé pour une mise à niveau sans temps d'arrêt consiste à supprimer chaque routeur, un par un, de l'équilibreur de charge. Ensuite, mettez à jour le routeur et tous les autres composants sur la même machine que le routeur, puis ajoutez de nouveau le routeur à l'équilibreur de charge.

  1. Mettez à jour les machines dans le bon ordre pour votre installation, comme décrit ci-dessous dans la section "Ordre des mises à jour des machines".
  2. Au moment de mettre à jour les routeurs, sélectionnez un routeur et rendez-le inaccessible, comme décrit dans la section Activer/Désactiver l'accessibilité du serveur (processeur de messages/routeur).
  3. Mettez à jour le routeur sélectionné et tous les autres composants Edge sur la même machine que le routeur. Toutes les configurations Edge montrent un routeur et un processeur de messages sur le même nœud.
  4. Rendez le routeur à nouveau accessible.
  5. Répétez les étapes 2 à 4 pour les autres routeurs.
  6. Continuez la mise à jour pour toutes les machines restantes de votre installation.

Effectuez les actions suivantes avant/après la mise à jour:

  • Sur le nœud à la fois de routeur et de processeur de messages :
    • Avant la mise à jour, effectuez les opérations suivantes :
      1. Rendez le routeur inaccessible.
      2. Rend le processeur de messages inaccessible.
    • Après la mise à jour, procédez comme suit :
      1. Rend le processeur de messages accessible.
      2. Rendez le routeur accessible.
  • Sur un seul nœud de routeur :
    • Avant la mise à jour, rendez le routeur inaccessible.
    • Après la mise à jour, rendez le routeur accessible.
  • Sur un seul nœud de processeur de messages :
    • Avant la mise à jour, rendez le processeur de messages inaccessible.
    • Après la mise à jour, rendez le processeur de messages accessible.

Utilisation d'un fichier de configuration silencieux

Vous devez transmettre un fichier de configuration silencieuse à la commande "update". Le fichier de configuration silencieuse doit être le même que celui que vous avez utilisé pour installer Edge 4.17.0x.

Procédure de mise à jour vers la version 4.18.01 sur un nœud avec une connexion Internet externe

Pour mettre à jour les composants Edge d'un nœud, procédez comme suit:

  1. Si vous utilisez actuellement la réplication en attente maître Postgres avec un stockage local, installez un nouveau nœud de secours Postgres comme décrit ci-dessus dans la section Installer un nouveau nœud de secours Postgres.

    Si vous utilisez le stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Prenez plutôt un instantané réseau du datastore utilisé par Postgres. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.
  2. Le cas échéant, désactivez toutes les tâches CRON configurées pour effectuer une opération de réparation sur Cassandra jusqu'à la fin de la mise à jour.
  3. Connectez-vous à votre nœud en tant qu'utilisateur racine pour installer les RPM Edge.
    Remarque: Bien que l'installation RPM nécessite un accès racine, vous pouvez effectuer une configuration Edge sans accès racine.
  4. Installez yum-utils et yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  5. Désactivez SELinux comme décrit dans la section Installer l'utilitaire de configuration Edge Apigee.
  6. Si vous effectuez l'installation sur Oracle 7.x, exécutez la commande suivante:
    > sudo yum-config-manager --enable ol7_optional_latest
  7. Si vous effectuez l'installation sur AWS, exécutez les commandes yum-configure-manager suivantes:
    > yum update rh-amazon-rhui-client.noarch
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  8. Téléchargez le fichier Edge 4.18.01 bootstrap_4.18.01.sh dans /tmp/bootstrap_4.18.01.sh:
    > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  9. Installez l'utilitaire et les dépendances apigee-service d'Edge 4.18.01:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    uName:pWord correspond au nom d'utilisateur et au mot de passe que vous avez reçus de la part d'Apigee. Si vous omettez pWord, vous serez invité à le faire.

    Par défaut, le programme d'installation vérifie que Java 1.8 est installé. Dans le cas contraire, il l'installe pour vous. Utilisez l'option JAVA_FIX pour indiquer comment gérer l'installation de Java. JAVA_FIX prend les valeurs suivantes:

    I = Installer OpenJDK 1.8 (par défaut)
    C = Continuer sans installer Java
    Q = Quitter. Pour utiliser cette option, vous devez installer Java vous-même.
  10. Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup mise à jour
  11. Mettez à jour l'utilitaire apigee-validate sur le serveur de gestion:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  12. Mettez à jour l'utilitaire apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  13. Exécutez l'utilitaire de mise à jour sur vos nœuds dans l'ordre décrit ci-dessous dans la section Ordre des mises à jour de la machine ci-dessous:
    > /opt/apigee/apigee-setup/bin/update.sh -c composant -f configFile

    La seule condition requise dans le fichier de configuration est qu'il soit accessible ou lisible par l'utilisateur "apigee".

    Utilisez l'option "-c" pour spécifier le composant à mettre à jour. La liste des composants possibles comprend les éléments suivants:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge = tous les composants Edge, à l'exception de l'interface utilisateur Edge: serveur de gestion, de l'API Baastic, du routeur, de la mise à jour de l'API Edge
    le serveur d'API Edge
    ui



  14. Testez la mise à jour en exécutant l'utilitaire apigee-validate sur le serveur de gestion, comme décrit dans la section Tester l'installation.
  15. Si vous avez installé un nouveau nœud de secours Postgres, mettez-le hors service comme décrit ci-dessus dans la section Mise hors service d'un nœud Postgres.

    Si vous utilisez le stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.

Pour annuler la mise à jour ultérieurement, suivez la procédure décrite dans la section 4.18.01 Processus de rollback.

Procédure de mise à jour vers la version 4.18.01 à partir d'un dépôt local

Si vos nœuds périphériques sont protégés par un pare-feu ou qu'ils ne sont pas autorisés à accéder au dépôt Apigee sur Internet, vous pouvez effectuer la mise à jour à partir d'un dépôt local ou en miroir du dépôt Apigee.

Après avoir créé un dépôt Edge local, vous disposez de deux options pour mettre à jour Edge à partir du dépôt local:

  • Créez un fichier .tar du dépôt, copiez-le sur un nœud, puis mettez à jour Edge à partir du fichier .tar.
  • Installez un serveur Web sur le nœud contenant le dépôt local afin que les autres nœuds puissent y accéder. Apigee met à votre disposition le serveur Web Nginx. Vous pouvez aussi utiliser votre propre serveur Web.

Pour effectuer une mise à jour à partir d'un dépôt 4.18.01 local:

  1. Si vous utilisez actuellement la réplication en attente maître Postgres, installez un nouveau nœud de secours Postgres comme décrit ci-dessus dans Installer un nouveau nœud de secours Postgres.

    Si vous utilisez le stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Prenez plutôt un instantané réseau du datastore utilisé par Postgres. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.
  2. Créez un dépôt local 4.18.01 comme décrit dans la section "Créer un dépôt Apigee local" de la section Installer l'utilitaire de configuration d'Apigee Edge.
    Remarque: Si vous disposez déjà d'un dépôt 4.17.0x, vous pouvez y ajouter le dépôt 4.18.01, comme décrit dans la section "Mettre à jour un dépôt Apigee local" dans la section Installer l'utilitaire de configuration Apigee Edge.
  3. Pour installer apigee-service à partir d'un fichier .tar :
    1. Sur le nœud contenant le dépôt local, utilisez la commande suivante pour empaqueter le dépôt local dans un seul fichier .tar nommé /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Copiez le fichier .tar sur le nœud où vous souhaitez mettre à jour Edge. Par exemple, copiez-le dans le répertoire /tmp du nouveau nœud.
    3. Sur le nouveau nœud, décompressez le fichier dans le répertoire /tmp:
      > tar -xzf apigee-4.18.01.tar.gz

      Cette commande crée un nouveau répertoire, nommé "repos", dans le répertoire contenant le fichier .tar. Par exemple, /tmp/repos.
    4. Installez l'utilitaire et les dépendances Edge apigee-service à partir de /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Notez que vous incluez le chemin d'accès au répertoire de dépôts dans cette commande.
  4. Pour installer apigee-service à l'aide du serveur Web Nginx:
    1. Configurez le serveur Web Nginx comme décrit dans la section "Installer à partir du dépôt à l'aide du serveur Web Nginx" de la section Installer l'utilitaire de configuration Edge apigee-setup.
    2. Sur le nœud distant, téléchargez le fichier Edge bootstrap_4.18.01.sh dans /tmp/bootstrap_4.18.01.sh :
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.0

    3. Sur le nœud distant, installez l'utilitaire et les dépendances Edge apigee-service :
      > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeName=http://

  5. Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  6. Mettez à jour l'utilitaire apigee-validate sur le serveur de gestion.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate mise à jour
  7. Mettez à jour l'utilitaire apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. Exécutez l'utilitaire de mise à jour sur vos nœuds dans l'ordre décrit ci-dessous dans la section "Ordre des mises à jour de la machine" ci-dessous:
    > /opt/apigee/apigee-setup/bin/update.sh -c composant -f configFile

    La seule condition requise dans le fichier de configuration est qu'il doit être accessible ou lisible par l'utilisateur "apigee".

    Utilisez l'option "-c" pour spécifier le composant à mettre à jour. La liste des composants possibles comprend les éléments suivants:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge = tous les composants Edge, à l'exception de l'interface utilisateur Edge: serveur de gestion, de l'API Baastic, du routeur, de la mise à jour de l'API Edge
    le serveur d'API Edge
    ui



  9. Testez la mise à jour en exécutant l'utilitaire apigee-validate sur le serveur de gestion, comme décrit dans la section Tester l'installation.
  10. Si vous avez installé un nouveau nœud de secours Postgres, mettez-le hors service comme décrit ci-dessus dans la section Mise hors service d'un nœud Postgres.

    Si vous utilisez le stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.

Pour annuler la mise à jour ultérieurement, suivez la procédure décrite dans la section 4.18.01 Processus de rollback.

Ordre des mises à jour de la machine

L'ordre dans lequel vous mettez à jour les machines dans une installation Edge est important. Voici les points les plus importants à prendre en compte avant une mise à jour:

  • Vous devez mettre à jour tous les nœuds Cassandra et ZooKeeper avant de mettre à jour les autres nœuds.
  • Pour toute machine comportant plusieurs composants Edge (serveur de gestion, processeur de messages, routeur, serveur QPID mais pas serveur Postgres), utilisez l'option "-c bord" pour tous les mettre à jour en même temps.
  • Si une étape indique qu'elle doit être effectuée sur plusieurs machines, exécutez-la dans l'ordre des machines spécifié.
  • Il n'existe aucune étape distincte pour mettre à jour la monétisation. Elle est mise à jour lorsque vous spécifiez l'option "-c bord".

Pour une installation autonome avec un hôte

  1. Si vous effectuez une mise à jour depuis la version 4.17.01, définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre se présente sous la forme suivante:
    SMTPMAILFROM="Mon entreprise <myco@company.com>"
  2. Mettez à jour Cassandra et ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Mettez à jour Qpid:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Mettez à jour LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Arrêtez Postgres Server, le serveur Qpid et PostgreSQL:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  6. Mettez à jour postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. Mettez à jour la base de données Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  8. Mettez à jour les composants Edge restants:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  9. Mettez à jour l'interface utilisateur Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Pour une installation autonome avec deux hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies en périphérie et des nombres de nœuds.

  1. Si vous effectuez une mise à jour depuis la version 4.17.01, définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre se présente sous la forme suivante:
    SMTPMAILFROM="Mon entreprise <myco@company.com>"
  2. Mettez à jour Cassandra et ZooKeeper sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Mettez à jour Qpid sur la machine 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Mettez à jour LDAP sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Mettez à jour les composants Edge sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile
  6. Mettez à jour l'UI sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. Mettez à jour postgresql sur la machine 2 :
    1. Arrêtez Postgres Server, le serveur Qpid et postgresql:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    2. Mettez à jour postgresql:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Mettez à jour la base de données Postgres:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. Mettez à jour les composants Edge sur la machine 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile

Pour une installation en cluster à cinq hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies en périphérie et des nombres de nœuds.

  1. Si vous effectuez une mise à jour depuis la version 4.17.01, définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre se présente sous la forme suivante:
    SMTPMAILFROM="Mon entreprise <myco@company.com>"
  2. Assurez-vous d'avoir installé un nouveau nœud de secours Postgres comme décrit ci-dessus dans la section Installer un nouveau nœud de secours Postgres.

    Si vous utilisez le stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Prenez plutôt un instantané réseau du datastore utilisé par Postgres. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.
  3. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Mettez à jour Qpid sur les machines 4 et 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Mettez à jour LDAP sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Mettez à jour les composants Edge sur les machines 1, 2 et 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Mettez à jour l'UI sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. ??Mettre à jour les machines 4 et 5 :
    1. Arrêtez le serveur Postgres et le serveur Qpid sur la machine 4:
      > /opt/apigee/apigee-service/bin/apigee-service bord-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    2. Arrêtez le serveur Postgres, le serveur Qpid et postgresql sur la machine 5:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
      > /opt/apigee/apigee-service/bin/apigee-service stopsql
      apigee-postgre
    3. Si installés, arrêtez le serveur Postgres et postgresql sur le nouveau nœud de secours que vous avez ajouté pour le rollback:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. Mettez à jour postgresql sur les machines 4:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Mettez à jour la base de données Postgres sur la machine 4 (maître PostgreSQL uniquement):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. Mettez à jour postgresql sur les machines 5:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Démarrez le serveur Postgres et le serveur Qpid sur les machines 4 et 5:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    8. Configurez Postgres en tant que nœud de secours en exécutant les commandes suivantes sur la machine 5:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-réplication-on-standby -f
      configFile
    9. Vérifiez l'état de la réplication en émettant les scripts suivants sur les deux serveurs. Le système doit afficher des résultats identiques sur les deux serveurs pour assurer une réplication réussie:

      Sur la machine 4, le nœud maître, exécutez la commande suivante:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Vérifiez qu'il s'agit bien du nœud maître.

      Sur la machine 5, le nœud de secours:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Vérifiez qu'il indique qu'il s'agit bien du nœud de secours.
  9. Mettez à jour les composants Edge sur la machine 4, 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile
  10. Assurez-vous de mettre le nouveau nœud de secours hors service en suivant la procédure ci-dessus dans la section Mise hors service d'un nœud Postgres.

    Si vous utilisez le stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.

Pour une installation en cluster avec neuf hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies en périphérie et des nombres de nœuds.

  1. Si vous effectuez une mise à jour depuis la version 4.17.01, définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre se présente sous la forme suivante:
    SMTPMAILFROM="Mon entreprise <myco@company.com>"
  2. Assurez-vous d'avoir installé un nouveau nœud de secours Postgres comme décrit ci-dessus dans la section Installer un nouveau nœud de secours Postgres.

    Si vous utilisez le stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Prenez plutôt un instantané réseau du datastore utilisé par Postgres. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.
  3. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Mettez à jour Qpid sur les machines 6 et 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Mettez à jour LDAP sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Mettez à jour les composants Edge sur les machines 6, 7, 1, 4 et 5, dans cet ordre:
    > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile
  7. Mettez à jour l'UI sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile?
  8. Mettre à jour les machines 8 et 9 :
    1. Arrêtez le serveur Postgres sur la machine 8:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    2. Arrêtez le serveur Postgres et postgresql sur la machine 9:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Arrêtez le serveur Qpid sur les machines 6 et 7:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. Si installés, arrêtez le serveur Postgres et postgresql sur le nouveau nœud de secours que vous avez ajouté pour le rollback:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Mettez à jour postgresql sur les machines 8:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Mettez à jour la base de données Postgres sur la machine 8 (maître PostgreSQL uniquement):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Mettez à jour postgresql sur les machines 9:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Démarrez le serveur Postgres sur les machines 8 et 9:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. Démarrez le serveur Qpid sur les machines 6 et 7:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Configurez Postgres en tant que nœud de secours en exécutant les commandes suivantes sur la machine 9:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-réplication-on-standby -f
      configFile
    11. Vérifiez l'état de la réplication en émettant les scripts suivants sur les deux serveurs. Le système doit afficher des résultats identiques sur les deux serveurs pour assurer une réplication réussie:
      Sur la machine 8, le nœud maître, exécutez la commande suivante:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Vérifiez qu'il s'agit bien du nœud maître.

      Sur la machine 9, le nœud de secours:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Vérifiez qu'il indique qu'il s'agit bien du nœud de secours.
  9. Mettez à jour les composants Edge sur les machines 8 et 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile
  10. Assurez-vous de mettre le nouveau nœud de secours hors service en suivant la procédure ci-dessus dans la section Mise hors service d'un nœud Postgres.

    Si vous utilisez le stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.

Pour une installation en cluster avec 13 hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies en périphérie et des nombres de nœuds.

  1. Si vous effectuez une mise à jour depuis la version 4.17.01, définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre se présente sous la forme suivante:
    SMTPMAILFROM="Mon entreprise <myco@company.com>"
  2. Assurez-vous d'avoir installé un nouveau nœud de secours Postgres comme décrit ci-dessus dans la section Installer un nouveau nœud de secours Postgres.

    Si vous utilisez le stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Prenez plutôt un instantané réseau du datastore utilisé par Postgres. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.
  3. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Mettez à jour Qpid sur les machines 12 et 13:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Mettez à jour LDAP sur les machines 4 et 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Mettez à jour les composants Edge sur les machines 12, 13, 6, 7, 10 et 11, dans cet ordre:
    > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile
  7. Mettez à jour l'UI sur les machines 6 et 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile??
  8. Mettre à jour les machines 8 et 9 :
    1. Arrêtez le serveur Postgres sur la machine 8:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    2. Arrêtez le serveur Postgres et postgresql sur la machine 9:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Arrêtez le serveur Qpid sur les machines 12 et 13:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. Si installés, arrêtez le serveur Postgres et postgresql sur le nouveau nœud de secours que vous avez ajouté pour le rollback:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Mettez à jour postgresql sur les machines 8:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Mettez à jour la base de données Postgres sur la machine 8 (maître PostgreSQL uniquement):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Mettez à jour postgresql sur les machines 9:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Démarrez le serveur Postgres sur les machines 8 et 9:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. Démarrez le serveur Qpid sur les machines 12 et 13:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Configurez Postgres en tant que nœud de secours en exécutant les commandes suivantes sur la machine 9:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-réplication-on-standby -f
      configFile
    11. Vérifiez l'état de la réplication en émettant les scripts suivants sur les deux serveurs. Le système doit afficher des résultats identiques sur les deux serveurs pour assurer une réplication réussie:
      Sur la machine 8, le nœud maître, exécutez la commande suivante:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Vérifiez qu'il s'agit bien du nœud maître.

      Sur la machine 9, le nœud de secours:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Vérifiez qu'il indique qu'il s'agit bien du nœud de secours.
  9. Mettez à jour les composants Edge sur les machines 8 et 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile??
  10. Assurez-vous de mettre le nouveau nœud de secours hors service en suivant la procédure ci-dessus dans la section Mise hors service d'un nœud Postgres.

    Si vous utilisez le stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.

Pour une installation en cluster avec 12 hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies en périphérie et des nombres de nœuds.

  1. Si vous effectuez une mise à jour depuis la version 4.17.01, définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre se présente sous la forme suivante:
    SMTPMAILFROM="Mon entreprise <myco@company.com>"
  2. Assurez-vous d'avoir installé un nouveau nœud de secours Postgres comme décrit ci-dessus dans la section Installer un nouveau nœud de secours Postgres.

    Si vous utilisez le stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Prenez plutôt un instantané réseau du datastore utilisé par Postgres. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.
  3. Mettez à jour Cassandra et ZooKeeper :
    1. Sur les machines 1, 2 et 3 du centre de données 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Sur les machines 7, 8 et 9 du centre de données 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Mettez à jour qpidd :
    1. Machines 4 et 5 dans le centre de données 1
      1. Mettez à jour qpidd sur la machine 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Répétez l'étape 1 sur la machine 5.
    2. Machines 10 et 11 du centre de données 2
      1. Mettez à jour qpidd sur la machine 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Répétez l'étape 1 sur la machine 11.
  5. Mettez à jour LDAP :
    1. Machines 1 dans le centre de données 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Machines 7 dans le centre de données 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Mettez à jour les composants Edge :
    1. Machines 4, 5, 1, 2, 3 dans le centre de données 1
      > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile
    2. Machines 10, 11, 7, 8, 9 dans le centre de données 2
      > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile
  7. Mettez à jour l'interface utilisateur :
    1. Machine 1 dans le centre de données 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. Machine 7 dans le centre de données 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. ?Mettre à jour la machine 6 dans les centres de données 1 et 12 dans le centre de données 2 :
    1. Arrêtez le serveur Postgres sur la machine 6:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    2. Arrêtez le serveur Postgres et postgresql sur la machine 12:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Arrêtez le serveur Qpid sur les machines 4, 5, 10 et 11:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. Si installés, arrêtez le serveur Postgres et postgresql sur le nouveau nœud de secours que vous avez ajouté pour le rollback:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Mettez à jour postgresql sur les machines 6:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Mettez à jour la base de données Postgres sur la machine 6 (maître PostgreSQL uniquement):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Mettez à jour postgresql sur les machines 12:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Démarrez le serveur Postgres sur les machines 6 et 12:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. Démarrez le serveur Qpid sur les machines 4, 5, 10 et 11:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Configurez Postgres en tant que nœud de secours en exécutant les commandes suivantes sur la machine 12:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-réplication-on-standby -f
      configFile
    11. Vérifiez l'état de la réplication en émettant les scripts suivants sur les deux serveurs. Le système doit afficher des résultats identiques sur les deux serveurs pour assurer une réplication réussie:
      Sur la machine 6, le nœud maître, exécutez la commande suivante:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Vérifiez qu'il s'agit bien du nœud maître.

      Sur la machine 12, le nœud de secours:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Vérifiez qu'il indique qu'il s'agit bien du nœud de secours.
  9. Mettez à jour les composants Edge sur les machines 6 et 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. Assurez-vous de mettre le nouveau nœud de secours hors service en suivant la procédure ci-dessus dans la section Mise hors service d'un nœud Postgres.

    Si vous utilisez le stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.

Pour une installation d'API BaaS à sept hôtes

  1. Définissez SMTPMAILFROM dans votre fichier de configuration. Ce paramètre se présente sous la forme suivante:
    SMTPMAILFROM="Mon entreprise <myco@company.com>"
  2. Mettez à jour Cassandra sur les machines 5, 6 et 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  3. Mettez à jour ElasticSearch et la pile BaaS d'API sur les machines 1, 2 et 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

  4. Mettez à jour le portail BaaS de l'API sur la machine 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Pour une installation d'API BaaS avec 10 hôtes

  1. Définissez SMTPMAILFROM dans votre fichier de configuration. Ce paramètre se présente sous la forme suivante:
    SMTPMAILFROM="Mon entreprise <myco@company.com>"
  2. Mettez à jour Cassandra sur les machines 8, 9 et 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  3. Mettez à jour ElasticSearch sur les machines 1, 2 et 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  4. Mettez à jour la pile BaaS de l'API sur les machines 4, 5 et 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  5. Mettez à jour le portail BaaS de l'API sur la machine 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Pour une installation Baas de deux centres de données utilisant l'API

Cette procédure nécessite la mise à jour des nœuds Cassandra dans les deux centres de données. Si vous partagez ces nœuds Cassandra avec Edge, vous mettez généralement à jour ces nœuds dans le cadre de la mise à jour de Edge.

  1. Définissez SMTPMAILFROM dans vos fichiers de configuration. Ce paramètre se présente sous la forme suivante:
    SMTPMAILFROM="Mon entreprise <myco@company.com>"
  2. Mettre à jour les espaces de clés Cassandra avec un facteur de réplication approprié pour les deux centres de données Vous n'avez besoin d'exécuter cette étape qu'une seule fois sur un serveur Cassandra de l'un ou l'autre des centres de données:

    Remarque: Les commandes ci-dessous définissent toutes le facteur de réplication sur "3", ce qui indique trois nœuds Cassandra du cluster. Modifiez cette valeur si nécessaire pour votre installation.
    1. Lancez l'utilitaire Cassandra cqlsh:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Exécutez les commandes CQL suivantes dans l'invite "cqlsh>" pour définir les niveaux de réplication des espaces de clés Cassandra :
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH réplication = { 'class': 'NetworkTopology', 'dc-1': '3','dc-2': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas" WITH réplication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. cqlsh> ALTER KEYSPACE "Apigee_Baas_Locks" avec réplication = { 'class': 'NetworkTopology', 'dc-1': '3','dc-2': '3' };
      4. cqlsh> ALTER KEYSPACE "system_traces" WITH réplication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      5. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH réplication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      6. Affichez les espaces de clés à l'aide de la commande suivante:
        cqlsh> select * from system.schema_keyspaces;
      7. Quittez cqlsh:
        cqlsh> exit.
  3. (Uniquement si vous n'avez pas mis à jour Cassandra lors de la mise à jour d'Edge) Mettez à jour les nœuds Cassandra dans le centre de données 1, une machine à la fois:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  4. (Uniquement si vous n'avez pas mis à jour Cassandra lors de la mise à jour d'Edge) Mettez à jour les nœuds Cassandra dans le centre de données 2, une machine à la fois:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. Mettez à jour ElasticSearch sur les machines du centre de données 1, une machine à la fois:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  6. Mettez à jour ElasticSearch sur les machines du centre de données 2, une machine à la fois:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  7. Mettez à jour la pile BaaS de l'API sur les machines du centre de données 1, une machine à la fois:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  8. Mettez à jour la pile BaaS de l'API sur les machines du centre de données 2, une machine à la fois:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  9. Mettez à jour le portail BaaS de l'API sur les machines du centre de données 1, une machine à la fois:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  10. Mettez à jour le portail BaaS d'API sur les machines du centre de données 2, une machine à la fois:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  11. Met à jour les valeurs de l'espace clé BaaS. Cet espace de clés doit être défini pour la réplication au moment de l'installation, mais pas au moment de l'exécution. La suppression de la réplication permet également d'économiser la mémoire Cassandra.

    Vous n'avez besoin d'exécuter cette étape qu'une seule fois sur un serveur Cassandra de l'un des centres de données :
    1. Lancez l'utilitaire Cassandra cqlsh:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Exécutez les commandes CQL suivantes pour définir les niveaux de réplication des espaces de clés Cassandra :
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH réplication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH réplication = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
      3. Affichez les espaces de clés à l'aide de la commande suivante:
        cqlsh> select * from system.schema_keyspaces;
      4. Quittez cqlsh:
        cqlsh> exit

Pour une installation non standard

Si votre installation n'est pas standard, mettez à jour les composants Edge dans l'ordre suivant:

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Edge, c'est-à-dire le profil "-c Edge" sur tous les nœuds de l'ordre: nœuds avec serveur Qpid, serveur Postgres, serveur de gestion, processeur de messages et routeur.
    Remarque: Si le serveur Qpid et le serveur Postgres sont installés sur le nœud, exécutez l'étape de profil "-c bord".
  6. Interface utilisateur périphérique
Mise à jour d'Apigee Edge 4.17.01/4.17.05 vers la version 4.17.09