Mettre à jour Apigee Edge 4.51.00 ou 4.52.00 vers 4.52.01

Apigee prend en charge la mise à niveau d'Edge pour Private Cloud à partir de la version 4.51.00 ou la version 4.52.00 directement 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 un personne qui exécute en tant que root.

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

Quels composants devez-vous mettre à jour ?

Vous devez mettre à jour tous les composants Edge. Edge ne prend pas en charge une configuration qui contient des composants à partir de plusieurs versions.

Mettre à jour les prérequis

Assurez-vous que les conditions préalables suivantes sont remplies avant la mise à niveau d'Apigee Edge:

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

  Cela vous permet d'avoir un plan de sauvegarde, au cas où la mise à jour vers une nouvelle version fonctionne correctement. Pour en savoir plus sur la sauvegarde, consultez la section Sauvegarde et Restaurer.

• Vérifier 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 complication Cassandra est LeveledCompactionStrategy
  Assurez-vous que la stratégie de compatification Cassandra est définie sur LeveledCompactionStrategy, comme décrit dans Modifiez le Stratégie de compactage Cassandra.

Propagation automatique des paramètres de propriété

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

Mise à niveau requise vers Zookeeper 3.8.3

Cette version d'Edge pour Private Cloud inclut une mise à niveau vers Zookeeper 3.8.3. Dans le cadre de toutes les données de Zookeeper sont transférées vers la version 3.8.3.

Avant de mettre à niveau ZooKeeper, consultez les Zookeeper guide de maintenance. La plupart des systèmes de production Edge utilisent un cluster de nœuds ZooKeeper répartis dans plusieurs centres de données. Certains de ces nœuds sont configurés en tant qu'électeurs qui participent lors de l'élection du responsable ZooKeeper, et les autres sont configurés en tant qu'observateurs. Voir <ph type="x-smartling-placeholder"></ph> À propos des dirigeants, des followers, des électeurs et des observateurs. Les membres des listes électorales élisent un après quoi les membres électoraux deviennent eux-mêmes des abonnés.

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

De manière générale, le processus de mise à niveau implique d'effectuer une sauvegarde de chaque nœud. Ce contenu est suivi en mettant à niveau tous les observateurs et followers, puis le nœud principal.

Effectuer une sauvegarde

Effectuez une sauvegarde de tous les nœuds de ZooKeeper à utiliser au cas où un rollback serait nécessaire. Notez que un rollback restaurera ZooKeeper à l'état au moment où la sauvegarde a été effectuée. Remarque: Tout déploiement ou modifications de l'infrastructure dans Apigee depuis la sauvegarde (dont les informations sont stockées dans ZooKeeper) seront perdus pendant la restauration.

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

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

Identifier le responsable, les followers et les observateurs

Remarque:Les exemples de commandes ci-dessous utilisent la méthode utilitaire nc pour envoyer des données à Zookeeper. Vous pourriez utiliser d'autres utilitaires pour envoyer des données à Zookeeper.

1. Si ce n'est pas déjà fait sur le nœud ZooKeeper, installez nc:

     sudo yum install nc

