Mise à jour d'Apigee Edge 4.52.02 vers la version 4.53.00

Apigee permet de passer directement de la version 4.52.02 à la version 4.53.00 d'Edge pour Private Cloud. Cette page explique comment effectuer ces mises à niveau.

Pour obtenir une présentation des chemins de mise à niveau compatibles, consultez la matrice de compatibilité des mises à niveau pour les versions d'Edge pour le cloud privé.

Qui peut effectuer la mise à jour ?

La personne qui exécute la mise à jour doit être celle qui a installé Edge à l'origine ou une personne exécutant en tant que root.

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.

Mettre à jour les prérequis

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

  • Sauvegardez 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é. Pour effectuer la sauvegarde, suivez la procédure correspondant à votre version actuelle d'Edge.

    Vous disposez ainsi 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 la section Sauvegarde et restauration.

  • 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
  • Vérifier les conditions préalables à Cassandra
    Si vous avez précédemment effectué la mise à niveau d'une ancienne version d'Edge pour Private Cloud vers la version 4.52.02 et que vous prévoyez maintenant de passer à la version 4.53.00, assurez-vous d'avoir effectué les étapes post-mise à niveau requises pour Cassandra. Ces étapes sont décrites dans la documentation de mise à niveau vers la version 4.52.02 sous Étapes à suivre après la mise à niveau. Si vous ne savez pas si ces étapes ont été effectuées lors de la mise à niveau précédente, répétez-les avant de passer à la version 4.53.00.
  • Exigences concernant Python
    Assurez-vous que Python 3 est installé sur tous les nœuds, y compris les nœuds Cassandra, avant de tenter la mise à niveau.

Propagation automatique des paramètres des établissements

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

Mise à niveau obligatoire vers Cassandra 4.0.13

Apigee Edge pour un cloud privé 4.53.00 inclut une mise à niveau de Cassandra vers la version 4.0.13.

Mises à niveau et rollback

  • La mise à niveau de Cassandra 3.11.X vers Cassandra 4.0.X est un processus fluide. Cassandra 4.0.X, publié avec Edge pour le cloud privé 4.53.00, est compatible avec les composants d'exécution et de gestion du cloud privé 4.52.02.
  • Il n'est pas possible d'effectuer un rollback direct sur place de Cassandra 4.0.X vers 3.11.X. La restauration à l'aide de réplicas ou de sauvegardes est une procédure complexe qui peut entraîner des temps d'arrêt et/ou une perte de données. Il est préférable de résoudre les problèmes et de passer à Cassandra 4.0.X plutôt que de revenir en arrière.
  • Il est important de vous familiariser avec les procédures de rollback avant de tenter la mise à niveau. Il est essentiel de tenir compte des nuances du rollback lors de la mise à niveau pour s'assurer que des chemins de rollback appropriés sont disponibles.

Centre de données unique

La mise à niveau de Cassandra de la version 3.11.X vers la version 4.0.X dans un même centre de données est simple, mais le rollback est complexe et peut entraîner des temps d'arrêt et une perte de données. Pour les charges de travail de production, nous vous recommandons vivement d'ajouter un nouveau centre de données avec au moins un nœud Cassandra disponible avant de lancer la mise à niveau. Vous pourrez ainsi effectuer un rollback de Cassandra sans entraîner de perte de données ni d'interruption du trafic de votre API. Ce centre de données supplémentaire peut être mis hors service une fois la mise à niveau terminée ou lorsque le point de contrôle 2 est atteint.

Si l'ajout d'un centre de données n'est pas possible, mais que vous souhaitez tout de même pouvoir effectuer un rollback, des sauvegardes seront nécessaires pour restaurer Cassandra 3.11.X. Toutefois, cette méthode entraîne probablement des temps d'arrêt et une perte de données.

Plusieurs centres de données

