Mettre à jour Apigee Edge 4.51.00 ou 4.52.00 vers 4.52.01

Apigee permet de mettre à niveau Edge for Private Cloud de la version 4.51.00 ou 4.52.00 directement vers la version 4.52.01. Cette page explique comment effectuer l'une ou l'autre de ces mises à niveau.

Qui peut effectuer la mise à jour

La personne qui exécute la mise à jour doit être la même que celle qui a installé Edge à l'origine, ou une personne exécutant la mise à jour en tant qu'utilisateur racine.

Une fois les RPM Edge installés, n'importe qui peut les configurer.

Quels composants devez-vous mettre à jour

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

Conditions préalables à la mise à jour

Assurez-vous de remplir les conditions préalables suivantes avant de mettre à niveau Apigee Edge :

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

    Cela vous permet de disposer d'un plan de secours au cas où la mise à jour vers une nouvelle version ne fonctionnerait pas correctement. Pour en savoir plus sur la sauvegarde, consultez Sauvegarde et restauration.

  • S'assurer 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
  • Assurez-vous que la stratégie de compactage Cassandra est définie sur LeveledCompactionStrategy
    Assurez-vous que la stratégie de compactage Cassandra est définie sur LeveledCompactionStrategy, comme décrit dans Modifier la stratégie de compactage Cassandra.

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 par la mise à jour.

Mise à niveau requise vers Zookeeper 3.8.3

Cette version d'Edge for Private Cloud inclut une mise à niveau vers Zookeeper 3.8.3. Dans le cadre de cette mise à niveau, toutes les données Zookeeper seront migrées vers Zookeeper 3.8.3.

Avant de mettre à niveau ZooKeeper, lisez le guide de maintenance de ZooKeeper. La plupart des systèmes de production Edge utilisent un cluster de nœuds Zookeeper répartis sur plusieurs centres de données. Certains de ces nœuds sont configurés en tant que votants qui participent à l'élection du leader ZooKeeper, et les autres sont configurés en tant qu'observateurs. Pour en savoir plus, consultez À propos des leaders, des followers, des votants et des observateurs. Les nœuds votants élisent un leader, après quoi les nœuds votants eux-mêmes deviennent des suiveurs.

