Mettre à jour Apigee Edge 4.51.00, 4.52.00 ou 4.52.01 vers la version 4.52.02

Apigee prend en charge la mise à niveau d'Edge pour Private Cloud directement de la version 4.51.00, 4.52.00 ou 4.52.01 vers la version 4.52.02. Cette page explique comment effectuer ces mises à niveau.

Qui peut effectuer la mise à jour

La personne qui exécute la mise à jour doit être la même que celle qui a installé Edge à l'origine, ou une personne utilisant le mode root.

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

Quels composants devez-vous mettre à jour ?

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

Mettre à jour les prérequis

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

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

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

  • Assurez-vous qu'Edge est en cours d'exécution
    Assurez-vous qu'Edge est en cours d'exécution pendant le processus de mise à jour à l'aide de la commande suivante : 
    /opt/apigee/apigee-service/bin/apigee-all status
  • Assurez-vous que la stratégie de compactage Cassandra est LeveledCompactionStrategy
    Assurez-vous que la stratégie de compactage Cassandra est définie sur LeveledCompactionStrategy, comme décrit dans Modifier la stratégie de compactage Cassandra.

Étapes spéciales à prendre en compte pour la mise à niveau

Pour mettre à niveau vers Edge pour Private Cloud 4.52.02, envisagez d’exécuter des étapes spécifiques pour mettre à niveau certains logiciels. Les étapes nécessaires dépendent de votre version actuelle. Reportez-vous au tableau ci-dessous pour connaître les différents logiciels qui nécessitent des étapes supplémentaires. Les sections suivantes de cette page fournissent des discussions détaillées et des étapes précises pour chaque logiciel.

Version actuelle Logiciels nécessitant une procédure spéciale pour la mise à niveau vers la version 4.52.02
4.52.01 Cassandra
4.52.00 Cassandra, ZooKeeper, Qpid
4.51.00 Cassandra, Zookeeper, Qpid, Postgres

Propagation automatique des paramètres de propriété

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

Mise à niveau requise vers Cassandra 3.11.16

Apigee Edge pour Private Cloud 4.52.02 inclut une mise à niveau de Cassandra vers la version 3.11.16. Cassandra est un composant essentiel d'Apigee. Cette mise à niveau inclut également des mises à jour du logiciel pilote dans divers composants d'exécution et de gestion permettant d'interroger et d'écrire dans Cassandra.

Comme il s'agit d'une mise à niveau majeure, certaines modifications du modèle de données d'Apigee dans Cassandra ont été nécessaires pour garantir des performances optimales dans les versions plus récentes. Bien que ces modifications soient minimes, le processus de mise à niveau interrompt certaines API de gestion, ce qui affecte à la fois l'interface utilisateur d'Apigee et le portail des développeurs. Le document ci-dessous indique les API exactes qui ne fonctionneront pas et décrit les étapes à suivre pour effectuer la mise à niveau, au début et à la fin de l'interruption. Il est important de noter que le trafic d'exécution ne devrait pas être interrompu pendant la mise à niveau.

Rollback de niveau supérieur

Appliquer Cassandra met à niveau un nœud à la fois. Dès qu'un nœud est mis à jour, certaines modifications du schéma prennent effet et ne peuvent pas faire l'objet d'un rollback direct. Lisez attentivement la section sur le rollback, car différentes techniques peuvent être utilisées en fonction de la quantité de cluster mise à niveau.

Si vous devez effectuer un rollback de la mise à niveau après la mise à niveau de l'ensemble du cluster Cassandra, la seule option consiste à restaurer les sauvegardes. Préparez-vous et familiarisez-vous avec la restauration de sauvegardes Cassandra. Si vous pouvez restaurer des instantanés au niveau des VM plus rapidement que les sauvegardes Apigee, utilisez les instantanés de VM pour restaurer vos VM Cassandra à un état antérieur.

Pour en savoir plus, consultez la section Effectuer un rollback de la mise à jour de Cassandra 3.11.16.

Documentation des API dans le portail des développeurs