L'exploitation de plusieurs centres de données avec Edge for Private Cloud 4.52.02 offre plus de flexibilité pour les rollbacks lors de la mise à niveau vers Edge for Private Cloud 4.53.00.

  • Les rollbacks nécessitent la présence d'au moins un centre de données exécutant l'ancienne version de Cassandra (3.11.X).
  • Si l'ensemble de votre cluster Cassandra est mis à niveau vers la version 4.0.X, vous ne devez pas effectuer de rollback vers la version 3.11.X. Vous devez continuer à utiliser la nouvelle version de Cassandra avec les autres composants de Private Cloud 4.53.00 ou 4.52.02.
  1. Mettez à niveau un centre de données Cassandra à la fois:commencez par mettre à niveau les nœuds Cassandra individuellement dans un même centre de données. Terminez la mise à niveau de tous les nœuds Cassandra d'un centre de données avant de passer au suivant.
  2. Mettez en pause et validez:après avoir mis à niveau un centre de données, mettez en pause pour vous assurer que votre cluster Private Cloud, en particulier le centre de données mis à niveau, fonctionne correctement.
  3. Rappel:Vous ne pouvez revenir à la version précédente de Cassandra que si au moins un centre de données exécute toujours l'ancienne version.
  4. Urgent:vous pouvez suspendre la migration pendant une courte période (quelques heures sont recommandées) pour valider les fonctionnalités, mais vous ne pouvez pas rester dans un état de version mixte indéfiniment. En effet, un cluster Cassandra non uniforme (avec des nœuds sur différentes versions) présente des limites opérationnelles.
  5. Tests approfondis:Apigee recommande vivement de tester de manière exhaustive les performances et les fonctionnalités avant de mettre à niveau le prochain centre de données. Une fois tous les centres de données mis à niveau, il est impossible de revenir à la version précédente.
Rétablir en tant que processus à deux points de contrôle
  1. Point de contrôle 1:état initial, avec tous les composants en version 4.52.02. Un rollback complet est possible tant qu'au moins un centre de données Cassandra reste sur l'ancienne version.
  2. Point de contrôle 2:une fois tous les nœuds Cassandra de tous les centres de données mis à jour. Vous pouvez revenir à cet état, mais pas au point de contrôle 1.
Exemple

Prenons l'exemple d'un cluster à deux centres de données:

  1. État de démarrage:les nœuds Cassandra des deux sites de données sont en version 3.11.X. Tous les autres nœuds sont sur la version 4.52.02 d'Edge pour le cloud privé. Supposons trois nœuds Cassandra par datacenter.
  2. Mettre à niveau le centre de données 1:mettez à niveau les trois nœuds Cassandra du centre de données 1 un par un.
  3. Mettez en pause et validez:mettez en pause pour vous assurer que le cluster, en particulier le site de datacenter 1, fonctionne correctement (vérifiez les performances et le fonctionnement). Vous pouvez revenir à l'état initial à l'aide des nœuds Cassandra dans DC-2. N'oubliez pas que cette pause doit être temporaire en raison des limites d'un cluster Cassandra à versions mixtes.
  4. Mettre à niveau le datacenter 2:mettez à niveau les trois nœuds Cassandra restants du datacenter 2. Il devient votre nouveau point de contrôle de rollback.
  5. Mettre à niveau d'autres composants:mettez à niveau les nœuds de gestion, d'exécution et d'analyse comme d'habitude dans tous les centres de données, un nœud et un centre de données à la fois. En cas de problème, vous pouvez revenir à l'état de l'étape 4.

Conditions préalables à la mise à niveau de Cassandra

Vous devez exécuter Cassandra 3.11.16 avec Edge pour le cloud privé 4.52.02 et vous assurer que les conditions suivantes sont remplies :
  • L'ensemble du cluster est opérationnel et entièrement fonctionnel avec Cassandra 3.11.16.
  • La stratégie de compaction est définie sur LeveledCompactionStrategy (condition préalable à la mise à niveau vers la version 4.52.02).
  • Toutes les étapes post-mise à niveau de la mise à niveau initiale vers Cassandra 3.11.16 dans le cadre de la mise à niveau 4.52.02 ont été effectuées. Si ce n'est pas le cas, répétez cette procédure. Cette procédure ne s'applique que si vous avez effectué la mise à niveau vers la version 4.52.02 de Private Cloud à partir d'une version antérieure.

Étape 1: Préparer la mise à niveau

