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.

<ph type="x-smartling-placeholder"> <ph type="x-smartling-placeholder"> <ph type="x-smartling-placeholder">

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.

<ph type="x-smartling-placeholder">

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.

  • Vérifier qu'Edge est en cours d'exécution
    Assurez-vous qu'Edge est opérationnel pendant le processus de mise à jour à l'aide de la commande suivante: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • Assurez-vous que la stratégie de 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.

<ph type="x-smartling-placeholder"> <ph type="x-smartling-placeholder">

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 à l'emplacement /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. <ph type="x-smartling-placeholder">
  • Si vous utilisez la fonctionnalité SmartDocs du portail des développeurs Apigee Drupal 7, exporter 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. Consultez Pour en savoir plus, consultez la section Exigences relatives aux ports.
<ph type="x-smartling-placeholder">

É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 qu'un nœud est 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: <ph type="x-smartling-placeholder">
<ph type="x-smartling-placeholder">

É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: <ph type="x-smartling-placeholder">

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

Une fois tous les serveurs de gestion mis à niveau, vous pouvez importez 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

<ph type="x-smartling-placeholder">

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.
<ph type="x-smartling-placeholder">

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 en savoir plus, consultez La nouvelle interface utilisateur Edge pour Private Cloud.

Installer l'interface utilisateur Edge

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

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

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

Mettre à jour l'interface utilisateur Edge

Pour mettre à jour le composant d'interface utilisateur Edge, prenez en compte la version d'Edge pour le cloud privé que vous passent de:

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

Effectuer une mise à jour avec Apigee mTLS

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

Restaurer une mise à jour

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

Si l'échec nécessite un rollback vers la version précédente de la mise à jour, consultez Effectuez un rollback de la version 4.52.00 pour obtenir des instructions détaillées.

Informations sur la mise à jour de la journalisation

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

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

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

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

Mise à jour sans temps d'arrêt

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

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

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

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

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

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

Utiliser un fichier de configuration silencieuse

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

Remplacer par 4.52.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 jobs cron configurés pour effectuer une opération de réparation sur Cassandra jusqu'à la fin de la mise à jour.
  2. Connectez-vous à votre nœud en tant qu'utilisateur racine pour installer les RPM Edge.
  3. Installez yum-utils et yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Désactivez SELinux comme décrit dans la section Installer l'utilitaire de configuration Edge Apigee.
  5. Si vous effectuez l'installation sur Oracle 7.x, exécutez la commande suivante: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. Si vous effectuez l'installation sur AWS, exécutez la commande suivante : Commandes yum-configure-manager: 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

  7. Si vous utilisez actuellement Edge 4.51.00:

    1. Téléchargez le fichier Edge bootstrap_4.52.02.sh sur /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 procédant comme suit : 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 Installation de Java. JAVA_FIX peut avoir les valeurs suivantes:

      • I: installez OpenJDK 1.8 (par défaut).
      • C: continuer sans installer Java.
      • Q: arrête. Pour utiliser cette option, vous devez installer Java vous-même.
    3. Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup, en tant que l'exemple suivant montre: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. Mettez à jour l'utilitaire apigee-validate sur le serveur de gestion, comme suit : dans cet exemple: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. Mettez à jour l'utilitaire apigee-provision sur le serveur de gestion, comme suit : dans cet exemple: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. Exécutez l'utilitaire update sur vos nœuds à l'aide de la commande suivante: 
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

      Où :

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

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

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

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

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

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

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

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

Pour effectuer la mise à jour à partir d'un dépôt 4.52.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". à Installez l'utilitaire de configuration Edge apigee.
  2. Pour installer apigee-service à partir d'un fichier .tar: <ph type="x-smartling-placeholder">
      </ph>
    1. Sur le nœud contenant le dépôt local, empaquetez le dépôt à l'aide de la commande suivante : dans un seul fichier .tar nommé /opt/apigee/data/apigee-mirror/apigee-4.52.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 sur le nouveau nœud.
    3. Sur le nouveau nœud, décompressez le fichier dans le répertoire /tmp: 
      tar -xzf apigee-4.52.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: <ph type="x-smartling-placeholder">
      </ph>
    1. Configurez le serveur Web Nginx comme indiqué dans la section "Installer à partir du dépôt à l'aide de la commande webserver&quot; dans la section Installer Edge utilitaire de configuration apigee.
    2. Sur le nœud distant, téléchargez le fichier Edge bootstrap_4.52.02.sh pour /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 est le nom d'utilisateur et le mot de passe que vous avez définis précédemment pour le dépôt, et remoteRepo est l'adresse IP ou le nom DNS du nœud du dépôt.

    3. Sur le nœud distant, installez l'utilitaire Edge apigee-setup et les dépendances: 
      sudo bash /tmp/bootstrap_4.52.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, en tant que l'exemple suivant montre: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Mettez à jour l'utilitaire apigee-validate sur le serveur de gestion, comme suit : dans cet exemple: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Mettez à jour l'utilitaire apigee-provision sur le serveur de gestion, comme suit : dans cet exemple: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Exécutez l'utilitaire update sur vos nœuds dans l'ordre décrit dans la section Ordre des mises à jour de la machine: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Où :

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

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

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

