Mise à jour d'Apigee Edge 4.19.01 ou 4.19.06 vers 4.50.00

Cette section explique comment effectuer la mise à niveau suivante:

  • Du 4.19.01 au 4.50.00
  • Du 4.19.06 au 4.50.00

Qui peut effectuer la mise à jour ?

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

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

Composants à mettre à jour

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

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.

Mettre à jour les prérequis

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

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

    Vous disposez ainsi d'un plan de sauvegarde au cas où la mise à jour vers une nouvelle version ne fonctionnerait pas correctement. Pour en savoir plus sur la sauvegarde, consultez la page Sauvegarde et restauration.

  • Assurez-vous qu'Edge est en cours d'exécution
    Assurez-vous qu'Edge est opérationnel pendant le processus de mise à jour à l'aide de la commande suivante :
    /opt/apigee/apigee-service/bin/apigee-all status

Nouvelle interface utilisateur Edge

Cette section répertorie les considérations relatives à l'interface utilisateur Edge. Pour plus d'informations, voir La nouvelle interface utilisateur Edge pour cloud privé.

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 les administrateurs d'Apigee Edge for Private Cloud.

Notez que l'interface utilisateur Edge nécessite que vous désactiviez l'authentification de base et que vous utilisiez un IdP tel que SAML ou LDAP.

Pour plus d'informations, voir Installer la nouvelle interface utilisateur Edge.

Mettre à jour l'interface utilisateur Edge