Les étapes ci-dessous s'ajoutent aux fichiers standards que vous créez généralement, comme le fichier de configuration standard d'Apigee pour activer les mises à niveau de composants.

  1. Sauvegardez Cassandra à l'aide d'Apigee.
  2. Prendre des instantanés de VM des nœuds Cassandra (si possible)
  3. Assurez-vous que le port 9042 est accessible depuis tous les composants Edge pour le cloud privé, y compris le serveur de gestion, le processeur de messages, le routeur, Qpid et Postgres, aux nœuds Cassandra si ce n'est pas déjà fait. Pour en savoir plus, consultez les Exigences concernant les ports.

Étape 2: Mettre à niveau tous les nœuds Cassandra

Tous les nœuds Cassandra doivent être mis à jour un par un dans chaque centre de données, un centre de données à la fois. Entre les mises à niveau de nœuds dans un centre de données, attendez quelques minutes pour vous assurer qu'un nœud mis à niveau a démarré et rejoint complètement le cluster avant de mettre à niveau un autre nœud dans le même centre de données.

Après avoir mis à niveau tous les nœuds Cassandra d'un centre de données, attendez un certain temps (30 minutes à quelques heures) avant de passer aux nœuds du centre de données suivant. Pendant cette période, examinez attentivement le centre de données mis à jour et assurez-vous que les métriques fonctionnelles et de performances de votre cluster Apigee sont intactes. Cette étape est cruciale pour assurer la stabilité du centre de données où Cassandra a été mis à niveau vers la version 4.0.X, tandis que le reste des composants Apigee reste sur la version 4.52.02.

  1. Pour mettre à niveau un nœud Cassandra, exécutez la commande suivante: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Une fois qu'un nœud a été mis à jour, exécutez la commande suivante sur le nœud pour effectuer des validations avant de continuer: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. Le code ci-dessus génère un résultat semblable à celui-ci: 
    Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.13 | CQL spec 3.4.5 | Native protocol v5] 
Metadata is verified

Étape 3: Mettez à niveau tous les nœuds de gestion

Mettez à niveau tous les nœuds de gestion de toutes les régions, un par un:

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

Étape 4: Mettre à niveau tous les nœuds d'exécution

Mettez à niveau tous les routeurs et tous les nœuds de processeur de messages de toutes les régions, un par un:

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

Étape 5: Mettez à niveau tous les autres composants Edge for Private Cloud 4.53.00

Mettez à niveau tous les nœuds edge-qpid-server et edge-postgres-server restants dans toutes les régions, un par un.

Étape 6: Étapes postérieures à la mise à niveau

Une fois la mise à niveau terminée, exécutez la commande suivante sur chaque nœud Cassandra, un par un:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

Nouvelle interface utilisateur Edge

Cette section présente les considérations concernant l'interface utilisateur d'Edge. Pour en savoir plus, consultez la section Nouvelle interface utilisateur Edge pour le cloud privé.

Installer l'interface utilisateur Edge

Après l'installation initiale, Apigee vous recommande d'installer l'interface utilisateur Edge, qui est une interface utilisateur améliorée pour les développeurs et les administrateurs d'Apigee Edge pour le cloud privé.

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

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

Mise à jour avec mTLS Apigee

Pour mettre à jour mTLS Apigee , 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 d'exécuter à nouveau update.sh. Vous pouvez exécuter la mise à jour plusieurs fois. Elle reprendra là où elle s'était arrêtée.

Si l'échec nécessite de revenir à la version précédente, consultez Rétablir la version 4.53.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 l'utilisateur qui exécute l'utilitaire update.sh n'a pas accès à ce répertoire, le journal est écrit 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 mise à jour progressive, vous permet de mettre à jour votre installation d'Edge sans l'arrêter.

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 est de supprimer chaque routeur, un par un, de l'équilibreur de charge. Vous devez ensuite mettre à jour le routeur et tous les autres composants sur la même machine que le routeur, puis ajouter le routeur à nouveau à 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 la connectivité des serveurs (Message Processor/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. Rendre le routeur accessible à nouveau.
  5. Répétez les étapes 2 à 4 pour les autres routeurs.
  6. Poursuivez la mise à jour pour les machines restantes de votre installation.

Avant et après la mise à jour, veillez à prendre en compte les points suivants:

Utiliser un fichier de configuration silencieux

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