Le portail des développeurs Apigee Drupal offre diverses fonctionnalités pour documenter vos API. Bien qu'il soit recommandé de ne plus utiliser le portail des développeurs basé sur Drupal 7, le document Utilisation des API SmartDocs vous concerne si vous l'utilisez toujours et que vous exploitez sa fonctionnalité SmartDocs. Si vous utilisez des versions plus récentes du portail des développeurs, cette mise à niveau n'aura aucune incidence sur la documentation de votre API.

Lorsque vous mettez à niveau Apigee vers la version 4.52.02, les modèles d'API créés à l'aide de la fonctionnalité SmartDocs du portail des développeurs Drupal 7 ne sont pas automatiquement migrés vers la nouvelle version. Vous devez exporter manuellement chaque modèle via le portail des développeurs et l'importer à nouveau une fois la mise à niveau terminée.

Terminologie utilisée dans les sections suivantes

Environnement d'exécution:l'environnement d'exécution englobe le traitement du trafic du proxy d'exécution. Elle inclut toutes les opérations effectuées par vos routeurs et processeurs de messages pour traiter efficacement une requête API d'exécution pour les proxys existants. Toutefois, cela n'inclut pas le déploiement de nouveaux proxys ni les nouvelles révisions de proxys.

Gestion:la gestion comprend l'administration de votre système Apigee Edge. Cela inclut, sans s'y limiter, les déploiements, les modifications d'applications, de produits, de serveurs cibles, de keystores, etc. Toutes les API de gestion (et leurs clients, par exemple l'interface utilisateur Apigee et le portail des développeurs) sont incluses dans ce champ d'application.

Dans chaque étape ci-dessous, l'état de l'exécution et de la gestion est décrit à mesure que vous progressez dans les différentes étapes de la procédure de mise à niveau. Notez que la mise à niveau n'a aucune incidence sur le trafic d'exécution. Toutefois, une petite partie des API de gestion et des fonctionnalités du portail des développeurs sont perturbées.

Étape 0: État de départ

  1. Cassandra dans Apigee s'exécutant avec la version 2.1.22.
  2. Les composants Edge pour Private Cloud 4.52.02:
    • Le serveur de gestion communique avec Cassandra via un ancien protocole Thrift.
    • Serveurs d'exécution (processeurs de messages et routeurs) communiquant avec Cassandra via un ancien protocole Thrift.
État de l'exécution à ce stade État de gestion à ce stade
Environnement d'exécution entièrement fonctionnel Gestion entièrement fonctionnelle

Étape 1: Préparez la migration

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

  1. Modifiez Cassandra pour utiliser LeveledCompactionStrategy.
  2. Sauvegardez Cassandra à l'aide d'Apigee.
  3. Prenez des instantanés de VM des nœuds Cassandra (si possible).
  4. Créez un fichier de configuration de mise à niveau Cassandra sur chaque nœud Cassandra de /opt/apigee/apigee-cassandra/cass_upgrade.conf avec le contenu suivant : 
    # IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    Si le fichier ne peut pas être créé dans /opt/apigee/apigee-cassandra/cass_upgrade.conf, créez le fichier /opt/silent.conf avec le même contenu sur chaque nœud Cassandra.
  • Si vous utilisez la fonctionnalité SmartDocs du portail des développeurs Apigee Drupal 7, exportez chacun de vos modèles en les téléchargeant au format JSON à partir de l'interface utilisateur du portail des développeurs. Ces modèles devront être réimportés dans Apigee après la mise à jour des serveurs de gestion.
  • Assurez-vous que les ports 9160 et 9042 sont accessibles aux nœuds Cassandra depuis tous les composants Edge for Private Cloud 4.52.02 s'ils ne sont pas déjà présents. Pour en savoir plus, consultez la section Configuration requise au niveau des ports.

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

  1. Mettez à niveau tous les nœuds Cassandra de toutes les régions un par un. Exécutez les commandes suivantes sur chaque nœud : 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Une fois un nœud mis à jour, exécutez la commande suivante sur le nœud pour effectuer quelques validations avant de continuer : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. La commande ci-dessus renvoie un résultat semblable aux lignes suivantes : 
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
État de l'exécution à ce stade État de gestion à ce stade
Environnement d'exécution entièrement fonctionnel La fonction de gestion suivante est dégradée après la mise à niveau de Cassandra :

