Mise à jour d'Apigee Edge 4.19.06 ou 4.50.00 vers la version 4.51.00

Cette section explique comment passer d'Apigee Edge 4.19.06 ou 4.50.00 à la version 4.51.00.

Qui peut effectuer la mise à jour

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

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

Quels composants devez-vous mettre à jour

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

Propagation automatique des paramètres de propriété

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

Mise à niveau requise vers Postgres 10.17

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

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

La façon dont vous effectuez la mise à jour de Postgres dépend de la façon dont vous avez configuré le stockage de données pour vos nœuds Postgres :

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

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

    Dans une configuration Edge à un ou deux nœuds, les topologies utilisées pour le prototypage et les tests, vous ne disposez que d'un seul nœud Postgres. Vous pouvez mettre à jour ces nœuds Postgres directement sans avoir à en créer un autre.

  • Si vous utilisez un espace de stockage réseau pour vos nœuds Postgres, comme recommandé par Apigee, vous n'avez pas besoin d'installer un nouveau nœud Postgres. Dans les procédures ci-dessous, vous pouvez ignorer les étapes qui indiquent d'installer, puis de mettre hors service un nouveau nœud Postgres de secours.

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

Installer un nouveau nœud de secours Postgres

Cette procédure crée un serveur de secours Postgres sur un nouveau nœud. Assurez-vous d'installer un nouveau serveur de secours Postgres pour votre version existante d'Edge (4.19.06 ou 4.50.00), et non pour la version 4.51.00.

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

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

  1. Sur le maître Postgres actuel, modifiez le fichier /opt/apigee/customer/application/postgresql.properties pour définir le jeton suivant. Si ce fichier n'existe pas, créez-le : 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

    Où existing_standby_ip est l'adresse IP du serveur de secours Postgres actuel et new_standby_ip est l'adresse IP du nouveau nœud de secours.

  2. Redémarrez apigee-postgresql sur le nœud maître Postgres : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Vérifiez que le nouveau nœud de secours a été ajouté en consultant le fichier /opt/apigee/apigee-postgresql/conf/pg_hba.conf sur le maître. Les lignes suivantes doivent s'afficher dans ce fichier : 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. Installez le nouveau serveur Postgres de secours :
    1. Modifiez le fichier de configuration que vous avez utilisé pour installer votre version actuelle d'Edge afin de spécifier les éléments suivants : 
      # IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
    2. Désactivez SELinux comme décrit dans Installer l'utilitaire apigee-setup d'Edge.
    3. Effectuez l'une des opérations suivantes, en fonction de la version d'Edge à partir de laquelle vous effectuez la mise à niveau :
      • Si vous effectuez une mise à niveau à partir d'Edge 4.19.06, téléchargez le fichier Edge bootstrap_4.19.06.sh dans /tmp/bootstrap_4.19.06.sh  : 
        curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

        Ensuite, installez l'utilitaire Edge apigee-service et les dépendances : 

        sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
      • Si vous effectuez une mise à niveau à partir d'Edge 4.50.00, téléchargez le fichier Edge bootstrap_4.50.00.sh dans /tmp/bootstrap_4.50.00.sh  : 
        curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

        Ensuite, installez l'utilitaire Edge apigee-service et les dépendances : 

        sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
    4. Utilisez apigee-service pour installer l'utilitaire apigee-setup : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. Installez Postgres : 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. Sur le nouveau nœud de secours, exécutez la commande suivante : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Vérifiez qu'il est indiqué qu'il s'agit du nœud de secours.

Effectuer une mise à niveau sur place de Postgres

Pour effectuer une mise à niveau sur place vers Postgres 10.17, procédez comme suit :

  1. Mettre à niveau Postgres sur l'hôte maître 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  2. Exécutez la commande de configuration sur l'hôte maître : 
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. Exécutez la commande de configuration sur l'hôte maître : 
    apigee-service apigee-postgresql configure
  4. Redémarrez l'hôte maître : 
    apigee-service apigee-postgresql restart
  5. Configurez-le en tant que maître : 
    apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
  6. Assurez-vous que l'hôte maître a démarré : 
    apigee-service apigee-postgresql wait_for_ready
  7. Arrêtez l'instance de secours : 
    apigee-service apigee-postgresql stop
  8. Mettez à niveau l'instance de secours.

    Remarque : Si cette étape échoue ou génère une erreur, vous pouvez l'ignorer. update.sh tentera de démarrer le serveur de secours avec une configuration incorrecte. Si l'installation de Postgres est mise à niveau vers la version 10.17, l'erreur peut être ignorée.

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. Assurez-vous que le nœud de secours est arrêté : 
    apigee-service apigee-postgresql stop
  10. Supprimez l'ancienne configuration de secours : 
    rm -rf /opt/apigee/data/apigee-postgresql/
  11. Configurez la réplication sur le serveur de secours : 
    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