Mise à jour vers la version 4.53.00 sur un nœud avec 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. Désactivez SELinux comme décrit dans la section Installer l'utilitaire apigee-setup Edge.
  4. 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

Si vous décidez par la suite de revenir à la version précédente, suivez la procédure décrite dans la section Revenir à la version 4.53.00.

Mise à jour vers la version 4.53.00 à partir d'un dépôt local

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

Une fois que vous avez 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 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 que vous pouvez utiliser, ou vous pouvez utiliser votre propre serveur Web.

Pour mettre à jour à partir d'un dépôt local 4.53.00:

  1. Créez un dépôt local 4.53.00, comme décrit dans la section "Créer un dépôt Apigee local" de la page Installer l'utilitaire apigee-setup 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.53.00.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.53.00.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 apigee-service Edge et les dépendances à partir de /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Notez que vous devez inclure le chemin d'accès au répertoire des dépôts 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 Installer l'utilitaire apigee-setup Edge.
    2. Sur le nœud distant, téléchargez le fichier bootstrap_4.53.00.sh Edge dans /tmp/bootstrap_4.53.00.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.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 à l'adresse IP ou au nom DNS du nœud du dépôt.

    3. Sur le nœud distant, installez l'utilitaire apigee-setup Edge et les dépendances: 
      sudo bash /tmp/bootstrap_4.53.00.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, 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 indiqué 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 indiqué 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 la section Ordre de mise à 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 les composants suivants :
      • cs: Cassandra
      • edge: tous les composants Edge, à l'exception de l'UI Edge: serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: SSO Apigee (si vous avez installé le SSO)
      • ue Nouvelle interface utilisateur Edge
      • ui: interface utilisateur 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 tout-en-un (AIO) Edge. Exemple :

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. Redémarrez les composants d'interface utilisateur sur tous les nœuds qui les exécutent, si ce n'est 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 la section Tester l'installation.

Si vous décidez par la suite de revenir à la version précédente, suivez la procédure décrite dans la section Revenir à la version 4.53.00.

Ordre de mise à 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 de mettre à jour d'autres nœuds.
  • Pour toute machine comportant plusieurs composants Edge (serveur de gestion, processeur de messages, routeur, serveur QPID, mais pas le serveur Postgres), utilisez l'option -c edge pour les mettre à jour tous en même temps.
  • Si une étape indique qu'elle doit être effectuée sur plusieurs machines, effectuez-la dans l'ordre des machines spécifié.
  • Il n'existe 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 d'un nœud

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

  1. Mettez à jour tous les composants : 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (Si vous avez installé apigee-adminapi) Mettez à jour 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:

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

  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) Vous avez mis à jour l'utilitaire apigee-adminapi sur la machine 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Si vous avez installé l'authentification unique Apigee) 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 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 cinq nœuds

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

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

  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 (qui ne sera peut-être pas la machine 1): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (Si vous avez installé apigee-adminapi) Vous avez mis à jour l'utilitaire apigee-adminapi sur la machine 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (Si vous avez installé l'authentification unique Apigee) 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 installé l'authentification unique.

  11. Redémarrez le composant d'UI :
    • Interface utilisateur classique:si vous utilisez l'interface utilisateur 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 (qui ne sera peut-être pas la machine 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  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 l'ordre suivant: 
    /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é l'authentification unique Apigee) 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 installé l'authentification unique.

  10. Redémarrez le composant d'UI :
    • Interface utilisateur classique:si vous utilisez l'interface utilisateur 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 (qui ne sera peut-être pas la machine 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Mise à niveau du cluster à 13 nœuds

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

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

  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 l'ordre suivant: 
    /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é l'authentification unique Apigee) 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 installé l'authentification unique.

  10. Redémarrez le composant d'UI :
    • 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 à 12 nœuds

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

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

  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 du 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. Mise à jour du 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 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 du 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 du 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 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. Mettez à 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) :
    1. Machine 1 du centre de données 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. Machine 7 du 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 du centre de données 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. Machine 7 du 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 du centre de données 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. Machine 7 du 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 l'interface utilisateur Edge nouvelle (edge-management-ui) ou 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 Postgres Edge, 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, veillez à redémarrer le composant d'interface utilisateur Edge sur toutes les machines qui l'exécutent.