É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
État de l'environnement d'exécution État de gestion
Environnement d'exécution entièrement fonctionnel API de gestion dégradée :

Étape 3a: [facultatif] Importer les SmartDocs précédemment exportés

Une fois tous les serveurs de gestion mis à niveau, vous pouvez importer les modèles SmartDocs que vous avez exportés à l'étape 1. Vous pourrez décider de le faire plus tard.

État de l'environnement d'exécution État de gestion
Environnement d'exécution entièrement fonctionnel Gestion entièrement fonctionnelle

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

Mettez à niveau tous les routeurs et 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
État de l'environnement d'exécution État de gestion
Environnement d'exécution entièrement fonctionnel Gestion entièrement fonctionnelle

Étape 5: Mettez à niveau tous les composants Edge restants pour Private Cloud 4.52.02

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

À ce stade, si vous effectuez une mise à niveau à partir de versions antérieures à Edge for Private Cloud 4.52.01 et que vous suivez des étapes supplémentaires pour mettre à niveau Qpid ou Postgres, suivez les étapes respectives pour effectuer la même mise à niveau.

État de l'environnement d'exécution État de gestion
Environnement d'exécution entièrement fonctionnel Gestion entièrement fonctionnelle

Étape 6: Étapes post-migration

Exécutez la commande suivante sur chaque nœud Cassandra une par une une fois la mise à niveau terminée:

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

Exécutez la commande suivante pour supprimer les anciennes tables inutilisées du cluster Cassandra. En attendant, vous ne pouvez pas utiliser certaines fonctionnalités de Cassandra (comme la configuration d'une nouvelle authentification ; les anciens mécanismes d'authentification continueront de fonctionner). Cette commande ne peut être exécutée que sur un seul nœud du cluster:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

Suivez l'étape 3a si ce n'est pas déjà fait.

État de l'environnement d'exécution État de gestion
Environnement d'exécution entièrement fonctionnel Gestion entièrement fonctionnelle

Mise à niveau requise vers Zookeeper 3.8.3

Même si Edge pour Private Cloud 4.52.02 n'inclut pas de mise à niveau vers Zookeeper, si vous effectuez une mise à niveau à partir de versions antérieures à 4.52.01, vous devez suivre les étapes de mise à niveau pour Zookeeper.

  • Si vous effectuez une mise à niveau à partir des versions 4.51.00 ou 4.52.00 d'Edge for Private Cloud, reportez-vous aux étapes de la section Mise à niveau requise vers Zookeeper 3.8.3 pour mettre à niveau Zookeeper.
  • Si vous effectuez une mise à niveau depuis Edge for Private Cloud version 4.52.01, vous devriez déjà utiliser Zookeeper version 3.8.3 et vous n'avez pas besoin de suivre une procédure spéciale pour mettre à niveau Zookeeper.

Mise à niveau requise vers Postgres 14

  • Si vous effectuez une mise à niveau d'Edge for Private Cloud vers la version 4.52.02, vous devez suivre les étapes de mise à niveau de Postgres, même si Edge for Private Cloud 4.52.02 n'inclut pas de mise à niveau de Postgres. La mise à niveau d'Edge for Private Cloud vers la version 4.51.00 vers la version 4.52.02 nécessite des étapes de mise à niveau Postgres supplémentaires. Veuillez consulter la section Mise à niveau requise vers Postgres 14.
  • Si vous effectuez une mise à niveau d'Edge for Private Cloud vers la version 4.52.00 ou 4.52.01 vers la version 4.52.02, aucune étape de mise à niveau Postgres supplémentaire n'est requise.

Mise à niveau requise vers Qpid J-Broker

Même si Edge pour Private Cloud 4.52.02 n'inclut pas de mise à niveau vers QPID, si vous effectuez une mise à niveau à partir de versions antérieures à 4.52.01, vous devez suivre les étapes pour mettre à niveau QPID.

  • Si vous effectuez une mise à niveau d'Edge for Private Cloud version 4.51.00 ou 4.52.00 vers la version 4.52.02, vous devez suivre des étapes de mise à niveau QPID supplémentaires. Veuillez consulter la section Mettre à niveau Qpid si vous effectuez une mise à niveau depuis la version 4.51.00 ou 4.52.00 vers la version 4.52.02.
  • Si vous effectuez une mise à niveau d'Edge pour Private Cloud 4.52.01 vers la version 4.52.02, vous devez déjà utiliser la dernière version de Qpid Broker. Aucune étape de mise à niveau QPID supplémentaire n'est nécessaire.