Pour mettre à jour le composant d'interface utilisateur Edge, tenez compte de la version d'Edge pour le cloud privé à partir de laquelle vous effectuez la mise à niveau:

  • À partir de la version 4.18.0x:si vous avez installé la version bêta de l'interface utilisateur Edge (anciennement appelée nouvelle expérience Edge ou nouvelle interface utilisateur) dans la version 4.18.0x, vous devez la désinstaller et effectuer une nouvelle installation de la version 4.19.06 de l'interface utilisateur Edge, comme décrit dans la section Installer la nouvelle interface utilisateur Edge.
  • À partir de la version 4.19.01 (avec la nouvelle interface utilisateur Edge déjà installée): suivez les instructions de mise à niveau de cette section pour le composant edge-management-ui.
  • À partir de la version 4.19.01 (avec l'interface utilisateur classique): mettez à niveau Edge pour l'installation du cloud privé comme décrit dans cette section, puis installez l'interface utilisateur Edge comme décrit dans Installer la nouvelle interface utilisateur Edge.
  • À partir de la version 4.19.06 (avec la nouvelle interface utilisateur Edge déjà installée): suivez les instructions de mise à niveau de cette section pour le composant edge-management-ui.

Mise à jour avec Apigee mTLS

Apigee mTLS n'est compatible qu'avec les versions 4.19.01 à 4.19.06 d'Apigee Edge pour le cloud privé. Vous ne pouvez pas mettre à niveau apigee-mtls pour les versions 4.18.* ou antérieures. Consultez la section Mettre à niveau Apigee mTLS.

Gérer les échecs de mise à jour

En cas d'échec de la mise à jour, vous pouvez essayer de corriger le problème, puis exécuter à nouveau update.sh. Vous pouvez exécuter la mise à jour plusieurs fois et elle reprendra 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 la section Effectuer un rollback de la version 4.50.00 pour en savoir plus.

Informations sur les mises à jour de Logging

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

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

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

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

Mise à jour sans temps d'arrêt

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

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

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

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

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

Utiliser un fichier de configuration silencieux

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

Passez à la version 4.50.00 sur un nœud avec une connexion Internet externe

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

  1. Le cas échéant, désactivez 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 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 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. Téléchargez le fichier bootstrap_4.50.00.sh Edge 4.50.00 dans /tmp/bootstrap_4.50.00.sh :
    curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
  8. Installez l'utilitaire apigee-service et les dépendances d'Edge 4.50.00 en exécutant la commande suivante :
    sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

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

    Par défaut, le programme d'installation vérifie que Java 1.8 est installé. Si vous ne le faites pas, 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 peut avoir les valeurs suivantes:

    • I: installez OpenJDK 1.8 (par défaut).
    • C: continuer sans installer Java.
    • Q: quitter. Pour utiliser cette option, vous devez installer Java vous-même.
  9. Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup, comme indiqué dans l'exemple suivant :
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  10. 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
  11. 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
  12. 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

    Procédez dans l'ordre indiqué dans la section Ordre des mises à 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: interface utilisateur Classic Edge
      • 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 4.19.01 ou 4.19.06.

    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
  13. Si vous ne l'avez pas déjà fait, redémarrez le composant d'interface utilisateur Edge sur tous les nœuds qui l'exécutent :
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  14. Testez la mise à jour en exécutant l'utilitaire apigee-validate sur le serveur de gestion, comme décrit dans la section Tester l'installation.

Si vous décidez ultérieurement d'effectuer un rollback de la mise à jour, suivez la procédure décrite dans la section Effectuer un rollback de la version 4.50.00.

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

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

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

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

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

  1. Créez un dépôt local 4.50.00 comme décrit dans la section "Créer un dépôt Apigee local" de la section Installer l'utilitaire de configuration d'Apigee Edge.
  2. Pour installer apigee-service à partir d'un fichier .tar :
    1. Sur le nœud contenant le dépôt local, exécutez la commande suivante pour empaqueter le dépôt local dans un seul fichier .tar nommé /opt/apigee/data/apigee-mirror/apigee-4.50.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.50.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 et les dépendances Edge apigee-service de /tmp/repos :
      sudo bash /tmp/repos/bootstrap_4.50.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

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

      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 de dépôt.

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

      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 indiqué 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 des mises à 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: interface utilisateur Classic Edge
      • 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 4.19.01 ou 4.19.06.

    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. Si vous ne l'avez pas déjà fait, redémarrez les composants d'interface utilisateur sur tous les nœuds qui l'exécutent :
    /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 ultérieurement d'effectuer un rollback de la mise à jour, suivez la procédure décrite dans la section Effectuer un rollback de la version 4.50.00.

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

Mise à niveau autonome à un nœud

Pour mettre à niveau une configuration autonome à un nœud vers la version 4.50.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) 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 de périphérie et des nombres de nœuds.

  1. Mettre à jour Cassandra et ZooKeeper sur la machine 1 :
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Mettre à jour Qpid et Postgres sur la machine 2 :
    /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  3. Mettre à 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 l'UI sur la machine 1 :
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. (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
  7. (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

    sso_config_file est le fichier de configuration que vous avez créé lors de l'installation de l'authentification unique.

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

Mise à niveau à 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 de périphérie et des nombres 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. Mettre à jour Qpid et Postgres sur la machine 4 :
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
  3. Mettre à jour Qpid et Postgres sur la machine 5 :
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
  4. Mettre à jour LDAP sur la machine 1 :
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Mettre à 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 l'interface utilisateur Edge :
    • UI classique:si vous utilisez l'UI classique, mettez à jour le composant ui sur la machine 1, comme indiqué 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, puis mettez à jour le composant ue sur la machine appropriée (il ne s'agit peut-être pas de la machine 1) :
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  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é 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

    sso_config_file est le fichier de configuration que vous avez créé lors de l'installation de l'authentification unique.

  9. Redémarrez le composant UI :
    • UI classique:si vous utilisez l'UI classique, redémarrez le composant edge-ui sur la machine 1, comme indiqué 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, puis redémarrez le composant edge-management-ui sur la machine appropriée (il ne peut pas s'agir de la 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 nombres 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. Mettre à jour Qpid sur les machines 6 et 7 :
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Mettre à jour Postgres sur la machine 8 :
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Mettre à jour Postgres sur la machine 9 :
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Mettre à jour LDAP sur la machine 1 :
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Mettez à jour les composants Edge sur les machines 6, 7, 8, 9, 1, 4 et 5, dans cet ordre :
    /opt/apigee/apigee-setup/bin/update.sh -c edge -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é 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

    sso_config_file est le fichier de configuration que vous avez créé lors de l'installation de l'authentification unique.

  10. Redémarrez le composant UI :
    • UI classique:si vous utilisez l'UI classique, redémarrez le composant edge-ui sur la machine 1, comme indiqué 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, puis redémarrez le composant edge-management-ui sur la machine appropriée (il ne peut pas s'agir de la 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 nombres 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. Mettre à jour Qpid sur les machines 12 et 13 :
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Mettre à jour Postgres sur la machine 8 :
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Mettre à jour Postgres sur la machine 9 :
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Mettre à jour LDAP sur les machines 4 et 5 :
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Mettez à jour les composants Edge sur les machines 12, 13, 8, 9, 6, 7, 10 et 11, dans cet ordre :
    /opt/apigee/apigee-setup/bin/update.sh -c edge -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) 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

    sso_config_file est le fichier de configuration que vous avez créé lors de l'installation de l'authentification unique.

  10. Redémarrez le composant UI :
    • UI classique:si vous utilisez l'interface utilisateur classique, redémarrez le composant edge-ui sur les machines 6 et 7, comme indiqué 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, puis 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 nombres 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 qpidd :
    1. Machines 4, 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 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
  3. 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 du centre de données 2
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Mettre à jour LDAP :
    1. Machine 1 du centre de données 1
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Machine 7 du centre de données 2
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Mettez à jour les composants Edge :
    1. Machines 4, 5, 6, 1, 2, 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
  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é l'authentification unique Apigee) Mettez à jour l'authentification unique Apigee :
    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. sso_config_file est le fichier de configuration que vous avez créé lors de l'installation de l'authentification unique.

  9. Redémarrez la nouvelle interface utilisateur Edge (edge-management-ui) ou le composant UI 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. qpidd, ps
  4. LDAP
  5. Edge, c'est-à-dire le profil "-c Edge" sur tous les nœuds de l'ordre: nœuds avec serveur Qpid, serveur Edge Postgres, serveur de gestion, processeur de messages et routeur.
  6. Interface utilisateur Edge (classique ou nouvelle)
  7. apigee-adminapi
  8. Authentification unique Apigee

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