Edge pour le cloud privé v4.18.01
Quelles versions d'Edge peuvent être mises à jour vers la version 4.18.01
Vous pouvez mettre à jour Apigee Edge versions 4.16.01.0x et 4.16.05.x vers la version 4.18.01 en suivant cette procédure.
Si vous disposez d'une version d'Edge antérieure à la version 4.16.01, vous devez d'abord migrer vers la version 4.16.01, puis passer à la version 4.18.01.
- Vous pouvez migrer Apigee Edge version 4.15.07 vers 4.16.01.
- Si vous disposez d'une version d'Edge antérieure à la version 4.15.07, vous devez d'abord migrer vers la version 4.15.07, puis vers la version 4.16.01.
- Si vous migrez depuis la version 4.14.04 ou ultérieure d'Edge: migrez directement vers la version 4.15.07.
- Si vous migrez depuis la version 4.14.01 d'Edge: vous devez d'abord migrer vers la version 4.14.04, puis vers la version 4.15.07.
Qui peut effectuer la mise à jour ?
L'utilisateur qui exécute la mise à jour doit être identique à celui qui a initialement installé Edge ou à l'utilisateur racine.
Une fois les RPM périphériques installés, tous les utilisateurs peuvent les configurer.
Composants à mettre à jour
Vous devez mettre à jour tous les composants Edge. Edge n'est pas compatible avec une configuration contenant des composants de plusieurs versions.
Retour à une version antérieure de Zookeeper en cas de mise à jour depuis la version 4.16.01
La version du RPM Zookeeper dans Edge pour le cloud privé 4.16.01 est apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. Dans les versions ultérieures d'Edge, la version de Zookeeper a été redéfinie sur apigee-zookeeper-3.4.5-0.0.94x. Cela empêche yum de mettre à niveau Zookeeper vers des versions ultérieures depuis la version 4.16.01. Pour résoudre ce problème, exécutez la commande yum rétrograder apigee-zookeeper avant de mettre à jour Zookeeper.
Vous pouvez vérifier la version de Zookeeper à l'aide de la commande suivante:
> rpm -qa |grep apigee-zookeeper
Si cette commande renvoie la version de Zookeeper:
apigee-zookeeper-3.4.5-1.0.905
Vous devez ensuite revenir à la version antérieure.
Propagation automatique des paramètres de la propriété
Si vous avez défini des propriétés en modifiant les fichiers .properties dans /opt/apigee/customer/application, ces valeurs sont conservées par la mise à jour.
Mettre à jour les conditions préalables
Vérifiez les conditions préalables suivantes avant de mettre à niveau Apigee Edge:
- Sauvegarder 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 correspondant à votre version actuelle d'Edge pour effectuer la sauvegarde.
Vous bénéficiez ainsi d'un plan de sauvegarde au cas où la mise à jour vers une nouvelle version ne fonctionnerait pas correctement. Pour en savoir plus sur la sauvegarde, consultez Sauvegarde et restauration. - Assurez-vous 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
Gérer une mise à jour ayant échoué
En cas d'échec de la mise à jour, vous pouvez essayer de corriger le problème, puis exécuter à nouveau le fichier update.sh. Vous pouvez exécuter la mise à jour plusieurs fois. Elle se poursuit là où elle s'était arrêtée.
Si l'échec nécessite un rollback vers la version précédente, consultez l'article 4.18.01 Rollback.
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 exécutant l'utilitaire update.sh n'a pas accès à ce répertoire, il écrit le journal 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 à niveau requise vers la version 8 de JDK Java
Cette version d'Edge nécessite l'installation de la version 8 de JDK Java sur tous les nœuds de traitement Edge. Vous pouvez installer Oracle JDK 8 ou OpenJDK 8. Si Java JDK 8 n'est pas déjà installé, le script de mise à jour peut le faire pour vous.
Dans le cadre de la mise à jour de Java 8, certains algorithmes de chiffrement TLS ne sont plus disponibles dans Oracle JDK 8. Pour obtenir la liste complète, consultez la section "Default Cipher Suites désactivées" à l'adresse http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
Obligatoire pour activer le dépôt EPEL
Vous devez activer les packages supplémentaires pour Enterprise Linux (EP EPEL) pour installer ou mettre à jour Edge. La commande à utiliser dépend de votre version de RedHat/CentOS:
- Pour RedHat/CentOS 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm - Pour RedHat/CentOS 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm
Ajout obligatoire du paramètre de configuration SMTPMAILFROM
Edge 4.17.05 a ajouté un nouveau paramètre obligatoire au fichier de configuration utilisé lors de l'activation d'un serveur SMTP. Si vous effectuez une mise à jour à partir de la version 4.17.01, vous devez définir SMTPMAILFROM dans le fichier de configuration lorsque vous activez le serveur SMTP.
La version 4.17.09 de l'API BaaS est également compatible avec la propriété SMTPMAILFROM. Lorsque vous mettez à jour l'API BaaS, vous devez définir SMTPMAILFROM dans le fichier de configuration.
Ce paramètre est au format suivant:
SMTPMAILFROM="My Company <myco@company.com>"
Obligatoire en cas de mise à jour lors de l'utilisation d'une authentification externe
Vous pouvez intégrer un service d'annuaire externe à une installation d'Apigee Edge Private Cloud existante. Cette fonctionnalité est conçue pour fonctionner avec n'importe quel service d'annuaire compatible avec LDAP, tel qu'Active Directory, OpenLDAP, etc. Une solution LDAP externe permet aux administrateurs système de gérer les identifiants utilisateur à partir d'un service centralisé de gestion d'annuaire, qui est externe aux systèmes tels qu'Apigee Edge qui les utilisent.
Pour en savoir plus, consultez Configuration de l'authentification externe.
Lorsque l'authentification externe est activée, la plupart des clients utilisent le champ de nom du compte SAM Active Directory comme nom d'utilisateur, au lieu de l'adresse e-mail utilisée par le serveur Edge OpenLDAP.
Si vous avez intégré un service d'annuaire externe, ajoutez la ligne suivante à votre fichier de configuration lorsque vous mettez à jour Edge vers la version 4.18.01:
IS_EXTERNAL_AUTH="true"
Cette ligne configure Edge pour accepter un nom de compte, plutôt qu'une adresse e-mail, comme nom d'utilisateur.
Mise à niveau requise vers Qpid 1.35
Cette version contient une mise à jour obligatoire de Qpid 1.35. Dans le cadre de la mise à jour d'un nœud Qpid, vous devez:
- Empêchez temporairement l'écriture des routeurs et des processeurs de message sur le nœud Qpid en bloquant le port 5672 sur le nœud Qpid. Vous pouvez utiliser la commande suivante pour bloquer ce port sur le nœud Qpid:
> sudo iptables -A INPUT -p tcp --destination-port 5672. -s `hostname` -i eth0 -j Drop - Attendez que la file d'attente Qpid soit vide pour vous assurer que le nœud Qpid a traité tous les messages avant la mise à jour. Exécutez la commande suivante pour vérifier que la file d'attente des messages Qpid est vide:
> qpid-stat -q - Mettez à jour le nœud Qpid.
- Débloquez le port 5672 sur le nœud Qpid afin d'autoriser l'accès à partir des routeurs et des processeurs de messages.
Pour débloquer ce port, vous pouvez utiliser la commande suivante:
> sudo iptables -F
Notez que si vous utilisez iptables pour d'autres règles, vous pouvez utiliser l'option -D pour annuler la modification spécifique:
> sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j Drop
Ce processus est décrit en détail ci-dessous pour chaque topologie Edge.
Mise à niveau requise vers Postgres 9.6
Cette version d'Edge inclut une mise à niveau vers Postgres 9.6. Dans le cadre de cette mise à niveau, toutes les données Postgres sont migrées vers Postgres 9.6.
Pendant le processus de mise à jour, pendant que les nœuds Postgres sont indisponibles, les données d'analyse sont toujours écrites dans les nœuds Qpid. Une fois les nœuds Postgres mis à jour et à nouveau en ligne, les données d'analyse sont transmises aux nœuds Postgres.
Le nœud de secours Postgres supplémentaire est requis si vous devez effectuer un rollback de la mise à jour pour une raison quelconque. Si vous devez effectuer un rollback de la mise à jour, le nouveau nœud de secours Postgres devient le nœud Postgres maître après le rollback. Par conséquent, lorsque vous installez le nouveau nœud de secours Postgres, celui-ci doit se trouver sur un nœud répondant à toutes les exigences matérielles d'un serveur Postgres, tel que défini dans les exigences d'installation d'Edge.
Installer un nouveau nœud de secours Postgres
Cette procédure crée un serveur de secours Postgres sur un nouveau nœud. Veillez à installer un nouveau serveur de secours Postgres pour votre version existante d'Edge (4.16.01 ou 4.16.05), et non pour la version 4.18.01.
Pour effectuer l'installation, utilisez le fichier de configuration que vous avez utilisé pour installer votre version actuelle d'Edge.
Pour créer un nœud de secours Postgres:
- Sur le maître Postgres actuel, modifiez le fichier /opt/apigee/customer/application/postgresql.properties pour définir le jeton suivant. Si ce fichier n'existe pas, créez-le:
conf_pg_hba_replication.connection=host réplication apigee existing_SLA_ip/32 Confiance\ \nhost réplication
- Redémarrez apigee-postgresql sur le maître Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart - Vérifiez que le nœud de secours a été ajouté en consultant le fichier /opt/apigee/apigee-postgresql/conf/pg_hba.conf sur le maître. Ce fichier doit contenir les lignes suivantes:
host réplication apigee apigee_existing_ip/32 confiance
host réplication apigee new_SLA_ip/32 confiance - Installez le nouveau serveur de secours Postgres :
- Modifiez le fichier de configuration que vous avez utilisé pour installer votre version actuelle d'Edge afin de spécifier les éléments suivants:
# adresse IP du maître actuel:
PG_MASTER=192.168.56.103
# adresse IP du nouveau nœud de secours
PG_STANDBY=192.168.56.102 - Désactivez SELinux comme décrit dans Installer l'utilitaire de configuration Edge apigee.
- Téléchargez le fichier Edge bootstrap_4.16.05.sh dans /tmp/bootstrap_4.16.05.sh :
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Mise à jour. - Installez l'utilitaire et les dépendances Edge apigee-service:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord - Utilisez apigee-service pour installer l'utilitaire apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - Installez Postgres:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - Sur le nouveau nœud de secours, exécutez la commande suivante:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Confirmez qu'il s'agit de l'instance de secours.
- Modifiez le fichier de configuration que vous avez utilisé pour installer votre version actuelle d'Edge afin de spécifier les éléments suivants:
Mettre un nœud Postgres hors service
Une fois la mise à jour terminée, mettez hors service le nouveau nœud de secours:
- Assurez-vous que Postgres est en cours d'exécution:
> /opt/apigee/apigee-service/bin/apigee-all status
Si Postgres n'est pas en cours d'exécution, démarrez-le:
> /opt/apigee/apigee-service/bin/apigee-all start - ?
- Arrêtez le nouveau nœud de secours en exécutant la commande suivante:
> /opt/apigee/apigee-service/bin/apigee-all stop - Sur le nœud maître Postgres, modifiez le fichier /opt/apigee/customer/application/postgresql.properties pour supprimer le nœud de secours de conf_pg_hba_replication.connection:
conf_pg_hba_replication.connection=host réplication apigee existing_SLA_ip/32 - Redémarrez apigee-postgresql sur le maître Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart - Vérifiez que le nouveau nœud de secours a été supprimé en consultant le fichier /opt/apigee/apigee-postgresql/conf/pg_hba.conf sur le maître. Ce fichier ne doit contenir que la ligne suivante:
host réplication apigee existing_SLA_ip/32trust - Supprimez l'UUID du nœud de secours de ZooKeeper en effectuant l'appel d'API de gestion Edge suivant sur le nœud du serveur de gestion:
> curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_SLA_uuid>
Mise à jour sans temps d'arrêt
Une mise à jour sans interruption, ou mise à jour progressive, vous permet de mettre à jour votre installation Edge sans désactiver Edge.
La mise à jour sans interruption n'est possible qu'avec une configuration à cinq nœuds ou supérieure.
La mise à niveau sans aucun temps d'arrêt consiste à supprimer chaque routeur, l'un après l'autre, de l'équilibreur de charge. Vous mettez ensuite à jour le routeur et tous les autres composants présents sur la même machine que le routeur, puis l'ajoutez de nouveau à l'équilibreur de charge.
- Mettez à jour les machines dans le bon ordre d'installation, comme décrit ci-dessous dans la section "Ordre des mises à jour des machines".
- Lorsque le moment est venu de mettre à jour les routeurs, sélectionnez l'un d'entre eux 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 accessible à nouveau.
- Répétez les étapes 2 à 4 pour les autres routeurs.
- Continuez la mise à jour pour toutes les machines restantes de votre installation.
Effectuez les opérations suivantes avant/après la mise à jour:
- Sur le routeur et le nœud de traitement des messages combinés :
- Avant la mise à jour :
- Rend le routeur inaccessible.
- Rendez le processeur de messages inaccessible.
- Après la mise à jour, procédez comme suit :
- Rendez le processeur de messages accessible.
- Rendez le routeur accessible.
- Avant la mise à jour :
- Sur un nœud de routeur unique :
- Avant la mise à jour, rendez le routeur inaccessible.
- Une fois la mise à jour effectuée, rendez le routeur accessible.
- Sur un nœud unique de processeur de message :
- Avant la mise à jour, rendez le processeur de messages inaccessible.
- Une fois la mise à jour effectuée, 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 identique à celui que vous avez utilisé pour installer Edge 4.16.01 ou 4.16.05.
Procédure de mise à jour vers la version 4.18.01 sur un nœud avec une connexion Internet externe
Procédez comme suit pour mettre à jour les composants périphériques d'un nœud:
- Si vous utilisez actuellement la réplication principale de secours Postgres, installez un nouveau nœud de secours Postgres, comme décrit ci-dessus dans la section Installer un nouveau nœud de secours Postgres.
- 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 en tant que racine à votre nœud pour installer les RPM Edge.
Remarque: Bien que l'installation du RPM nécessite un accès racine, vous pouvez effectuer une configuration Edge sans accès racine. - Installez yum-utils et yum-plugin-priorities:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities - Désactivez SELinux comme décrit dans Installer l'utilitaire de configuration Apigee Edge.
- Activez le dépôt EPEL comme décrit ci-dessus.
- 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 - Téléchargez le fichier Edge
- Installez l'utilitaire et les dépendances Edge 4.18.01 apigee-service:
> sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
où uName:pWord correspond au nom d'utilisateur et au mot de passe reçus. Si vous omettez pWord, vous êtes invité à le saisir.
Par défaut, le programme d'installation vérifie que Java 1.8 est installé. Si vous ne le faites pas, il l'installe pour vous. Utilisez l'option JAVA_FIX pour spécifier comment gérer l'installation de Java. JAVA_FIX accepte les valeurs suivantes:
I = Installer 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'utilitaire apigee-setup :
- Si vous avez installé la version 4.16.01 en mettant à niveau la version Edge 4.15.07.0x, vous devez installer l'utilitaire apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
Cette commande installe l'utilitaire update.sh dans /opt/apigee/apigee-setup/bin.
Si vous avez déjà installé l'utilitaire apigee-setup, mettez-le à jour:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update - Si vous avez installé la version 4.16.01 directement, ce qui signifie que vous n'avez pas effectué de mise à niveau à partir de la version 4.15.07.0x, vous devez mettre à jour l'utilitaire apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Cette mise à jour vers apigee-service installe l'utilitaire update.sh dans /opt. - Si vous avez installé la version 4.16.05 directement ou par mise à jour, vous devez mettre à jour l'utilitaire apigee-setup:
> Cette mise à jour vers apigee-service installe l'utilitaire update.sh dans /opt/apigee/apigee-setup/bin.
- Si vous avez installé la version 4.16.01 en mettant à niveau la version Edge 4.15.07.0x, vous devez installer l'utilitaire apigee-setup:
- Selon votre version actuelle d'Edge, vous devez installer ou mettre à jour l'utilitaire apigee-validate sur le serveur de gestion.
- Si vous utilisez actuellement Edge 4.16.05: mettez à jour l'utilitaire apigee-validate sur le serveur de gestion:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update - Si vous utilisez :
- Si vous effectuez une mise à niveau depuis la version 4.16.01: modifiez le fichier de configuration transmis à l'utilitaire apigee-validate. Dans la version 4.16.01 Edge, le fichier de configuration utilisé par apigee-validate nécessitait les propriétés suivantes:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
Dans cette version, le fichier de configuration ne requiert que la propriété APIGEE_ADMINPW. Vous pouvez supprimer les deux autres propriétés du fichier.
- Si vous utilisez actuellement Edge 4.16.05: mettez à jour l'utilitaire apigee-validate sur le serveur de gestion:
- Mettez à jour l'utilitaire apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update - Exécutez l'utilitaire de mise à jour sur vos nœuds dans l'ordre indiqué dans la section Ordre des mises à jour des machines ci-dessous:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
La seule condition requise pour le fichier de configuration est que l'utilisateur "apigee" puisse accéder au fichier de configuration ou le lire.
Utilisez l'option "-c" pour spécifier le composant à mettre à jour. ? - Testez la mise à jour en exécutant l'utilitaire apigee-validate sur le serveur de gestion, comme décrit dans Tester l'installation.
- Si vous avez installé un nouveau nœud de secours Postgres, mettez-le hors service comme décrit dans la section Mettre un nœud Postgres hors service.
Pour effectuer un rollback ultérieur de la mise à jour, suivez la procédure décrite dans 4.18.01 Rollback processus.
Procédure de mise à jour vers la version 4.18.01 à partir d'un dépôt local
Si vos nœuds périphériques sont protégés par un pare-feu ou ne sont pas autorisés à accéder au dépôt Apigee via Internet, vous pouvez effectuer la mise à jour du dépôt local, ou la mise en 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 dans un nœud, puis mettez-le à jour à 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 ou vous pouvez utiliser votre propre serveur Web.
Pour effectuer la mise à jour à partir d'un dépôt local 4.18.01:
- Si vous utilisez actuellement la réplication principale de secours Postgres, installez un nouveau nœud de secours Postgres, comme décrit ci-dessus dans la section Installer un nouveau nœud de secours Postgres.
- Créez un dépôt local 4.18.01 comme décrit dans la section "Créer un dépôt Apigee local" dans Installer l'utilitaire de configuration Apigee Apigee.
Remarque: Si vous disposez déjà d'un dépôt 4.16.01 ou 4.16.05, vous pouvez y ajouter le dépôt 4.18.01, comme décrit dans la section "Mettre à jour un dépôt Apigee local" dans Installer l'utilitaire de configuration Apigee Edge. -
Pour installer apigee-service à partir d'un fichier .tar :
- Sur le nœud avec le dépôt local, exécutez la commande suivante pour empaqueter le dépôt local dans un seul fichier .tar nommé /opt/apigee/data/apigee-Mirror/apigee-4.18.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, annulez l'exécution du fichier dans le répertoire /tmp:
> tar -xzf apigee-4.18.01.tar.gz
Cette commande crée un répertoire nommé dépôts 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.18.01.sh apigeeProtocol="file://" apigeerepobasepath=/tmp/repos
Notez que vous incluez le chemin d'accès au répertoire des dépôts dans cette commande.
- Sur le nœud avec le dépôt local, exécutez la commande suivante pour empaqueter le dépôt local dans un seul fichier .tar nommé /opt/apigee/data/apigee-Mirror/apigee-4.18.01.tar.gz:
-
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" dans Installer l'utilitaire de configuration Apigee Edge.
- Changement des règles :
- Sur le nœud distant, installez l'utilitaire Edge apigee-service et les dépendances :
> sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord
- Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup :
- Si vous avez installé la version 4.16.01 en mettant à niveau la version Edge 4.15.07.0x, vous devez installer l'utilitaire apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
Cette commande installe l'utilitaire update.sh dans /opt/apigee/apigee-setup/bin.
Si vous avez déjà installé l'utilitaire apigee-setup, mettez-le à jour:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update - Si vous avez installé la version 4.16.01 directement, ce qui signifie que vous n'avez pas effectué de mise à niveau à partir de la version 4.15.07.0x, vous devez mettre à jour l'utilitaire apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Cette mise à jour vers apigee-service installe l'utilitaire update.sh dans /opt. - Si vous avez installé la version 4.16.05 directement ou par mise à jour, vous devez mettre à jour l'utilitaire apigee-setup:
>Cette mise à jour vers apigee-service installe l'utilitaire update.sh dans /opt/apigee/apigee-setup/bin.
- Si vous avez installé la version 4.16.01 en mettant à niveau la version Edge 4.15.07.0x, vous devez installer l'utilitaire apigee-setup:
- Selon votre version actuelle d'Edge, vous devez installer ou mettre à jour l'utilitaire apigee-validate sur le serveur de gestion.
- Si vous utilisez actuellement Edge 4.16.05: mettez à jour l'utilitaire apigee-validate sur le serveur de gestion:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update - Si vous utilisez actuellement la commande ci-dessous, procédez comme suit :
- Si vous effectuez une mise à niveau depuis la version 4.16.01: modifiez le fichier de configuration transmis à l'utilitaire apigee-validate. Dans la version 4.16.01 Edge, le fichier de configuration utilisé par apigee-validate nécessitait les propriétés suivantes:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
Dans cette version, le fichier de configuration ne requiert que la propriété APIGEE_ADMINPW. Vous pouvez supprimer les deux autres propriétés du fichier.
- Si vous utilisez actuellement Edge 4.16.05: mettez à jour l'utilitaire apigee-validate sur le serveur de gestion:
- Mettez à jour l'utilitaire apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update - Exécutez l'utilitaire de mise à jour sur vos nœuds dans l'ordre indiqué ci-dessous dans la section "Ordre des mises à jour de la machine" ci-dessous:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
La seule condition requise pour le fichier de configuration est que le fichier de configuration soit accessible ou lisible par l'utilisateur "apigee".
Utilisez l'option "-c" pour spécifier le composant à mettre à jour. ? - Testez la mise à jour en exécutant l'utilitaire apigee-validate sur le serveur de gestion, comme décrit dans Tester l'installation.
- Si vous avez installé un nouveau nœud de secours Postgres, mettez-le hors service comme décrit dans la section Mettre un nœud Postgres hors service.
Pour effectuer un rollback ultérieur de la mise à jour, suivez la procédure décrite dans 4.18.01 Rollback processus.
Ordre des mises à jour de la machine
L'ordre dans lequel vous mettez à jour les machines dans une installation Edge est important. Voici les principaux points à prendre en compte lors d'une mise à jour:
- Vous devez mettre à jour tous les nœuds Cassandra et ZooKeeper avant d'en modifier d'autres.
- Pour toutes les machines dotées de plusieurs composants Edge (serveur de gestion, processeur de messages, routeur, serveur QPID, mais pas de serveur Postgres), utilisez l'option "-c Edge" pour les mettre à jour simultanément.
- Si une étape spécifie qu'elle doit être exécutée sur plusieurs machines, effectuez-la dans l'ordre spécifié.
- Il n'y a pas d'étape distincte pour mettre à jour la monétisation. Elle est mise à jour lorsque vous spécifiez l'option "-c Edge".
Pour une installation autonome à un hôte
- Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre est au format suivant:
SMTPMAILFROM="Mon entreprise <monco@entreprise.com>" - En cas de mise à jour depuis la version 4.16.01, revenez à la version antérieure de Zookeeper:
> yum rétrograder apigee-zookeeper. - Mettez à jour Cassandra et ZooKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Définissez la règle iptables suivante:
> sudo iptables -A INPUT -p tcp --destination-port 5672 -s `hostname` -i eth0 -j Drop - Vérifiez la file d'attente des messages Qpid:
> qpid-stat -q
Continuez à vérifier la file d'attente jusqu'à ce que le nombre indiqué dans la colonne "msg" soit égal à 0. Vous ne pouvez pas mettre à niveau Qpid tant que tous les messages n'ont pas été traités. - Mettez à jour qpidd:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Vider les iptables:
> sudo iptables -F - Mettre à jour LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Arrêt de Postgres Server, du serveur Qpid et de PostgreSQL:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Mettre à jour postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Mettez à jour la base de données Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Mettez à jour les composants Edge restants:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Mettre à jour l'interface utilisateur Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Pour une installation autonome à deux hôtes
Consultez la section Topologies de l'installation pour obtenir la liste des topologies et numéros de nœud Edge.
- Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre est au format suivant:
SMTPMAILFROM="Mon entreprise <monco@entreprise.com>" - En cas de mise à jour depuis la version 4.16.01, revenez à la version antérieure de Zookeeper sur la machine 1:
> yum rétrograder apigee-zookeeper. - Mettez à jour Cassandra et ZooKeeper sur la machine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Définissez la règle iptables suivante sur la machine 2:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j Drop - Vérifiez la file d'attente des messages Qpid sur la machine 2:
> qpid-stat -q
Continuez à vérifier la file d'attente jusqu'à ce que le nombre indiqué dans la colonne "msg" soit égal à 0. Vous ne pouvez pas mettre à niveau Qpid tant que tous les messages n'ont pas été traités. - Mettez à jour qpidd sur la machine 2:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Vider les iptables sur la machine 2:
> sudo iptables -F - Mettre à jour LDAP sur la machine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Mettez à jour les composants Edge sur la machine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Mettre à jour l'interface utilisateur sur la machine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Mettez à jour postgresql sur la machine 2 :
- Arrêtez Postgres Server, Qpid Server et postgresql:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql - Mettre à jour postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Mettez à jour la base de données Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Mettez à jour les composants Edge sur la machine 2:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
- Arrêtez Postgres Server, Qpid Server et postgresql:
Pour une installation en cluster à cinq hôtes
Consultez la section Topologies de l'installation pour obtenir la liste des topologies et numéros de nœud Edge.
- Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre est au format suivant:
SMTPMAILFROM="Mon entreprise <monco@entreprise.com>" - Assurez-vous d'avoir installé un nouveau nœud de secours Postgres, comme décrit ci-dessus dans la section Installer un nouveau nœud de secours Postgres.
- En cas de mise à jour depuis la version 4.16.01, revenez à une version antérieure de Zookeeper sur les machines 1, 2 et 3:
> yum rétrograder apigee-zookeeper. - Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Définissez la règle iptables suivante sur la machine 4:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j Drop - Vérifiez la file d'attente des messages Qpid sur la machine 4:
> qpid-stat -q
Continuez à vérifier la file d'attente jusqu'à ce que le nombre indiqué dans la colonne "msg" soit égal à 0. Vous ne pouvez pas mettre à niveau Qpid tant que tous les messages n'ont pas été traités. - Mettez à jour qpidd sur la machine 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Vider les iptables sur la machine 4:
> sudo iptables -F - Répétez les étapes 5 à 8 sur la machine 5.
- 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 1, 2 et 3:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Mettre à jour l'interface utilisateur sur la machine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Mettez à jour les machines 4 et 5 :
- Arrêtez le serveur Postgres et le serveur Qpid sur la machine 4:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server - Arrêt du serveur Postgres, du serveur Qpid et de postgresql sur la machine 5:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
> /opt/apigee/service/bin/apigee-service Edge-qpid-server arrêt
> /opt/apigee/apigee-service/bin/apigee-service apigee-post apigee - Arrêtez le serveur Postgres et postgresql sur le nouveau nœud de secours que vous avez ajouté pour le rollback:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Mettre à jour postgresql sur les machines 4:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Mettez à jour la base de données Postgres sur la machine 4 (maître Postgres uniquement):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Mettre à jour postgresql sur les machines 5:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Démarrez le serveur Postgres et le serveur Qpid sur les machines 4 et 5:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start - Configurez Postgres en tant que nœud de secours en exécutant les commandes suivantes sur la machine 5:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f - Vérifiez l'état de la réplication en émettant les scripts suivants sur les deux serveurs. Le système doit afficher des résultats identiques sur les deux serveurs pour garantir une réplication réussie:
Sur la machine 4, le nœud maître, exécute:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Confirmez qu'il s'agit du maître.
Sur la machine 5, le nœud de secours:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Vérifiez qu'il s'agit bien de l'instance de secours.
- Arrêtez le serveur Postgres et le serveur Qpid sur la machine 4:
- Mettez à jour les composants Edge sur la machine 4, 5:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Veillez à mettre hors service le nouveau nœud de secours en suivant la procédure ci-dessus décrite dans la section Mettre un nœud Postgres hors service.
Pour une installation en cluster de neuf hôtes
Consultez la section Topologies de l'installation pour obtenir la liste des topologies et numéros de nœud Edge.
- Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre est au format suivant:
SMTPMAILFROM="Mon entreprise <monco@entreprise.com>" - Assurez-vous d'avoir installé un nouveau nœud de secours Postgres, comme décrit ci-dessus dans la section Installer un nouveau nœud de secours Postgres.
- En cas de mise à jour depuis la version 4.16.01, revenez à une version antérieure de Zookeeper sur les versions 1, 2 et 3 de Maccine:
> yum rétrograder apigee-zookeeper. - Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Définissez la règle iptables suivante sur la machine 6:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j Drop - Vérifiez la file d'attente des messages Qpid sur la machine 6:
> qpid-stat -q
Continuez à vérifier la file d'attente jusqu'à ce que le nombre indiqué dans la colonne "msg" soit égal à 0. Vous ne pouvez pas mettre à niveau Qpid tant que tous les messages n'ont pas été traités. - Mettez à jour qpidd sur la machine 6:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Vider les iptables sur la machine 6:
> sudo iptables -F - Répétez les étapes 5 à 8 sur la machine 7.
- 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, 1, 4 et 5 dans cet ordre:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Mettre à jour l'interface utilisateur sur la machine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Mettez à jour les machines 8 et 9 :
- Arrêtez le serveur Postgres sur la machine 8:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop - Arrêtez le serveur Postgres et postgresql sur la machine 9:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Arrêtez le serveur Qpid sur les machines 6 et 7:
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server - Arrêtez le serveur Postgres et postgresql sur le nouveau nœud de secours que vous avez ajouté pour le rollback:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Mettre à jour postgresql sur les machines 8:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Mettez à jour la base de données Postgres sur la machine 8 (principale Postgres uniquement):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Mettre à jour postgresql sur les machines 9:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Démarrez le serveur de serveur Postgres sur les machines 8 et 9:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start - Démarrez le serveur de serveur Qpid sur les machines 6 et 7:
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start - Configurez Postgres en tant que nœud de secours en exécutant les commandes suivantes sur la machine 9:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f - Vérifiez l'état de la réplication en émettant les scripts suivants sur les deux serveurs. Le système doit afficher des résultats identiques sur les deux serveurs pour garantir une réplication réussie:
Sur la machine 8, le nœud maître exécute:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Confirmez qu'il s'agit du maître.
Sur la machine 9, le nœud de secours:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Vérifiez qu'il s'agit de l'instance de secours.
- Arrêtez le serveur Postgres sur la machine 8:
- Mettez à jour les composants Edge sur les machines 8 et 9:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Veillez à mettre hors service le nouveau nœud de secours en suivant la procédure ci-dessus décrite dans la section Mettre un nœud Postgres hors service.
Pour une installation en cluster de 13 hôtes
Consultez la section Topologies de l'installation pour obtenir la liste des topologies et numéros de nœud Edge.
- Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre est au format suivant:
SMTPMAILFROM="Mon entreprise <monco@entreprise.com>" - Assurez-vous d'avoir installé un nouveau nœud de secours Postgres, comme décrit ci-dessus dans la section Installer un nouveau nœud de secours Postgres.
- En cas de mise à jour depuis la version 4.16.01, revenez à une version antérieure de Zookeeper sur les versions 1, 2 et 3 de Maccine:
> yum rétrograder apigee-zookeeper. - Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Définissez la règle iptables suivante sur la machine 12:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j Drop - Vérifiez la file d'attente des messages Qpid sur la machine 12:
> qpid-stat -q
Continuez à vérifier la file d'attente jusqu'à ce que le nombre indiqué dans la colonne "msg" soit égal à 0. Vous ne pouvez pas mettre à niveau Qpid tant que tous les messages n'ont pas été traités. - Mettez à jour qpidd sur la machine 12:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Vider les iptables sur la machine 12:
> sudo iptables -F - Répétez les étapes 5 à 8 sur la machine 13.
- 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, 6, 7, 10 et 11 dans cet ordre:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Mettez à jour l'interface utilisateur sur les machines 6 et 7:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Mettez à jour les machines 8 et 9 :
- Arrêtez le serveur Postgres sur la machine 8:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop - Arrêtez le serveur Postgres et postgresql sur la machine 9:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Arrêtez le serveur Qpid sur les machines 12 et 13:
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server - Arrêtez le serveur Postgres et postgresql sur le nouveau nœud de secours que vous avez ajouté pour le rollback:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Mettre à jour postgresql sur les machines 8:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Mettez à jour la base de données Postgres sur la machine 8 (principale Postgres uniquement):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Mettre à jour postgresql sur les machines 9:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Démarrez le serveur Postgres sur les machines 8 et 9:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start - Démarrez le serveur de serveur Qpid sur les machines 12 et 13:
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start - Configurez Postgres en tant que nœud de secours en exécutant les commandes suivantes sur la machine 9:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f - Vérifiez l'état de la réplication en émettant les scripts suivants sur les deux serveurs. Le système doit afficher des résultats identiques sur les deux serveurs pour garantir une réplication réussie:
Sur la machine 8, le nœud maître exécute:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Confirmez qu'il s'agit du maître.
Sur la machine 9, le nœud de secours:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Vérifiez qu'il s'agit de l'instance de secours.
- Arrêtez le serveur Postgres sur la machine 8:
- Mettez à jour les composants Edge sur les machines 8 et 9:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Veillez à mettre hors service le nouveau nœud de secours en suivant la procédure ci-dessus décrite dans la section Mettre un nœud Postgres hors service.
Pour une installation en cluster de 12 hôtes
Consultez la section Topologies de l'installation pour obtenir la liste des topologies et numéros de nœud Edge.
- Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre est au format suivant:
SMTPMAILFROM="Mon entreprise <monco@entreprise.com>" - Assurez-vous d'avoir installé un nouveau nœud de secours Postgres, comme décrit ci-dessus dans la section Installer un nouveau nœud de secours Postgres.
- Mettez à jour Cassandra et ZooKeeper :
- Si vous passez de la version 4.16.01 à une version antérieure de Zookeeper sur les versions 1, 2 et 3 de Mackeeper dans le centre de données 1:
> yum rétrograder apigee-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 - En cas de mise à jour à partir de la version 4.16.01, revenir à une version antérieure de Zookeeper sur les versions 7, 8 et 9 de Maccare dans le centre de données 2:
> yum - Sur les machines 7, 8 et 9 dans le centre de données 2
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Si vous passez de la version 4.16.01 à une version antérieure de Zookeeper sur les versions 1, 2 et 3 de Mackeeper dans le centre de données 1:
- Mettez à jour Qpidd :
- Machines 4, 5 dans le centre de données 1
- Définissez la règle iptables suivante sur la machine 4:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j Drop - Vérifiez la file d'attente des messages Qpid sur la machine 4:
> qpid-stat -q
Continuez à vérifier la file d'attente jusqu'à ce que le nombre indiqué dans la colonne "msg" soit égal à 0. Vous ne pourrez pas mettre à niveau Qpid tant qu'elle n'aura pas traité tous les messages. - Mettez à jour qpidd sur la machine 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Vider les iptables sur la machine 4:
> sudo iptables -F - Répétez les étapes 1 à 4 sur la machine 5.
- Définissez la règle iptables suivante sur la machine 4:
- Machines 10 et 11 dans le centre de données 2
- Définissez la règle iptables suivante sur la machine 10:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j Drop - Vérifiez la file d'attente des messages Qpid sur la machine 10:
> qpid-stat -q
Continuez à vérifier la file d'attente jusqu'à ce que le nombre indiqué dans la colonne "msg" soit égal à 0. Vous ne pourrez pas mettre à niveau Qpid tant qu'elle n'aura pas traité tous les messages. - Mettez à jour qpidd sur la machine 10:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Vider les iptables sur la machine 10:
> sudo iptables -F - Répétez les étapes 1 à 4 sur la machine 11.
- Définissez la règle iptables suivante sur la machine 10:
- Machines 4, 5 dans le centre de données 1
- Mettez à jour LDAP :
- Machines 1 dans centre de données 1
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Machines 7 dans le centre de données 2
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Machines 1 dans centre de données 1
- Mettez à jour les composants Edge :
- Machines 4, 5, 1, 2 et 3 dans le centre de données 1
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Machines 10, 11, 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, 1, 2 et 3 dans le centre de données 1
- Mettez à jour l'interface utilisateur :
- Machine 1 dans le centre de données 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Machine 7 dans le centre de données 2:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- Machine 1 dans le centre de données 1:
- Mettez à jour la machine 6 dans les centres de données 1 et 12 du centre de données 2 :
- Arrêtez le serveur Postgres sur la machine 6:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop - Arrêtez le serveur Postgres et postgresql sur la machine 12:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Arrêtez le serveur Qpid sur les machines 4, 5, 10 et 11:
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server - Arrêtez le serveur Postgres et postgresql sur le nouveau nœud de secours que vous avez ajouté pour le rollback:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Mettre à jour postgresql sur les machines 6:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Mettez à jour la base de données Postgres sur la machine 6 (maître Postgres uniquement):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Mettre à jour postgresql sur les machines 12:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Démarrez le serveur de serveur Postgres sur les machines 6 et 12:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start - Démarrez le serveur de serveur Qpid sur les machines 4, 5, 10 et 11:
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server - Configurez Postgres en tant que nœud de secours en exécutant les commandes suivantes sur la machine 12:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f - Vérifiez l'état de la réplication en émettant les scripts suivants sur les deux serveurs. Le système doit afficher des résultats identiques sur les deux serveurs pour assurer une réplication réussie:
Sur la machine 6, le nœud maître, exécute:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Confirmez qu'il s'agit du maître.
Sur la machine 12, le nœud de secours:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Confirmez qu'il s'agit de l'instance de secours.
- Arrêtez le serveur Postgres sur la machine 6:
- Mettez à jour les composants Edge sur les machines 6 et 12:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Veillez à mettre hors service le nouveau nœud de secours en suivant la procédure ci-dessus décrite dans la section Mettre un nœud Postgres hors service.
Pour une installation BaaS d'API à 7 ou 10 hôtes
Pour une installation non standard
Si votre installation est non standard, mettez à jour les composants Edge dans l'ordre suivant:
- ZooKeeper
- Cassandra
- Qpidd
- LDAP
- Edge, qui signifie le profil "-c Edge" sur tous les nœuds de l'ordre: nœuds avec serveur Qpid, mais pas le serveur Postgres, le serveur de gestion, le processeur de messages et le routeur.
Remarque: Si le serveur Qpid et le serveur Postgres sont installés sur le nœud, exécutez l'étape de profil "-c Edge" à l'étape 8. - UI périphérique
- postgresql sur le maître Postgres, y compris la mise à niveau.
- postgresql dans l'instance de secours Postgres.
- Edge, qui correspond au profil "-c Edge" sur tous les nœuds Qpid et Postgres combinés, ou sur tous les nœuds Postgres autonomes.