Si vous décidez ultérieurement d'effectuer un rollback de la mise à jour, suivez la procédure décrite dans Roll back 4.52.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 d'effectuer la mise à jour d'autres nœuds.
  • Pour toute machine dotée de plusieurs composants Edge (serveur de gestion, processeur de messages, (routeur, serveur QPID, mais pas serveur Postgres), utilisez l'option -c edge pour effectuer la mise à jour tous en même temps.
  • Si une étape indique qu'elle doit être exécutée sur plusieurs machines, effectuez-la dans le l'ordre de machine spécifié.
  • Il n'y a pas d'étape distincte pour mettre à jour la monétisation. Il est mis à jour lorsque vous spécifiez Option -c edge.

Mise à niveau autonome à un nœud

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

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

Mise à niveau autonome à 2 nœuds

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

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

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

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

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

Mise à niveau de cinq nœuds

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

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

  1. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Mettez à jour Postgres sur la machine 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Mettez à jour Postgres sur la machine 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Mise à jour de LDAP sur la machine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Mettez à jour les composants Edge sur les machines 4, 5, 1, 2, 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Mettez à jour Qpid sur la machine 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Mettez à jour Qpid sur la machine 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Mettez à jour l'interface utilisateur Edge: <ph type="x-smartling-placeholder">
      </ph>
    • Interface utilisateur classique:si vous utilisez l'interface utilisateur classique, mettez à jour le ui sur la machine 1, comme le montre l'exemple suivant: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • Nouvelle interface utilisateur Edge:si vous avez installé la nouvelle interface utilisateur Edge, mettez à jour le ue sur la machine appropriée (il peut ne pas s'agir de la machine 1): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (Si vous avez installé apigee-adminapi) Mise à jour de l'utilitaire apigee-adminapi sur la machine 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (Si vous avez installé Apigee SSO) Mettez à jour l'authentification unique Apigee sur la machine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  11. Redémarrez le composant d'interface utilisateur: <ph type="x-smartling-placeholder">
      </ph>
    • Interface utilisateur classique:si vous utilisez l'interface utilisateur classique, redémarrez le edge-ui sur la machine 1, comme le montre l'exemple suivant: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nouvelle interface utilisateur Edge:si vous avez installé la nouvelle interface utilisateur Edge, redémarrez le edge-management-ui sur la machine appropriée (il ne peut pas s'agir d'une machine 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Mise à niveau en cluster à 9 nœuds

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

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

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

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

  10. Redémarrez le composant d'interface utilisateur: <ph type="x-smartling-placeholder">
      </ph>
    • Interface utilisateur classique:si vous utilisez l'interface utilisateur classique, redémarrez le edge-ui sur la machine 1, comme le montre l'exemple suivant: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nouvelle interface utilisateur Edge:si vous avez installé la nouvelle interface utilisateur Edge, redémarrez le edge-management-ui sur la machine appropriée (il ne peut pas s'agir d'une machine 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Mise à niveau en cluster à 13 nœuds

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

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

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

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

  10. Redémarrez le composant d'interface utilisateur: <ph type="x-smartling-placeholder">
      </ph>
    • Interface utilisateur classique:si vous utilisez l'interface utilisateur classique, redémarrez le edge-ui sur les machines 6 et 7, comme le montre l'exemple suivant: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nouvelle interface utilisateur Edge:si vous avez installé la nouvelle interface utilisateur Edge, redémarrez le Composant edge-management-ui sur les machines 6 et 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Mise à niveau en cluster à 12 nœuds

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

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

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

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

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

Pour une configuration non standard

Si vous disposez d'une configuration non standard, mettez à jour les composants Edge à la commande:

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

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