Pendant le processus de mise à jour, il peut y avoir un retard momentané ou un échec d'écriture dans ZooKeeper lorsque le nœud leader est arrêté. Cela peut affecter les opérations de gestion qui écrivent dans ZooKeeper, telles que l'opération de déploiement d'un proxy, et les modifications de l'infrastructure Apigee, telles que l'ajout ou la suppression d'un processeur de messages, etc. Les API d'exécution d'Apigee ne devraient pas être affectées (sauf si ces API d'exécution appellent des API de gestion) lors de la mise à niveau de ZooKeeper en suivant la procédure ci-dessous.

Globalement, le processus de mise à niveau implique d'effectuer une sauvegarde de chaque nœud. Ensuite, tous les observateurs et les suiveurs sont mis à niveau, et enfin le nœud leader.

Effectuer une sauvegarde

Sauvegardez tous les nœuds de ZooKeeper pour pouvoir les utiliser en cas de rollback. Notez qu'un rollback restaure ZooKeeper à l'état dans lequel il se trouvait au moment de la sauvegarde. Remarque : Tout déploiement ou modification d'infrastructure dans Apigee depuis la création de la sauvegarde (dont les informations sont stockées dans ZooKeeper) sera perdu lors de la restauration. 

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

Si vous utilisez des machines virtuelles et que vous en avez la possibilité, vous pouvez également créer des instantanés ou des sauvegardes de VM pour la restauration ou le rollback (si nécessaire).

Identifier le leader, les followers et les observateurs

Remarque : Les exemples de commandes ci-dessous utilisent l'utilitaire nc pour envoyer des données à ZooKeeper. Vous pouvez également utiliser d'autres utilitaires pour envoyer des données à ZooKeeper.

  1. S'il n'est pas installé sur le nœud ZooKeeper, installez nc : 
      sudo yum install nc
  2. Exécutez la commande nc suivante sur le nœud, où 2181 est le port ZooKeeper : 
      echo stat | nc localhost 2181

    Vous devriez voir une sortie semblable à ce qui suit.

      Zookeeper version: 3.8.3-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597

    Sur la ligne Mode du résultat pour les nœuds, vous devriez voir "observer", "leader" ou "follower" (c'est-à-dire un votant qui n'est pas le leader) selon la configuration du nœud. Remarque : Dans une installation autonome d'Edge avec un seul nœud ZooKeeper, Mode est défini sur "standalone".

  3. Répétez les étapes 1 et 2 sur chaque nœud ZooKeeper.

Mettre à niveau ZooKeeper sur les nœuds d'observation et de suivi

Mettez à niveau ZooKeeper sur chacun des nœuds d'observateur et de suiveur comme suit :

  1. Téléchargez et exécutez le bootstrap d'Edge for Private Cloud 4.52, comme décrit dans Mettre à jour vers la version 4.52.01 sur un nœud disposant d'une connexion Internet externe. Le processus varie probablement selon que le nœud dispose d'une connexion Internet externe ou que vous effectuez une installation hors connexion.
  2. Mettez à niveau le composant Zookeeper : 
      /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
     Remarque : Si d'autres composants sont installés sur ces nœuds (comme Cassandra), vous pouvez également les mettre à niveau maintenant (comme avec le profil cs,zk) ou plus tard. Apigee vous recommande de ne mettre à niveau que ZooKeeper dans un premier temps et de vous assurer que votre cluster fonctionne correctement avant de mettre à niveau d'autres composants.
  3. Répétez les étapes ci-dessus sur chacun des nœuds d'observateur et de suiveur ZooKeeper.

Arrêter le leader

Une fois que tous les nœuds observateurs et suiveurs ont été mis à niveau, arrêtez le leader. Sur le nœud identifié comme leader, exécutez la commande ci-dessous : 

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Notez que pendant cet événement, avant qu'un nouveau leader ne soit élu, il peut y avoir des retards momentanés ou des échecs d'écriture dans ZooKeeper. Cela peut affecter les opérations qui écrivent dans ZooKeeper, telles que l'action de déploiement de proxys ou les modifications de l'infrastructure Apigee, comme l'ajout ou la suppression de processeurs de messages, etc.

Vérifier que le nouveau leader est élu

En suivant la procédure décrite dans la section Identifier le leader, les followers et les observateurs ci-dessus, vérifiez qu'un nouveau leader a été élu parmi les followers une fois que le leader existant est arrêté. Notez que le leader peut avoir été élu dans un centre de données différent de celui du leader actuel.

Mettre à niveau le leader

Suivez la même procédure que dans la section Mettre à niveau ZooKeeper sur les nœuds d'observateur et de suiveur ci-dessus.

Une fois l'ancien nœud leader mis à niveau, vérifiez l'état du cluster et assurez-vous qu'il existe un nœud leader.

Rollback

Si un rollback est nécessaire :

  1. Effectuez d'abord les étapes de rollback sur les observateurs et les followers.
  2. Téléchargez et exécutez le bootstrap de la version vers laquelle vous effectuez le rollback (4.50 ou 4.51). Le processus varie probablement selon que le nœud dispose d'une connexion Internet externe ou que vous suivez une installation hors connexion.
  3. Arrêtez ZooKeeper s'il est en cours d'exécution sur le nœud : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. Désinstallez le service ZooKeeper existant : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
  5. Installez Zookeeper comme d'habitude : 
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  6. Une fois que tous les nœuds suiveurs et observateurs ont été restaurés, restaurez le nœud leader en suivant les étapes 2 à 5 sur le nœud leader.
  7. Une fois tous les nœuds restaurés, vérifiez l'état du cluster et assurez-vous qu'il contient un nœud leader.

Restaurer une sauvegarde

Consultez Restaurer à partir d'une sauvegarde. Notez que les sauvegardes de Zookeeper effectuées à partir de versions antérieures d'Edge for Private Cloud, telles que 4.50 et 4.51, doivent être compatibles avec la version de Zookeeper dans Edge for Private Cloud 4.52.

Mise à niveau requise vers Postgres 14

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

  • Si vous passez d'Edge for Private Cloud 4.51.00 à la version 4.52.01, vous devez suivre des étapes supplémentaires de mise à niveau de Postgres. Consultez la section Mise à niveau requise vers Postgres 14 si vous effectuez une mise à niveau de la version 4.51.00 vers la version 4.52.01.
  • Si vous passez d'Edge for Private Cloud 4.52.00 à la version 4.52.01, aucune étape de mise à niveau supplémentaire de Postgres n'est nécessaire.

Mettre à niveau Qpid

Cette version d'Edge for Private Cloud inclut une mise à niveau vers Qpid J-Broker.

Nous vous recommandons de sélectionner l'une des méthodes suivantes pour effectuer la mise à niveau de Qpid :

Mise à niveau sur place sans temps d'arrêt

Cette méthode garantit l'absence de temps d'arrêt pour votre environnement d'exécution Edge et minimise la perte de données d'exécution, le cas échéant, acquises pour l'analyse.

Pour effectuer une mise à niveau sur place sans temps d'arrêt vers Qpid :

  1. Choisissez un nœud Qpid pour commencer.
  2. Arrêtez l'agent Qpid sur le nœud : 
    apigee-service apigee-qpidd stop
  3. Bloquez le trafic entrant sur le port de l'agent 5672 à partir de tous les processeurs de messages en appliquant un pare-feu. Vous pouvez appliquer ce pare-feu au niveau de l'instance de nœud Qpid ou d'un autre composant de pare-feu/réseau externe.

    Nous vous recommandons d'effectuer la même étape pour toutes les adresses IP des processeurs de messages. Par exemple, pour supprimer les requêtes provenant des adresses IP du processeur de messages vers le nœud Qpid sur le port 5672 à l'aide d'IPTables, vous pouvez utiliser une commande de ce type :

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  4. Redémarrez le broker Qpid pour drainer les messages existants, le cas échéant : 
    apigee-service apigee-qpidd start
  5. Vérifiez que les files d'attente existantes sont vides : 
    qpid-stat -q

    Si des messages sont bloqués dans la file d'attente de lettres mortes (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), videz la file d'attente en suivant les étapes pour résoudre les problèmes de données d'analyse bloquées dans la file d'attente de lettres mortes.

  6. Après avoir vérifié que les files d'attente ont été vidées sur l'ancien nœud, arrêtez apigee-qpidd : 
    apigee-service apigee-qpidd stop
  7. Mettez à niveau Qpid sur le nœud : 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Redémarrez edge-qpid-server : 
    apigee-service edge-qpid-server restart

  9. Supprimez la règle de pare-feu appliquée à l'étape 3.

    Effectuez la même étape de suppression pour toutes les adresses IP du processeur de messages auxquelles le pare-feu a été appliqué. Une fois les pare-feu supprimés, les requêtes provenant des adresses IP du processeur de messages vers le nœud Qpid sur le port 5672 seront acceptées. Si vous avez utilisé iptables pour ajouter le pare-feu, vous pouvez utiliser des commandes comme celles-ci pour supprimer le pare-feu et lister les paramètres existants :

    iptables -F
  iptables -L
  10. Utilisez la surveillance Web pour vérifier que les files d'attente Qpid reçoivent des messages : 
    http://QPID_NODE_IP:8090
  11. Répétez les étapes 1 à 9 pour chaque nœud Qpid.

Mettre en service un nouveau nœud Qpid

Cette méthode configure et installe apigee-qpidd et edge-qpid-server sur un nouveau nœud.

  1. Ajoutez un nœud Qpid. Cette étape configure un nœud Qpid avec J-broker. Pour connaître la procédure détaillée, consultez Ajouter un serveur Qpid.
  2. Choisissez un nœud Qpid existant (un nœud de la version à partir de laquelle vous effectuez la mise à niveau).
  3. Arrêtez l'agent Qpid sur le nœud : 
    apigee-service apigee-qpidd stop
  4. Bloquez le trafic entrant sur le port de l'agent 5672 à partir de tous les processeurs de messages en appliquant un pare-feu. Vous pouvez appliquer ce pare-feu au niveau de l'instance de nœud Qpid ou d'un autre composant de pare-feu/réseau externe.

    Nous vous recommandons d'effectuer la même étape pour toutes les adresses IP des processeurs de messages. Par exemple, pour supprimer les requêtes provenant des adresses IP du processeur de messages vers le nœud Qpid sur le port 5672 à l'aide d'IPTables, vous pouvez utiliser une commande de ce type :

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  5. Redémarrez le broker Qpid pour drainer les messages existants, le cas échéant : 
    apigee-service apigee-qpidd start
  6. Vérifiez que les files d'attente existantes sont vides : 
    qpid-stat -q

    Si des messages sont bloqués dans la file d'attente de lettres mortes (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), videz la file d'attente en suivant les étapes décrites dans la section Données d'analyse bloquées dans la file d'attente de lettres mortes Qpidd de la rubrique de dépannage.

  7. Après avoir vérifié que les files d'attente ont été vidées sur l'ancien nœud, arrêtez apigee-qpidd. 
    apigee-service apigee-qpidd stop
  8. Annulez l'enregistrement de l'ancien nœud Qpid en suivant la procédure décrite dans Supprimer un serveur Qpid.
  9. Continuez à ajouter un nœud et à en supprimer un, un par un, jusqu'à ce que tous les nœuds Qpid aient été mis à niveau.

Rollback

Pour effectuer un rollback vers une version de fonctionnalité précédente, veillez à télécharger le fichier bootstrap.sh de la version vers laquelle vous souhaitez effectuer un rollback. Pour revenir à la version 4.52.00, téléchargez bootstrap_4.52.00.sh.

Pour effectuer un rollback de Qpid, procédez comme suit sur tous les hôtes Qpid :

  1. Arrêter l'agent Qpid existant 
    apigee-service apigee-qpidd stop
  2. Bloquez le trafic entrant sur le port de l'agent 5672 à partir de tous les processeurs de messages en appliquant un pare-feu. Vous pouvez appliquer ce pare-feu au niveau de l'instance de nœud Qpid ou d'un autre composant de pare-feu/réseau externe.

    Nous vous recommandons d'effectuer la même étape pour toutes les adresses IP des processeurs de messages. Par exemple, pour supprimer les requêtes provenant des adresses IP du processeur de messages vers le nœud Qpid sur le port 5672 à l'aide d'IPTables, vous pouvez utiliser une commande de ce type :

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  3. Redémarrez le broker qpid pour drainer les messages existants, le cas échéant : 
    apigee-service apigee-qpidd start
  4. Assurez-vous que les files d'attente existantes sont vides. Pour le vérifier, connectez-vous au portail de gestion Qpid : 
    http://QPID_NODE_IP:8090
     Remarque : Si le port 8090 du nœud QPID n'est pas accessible, vous pouvez utiliser d'autres mécanismes, tels que le transfert de port SSH, pour accéder à cette URL.
  5. Après avoir vérifié que les files d'attente ont été vidées, arrêtez et désinstallez Qpid : 
    apigee-service apigee-apidd uninstall
  6. Supprimez le répertoire de données Qpid : 
    rm -r APIGEE_ROOT/data/apigee-qpidd
  7. Réinstallez l'agent Qpid : 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  8. Une fois l'agent Qpid réinstallé, supprimez les paramètres de pare-feu et listez les paramètres existants à l'aide des commandes suivantes : 
    iptables -F
     
    iptables -L

Nouvelle interface utilisateur Edge

Cette section répertorie les points à prendre en compte concernant l'interface utilisateur Edge. Pour en savoir plus, consultez Nouvelle interface utilisateur Edge pour Private Cloud.

Installer l'interface utilisateur Edge

Une fois l'installation initiale terminée, Apigee vous recommande d'installer l'UI Edge, qui est une interface utilisateur améliorée pour les développeurs et les administrateurs d'Apigee Edge pour Private Cloud.

Notez que l'UI Edge nécessite de désactiver l'authentification de base et d'utiliser un IDP tel que SAML ou LDAP.

Pour en savoir plus, consultez Installer la nouvelle interface utilisateur Edge.

Mettre à jour l'interface utilisateur Edge

Pour mettre à jour le composant de l'interface utilisateur Edge, tenez compte de la version d'Edge for Private Cloud à partir de laquelle vous effectuez la mise à niveau :

Mettre à jour avec Apigee mTLS

Pour mettre à jour Apigee mTLS, procédez comme suit :

Restaurer une 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. Elle reprend là où elle s'est arrêtée.

Si l'échec nécessite d'effectuer un rollback de la mise à jour vers la version précédente, consultez Effectuer un rollback de la version 4.52.00 pour obtenir des instructions détaillées.

Informations sur la mise à jour de la journalisation

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

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

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

Si la personne 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 mise à jour progressive, vous permet de mettre à jour votre installation Edge sans arrêter Edge.

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

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

  1. Mettez à jour les machines dans l'ordre approprié pour votre installation, comme décrit dans la section Ordre de mise à jour des machines.
  2. Lorsque vous devez 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 affichent 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 routeurs restants.
  6. Poursuivez la mise à jour pour toutes les machines restantes de votre installation.

Avant et après la mise à jour, tenez compte des points suivants :

Utiliser un fichier de configuration silencieuse

Vous devez transmettre un fichier de configuration silencieuse à la commande de mise à jour. Le fichier de configuration silencieuse doit être le même que celui que vous avez utilisé pour installer Edge 4.50.00 ou 4.51.00.

Mettre à jour vers la version 4.52.01 sur un nœud disposant d'une connexion Internet externe

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

  1. 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.
  2. Connectez-vous à votre nœud en tant qu'utilisateur racine pour installer les RPM Edge.
  3. Installez yum-utils et yum-plugin-priorities : 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Désactivez SELinux comme décrit dans Installer l'utilitaire apigee-setup d'Edge.
  5. Si vous effectuez l'installation sur Oracle 7.x, exécutez la commande suivante : 
    sudo yum-config-manager --enable ol7_optional_latest
  6. 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

  7. Si vous utilisez actuellement Edge 4.51.00 :

    1. Téléchargez le fichier Edge bootstrap_4.52.01.sh dans /tmp/bootstrap_4.52.01.sh : 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
    2. Installez l'utilitaire apigee-service Edge 4.52.01 et ses dépendances en exécutant la commande suivante : 
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

      Où uName:pWord sont le nom d'utilisateur et le mot de passe que vous avez reçus d'Apigee. Si vous omettez pWord, vous serez invité à le saisir.

      Par défaut, le programme d'installation vérifie que Java 1.8 est installé. Si ce n'est pas le cas, le programme d'installation l'installe pour vous.

      Utilisez l'option JAVA_FIX pour spécifier comment gérer l'installation de Java. JAVA_FIX accepte les valeurs suivantes :

      • I : installez OpenJDK 1.8 (par défaut).
      • C : continuer sans installer Java.
      • Q : quitter. Pour cette option, vous devez installer Java vous-même.
    3. Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup, comme illustré dans l'exemple suivant : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. Mettez à jour l'utilitaire apigee-validate sur le serveur de gestion, comme illustré dans l'exemple suivant : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. Mettez à jour l'utilitaire apigee-provision sur le serveur de gestion, comme illustré dans l'exemple suivant : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. Exécutez l'utilitaire update sur vos nœuds en exécutant la commande suivante : 
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      Pour ce faire, suivez l'ordre décrit dans Ordre de mise à jour des machines.

      Où :

      • component est le composant Edge à mettre à jour. Les valeurs possibles sont les suivantes :
        • cs : Cassandra
        • edge : tous les composants Edge, à l'exception de l'interface utilisateur Edge : serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgres
        • ldap : OpenLDAP
        • ps : postgresql
        • qpid : qpidd
        • sso : Apigee SSO (si vous avez installé l'authentification unique)
        • ue : nouvelle interface utilisateur Edge
        • ui : UI Edge classique
        • zk : ZooKeeper
      • configFile est le même fichier de configuration que celui que vous avez utilisé pour définir vos composants Edge lors de l'installation de la version 4.50.00 ou 4.51.00.

      Vous pouvez exécuter update.sh sur tous les composants en définissant component sur "all", mais uniquement si vous disposez d'un profil d'installation Edge tout-en-un (AIO). Exemple :

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
    7. Redémarrez les composants de l'UI Edge sur tous les nœuds qui les exécutent, si vous ne l'avez pas déjà fait : 
      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
    8. Testez la mise à jour en exécutant l'utilitaire apigee-validate sur le serveur de gestion, comme décrit dans Tester l'installation.

Si vous décidez ultérieurement d'annuler la mise à jour, suivez la procédure décrite dans Annuler la version 4.52.01.

Mettre à jour vers la version 4.52.01 à partir d'un dépôt local

Si vos nœuds Edge se trouvent derrière un pare-feu ou si l'accès au dépôt Apigee via Internet est interdit, vous pouvez effectuer la mise à jour à partir d'un dépôt local ou d'un 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 avec le dépôt local afin que les autres nœuds puissent y accéder. Apigee fournit le serveur Web Nginx, mais vous pouvez également utiliser votre propre serveur Web.

Pour effectuer la mise à jour à partir d'un dépôt 4.52.01 local :

  1. Créez un dépôt 4.52.01 local comme décrit dans la section "Créer un dépôt Apigee local" de la page Installer l'utilitaire apigee-setup d'Edge.
  2. Pour installer apigee-service à partir d'un fichier .tar :
    1. Sur le nœud avec 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.52.01.tar.gz : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Copiez le fichier .tar sur le nœud sur lequel 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.52.01.tar.gz

      Cette commande crée un répertoire nommé repos dans le répertoire contenant le fichier .tar. Exemple : /tmp/repos.

    4. Installez l'utilitaire et les dépendances Edge apigee-service à partir de /tmp/repos : 
      sudo bash /tmp/repos/bootstrap_4.52.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Notez que vous incluez le chemin d'accès au répertoire "repos" dans cette commande.

  3. 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 page Installer l'utilitaire apigee-setup d'Edge.
    2. Sur le nœud distant, téléchargez le fichier Edge bootstrap_4.52.01.sh dans /tmp/bootstrap_4.52.01.sh : 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh

      Où uName:pWord correspond au nom d'utilisateur et au mot de passe que vous avez définis précédemment pour le dépôt, et remoteRepo correspond à l'adresse IP ou au nom DNS du nœud du dépôt.

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

      Où uName:pWord sont le nom d'utilisateur et le mot de passe du dépôt.

  4. Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup, comme illustré dans l'exemple suivant : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Mettez à jour l'utilitaire apigee-validate sur le serveur de gestion, comme illustré dans l'exemple suivant : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Mettez à jour l'utilitaire apigee-provision sur le serveur de gestion, comme illustré dans l'exemple suivant : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Exécutez l'utilitaire update sur vos nœuds dans l'ordre décrit dans Ordre de mise à jour des machines : 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Où :

    • component est le composant Edge à mettre à jour. Vous mettez généralement à jour les composants suivants :
      • cs : Cassandra
      • edge : tous les composants Edge, à l'exception de l'interface utilisateur Edge : serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgres
      • ldap : OpenLDAP
      • ps : postgresql
      • qpid : qpidd
      • sso : Apigee SSO (si vous avez installé l'authentification unique)
      • ue Nouvelle interface utilisateur Edge
      • ui : UI Edge classique
      • zk : ZooKeeper
    • configFile est le même fichier de configuration que celui que vous avez utilisé pour définir vos composants Edge lors de l'installation de la version 4.50.00 ou 4.51.00.

    Vous pouvez exécuter update.sh sur tous les composants en définissant component sur "all", mais uniquement si vous disposez d'un profil d'installation Edge tout-en-un (AIO). Exemple :

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. Redémarrez les composants de l'interface utilisateur sur tous les nœuds qui l'exécutent, si vous ne l'avez pas déjà fait : 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Testez la mise à jour en exécutant l'utilitaire apigee-validate sur le serveur de gestion, comme décrit dans Tester l'installation.

Si vous décidez ultérieurement d'annuler la mise à jour, suivez la procédure décrite dans Annuler la version 4.52.01.

Ordre de mise à jour des machines

L'ordre dans lequel vous mettez à jour les machines d'une installation Edge est important :

  • Vous devez mettre à jour tous les nœuds Cassandra et ZooKeeper avant de mettre à jour les autres nœuds.
  • Pour toute machine dotée de plusieurs composants Edge (Management Server, Processeur de messages, Router, QPID Server, mais pas Postgres Server), utilisez l'option -c edge pour les mettre à jour simultanément.
  • Si une étape indique qu'elle doit être effectuée sur plusieurs machines, effectuez-la dans l'ordre spécifié.
  • Il n'y a pas d'étape distincte pour mettre à jour la monétisation. Il est mis à jour lorsque vous spécifiez l'option -c edge.

Mise à niveau autonome à un nœud

Pour mettre à niveau une configuration autonome à un nœud vers la version 4.52.01 :

  1. Mettez à jour tous les composants : 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (Si vous avez installé apigee-adminapi) Mise à jour de l'utilitaire apigee-adminapi : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Mise à niveau autonome à deux nœuds

Mettez à jour les composants suivants pour une installation autonome à deux nœuds :

Consultez la section Topologies d'installation pour obtenir la liste des topologies Edge et des numéros de nœuds.

  1. Mettez à jour Cassandra et ZooKeeper sur la machine 1 : 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Mettez à jour Postgres sur la machine 2 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Mettez à jour LDAP sur la machine 1 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Mettez à jour les composants Edge sur les machines 2 et 1 : 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Mettez à jour Qpid sur la machine 2 : 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Mettez à jour l'UI sur la machine 1 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Si vous avez installé apigee-adminapi) Mise à jour de l'utilitaire apigee-adminapi sur la machine 1 : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Si vous avez installé Apigee SSO) Mettez à jour Apigee SSO sur la machine 1 : 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Où sso_config_file est le fichier de configuration que vous avez créé lorsque vous avez installé l'authentification unique.

  9. Redémarrez le composant de l'interface utilisateur Edge sur la machine 1 : 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Mise à niveau de 5 nœuds

Mettez à jour les composants suivants pour une installation à cinq nœuds :

Consultez la section Topologies d'installation pour obtenir la liste des topologies Edge et des numéros de nœuds.

  1. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3 : 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Mettez à jour Postgres sur la machine 4 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Mettez à jour Postgres sur la machine 5 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -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 les machines 4, 5, 1, 2 et 3 : 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Mettez à jour Qpid sur la machine 4 : 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Mettez à jour Qpid sur la machine 5 : 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Mettez à jour l'interface utilisateur Edge :
    • UI classique : si vous utilisez l'UI classique, mettez à jour le composant ui sur la machine 1, comme illustré dans l'exemple suivant : 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • Nouvelle interface utilisateur Edge : si vous avez installé la nouvelle interface utilisateur Edge, mettez à jour le composant ue sur la machine appropriée (il peut ne pas s'agir de la machine 1) : 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (Si vous avez installé apigee-adminapi) Mise à jour de l'utilitaire apigee-adminapi sur la machine 1 : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (Si vous avez installé Apigee SSO) Mettez à jour Apigee SSO sur la machine 1 : 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Où sso_config_file est le fichier de configuration que vous avez créé lorsque vous avez installé l'authentification unique.

  11. Redémarrez le composant d'interface utilisateur :
    • UI classique : si vous utilisez l'UI classique, redémarrez le composant edge-ui sur la machine 1, comme illustré dans l'exemple suivant : 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nouvelle interface utilisateur Edge : si vous avez installé la nouvelle interface utilisateur Edge, redémarrez le composant edge-management-ui sur la machine appropriée (il peut ne pas s'agir de la machine 1) : 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Mise à niveau d'un cluster à neuf nœuds

Mettez à jour les composants suivants pour une installation en cluster à neuf nœuds :

Consultez la section Topologies d'installation pour obtenir la liste des topologies Edge et des numéros de nœuds.

  1. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3 : 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Mettez à jour Postgres sur la machine 8 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Mettez à jour Postgres sur la machine 9 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -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 les machines 6, 7, 8, 9, 1, 4 et 5, dans cet ordre : 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Mettez à jour Qpid sur les machines 6 et 7 : 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Mettez à jour la nouvelle UI (ue) ou l'UI classique (ui) sur la machine 1 : 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Si vous avez installé apigee-adminapi) Mettez à jour l'utilitaire apigee-adminapi sur la machine 1 : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Si vous avez installé Apigee SSO) Mettez à jour Apigee SSO sur la machine 1 : 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Où sso_config_file est le fichier de configuration que vous avez créé lorsque vous avez installé l'authentification unique.

  10. Redémarrez le composant d'interface utilisateur :
    • UI classique : si vous utilisez l'UI classique, redémarrez le composant edge-ui sur la machine 1, comme illustré dans l'exemple suivant : 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nouvelle interface utilisateur Edge : si vous avez installé la nouvelle interface utilisateur Edge, redémarrez le composant edge-management-ui sur la machine appropriée (il peut ne pas s'agir de la machine 1) : 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Mise à niveau d'un cluster à 13 nœuds

Mettez à jour les composants suivants pour une installation en cluster à 13 nœuds :

Consultez la section Topologies d'installation pour obtenir la liste des topologies Edge et des numéros de nœuds.

  1. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3 : 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Mettez à jour Postgres sur la machine 8 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Mettez à jour Postgres sur la machine 9 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Mettez à jour LDAP sur les machines 4 et 5 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Mettez à jour les composants Edge sur les machines 12, 13, 8, 9, 6, 7, 10 et 11, dans cet ordre : 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Mettez à jour Qpid sur les machines 12 et 13 : 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Mettez à jour la nouvelle UI (ue) ou l'UI classique (ui) sur les machines 6 et 7 : 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Si vous avez installé apigee-adminapi) Mettez à jour l'utilitaire apigee-adminapi sur les machines 6 et 7 : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Si vous avez installé Apigee SSO) Mettez à jour Apigee SSO sur les machines 6 et 7 : 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Où sso_config_file est le fichier de configuration que vous avez créé lorsque vous avez installé l'authentification unique.

  10. Redémarrez le composant d'interface utilisateur :
    • UI classique : si vous utilisez l'UI classique, redémarrez le composant edge-ui sur les machines 6 et 7, comme illustré dans l'exemple suivant : 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nouvelle interface utilisateur Edge : si vous avez installé la nouvelle interface utilisateur Edge, redémarrez le composant edge-management-ui sur les machines 6 et 7 : 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Mise à niveau d'un cluster de 12 nœuds

Mettez à jour les composants suivants pour une installation en cluster à 12 nœuds :

Consultez la section Topologies d'installation pour obtenir la liste des topologies Edge et des numéros de nœuds.

  1. 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
  2. Mettez à jour Postgres :
    1. Machine 6 dans le centre de données 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. Machine 12 dans le centre de données 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Mettez à jour LDAP :
    1. Machine 1 dans le centre de données 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Machine 7 dans le centre de données 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Mettez à jour les composants Edge :
    1. Machines 4, 5, 6, 1, 2, 3 dans le centre de données 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Machines 10, 11, 12, 7, 8, 9 dans le centre de données 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. 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. Mettez à jour qpidd sur la machine 5 : 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Machines 10 et 11 dans le 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. Mettez à jour qpidd sur la machine 11 : 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Mettez à jour la nouvelle UI (ue) ou l'UI classique (ui) :
    1. Machine 1 dans le centre de données 1 : 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. Machine 7 dans le centre de données 2 : 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (Si vous avez installé apigee-adminapi) : mise à jour de l'utilitaire apigee-adminapi :
    1. Machine 1 dans le centre de données 1 : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. Machine 7 dans le centre de données 2 : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Si vous avez installé Apigee SSO) Mettez à jour Apigee SSO :
    1. Machine 1 dans le centre de données 1 : 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. Machine 7 dans le centre de données 2 : 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      3. Où sso_config_file est le fichier de configuration que vous avez créé lorsque vous avez installé l'authentification unique.

  9. Redémarrez le composant de la nouvelle interface utilisateur Edge (edge-management-ui) ou de l'interface utilisateur Edge classique (edge-ui) sur les machines 1 et 7 : 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

Pour une configuration non standard

Si vous disposez d'une configuration non standard, mettez à jour les composants Edge dans l'ordre suivant :

  1. ZooKeeper
  2. Cassandra
  3. ps
  4. LDAP
  5. Edge, c'est-à-dire le profil "-c edge" sur tous les nœuds dans l'ordre suivant : nœuds avec serveur Qpid, serveur Edge Postgres, serveur de gestion, processeur de messages et routeur.
  6. qpidd
  7. UI Edge (classique ou nouvelle)
  8. apigee-adminapi
  9. Apigee SSO

Une fois la mise à jour terminée, veillez à redémarrer le composant de l'UI Edge sur toutes les machines qui l'exécutent.