Une fois cette procédure terminée, l'instance de secours démarrera correctement.

Mettre hors service un nœud Postgres

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

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

    Si Postgres n'est pas en cours d'exécution, démarrez-le : 

    /opt/apigee/apigee-service/bin/apigee-all start
  2. Obtenez l'UUID du nouveau nœud de secours en exécutant la commande curl suivante sur le nouveau nœud de secours : 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

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

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  3. Arrêtez le nouveau nœud de secours en exécutant la commande suivante sur le nouveau nœud de secours : 
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. Sur le nœud maître Postgres, modifiez /opt/apigee/customer/application/postgresql.properties pour supprimer le nouveau nœud de secours de conf_pg_hba_replication.connection : 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
  5. Redémarrez apigee-postgresql sur le nœud maître Postgres : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Vérifiez que le nouveau nœud de secours a été supprimé en consultant le fichier /opt/apigee/apigee-postgresql/conf/pg_hba.conf sur le maître. Seule la ligne suivante doit s'afficher dans ce fichier : 
    host replication apigee existing_standby_ip/32 trust
  7. Supprimez l'UUID du nœud de secours de ZooKeeper en effectuant l'appel d'API de gestion Edge suivant sur le nœud du serveur de gestion : 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

Conditions préalables à la mise à jour

Avant de mettre à niveau Apigee Edge, assurez-vous de respecter les conditions préalables suivantes :

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

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

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

Nouvelle interface utilisateur Edge

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

Installer l'interface utilisateur Edge

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

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

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

Mettre à jour l'interface utilisateur Edge

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

Mettre à jour avec Apigee mTLS

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

Restaurer une mise à jour

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

Si l'échec nécessite de revenir à la version précédente, consultez Revenir à la version 4.51.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, le journal est écrit dans le répertoire /tmp sous la forme d'un fichier nommé update_username.log.

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

Mise à jour sans temps d'arrêt

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

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

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

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

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

