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 surLeveledCompactionStrategy
, 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
- Cassandra dans Apigee s'exécutant avec la version 2.1.22.
- 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.
- Modifiez Cassandra pour utiliser LeveledCompactionStrategy.
- Sauvegardez Cassandra à l'aide d'Apigee.
- Prenez des instantanés de VM des nœuds Cassandra (si possible).
-
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
-
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
-
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
-
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:
- De la version 4.51.00 à la version 4.52.00 (avec la nouvelle interface utilisateur Edge déjà installée): suivez les instructions de mise à niveau de cette section pour le composant
edge-management-ui
.
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.
- Mettez à jour les machines dans le bon ordre pour votre installation, comme indiqué dans l'ordre des mises à jour des machines.
- 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).
- 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.
- Rendez le routeur à nouveau accessible.
- Répétez les étapes 2 à 4 pour les routeurs restants.
- 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 :
- Avant la mise à jour :
- Rendez le routeur inaccessible.
- Rendre le processeur de messages inaccessible.
- Après la mise à jour :
- Rendez le processeur de messages accessible.
- Rendez le routeur accessible.
- Avant la mise à jour :
- Sur des nœuds de routeur uniques :
- Avant la mise à jour, rendez le routeur inaccessible.
- Après la mise à jour, rendez le routeur accessible.
- Sur les nœuds uniques du processeur de messages :
- Avant la mise à jour, rendez le processeur de messages inaccessible.
- Après la mise à jour, rendez le processeur de messages accessible.
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:
- 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. - Connectez-vous à votre nœud en tant qu'utilisateur racine pour installer les RPM Edge.
- Installez
yum-utils
etyum-plugin-priorities
:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- Désactivez SELinux comme décrit dans la section Installer l'utilitaire de configuration Edge d'Apigee.
- Si vous effectuez l'installation sur Oracle 7.x, exécutez la commande suivante :
sudo yum-config-manager --enable ol7_optional_latest
- Si vous effectuez l'installation sur AWS, exécutez les commandes
yum-configure-manager
suivantes :yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Si vous utilisez actuellement Edge 4.51.00:
- 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
- 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.
- Utilisez
apigee-service
pour mettre à jour l'utilitaireapigee-setup
, comme le montre l'exemple suivant :/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- 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
- 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
- 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
: Cassandraedge
: tous les composants Edge à l'exception de l'interface utilisateur Edge: serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: authentification unique Apigee (si vous avez installé SSO)ue
: nouvelle interface utilisateur Edgeui
: UI classique Edgezk
: 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
- component est le composant Edge à mettre à jour. Les valeurs possibles sont les suivantes :
- 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
- 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.
- Téléchargez le fichier Edge
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:
- 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.
- Pour installer apigee-service à partir d'un fichier .tar :
- 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
- 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. - 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
. - 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".
- 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é
- Pour installer apigee-service à l'aide du serveur Web Nginx:
- 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.
- 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.
- 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.
- Utilisez
apigee-service
pour mettre à jour l'utilitaireapigee-setup
, comme le montre l'exemple suivant :/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- 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
- 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
- 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
: Cassandraedge
: tous les composants Edge à l'exception de l'interface utilisateur Edge: serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: authentification unique Apigee (si vous avez installé SSO)ue
Nouvelle interface utilisateur Edgeui
: UI classique Edgezk
: 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
- component est le composant Edge à mettre à jour. Vous mettez généralement à jour les composants suivants :
- 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
- 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:
- Mettre à jour tous les composants :
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
- (Si vous avez installé
apigee-adminapi
) Mise à jour de l'utilitaireapigee-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.
- Mettez à jour Cassandra et ZooKeeper sur la machine 1 :
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Mettez à jour Postgres sur la machine 2 :
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Mettre à jour LDAP sur la machine 1 :
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Mettez à jour les composants Edge sur les machines 2 et 1 :
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Mettre à jour Qpid sur la machine 2 :
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Mettez à jour l'interface utilisateur sur la machine 1 :
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (Si vous avez installé
apigee-adminapi
) Mise à jour de l'utilitaireapigee-adminapi
sur la machine 1 :/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (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.
- 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.
- Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3 :
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Mettez à jour Postgres sur la machine 4 :
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Mettez à jour Postgres sur la machine 5 :
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Mettre à jour LDAP sur la machine 1 :
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Mettre à jour les composants Edge sur les machines 4, 5, 1, 2, 3 :
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Mettre à jour Qpid sur la machine 4 :
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Mettre à jour Qpid sur la machine 5 :
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 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
- Interface utilisateur classique:si vous utilisez l'interface utilisateur classique, mettez à jour le composant
- (Si vous avez installé
apigee-adminapi
) Mise à jour de l'utilitaireapigee-adminapi
sur la machine 1 :/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (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.
- 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
- Interface utilisateur classique:si vous utilisez l'interface utilisateur classique, redémarrez le composant
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.
- Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3 :
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Mettez à jour Postgres sur la machine 8 :
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Mettez à jour Postgres sur la machine 9 :
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Mettre à jour LDAP sur la machine 1 :
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 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
- Mettez à jour Qpid sur les machines 6 et 7 :
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 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
- (Si vous avez installé
apigee-adminapi
) Mettez à jour l'utilitaireapigee-adminapi
sur la machine 1 :/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (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.
- 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
- Interface utilisateur classique:si vous utilisez l'interface utilisateur classique, redémarrez le composant
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.
- Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3 :
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Mettez à jour Postgres sur la machine 8 :
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Mettez à jour Postgres sur la machine 9 :
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Mettre à jour LDAP sur les machines 4 et 5 :
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 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
- Mettre à jour Qpid sur les machines 12 et 13 :
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 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
- (Si vous avez installé
apigee-adminapi
) Mise à jour de l'utilitaireapigee-adminapi
sur les machines 6 et 7 :/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (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.
- 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
- Interface utilisateur classique:si vous utilisez l'interface utilisateur classique, redémarrez le composant
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.
- Mettez à jour Cassandra et ZooKeeper :
- 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
- 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
- Sur les machines 1, 2 et 3 du centre de données 1 :
- Mettez à jour Postgres :
- Machine 6 dans le centre de données 1
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Machine 12 dans le centre de données 2
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Machine 6 dans le centre de données 1
- Mise à jour LDAP :
- Machine 1 dans le centre de données 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Machine 7 dans le centre de données 2
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Machine 1 dans le centre de données 1
- Mettez à jour les composants Edge :
- Machines 4, 5, 6, 1, 2, 3 du centre de données 1
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 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
- Machines 4, 5, 6, 1, 2, 3 du centre de données 1
- Mettez à jour Qpidd :
- Machines 4 et 5 dans le centre de données 1
- Mise à jour de
qpidd
sur la machine 4 :/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Mise à jour de
qpidd
sur la machine 5 :/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Mise à jour de
- Machines 10 et 11 dans le centre de données 2
- Mise à jour de
qpidd
sur la machine 10 :/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Mise à jour
qpidd
sur la machine 11 :/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Mise à jour de
- Machines 4 et 5 dans le centre de données 1
- Mettez à jour la nouvelle interface utilisateur (
ue
) ou l'interface utilisateur classique (ui
) :- Machine 1 dans le centre de données 1 :
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Machine 7 dans le centre de données 2 :
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Machine 1 dans le centre de données 1 :
- (Si vous avez installé
apigee-adminapi
) Mise à jour de l'utilitaireapigee-adminapi
:- Machine 1 dans le centre de données 1 :
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Machine 7 dans le centre de données 2 :
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Machine 1 dans le centre de données 1 :
- (Si vous avez installé Apigee SSO) Mettez à jour l'authentification unique Apigee :
- Machine 1 dans le centre de données 1 :
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- Machine 7 dans le centre de données 2 :
/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.
- Machine 1 dans le centre de données 1 :
- 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:
- ZooKeeper
- Cassandra
- ps
- LDAP
- 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.
- qpidd
- Interface utilisateur Edge (classique ou nouvelle)
apigee-adminapi
- SSO Apigee
Une fois la mise à jour terminée, veillez à redémarrer le composant Edge UI sur toutes les machines qui l'exécutent.