2. Exécutez la commande nc suivante sur le nœud, où 2181 correspond au 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

   Dans la ligne Mode du résultat des nœuds, vous devriez voir un observateur, un leader ou abonné (un électeur qui n'est pas le responsable) en fonction de la configuration du nœud. Remarque:Dans une installation autonome d'Edge avec un seul nœud ZooKeeper, le Mode est définie comme autonome.

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

Mettre à niveau Zookeeper sur les nœuds d'observateur et de followers

Mettez à niveau Zookeeper sur chacun des nœuds observateur et esclave comme suit:

1. Téléchargez et exécutez l'amorçage d'Edge pour Private Cloud 4.52, comme décrit dans <ph type="x-smartling-placeholder"></ph> Mise à jour vers la version 4.52.01 sur un nœud avec une connexion Internet externe. Le processus sera probablement varient selon que le nœud dispose d'une connexion Internet externe ou 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 les mettre à niveau eux aussi maintenant (comme avec les profils cs,zk) ou mettre à niveau les autres composants ultérieurement. Apigee vous recommande de mettre à niveau Zookeeper uniquement avant 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 la variante optimale

Une fois que tous les nœuds observateur et esclave ont été mis à niveau, arrêtez le nœud maître. Sur le nœud identifié comme responsable, exécutez la commande ci-dessous:

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

Notez que pendant cet événement, avant l'élection d'un nouveau responsable, des retards ou les échecs d'écriture dans ZooKeeper. Cela peut affecter les opérations qui écrivent dans ZooKeeper comme l'action de déploiement de proxys ou les modifications d'infrastructure Apigee, telles que l'ajout ou la suppression des processeurs de messages, etc.

Vérifier que le nouveau responsable est élu

En suivant les étapes de l'article Identifier le responsable, abonnés et observateurs ci-dessus, vérifiez qu'un nouveau responsable a été élu au sein de abonnés, une fois que le responsable existant est arrêté. Notez que le dirigeant peut avoir été élu au cours d'une un centre de données différent de celui du leader actuel.

Mettre à niveau le responsable

Suivez la même procédure que pour Mise à niveau de ZooKeeper sur les nœuds d'observateur et de followers ci-dessus.

Une fois l'ancien nœud principal mis à niveau, vérifiez l'état du cluster et s'assurer qu'il existe un nœud principal.

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 l'amorçage de la version vers laquelle vous effectuez le rollback (4.50 ou 4.51). Le processus variera probablement selon que le nœud dispose ou non d'une connexion Internet externe ou si vous suivez l'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ésinstaller 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 le rollback a été effectué pour tous les followers et observateurs, effectuez le rollback du nœud principal en suivant les étapes 2 à 5 sur le nœud maître.
7. Une fois que le rollback a été effectué pour tous les nœuds, vérifiez l'état du cluster et assurez-vous comme un nœud principal du cluster.

Restaurer une sauvegarde

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

Mise à niveau requise vers Postgres 14

Cette version d'Edge pour 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 effectuez une mise à niveau d'Edge for Private Cloud vers la version 4.52.01, il est nécessaire de suivre des étapes de mise à niveau supplémentaires pour Postgres. Reportez-vous à 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 effectuez une mise à niveau d'Edge for Private Cloud vers la version 4.52.01, aucune étape de mise à niveau Postgres supplémentaire n'est nécessaire.

Mettre à niveau Qpid

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

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

• Mise à niveau sur place sans temps d'arrêt
• Mettre en service un nouveau nœud 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 réduit la perte de données d'exécution, le cas échéant, acquises à des fins d'analyse.

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

1. Choisissez un nœud Qpid avec lequel 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 courtier 5672 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 de pare-feu/réseau externe.

   Nous vous recommandons d'effectuer la même opération pour toutes les adresses IP du processeur de messages. Par exemple, pour abandonner 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 comme celle-ci:

   iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP

4. Redémarrez l'agent 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), drainez la file d'attente en utilisant les étapes pour résoudre les problèmes liés aux données d'analyse bloquées dans la file d'attente des lettres mortes.

6. Après avoir vérifié que les files d'attente se sont drainé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 de processeurs 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 le nœud Qpid sur le port 5672 sera accepté. Si vous avez utilisé iptables pour ajouter le pare-feu, supprimez le pare-feu et listez les paramètres existants, utilisez les commandes suivantes:

   iptables -F
     iptables -L

10. Utilisez la surveillance Web pour vérifier que les files d'attente Qpid reçoivent les 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 nouveau nœud Qpid. Cette étape configure un nœud Qpid avec J-broker. Pour connaître la procédure détaillée, consultez la section 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 courtier 5672 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 de pare-feu/réseau externe.

   Nous vous recommandons d'effectuer la même opération pour toutes les adresses IP du processeur de messages. Par exemple, pour abandonner 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 comme celle-ci:

   iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP

5. Redémarrez l'agent 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), drainez en suivant les étapes de la rubrique de dépannage Données d'analyse bloquées dans la file d'attente de lettres mortes Qpidd

7. Après avoir vérifié que les files d'attente se sont drainé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 Supprimez un serveur Qpid.
9. Continuez à ajouter un nouveau nœud et à supprimer un ancien nœud, un par un, jusqu'à ce que tous les nœuds Qpid aient été ont été mis à niveau.

Rollback

Pour effectuer un rollback vers une version de fonctionnalité précédente, veillez à télécharger le fichier bootstrap.sh pour la version vers laquelle vous souhaitez effectuer le 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 courtier 5672 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 de pare-feu/réseau externe.

   Nous vous recommandons d'effectuer la même opération pour toutes les adresses IP du processeur de messages. Par exemple, pour abandonner 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 comme celle-ci:

   iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP

3. Redémarrez l'agent 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 vérifier, connectez-vous à Qpid de gestion centralisée:

   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 sont drainé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 répertoriez tous les paramètres existants à l'aide des commandes suivantes:

   iptables -F

   iptables -L

Nouvelle interface utilisateur Edge

Cette section répertorie les considérations relatives à l'interface utilisateur Edge. Pour en savoir plus, consultez La 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'interface utilisateur Edge, qui est une interface utilisateur améliorée pour les développeurs et administrateurs d'Apigee Edge pour Private Cloud.

Notez que l'interface utilisateur Edge nécessite que vous désactiviez l'authentification de base et que vous utilisiez 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 d'interface utilisateur Edge, prenez en compte la version d'Edge pour le cloud privé que vous passent de:

• De la version 4.51.00 à la version 4.52.00 (avec la nouvelle interface utilisateur Edge déjà installée): utilisez la ces instructions de mise à jour pour les edge-management-ui.

Effectuer une mise à jour avec Apigee mTLS

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

• Désinstallez Apigee mTLS.
• Réinstallez Apigee mTLS.

Restaurer une mise à jour

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

Si l'échec nécessite un rollback vers la version précédente de la mise à jour, consultez Effectuez 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, il é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 est défaillant.

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 pour faire descendre Edge.

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

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

1. Mettez à jour les machines dans le bon ordre pour votre installation, comme décrit ci-dessus. Ordre des mises à jour de la machine.
2. Au moment de mettre à jour les routeurs, sélectionnez un routeur et rendez-le inaccessible, car décrit dans la section Activation/Désactivation du serveur joignabilité (processeur/routeur de messages).
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. Continuez la mise à jour pour toutes les machines restantes de votre installation.

Vérifiez les points suivants avant et après la mise à jour:

• Sur les nœuds de routeur et de processeur de messages combinés: <ph type="x-smartling-placeholder">
  </ph>
  • Avant la mise à jour: <ph type="x-smartling-placeholder">
    </ph>
    1. Rendez le routeur inaccessible.
    2. Rendre le processeur de messages inaccessible.
  • Après la mise à jour, procédez comme suit: <ph type="x-smartling-placeholder">
    </ph>
    1. Rendez le processeur de messages accessible.
    2. Rendez le routeur accessible.
• Sur des nœuds de routeur unique: <ph type="x-smartling-placeholder">
  </ph>
  • Avant la mise à jour, rendez le routeur inaccessible.
  • Après la mise à jour, rendez le routeur accessible.
• Sur les nœuds individuels du processeur de messages: <ph type="x-smartling-placeholder">
  </ph>
  • Avant la mise à jour, rendez le processeur de messages inaccessible.
  • Après la mise à jour, rendez le processeur de messages accessible.

Utiliser un fichier de configuration silencieuse

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

Remplacer par 4.52.01 sur un nœud avec une connexion Internet externe

Procédez comme suit pour mettre à jour les composants Edge sur un nœud:

1. Le cas échéant, désactivez les jobs cron configurés 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 la section Installer l'utilitaire de configuration Edge Apigee.
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 la commande suivante : Commandes yum-configure-manager:

   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 sur /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 Edge 4.52.01 apigee-service et les dépendances en procédant comme suit : en exécutant la commande suivante:

      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

      Où uName:pWord correspond au nom d'utilisateur et au 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 bien 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 Installation de Java. JAVA_FIX peut avoir les valeurs suivantes:

      • I: installez OpenJDK 1.8 (par défaut).
      • C: continuer sans installer Java.
      • Q: arrête. Pour utiliser cette option, vous devez installer Java vous-même.
   3. Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup, en tant que l'exemple suivant montre:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

   4. Mettez à jour l'utilitaire apigee-validate sur le serveur de gestion, comme suit : dans cet exemple:

      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

   5. Mettez à jour l'utilitaire apigee-provision sur le serveur de gestion, comme suit : dans cet exemple:

      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

   6. Exécutez l'utilitaire update sur vos nœuds à l'aide de la commande suivante:

      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      Effectuez cette opération dans l'ordre décrit dans la section Ordre des mise à jour.

      Où :

      • component est le composant Edge à mettre à jour. Les valeurs possibles sont les suivantes: <ph type="x-smartling-placeholder">
        </ph>
        • cs: Cassandra
        • edge: tous les composants Edge à l'exception de l'interface utilisateur Edge: Management Server, Message Processeur, routeur, serveur QPID, serveur Postgres
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: authentification unique Apigee (si vous avez installé SSO)
        • ue: nouvelle interface utilisateur Edge
        • ui: UI classique Edge
        • zk: ZooKeeper
      • configFile est le même fichier de configuration que celui utilisé pour définir votre périphérie pendant l'installation 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 le composant d'interface utilisateur Edge 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-ui restart

   8. Testez la mise à jour en exécutant l'utilitaire apigee-validate sur le gestionnaire serveur, comme décrit dans la section Tester l'installation.

Si vous décidez ultérieurement d'effectuer un rollback de la mise à jour, suivez la procédure décrite dans Roll back 4.52.01.

Mise à jour vers la version 4.52.01 depuis un dépôt local

Si vos nœuds périphériques se trouvent derrière un pare-feu ou s'ils ne sont pas autorisés d'une autre manière à accéder dans le dépôt Apigee sur Internet, vous pouvez alors effectuer la mise à jour ou un miroir du dépôt Apigee.

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

• Créez un fichier .tar du dépôt, copiez le fichier .tar sur un nœud, puis mettez à jour Edge à partir du .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 met à votre disposition le serveur Web Nginx, mais vous pouvez aussi utiliser votre propre serveur 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". à Installez l'utilitaire de configuration Edge apigee.
2. Pour installer apigee-service à partir d'un fichier .tar: <ph type="x-smartling-placeholder">
   </ph>
   1. Sur le nœud contenant le dépôt local, empaquetez le dépôt à l'aide de la commande suivante : 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 où vous souhaitez mettre à jour Edge. Par exemple, copiez-le dans le répertoire /tmp sur le 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 Edge apigee-service et les dépendances à partir de /tmp/repos:

      sudo bash /tmp/repos/bootstrap_4.52.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

3. Pour installer apigee-service à l'aide du serveur Web Nginx: <ph type="x-smartling-placeholder">
   </ph>
   1. Configurez le serveur Web Nginx comme indiqué dans la section "Installer à partir du dépôt à l'aide de la commande webserver&quot; dans la section Installer Edge utilitaire de configuration apigee.
   2. Sur le nœud distant, téléchargez le fichier Edge bootstrap_4.52.01.sh pour /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 est le nom d'utilisateur et le mot de passe que vous avez définis précédemment pour le dépôt, et remoteRepo est l'adresse IP ou le nom DNS du nœud du dépôt.

   3. Sur le nœud distant, installez l'utilitaire Edge apigee-setup et les dépendances:

      sudo bash /tmp/bootstrap_4.52.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

4. Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup, en tant que l'exemple suivant montre:

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 

5. Mettez à jour l'utilitaire apigee-validate sur le serveur de gestion, comme suit : dans cet exemple:

   /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

6. Mettez à jour l'utilitaire apigee-provision sur le serveur de gestion, comme suit : dans cet exemple:

   /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 la section Ordre des mises à jour de la machine:

   /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 composants suivants: <ph type="x-smartling-placeholder">
     </ph>
     • cs: Cassandra
     • edge: tous les composants Edge à l'exception de l'interface utilisateur Edge: serveur de gestion, processeur de messages, routeur QPID Server, Postgres Server
     • ldap: OpenLDAP
     • ps: postgresql
     • qpid: qpidd
     • sso: authentification unique Apigee (si vous avez installé SSO)
     • ue Nouvelle interface utilisateur Edge
     • ui: UI classique Edge
     • zk: ZooKeeper
   • configFile est le même fichier de configuration que celui utilisé pour définir vos composants Edge pendant l'installation 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 gestionnaire serveur, comme décrit dans la section Tester l'installation.

Si vous décidez ultérieurement d'effectuer un rollback de la mise à jour, suivez la procédure décrite dans Roll back 4.52.01.

Ordre des mises à jour de la machine

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

• Vous devez mettre à jour tous les nœuds Cassandra et ZooKeeper avant d'effectuer la mise à jour d'autres nœuds.
• Pour toute machine dotée de plusieurs composants Edge (serveur de gestion, processeur de messages, (routeur, serveur QPID, mais pas serveur Postgres), utilisez l'option -c edge pour effectuer la mise à jour tous en même temps.
• Si une étape indique qu'elle doit être exécutée sur plusieurs machines, effectuez-la dans le l'ordre de machine spécifié.
• Il n'y a pas d'étape distincte pour mettre à jour la monétisation. Il est mis à jour lorsque vous spécifiez 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 à 2 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 de périphérie 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. Mise à jour de 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'interface utilisateur 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 l'authentification unique Apigee 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 avoir installé SSO.

9. Redémarrez le composant Edge UI sur la machine 1:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Mise à niveau de cinq 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 de périphérie 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. Mise à jour de 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, 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: <ph type="x-smartling-placeholder">
   </ph>
   • Interface utilisateur classique:si vous utilisez l'interface utilisateur classique, mettez à jour le ui sur la machine 1, comme le montre 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 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 l'authentification unique Apigee 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 avoir installé SSO.

11. Redémarrez le composant d'interface utilisateur: <ph type="x-smartling-placeholder">
    </ph>
    • Interface utilisateur classique:si vous utilisez l'interface utilisateur classique, redémarrez le edge-ui sur la machine 1, comme le montre 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 edge-management-ui sur la machine appropriée (il ne peut pas s'agir d'une machine 1):

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Mise à niveau en cluster à 9 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 de périphérie 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. Mise à jour de 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 interface utilisateur (ue) ou l'interface utilisateur 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 l'authentification unique Apigee 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 avoir installé SSO.

10. Redémarrez le composant d'interface utilisateur: <ph type="x-smartling-placeholder">
    </ph>
    • Interface utilisateur classique:si vous utilisez l'interface utilisateur classique, redémarrez le edge-ui sur la machine 1, comme le montre 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 edge-management-ui sur la machine appropriée (il ne peut pas s'agir d'une machine 1):

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Mise à niveau en 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 de périphérie 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 interface utilisateur (ue) ou l'interface utilisateur 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) Mise à jour de 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 l'authentification unique Apigee 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 avoir installé SSO.

10. Redémarrez le composant d'interface utilisateur: <ph type="x-smartling-placeholder">
    </ph>
    • Interface utilisateur classique:si vous utilisez l'interface utilisateur classique, redémarrez le edge-ui sur les machines 6 et 7, comme le montre 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 en cluster à 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 de périphérie et des numéros de nœuds.

1. Mettez à jour Cassandra et ZooKeeper: <ph type="x-smartling-placeholder">
   </ph>
   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: <ph type="x-smartling-placeholder">
   </ph>
   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. Mettre à jour LDAP: <ph type="x-smartling-placeholder">
   </ph>
   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: <ph type="x-smartling-placeholder">
   </ph>
   1. Machines 4, 5, 6, 1, 2 et 3 du centre de données 1

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   2. Machines 10, 11, 12, 7, 8 et 9 dans le centre de données 2

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

5. Mettre à jour Qpidd: <ph type="x-smartling-placeholder">
   </ph>
   1. Machines 4 et 5 dans le centre de données 1 <ph type="x-smartling-placeholder">
      </ph>
      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 <ph type="x-smartling-placeholder">
      </ph>
      1. Mettez à jour qpidd sur la machine 10:

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

      2. Mise à jour qpidd sur la machine 11:

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

6. Mettez à jour la nouvelle interface utilisateur (ue) ou l'interface utilisateur classique (ui): <ph type="x-smartling-placeholder">
   </ph>
   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: <ph type="x-smartling-placeholder">
   </ph>
   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 l'authentification unique Apigee: <ph type="x-smartling-placeholder">
   </ph>
   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

   Où sso_config_file est le fichier de configuration que vous avez créé lorsque vous avez avoir installé SSO.

9. Redémarrer la nouvelle interface utilisateur Edge (edge-management-ui) ou 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 à la commande:

1. ZooKeeper
2. Cassandra
3. ps
4. LDAP
5. Edge, qui signifie « -c bord » profil sur tous les nœuds dans l'ordre: nœuds avec serveur Qpid, Serveur Edge Postgres, serveur de gestion, processeur de messages et routeur.
6. qpidd
7. Interface utilisateur Edge (classique ou nouvelle)
8. apigee-adminapi
9. SSO Apigee

Une fois la mise à jour terminée, n'oubliez pas de redémarrer le composant Edge UI sur toutes les machines exécutant