Nouvelle interface utilisateur Edge

Cette section répertorie les considérations relatives à l'interface utilisateur Edge. Pour plus d'informations, consultez la section 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 pour 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 en savoir plus, consultez Installer la nouvelle interface utilisateur Edge.

Mettre à jour l'interface utilisateur Edge

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

Effectuer une mise à 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 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 vers la version 4.52.00 pour obtenir des instructions détaillées.

Informations sur la mise à jour de la journalisation

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

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

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

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

Mise à jour sans temps d'arrêt

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

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

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

  1. Mettez à jour les machines dans le bon ordre pour votre installation, comme indiqué dans l'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 affichent un routeur et un processeur de messages sur le même nœud.
  4. Rendez le routeur à nouveau accessible.
  5. Répétez les étapes 2 à 4 pour les routeurs restants.
  6. Continuez la mise à jour pour toutes les machines restantes de votre installation.

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

Utiliser un fichier de configuration silencieuse

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

Mise à jour vers la version 4.52.02 sur un nœud avec une connexion Internet externe

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

  1. Le cas échéant, désactivez les 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 d'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. Si vous utilisez actuellement Edge 4.51.00:

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

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

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

      Utilisez l'option JAVA_FIX pour spécifier comment gérer 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: arrête. Pour utiliser cette option, vous devez installer Java vous-même.
    3. Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup, comme le montre l'exemple suivant : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. Mettez à jour l'utilitaire apigee-validate sur le serveur de gestion, comme indiqué dans l'exemple suivant : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. Mettez à jour l'utilitaire apigee-provision sur le serveur de gestion, comme indiqué dans l'exemple suivant : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. Exécutez l'utilitaire update sur vos nœuds à l'aide de la commande suivante : 
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      Effectuez cette opération dans l'ordre décrit dans la section Ordre des 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: authentification unique Apigee (si vous avez installé SSO)
        • ue: nouvelle interface utilisateur Edge
        • ui: UI classique Edge
        • zk: ZooKeeper
      • configFile est le même fichier de configuration que celui que vous avez utilisé pour définir vos composants Edge lors de l'installation 4.50.00 ou 4.51.00.

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

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
    7. Redémarrez le composant d'interface utilisateur Edge sur tous les nœuds qui l'exécutent, si vous ne l'avez pas déjà fait : 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    8. Testez la mise à jour en exécutant l'utilitaire apigee-validate sur le 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.52.02.

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

Si vos nœuds Edge se trouvent derrière un pare-feu ou ne sont pas autorisés d'une autre manière à accéder au dépôt Apigee sur Internet, vous pouvez effectuer la mise à jour à partir d'un dépôt local (ou miroir) du dépôt Apigee.

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

  • Créez un fichier .tar du dépôt, copiez le fichier .tar sur un nœud, puis mettez à jour Edge à partir du 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 vous fournit le serveur Web Nginx, ou vous pouvez utiliser votre propre serveur Web.

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

  1. Créez un dépôt 4.52.02 local comme décrit dans la section "Créer un dépôt Apigee local" de la page Installer l'utilitaire Edge apigee-setup.
  2. Pour installer apigee-service à partir d'un fichier .tar :
    1. Sur le nœud contenant le dépôt local, utilisez la commande suivante pour empaqueter le dépôt local dans un seul fichier .tar nommé /opt/apigee/data/apigee-mirror/apigee-4.52.02.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.52.02.tar.gz

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

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

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

  3. Pour installer apigee-service à l'aide du serveur Web Nginx:
    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 Edge de configuration Apigee.
    2. Sur le nœud distant, téléchargez le fichier Edge bootstrap_4.52.02.sh sur /tmp/bootstrap_4.52.02.sh : 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.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 Edge apigee-setup et les dépendances : 
      sudo bash /tmp/bootstrap_4.52.02.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 le montre 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: authentification unique Apigee (si vous avez installé SSO)
      • ue Nouvelle interface utilisateur Edge
      • ui: UI classique Edge
      • zk: ZooKeeper
    • configFile est le même fichier de configuration que celui que vous avez utilisé pour définir vos composants Edge lors de l'installation 4.50.00 ou 4.51.00.

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

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

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