Utiliser un fichier de configuration 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 4.19.06 ou 4.50.00.

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

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

  1. Le cas échéant, désactivez toutes les tâches cron configurées pour effectuer une opération de réparation sur Cassandra jusqu'à la fin de la mise à jour.
  2. Connectez-vous à votre nœud en tant qu'utilisateur racine pour installer les RPM Edge.
  3. Installez yum-utils et yum-plugin-priorities : 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Désactivez SELinux comme décrit dans Installer l'utilitaire apigee-setup d'Edge.
  5. Si vous effectuez l'installation sur Oracle 7.x, exécutez la commande suivante : 
    sudo yum-config-manager --enable ol7_optional_latest
  6. Si vous effectuez l'installation sur AWS, exécutez les commandes yum-configure-manager suivantes : 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  7. Téléchargez le fichier Edge 4.51.00 bootstrap_4.51.00.sh dans /tmp/bootstrap_4.51.00.sh : 
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  8. Installez l'utilitaire apigee-service Edge 4.51.00 et ses dépendances en exécutant la commande suivante : 
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

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

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

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

    • I : installez OpenJDK 1.8 (par défaut).
    • C : continuer sans installer Java.
    • Q : quitter. Pour cette option, vous devez installer Java vous-même.
  9. 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
  10. Mettez à jour l'utilitaire apigee-validate sur le serveur de gestion, comme illustré dans l'exemple suivant : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  11. Mettez à jour l'utilitaire apigee-provision sur le serveur de gestion, comme illustré dans l'exemple suivant : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  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

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

    Où :

    • component est le composant Edge à mettre à jour. Les valeurs possibles sont les suivantes :
      • cs : Cassandra
      • edge : tous les composants Edge, à l'exception de l'interface utilisateur Edge : serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgres
      • ldap : OpenLDAP
      • ps : postgresql
      • qpid : qpidd
      • sso : Apigee SSO (si vous avez installé l'authentification unique)
      • ue : nouvelle interface utilisateur Edge
      • ui : UI Edge classique
      • zk : ZooKeeper
    • configFile est le même fichier de configuration que celui que vous avez utilisé pour définir vos composants Edge lors de l'installation de la version 4.19.06 ou 4.50.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
  13. Redémarrez le composant de l'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
  14. Testez la mise à jour en exécutant l'utilitaire apigee-validate sur le serveur de gestion, comme décrit dans Tester l'installation.

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

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

Si vos nœuds Edge se trouvent derrière un pare-feu ou si l'accès au dépôt Apigee via Internet est interdit, vous pouvez effectuer la mise à jour à partir d'un dépôt local ou d'un miroir du dépôt Apigee.

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

  • Créez un fichier .tar du dépôt, copiez-le sur un nœud, puis mettez à jour Edge à partir du fichier .tar.
  • Installez un serveur Web sur le nœud avec le dépôt local afin que les autres nœuds puissent y accéder. Apigee fournit le serveur Web NGINX, mais vous pouvez également utiliser votre propre serveur Web.

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

  1. Créez un dépôt 4.51.00 local comme décrit dans la section "Créer un dépôt Apigee local" de la page Installer l'utilitaire apigee-setup d'Edge.
  2. Pour installer apigee-service à partir d'un fichier .tar :
    1. Sur le nœud avec le dépôt local, utilisez la commande suivante pour empaqueter le dépôt local dans un seul fichier .tar nommé /opt/apigee/data/apigee-mirror/apigee-4.51.00.tar.gz : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Copiez le fichier .tar sur le nœud sur lequel vous souhaitez mettre à jour Edge. Par exemple, copiez-le dans le répertoire /tmp du nouveau nœud.
    3. Sur le nouveau nœud, décompressez le fichier dans le répertoire /tmp : 
      tar -xzf apigee-4.51.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 à partir de /tmp/repos : 
      sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

      Où uName:pWord sont 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 apigee-setup Edge et les dépendances : 
      sudo bash /tmp/bootstrap_4.51.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

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

    Où :

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

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

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

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

Ordre de mise à jour des machines

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 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 les mettre à jour simultanément.
  • Si une étape indique qu'elle doit être effectuée sur plusieurs machines, effectuez-la dans l'ordre spécifié.
  • Il n'existe pas d'étape distincte pour mettre à jour la monétisation. Il est mis à jour lorsque vous spécifiez l'option -c edge.

Licence autonome pour un nœud

Pour mettre à niveau une configuration autonome à un nœud vers la version 4.51.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 Edge et des numéros de nœuds.

  1. Mettez à jour Cassandra et ZooKeeper sur la machine 1 : 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Mettez à jour Qpid et Postgres sur la machine 2 : 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid,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 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é Apigee SSO) Mettez à jour Apigee SSO sur la machine 1 : 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

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

Mise à niveau de 5 nœuds

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

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

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

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

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

Mise à niveau d'un cluster à 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 Edge et des numéros de nœuds.

  1. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3 : 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Mettez à jour Qpid sur les machines 6 et 7 : 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Mettez à jour Postgres sur la machine 8 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Mettez à jour Postgres sur la machine 9 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Mettez à jour LDAP sur la machine 1 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Mettez à jour les composants Edge sur les machines 6, 7, 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é Apigee SSO) Mettez à jour Apigee SSO sur la machine 1 : 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

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

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

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

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

  1. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3 : 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Mettez à jour Qpid sur les machines 12 et 13 : 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Mettez à jour Postgres sur la machine 8 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Mettez à jour Postgres sur la machine 9 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Mettez à jour LDAP sur les machines 4 et 5 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Mettez à jour les composants Edge sur les machines 12, 13, 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) Mettez à jour l'utilitaire apigee-adminapi sur les machines 6 et 7 : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Si vous avez installé 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'interface utilisateur :
    • UI classique : si vous utilisez l'UI classique, redémarrez le composant edge-ui sur les machines 6 et 7, comme illustré dans l'exemple suivant : 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nouvelle interface utilisateur Edge : si vous avez installé la nouvelle interface utilisateur Edge, redémarrez le composant edge-management-ui sur les machines 6 et 7 : 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

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

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

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

Pour une configuration non standard

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

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

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