Apigee permet de mettre à niveau Edge pour Private Cloud à partir de la version 4.51.00 ou de la version 4.52.00 directement vers la version 4.52.01. Cette page explique comment effectuer ces deux 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 exécutant en tant que root.
Une fois les RPM Edge installés, n'importe qui peut les configurer.
Quels composants devez-vous mettre à jour ?
Vous devez mettre à jour tous les composants Edge. Edge n'est pas compatible avec une configuration contenant des composants de plusieurs versions.
Mettre à jour les prérequis
Assurez-vous de remplir les conditions préalables suivantes avant de mettre à niveau Apigee Edge:
- Sauvegardez tous les nœuds
Avant de procéder à la mise à jour, nous vous recommandons d'effectuer une sauvegarde complète de tous les nœuds pour des raisons de sécurité. Suivez la procédure pour votre version actuelle d'Edge pour effectuer la sauvegarde.Vous disposez ainsi d'un plan de secours au cas où la mise à jour vers une nouvelle version ne fonctionnerait pas correctement. Pour en savoir plus sur la sauvegarde, consultez la section 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 compaction Cassandra est
LeveledCompactionStrategy
Assurez-vous que la stratégie de compaction Cassandra est définie surLeveledCompactionStrategy
, comme décrit dans la section Modifier la stratégie de compaction Cassandra.
Propagation automatique des paramètres des établissements
Si vous avez défini des propriétés en modifiant des fichiers .properties
dans /opt/apigee/customer/application
, ces valeurs sont conservées par la mise à jour.
Mise à niveau vers Zookeeper 3.8.3 requise
Cette version d'Edge pour le cloud privé inclut une mise à niveau vers Zookeeper 3.8.3. Lors de cette mise à niveau, toutes les données Zookeeper seront migrées vers Zookeeper 3.8.3.
Avant de mettre à niveau Zookeeper, consultez le guide de maintenance de Zookeeper. La plupart des systèmes de production Edge utilisent un cluster de nœuds Zookeeper répartis sur plusieurs centres de données. Certains de ces nœuds sont configurés en tant que votants qui participent à l'élection du leader Zookeeper, et les autres sont configurés en tant qu'observateurs. Pour en savoir plus, consultez À propos des leaders, des suiveurs, des électeurs et des observateurs. Les nœuds électeurs élisent un leader, après quoi ils deviennent eux-mêmes des suiveurs.
Lors du processus de mise à jour, un délai momentané ou un échec d'écriture dans Zookeeper peut se produire lorsque le nœud leader est arrêté. Cela peut affecter les opérations de gestion qui écrivent dans Zookeeper, telles que l'opération de déploiement d'un proxy, et les modifications de l'infrastructure Apigee, telles que l'ajout ou la suppression d'un processeur de messages, etc. Aucune incidence ne devrait être observée sur les API d'exécution d'Apigee (sauf si ces API d'exécution appellent des API de gestion) lors de la mise à niveau de Zookeeper en suivant la procédure ci-dessous.
De manière générale, le processus de mise à niveau implique de créer une sauvegarde de chaque nœud. Ensuite, mettez à niveau tous les observateurs et les suiveurs, puis le nœud leader.
Effectuer une sauvegarde
Effectuez une sauvegarde de tous les nœuds de Zookeeper à utiliser en cas de rollback. Notez qu'un rollback rétablit Zookeeper à l'état au moment de la sauvegarde. Remarque:Tous les déploiements ou modifications d'infrastructure dans Apigee depuis la sauvegarde (dont les informations sont stockées dans Zookeeper) seront perdus lors de la restauration.
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup
Si vous utilisez des machines virtuelles et que vous en avez la possibilité, vous pouvez également prendre des instantanés ou des sauvegardes de VM pour les restaurer ou les annuler (si nécessaire).
Identifier le leader, les suiveurs et les observateurs
Remarque:Les exemples de commandes ci-dessous utilisent l'utilitaire nc pour envoyer des données à Zookeeper. Vous pouvez également utiliser d'autres utilitaires pour envoyer des données à Zookeeper.
- Si nc n'est pas installé sur le nœud ZooKeeper, installez-le:
sudo yum install nc
- Exécutez la commande nc suivante sur le nœud, où 2181 correspond au port ZooKeeper:
echo stat | nc localhost 2181
Vous devriez voir une sortie semblable à ce qui suit.
Zookeeper version: 3.8.3-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC Clients: /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0) Latency min/avg/max: 0/0.2518/41 Received: 647228 Sent: 647339 Connections: 4 Outstanding: 0 Zxid: 0x400018b15 Mode: follower Node count: 100597
Dans la ligne
Mode
de la sortie des nœuds, vous devriez voir "observer", "leader" ou "follower" (un votant qui n'est pas le leader), en fonction de la configuration du nœud. Remarque:Dans une installation autonome d'Edge avec un seul nœud ZooKeeper,Mode
est défini sur "standalone" (autonome). - Répétez les étapes 1 et 2 sur chaque nœud ZooKeeper.
Mettre à niveau ZooKeeper sur les nœuds d'observateur et de suiveur
Mettez à niveau Zookeeper sur chacun des nœuds d'observateur et de suiveur comme suit:
- Téléchargez et exécutez le bootstrap d'Edge pour Private Cloud 4.52, comme décrit dans la section Mettre à niveau vers la version 4.52.01 sur un nœud avec une connexion Internet externe. La procédure varie probablement selon que le nœud dispose d'une connexion Internet externe ou que vous effectuez une installation hors connexion.
- Mettez à niveau le composant Zookeeper:
Remarque:Si d'autres composants sont installés sur ces nœuds (tels que Cassandra), vous pouvez également les mettre à niveau maintenant (comme avec le profil cs,zk) ou les mettre à niveau ultérieurement. Apigee vous recommande de commencer par mettre à niveau Zookeeper et de vous assurer que votre cluster fonctionne correctement avant de mettre à niveau d'autres composants./opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
- Répétez les étapes ci-dessus pour chacun des nœuds d'observateur et de suiveur Zookeeper.
Arrêter le leader
Une fois tous les nœuds d'observateur et de suiveur mis à niveau, arrêtez le nœud principal. Sur le nœud identifié comme leader, exécutez la commande ci-dessous:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
Notez que pendant cet événement, avant qu'un nouveau leader ne soit élu, des retards momentanés ou des échecs d'écriture peuvent se produire dans Zookeeper. Cela peut affecter les opérations qui écrivent dans Zookeeper, telles que l'action de déploiement des proxys ou les modifications d'infrastructure Apigee, telles que l'ajout ou la suppression de processeurs de messages, etc.
Vérifier que le nouveau leader est élu
Suivez la procédure décrite dans la section Identifier le leader, les suiveurs et les observateurs ci-dessus pour vérifier qu'un nouveau leader a été élu parmi les suiveurs une fois que le leader existant a été arrêté. Notez que le leader peut avoir été élu dans un centre de données différent de celui du leader actuel.
Leader de la mise à niveau
Suivez la même procédure que pour Mettre à niveau Zookeeper sur les nœuds d'observateur et de suiveur ci-dessus.
Une fois l'ancien nœud leader mis à niveau, vérifiez l'état du cluster et assurez-vous qu'il existe un nœud leader.
Rollback
En cas de rollback:
- Effectuez d'abord les étapes de rollback sur les observateurs et les abonnés.
- Téléchargez et exécutez le bootstrap de la version vers laquelle vous effectuez le rollback (4.50 ou 4.51). La procédure varie probablement selon que le nœud dispose d'une connexion Internet externe ou que vous suivez une installation hors connexion.
- Arrêtez ZooKeeper s'il est en cours d'exécution sur le nœud:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
- Désinstallez zookeeper existant:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
- Installez ZooKeeper comme d'habitude:
/opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
- Une fois tous les suiveurs et les observateurs annulés, annulez le nœud principal en suivant les étapes 2 à 5 sur le nœud principal.
- Une fois tous les nœuds annulés, vérifiez l'état du cluster et assurez-vous qu'il existe un nœud leader dans le cluster.
Restaurer une sauvegarde
Consultez Restaurer à partir d'une sauvegarde. Notez que les sauvegardes de Zookeeper issues de versions antérieures d'Edge pour le cloud privé, telles que les versions 4.50 et 4.51, doivent être compatibles avec la version de Zookeeper dans Edge pour le cloud privé 4.52.
Mise à niveau vers Postgres 14 requise
Cette version d'Edge pour le cloud privé inclut une mise à niveau vers Postgres 14. Dans le cadre de cette mise à niveau, toutes les données Postgres sont migrées vers Postgres 14.
- Si vous passez de la version 4.51.00 d'Edge pour le cloud privé à la version 4.52.01, vous devez suivre des étapes de mise à niveau supplémentaires pour Postgres. Consultez la section Mise à niveau requise vers Postgres 14 si vous passez de la version 4.51.00 à la version 4.52.01.
- Si vous passez de la version 4.52.00 d'Edge pour le cloud privé à la version 4.52.01, aucune étape de mise à niveau supplémentaire de Postgres n'est nécessaire.
Mettre à niveau Qpid
Cette version d'Edge pour le cloud privé inclut une mise à niveau de Qpid J-Broker.
Nous vous recommandons de sélectionner l'une des méthodes suivantes pour effectuer la mise à niveau de Qpid:
Mise à niveau sur place sans temps d'arrêt
Cette méthode garantit qu'il n'y a pas de temps d'arrêt pour votre environnement d'exécution Edge et minimise la perte de données d'exécution, le cas échéant, acquises pour l'analyse.
Pour effectuer une mise à niveau sur place sans temps d'arrêt vers Qpid:
- Choisissez un nœud Qpid pour commencer.
- Arrêtez le courtier Qpid sur le nœud:
apigee-service apigee-qpidd stop
- Bloquez le trafic entrant sur le port de courtier 5672 de tous les processeurs de messages en appliquant un pare-feu. Vous pouvez appliquer ce pare-feu au niveau de l'instance de nœud Qpid ou d'un autre composant réseau/pare-feu externe.
Nous vous recommandons d'effectuer la même opération pour toutes les adresses IP des processeurs de messages. Par exemple, pour supprimer les requêtes provenant des adresses IP du processeur de messages vers le nœud Qpid sur le port 5672 à l'aide d'IPTables, vous pouvez utiliser une commande comme celle-ci:
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
- Redémarrez le broker Qpid pour vider les messages existants, le cas échéant:
apigee-service apigee-qpidd start
- Vérifiez que les files d'attente existantes sont vides:
qpid-stat -q
Si des messages sont bloqués dans la file d'attente de messages non distribués (ax-q-axgroup-001-consumer-group-001-dl), vidangez la file d'attente en suivant ces étapes pour résoudre les problèmes liés aux données analytiques bloquées dans la file d'attente de messages non distribués.
- Après avoir vérifié que les files d'attente ont été vidées sur l'ancien nœud, arrêtez
apigee-qpidd
:apigee-service apigee-qpidd stop
- Mettez à niveau Qpid sur le nœud:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Redémarrez
edge-qpid-server
:apigee-service edge-qpid-server restart
Supprimez la règle de pare-feu appliquée à l'étape 3.
Suivez la même procédure de suppression pour toutes les adresses IP des processeurs de messages auxquelles le pare-feu a été appliqué. Une fois les pare-feu supprimés, les requêtes provenant des adresses IP des processeurs de messages vers le nœud Qpid sur le port 5672 seront acceptées. Si vous avez utilisé
iptables
pour ajouter le pare-feu, le supprimer et lister les paramètres existants, vous pouvez utiliser des commandes comme celles-ci:iptables -F iptables -L
- Utilisez la surveillance Web pour vérifier que les files d'attente Qpid reçoivent des messages:
http://QPID_NODE_IP:8090
- Répétez les étapes 1 à 9 pour chaque nœud Qpid.
Mise en service d'un nouveau nœud Qpid
Cette méthode configure et installe apigee-qpidd
et edge-qpid-server
sur un nouveau nœud.
- Ajoutez un nœud Qpid. Cette étape configure un nœud Qpid avec J-broker. Pour connaître la procédure détaillée, consultez Ajouter un serveur Qpid.
- Sélectionnez un nœud Qpid existant (un nœud de la version à partir de laquelle vous effectuez la mise à niveau).
- Arrêtez le courtier Qpid sur le nœud:
apigee-service apigee-qpidd stop
- Bloquez le trafic entrant sur le port de courtier 5672 de tous les processeurs de messages en appliquant un pare-feu. Vous pouvez appliquer ce pare-feu au niveau de l'instance de nœud Qpid ou d'un autre composant réseau/pare-feu externe.
Nous vous recommandons d'effectuer la même opération pour toutes les adresses IP des processeurs de messages. Par exemple, pour supprimer les requêtes provenant des adresses IP du processeur de messages vers le nœud Qpid sur le port 5672 à l'aide d'IPTables, vous pouvez utiliser une commande comme celle-ci:
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
- Redémarrez le broker Qpid pour vider les messages existants, le cas échéant:
apigee-service apigee-qpidd start
- Vérifiez que les files d'attente existantes sont vides:
qpid-stat -q
Si des messages sont bloqués dans la file d'attente de messages non distribués (DLQ, ax-q-axgroup-001-consumer-group-001-dl), vidangez la file d'attente en suivant la procédure décrite dans l'article de dépannage Données Analytics bloquées dans la file d'attente de messages non distribués Qpidd.
- Après avoir vérifié que les files d'attente ont été vidées sur l'ancien nœud, arrêtez
apigee-qpidd
.apigee-service apigee-qpidd stop
- Désinscrivez l'ancien nœud Qpid en suivant la procédure décrite dans la section Supprimer un serveur Qpid.
- Continuez à ajouter un nouveau nœud et à supprimer un ancien nœud, un par un, jusqu'à ce que tous les nœuds Qpid soient mis à niveau.
Rollback
Pour effectuer un rollback vers une version précédente, veillez à télécharger le fichier bootstrap.sh
de la version vers laquelle vous souhaitez effectuer un rollback. Pour revenir à la version 4.52.00, téléchargez bootstrap_4.52.00.sh
.
Pour effectuer un rollback de Qpid, procédez comme suit sur tous les hôtes Qpid:
- Arrêter le courtier Qpid existant
apigee-service apigee-qpidd stop
- Bloquez le trafic entrant sur le port de courtier 5672 de tous les processeurs de messages en appliquant un pare-feu. Vous pouvez appliquer ce pare-feu au niveau de l'instance de nœud Qpid ou d'un autre composant réseau/pare-feu externe.
Nous vous recommandons d'effectuer la même opération pour toutes les adresses IP des processeurs de messages. Par exemple, pour supprimer les requêtes provenant des adresses IP du processeur de messages vers le nœud Qpid sur le port 5672 à l'aide d'IPTables, vous pouvez utiliser une commande comme celle-ci:
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
- Redémarrez le broker qpid pour vider les messages existants, le cas échéant:
apigee-service apigee-qpidd start
- Assurez-vous que les files d'attente existantes sont vides. Pour le vérifier, connectez-vous au portail de gestion Qpid:
Remarque : Si le port 8090 du nœud QPID n'est pas accessible, vous pouvez utiliser d'autres mécanismes, tels que le transfert de port SSH, pour accéder à cette URL.http://QPID_NODE_IP:8090
- Après avoir vérifié que les files d'attente sont vides, arrêtez et désinstallez Qpid:
apigee-service apigee-apidd uninstall
- Supprimez le répertoire de données Qpid:
rm -r APIGEE_ROOT/data/apigee-qpidd
- Réinstallez le broker Qpid:
/opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
- Une fois le courtier Qpid réinstallé, supprimez les paramètres du pare-feu et listez les paramètres existants à l'aide des commandes suivantes:
iptables -F
iptables -L
Nouvelle interface utilisateur Edge
Cette section présente les considérations concernant l'UI Edge. Pour en savoir plus, consultez la section Nouvelle interface utilisateur Edge pour le cloud privé.
Installer l'UI Edge
Une fois l'installation initiale terminée, Apigee vous recommande d'installer l'UI Edge, qui est une interface utilisateur améliorée pour les développeurs et les administrateurs d'Apigee Edge pour le cloud privé.
Notez que l'UI Edge vous oblige à désactiver l'authentification de base et à utiliser un IDP tel que SAML ou LDAP.
Pour en savoir plus, consultez Installer la nouvelle interface utilisateur d'Edge.
Mettre à jour l'UI d'Edge
Pour mettre à jour le composant de l'interface utilisateur Edge, tenez compte de 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 (la nouvelle interface utilisateur Edge est déjà installée): suivez les instructions de mise à niveau de cette section pour le composant
edge-management-ui
.
Mise à jour avec mTLS Apigee
Pour mettre à jour mTLS Apigee , 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 d'exécuter à nouveau update.sh
. Vous pouvez exécuter la mise à jour plusieurs fois. Elle reprendra là où elle s'était arrêtée.
Si l'échec nécessite de revenir à la version précédente, consultez Revenir à 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 l'utilisateur qui exécute l'utilitaire update.sh
n'a pas accès à ce répertoire, le journal est écrit dans le répertoire /tmp
sous la forme d'un fichier nommé update_username.log
.
Si l'utilisateur n'a pas accès à /tmp
, l'utilitaire update.sh
échoue.
Mise à jour sans temps d'arrêt
Une mise à jour sans temps d'arrêt, ou mise à jour progressive, vous permet de mettre à jour votre installation d'Edge sans l'arrêter.
La mise à jour sans temps d'arrêt n'est possible qu'avec une configuration de cinq nœuds ou plus.
La clé d'une mise à niveau sans temps d'arrêt est de supprimer chaque routeur, un par un, de l'équilibreur de charge. Vous devez ensuite mettre à jour le routeur et tous les autres composants sur la même machine que le routeur, puis ajouter le routeur à nouveau à l'équilibreur de charge.
- Mettez à jour les machines dans l'ordre approprié pour votre installation, comme décrit dans la section Ordre de mise à jour des machines.
- Lorsque vous devez mettre à jour les routeurs, sélectionnez un routeur et rendez-le inaccessible, comme décrit dans la section Activer/Désactiver la connectivité des serveurs (Message Processor/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.
- Rendre le routeur accessible à nouveau.
- Répétez les étapes 2 à 4 pour les autres routeurs.
- Poursuivez la mise à jour des machines restantes de votre installation.
Avant et après la mise à jour, veillez à prendre en compte les points suivants:
- Sur le nœud routeur et processeur de messages combiné :
- Avant la mise à jour, procédez comme suit :
- Rendre le routeur inaccessible.
- Rendez le processeur de messages inaccessible.
- Après la mise à jour, procédez comme suit :
- Rendre le processeur de messages accessible.
- Rendre le routeur accessible
- Avant la mise à jour, procédez comme suit :
- Sur des nœuds de routeur uniques :
- Avant la mise à jour, rendre le routeur inaccessible.
- Après la mise à jour, rendre le routeur accessible.
- Sur des nœuds de processeur de messages uniques :
- Avant la mise à jour, rendre le processeur de messages inaccessible.
- Après la mise à jour, rendre le processeur de messages accessible.
Utiliser un fichier de configuration silencieux
Vous devez transmettre un fichier de configuration silencieux à la commande de mise à jour. Le fichier de configuration silencieuse doit être le même que celui que vous avez utilisé pour installer Edge 4.50.00 ou 4.51.00.
Mise à jour vers la version 4.52.01 sur un nœud avec une connexion Internet externe
Pour mettre à jour les composants Edge sur un nœud, procédez comme suit:
- Le cas échéant, désactivez toutes les tâches
cron
configurées pour effectuer une opération de réparation sur Cassandra jusqu'à la fin de la mise à jour. - 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 Installer l'utilitaire apigee-setup Edge.
- 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
bootstrap_4.52.01.sh
d'Edge dans/tmp/bootstrap_4.52.01.sh
:curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
- Installez l'utilitaire
apigee-service
et les dépendances d'Edge 4.52.01 en exécutant la commande suivante:sudo bash /tmp/bootstrap_4.52.01.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 installé. Dans le cas contraire, 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
prend les valeurs suivantes:I
: installez OpenJDK 1.8 (par défaut).C
: continuer sans installer Java.Q
: Quitter. Pour cette option, vous devez installer Java vous-même.
- Utilisez
apigee-service
pour mettre à jour l'utilitaireapigee-setup
, comme illustré dans 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 en exécutant la commande suivante:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Faites-le dans l'ordre décrit dans la section Ordre de mise à jour des machines.
Où :
- component est le composant Edge à mettre à jour. Les valeurs possibles sont les suivantes :
cs
: Cassandraedge
: tous les composants Edge, à l'exception de l'UI Edge: serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: SSO Apigee (si vous avez installé le SSO)ue
: nouvelle interface utilisateur Edgeui
: interface utilisateur Edge classiquezk
: ZooKeeper
- configFile est le même fichier de configuration que celui que vous avez utilisé pour définir vos composants Edge lors de l'installation de la version 4.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 tout-en-un (AIO) Edge. 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 les composants de l'interface utilisateur Edge sur tous les nœuds qui les exécutent, si ce n'est 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.
- Téléchargez le fichier
Si vous décidez par la suite de revenir à la version précédente, suivez la procédure décrite dans la section Revenir à la version 4.52.01.
Mise à jour vers la version 4.52.01 à partir d'un dépôt local
Si vos nœuds Edge sont protégés par un pare-feu ou s'ils ne sont pas autorisés à accéder au dépôt Apigee via Internet, vous pouvez effectuer la mise à jour à partir d'un dépôt local (ou miroir) du dépôt Apigee.
Une fois que vous avez 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 sur un nœud, puis mettez à jour Edge à partir du fichier .tar.
- Installez un serveur Web sur le nœud avec le dépôt local afin que les autres nœuds puissent y accéder. Apigee fournit le serveur Web Nginx que vous pouvez utiliser, ou vous pouvez utiliser votre propre serveur Web.
Pour mettre à jour à partir d'un dépôt local 4.52.01:
- Créez un dépôt local 4.52.01, comme décrit dans la section "Créer un dépôt Apigee local" de la page Installer l'utilitaire apigee-setup Edge.
- Pour installer apigee-service à partir d'un fichier .tar :
- Sur le nœud avec le dépôt local, utilisez la commande suivante pour empaqueter le dépôt local dans un seul fichier .tar nommé
/opt/apigee/data/apigee-mirror/apigee-4.52.01.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.01.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
apigee-service
Edge et les dépendances à partir de/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.52.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Notez que vous devez inclure le chemin d'accès au répertoire des dépôts dans cette commande.
- Sur le nœud avec le dépôt local, utilisez la commande suivante pour empaqueter le dépôt local dans un seul fichier .tar nommé
- 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 Installer l'utilitaire apigee-setup Edge.
- Sur le nœud distant, téléchargez le fichier
bootstrap_4.52.01.sh
Edge dans/tmp/bootstrap_4.52.01.sh
:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.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
apigee-setup
Edge et les dépendances:sudo bash /tmp/bootstrap_4.52.01.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 illustré dans 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 de mise à 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 les composants suivants :
cs
: Cassandraedge
: tous les composants Edge, à l'exception de l'UI Edge: serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: SSO Apigee (si vous avez installé le SSO)ue
Nouvelle interface utilisateur Edgeui
: interface utilisateur Edge classiquezk
: ZooKeeper
- configFile est le même fichier de configuration que celui que vous avez utilisé pour définir vos composants Edge lors de l'installation de la version 4.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 tout-en-un (AIO) Edge. 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 d'interface utilisateur sur tous les nœuds qui les exécutent, si ce n'est 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 par la suite de revenir à la version précédente, suivez la procédure décrite dans la section Revenir à la version 4.52.01.
Ordre de mise à 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 d'autres nœuds.
- Pour toute machine comportant plusieurs composants Edge (serveur de gestion, processeur de messages, routeur, serveur QPID, mais pas le serveur Postgres), utilisez l'option
-c edge
pour les mettre à jour tous en même temps. - Si une étape indique qu'elle doit être effectuée sur plusieurs machines, effectuez-la dans l'ordre des machines spécifié.
- Il n'existe pas d'étape distincte pour mettre à jour la monétisation. Il est mis à jour lorsque vous spécifiez l'option
-c edge
.
Mise à niveau autonome d'un nœud
Pour mettre à niveau une configuration autonome à un nœud vers la version 4.52.01:
- Mettez à 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 à deux nœuds
Mettez à jour les composants suivants pour une installation autonome à deux nœuds:
Pour obtenir la liste des topologies Edge et des numéros de nœuds, consultez la section Topologies d'installation.
- 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
- Mettez à 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
- Mettez à jour Qpid sur la machine 2:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Mettez à jour l'UI sur la machine 1:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (Si vous avez installé
apigee-adminapi
) Vous avez mis à jour l'utilitaireapigee-adminapi
sur la machine 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Si vous avez installé l'authentification unique Apigee) Mettez à jour l'authentification unique Apigee sur la machine 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
où sso_config_file est le fichier de configuration que vous avez créé lorsque vous avez installé l'authentification unique.
- Redémarrez le composant d'interface utilisateur Edge 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:
Pour obtenir la liste des topologies Edge et des numéros de nœuds, consultez la section Topologies d'installation.
- 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
- Mettez à 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 4, 5, 1, 2 et 3:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Mettez à jour Qpid sur la machine 4:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Mettez à jour Qpid sur la machine 5:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Mettez à jour l'interface utilisateur Edge :
- UI classique:si vous utilisez l'UI classique, mettez à jour le composant
ui
sur la machine 1, comme illustré dans l'exemple suivant:/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- Nouvelle interface utilisateur Edge:si vous avez installé la nouvelle interface utilisateur Edge, mettez à jour le composant
ue
sur la machine appropriée (qui ne sera peut-être pas la machine 1):/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
- UI classique:si vous utilisez l'UI classique, mettez à jour le composant
- (Si vous avez installé
apigee-adminapi
) Vous avez mis à jour l'utilitaireapigee-adminapi
sur la machine 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Si vous avez installé l'authentification unique Apigee) Mettez à jour l'authentification unique Apigee sur la machine 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
où sso_config_file est le fichier de configuration que vous avez créé lorsque vous avez installé l'authentification unique.
- Redémarrez le composant d'UI :
- Interface utilisateur classique:si vous utilisez l'interface utilisateur classique, redémarrez le composant
edge-ui
sur la machine 1, comme illustré dans l'exemple suivant:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Nouvelle interface utilisateur Edge:si vous avez installé la nouvelle interface utilisateur Edge, redémarrez le composant
edge-management-ui
sur la machine appropriée (qui ne sera peut-être pas 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 d'un cluster à 9 nœuds
Mettez à jour les composants suivants pour une installation en cluster à neuf nœuds:
Pour obtenir la liste des topologies Edge et des numéros de nœuds, consultez la section Topologies d'installation.
- 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
- Mettez à 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 l'ordre suivant:
/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é l'authentification unique Apigee) Mettez à jour l'authentification unique Apigee sur la machine 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
où sso_config_file est le fichier de configuration que vous avez créé lorsque vous avez installé l'authentification unique.
- Redémarrez le composant d'UI :
- Interface utilisateur classique:si vous utilisez l'interface utilisateur classique, redémarrez le composant
edge-ui
sur la machine 1, comme illustré dans l'exemple suivant:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Nouvelle interface utilisateur Edge:si vous avez installé la nouvelle interface utilisateur Edge, redémarrez le composant
edge-management-ui
sur la machine appropriée (qui ne sera peut-être pas 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 du cluster à 13 nœuds
Mettez à jour les composants suivants pour une installation en cluster à 13 nœuds:
Pour obtenir la liste des topologies Edge et des numéros de nœuds, consultez la section Topologies d'installation.
- 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
- Mettez à 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 l'ordre suivant:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Mettez à 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é l'authentification unique Apigee) Mettez à jour l'authentification unique Apigee sur les machines 6 et 7:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
où sso_config_file est le fichier de configuration que vous avez créé lorsque vous avez installé l'authentification unique.
- Redémarrez le composant d'UI :
- UI classique:si vous utilisez l'UI classique, redémarrez le composant
edge-ui
sur les machines 6 et 7, comme illustré dans l'exemple suivant:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Nouvelle interface utilisateur Edge:si vous avez installé la nouvelle interface utilisateur Edge, redémarrez le composant
edge-management-ui
sur les machines 6 et 7:/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- UI classique:si vous utilisez l'UI classique, redémarrez le composant
Mise à niveau d'un cluster à 12 nœuds
Mettez à jour les composants suivants pour une installation en cluster à 12 nœuds:
Pour obtenir la liste des topologies Edge et des numéros de nœuds, consultez la section Topologies d'installation.
- 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 du 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 du centre de données 1
- Mise à jour du 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 et 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 du centre de données 2
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Machines 4, 5, 6, 1, 2 et 3 du centre de données 1
- Mettez à jour qpidd :
- Machines 4 et 5 du centre de données 1
- Mettez à jour
qpidd
sur la machine 4:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Mettez à jour
qpidd
sur la machine 5:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Mettez à jour
- Machines 10 et 11 du centre de données 2
- Mettez à jour
qpidd
sur la machine 10:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Mettez à jour
qpidd
sur la machine 11:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Mettez à jour
- Machines 4 et 5 du centre de données 1
- Mettez à jour la nouvelle interface utilisateur (
ue
) ou l'interface utilisateur classique (ui
) :- Machine 1 du centre de données 1:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Machine 7 du centre de données 2:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Machine 1 du centre de données 1:
- (Si vous avez installé
apigee-adminapi
) Mise à jour de l'utilitaireapigee-adminapi
:- Machine 1 du centre de données 1:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Machine 7 du centre de données 2:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Machine 1 du centre de données 1:
- (Si vous avez installé l'authentification unique Apigee) Mettez à jour l'authentification unique Apigee :
- Machine 1 du centre de données 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- Machine 7 du centre de données 2:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
où sso_config_file est le fichier de configuration que vous avez créé lorsque vous avez installé l'authentification unique.
- Machine 1 du centre de données 1:
- Redémarrez le composant de la nouvelle interface utilisateur Edge (
edge-management-ui
) ou de l'interface utilisateur Edge classique (edge-ui
) sur les machines 1 et 7:/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
Pour une configuration non standard
Si vous disposez d'une configuration non standard, mettez à jour les composants Edge dans l'ordre suivant:
- ZooKeeper
- Cassandra
- ps
- LDAP
- Edge, c'est-à-dire le profil "-c edge" sur tous les nœuds dans l'ordre suivant: nœuds avec serveur Qpid, serveur Postgres Edge, 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 d'interface utilisateur Edge sur toutes les machines qui l'exécutent.