Mise à niveau autonome à un nœud

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

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

Mise à niveau autonome à 2 nœuds

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

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

  1. Mettez à jour Cassandra et ZooKeeper sur la machine 1 : 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Mettez à jour Postgres sur la machine 2 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. 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. Mettre à jour Qpid sur la machine 2 : 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Mettez à jour l'interface utilisateur sur la machine 1 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Si vous avez installé apigee-adminapi) Mise à jour de l'utilitaire apigee-adminapi sur la machine 1 : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Si vous avez installé Apigee SSO) Mettez à jour l'authentification unique Apigee sur la machine 1 : 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Où sso_config_file correspond au fichier de configuration que vous avez créé lors de l'installation de SSO.

  9. Redémarrez le composant Edge UI sur la machine 1 : 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Mise à niveau de cinq nœuds

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

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

  1. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3 : 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Mettez à jour Postgres sur la machine 4 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Mettez à jour Postgres sur la machine 5 : 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. 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. Mettre à jour Qpid sur la machine 4 : 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Mettre à jour Qpid sur la machine 5 : 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Mettez à jour l'interface utilisateur Edge :
    • Interface utilisateur classique:si vous utilisez l'interface utilisateur 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, mettez à jour le composant ue sur la machine appropriée (il peut ne pas s'agir de la machine 1) : 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (Si vous avez installé apigee-adminapi) Mise à jour de l'utilitaire apigee-adminapi sur la machine 1 : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (Si vous avez installé Apigee SSO) Mettez à jour 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 correspond au fichier de configuration que vous avez créé lors de l'installation de SSO.

  11. Redémarrez le composant d'interface utilisateur :
    • Interface utilisateur classique:si vous utilisez l'interface utilisateur 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, 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 en cluster à 9 nœuds

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

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

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

    Où sso_config_file correspond au fichier de configuration que vous avez créé lors de l'installation de SSO.

  10. Redémarrez le composant d'interface utilisateur :
    • Interface utilisateur classique:si vous utilisez l'interface utilisateur 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, 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 en cluster à 13 nœuds

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

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

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

    Où sso_config_file correspond au fichier de configuration que vous avez créé lors de l'installation de SSO.

  10. Redémarrez le composant d'interface utilisateur :
    • Interface utilisateur 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, redémarrez le composant edge-management-ui sur les machines 6 et 7 : 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Mise à niveau en cluster à 12 nœuds

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

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

  1. Mettez à jour Cassandra et ZooKeeper :
    1. Sur les machines 1, 2 et 3 du centre de données 1 : 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Sur les machines 7, 8 et 9 du centre de données 2 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Mettez à jour Postgres :
    1. Machine 6 dans le centre de données 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. Machine 12 dans le centre de données 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Mise à jour LDAP :
    1. Machine 1 dans le centre de données 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Machine 7 dans le centre de données 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Mettez à jour les composants Edge :
    1. Machines 4, 5, 6, 1, 2, 3 du centre de données 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Machines 10, 11, 12, 7, 8 et 9 dans le centre de données 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Mettez à jour Qpidd :
    1. Machines 4 et 5 dans le centre de données 1
      1. Mise à jour de qpidd sur la machine 4 : 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Mise à jour de 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. Mise à jour de qpidd sur la machine 10 : 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Mise à jour qpidd sur la machine 11 : 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Mettez à jour la nouvelle interface utilisateur (ue) ou l'interface utilisateur classique (ui) :
    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 l'authentification unique Apigee :
    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 correspond au fichier de configuration que vous avez créé lors de l'installation de SSO.

  9. Redémarrez le nouveau composant Edge UI (edge-management-ui) ou classique Edge UI (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 avez une configuration non standard, mettez à jour les composants Edge dans l'ordre suivant:

  1. ZooKeeper
  2. Cassandra
  3. ps
  4. LDAP
  5. Edge, qui signifie 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. 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 Edge UI sur toutes les machines qui l'exécutent.