Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Mise à jour d'Apigee Edge 4.16.05.x vers la dernière version 4.16.05

Edge for Private Cloud v. 4.16.05

Ce document contient la procédure à suivre pour mettre à jour votre installation 4.16.05 existante afin d'utiliser les derniers RPM et fichiers d'assistance d'Apigee. Cette procédure utilise l'utilitaire update.sh pour effectuer la mise à jour.

Quelles versions d'Edge pouvez-vous mettre à jour vers la dernière version 4.16.05 ?

Vous ne pouvez mettre à jour une installation Apigee Edge version 4.16.05.x existante que vers la dernière version 4.16.05.

Si vous utilisez actuellement la version 4.16.01.0x ou une version antérieure d'Edge, vous devez d'abord migrer vers la version 4.16.05. Pour savoir comment migrer vers la version 4.16.05, consultez Mettre à jour Apigee Edge 4.16.01 vers la version 4.16.05.

Qui peut effectuer la mise à jour

L'utilisateur qui exécute la mise à jour doit être le même que celui qui a installé Edge à l'origine, ou un utilisateur exécutant en tant qu'utilisateur racine.

Une fois les RPM Edge installés, n'importe quel utilisateur peut les configurer.

Espace disque requis pour la mise à jour

Assurez-vous de disposer d'au moins 1 Go d'espace disque libre avant d'effectuer la mise à jour.

Propagation automatique des paramètres de propriété à partir de la version 4.16.05.x

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.

Conditions préalables à la mise à jour

Avant de mettre à niveau Apigee Edge, assurez-vous de respecter les conditions préalables suivantes :

Sauvegarder tous les nœuds
Avant d'effectuer la mise à jour, il est recommandé d'effectuer une sauvegarde complète de tous les nœuds pour des raisons de sécurité. Utilisez la procédure correspondant à votre version actuelle d'Edge pour effectuer la sauvegarde.

Cela vous permet de disposer 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 Sauvegarde et restauration.
S'assurer 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 :

> /<inst_root>/apigee/apigee-service/bin/apigee-all status

Gérer un échec de mise à jour

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

Si l'échec nécessite un rollback de la mise à jour vers la version précédente, consultez Processus de rollback de la version 4.16.05.

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, 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 à jour sans temps d'arrêt

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

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 consiste à supprimer chaque routeur, un par un, de l'équilibreur de charge. Vous mettez ensuite à jour le routeur et tous les autres composants sur la même machine que le routeur, puis vous ajoutez à nouveau le routeur à l'équilibreur de charge.

Mettez à jour les machines dans l'ordre approprié pour votre installation, comme décrit ci-dessous 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 suivante "Rendre un routeur et un processeur de messages inaccessibles".
Mettez à jour le routeur sélectionné et tous les autres composants Edge sur la même machine que le routeur. Toutes les configurations Edge affichent un routeur et un processeur de messages sur le même nœud.
Rendez le routeur à nouveau accessible.
Répétez les étapes 2 à 4 pour les routeurs restants.
Poursuivez la mise à jour pour toutes les machines restantes de votre installation.

Rendre un routeur et un processeur de messages inaccessibles

Dans une configuration de production, vous disposerez de plusieurs routeurs et processeurs de messages pour obtenir des performances optimales. Vous devez activer/désactiver l'accessibilité de ces routeurs et processeurs de messages avant/après la mise à jour.

L'appel d'API suivant configure un nœud comme accessible ou inaccessible :

> curl -u adminEmail:pWord -X POST "http://<ms_IP>:8080/v1/servers/UUID" -d "reachable=true|false"

où UUID est l'UUID du processeur de messages ou du routeur, et "reachable" est défini sur "true" ou "false".

Si vous devez déterminer l'UUID du routeur, utilisez la commande cURL suivante :

> curl http://<routerIP>:8081/v1/servers/self

Si vous devez déterminer l'UUID du processeur de messages, utilisez la commande cURL suivante :

> curl http://<mpIP>:8082/v1/servers/self

Tenez compte des points suivants avant/après la mise à jour :

Sur le nœud combiné du routeur et du processeur de messages :
- Avant la mise à jour, procédez comme suit :
  1. Rendez le routeur inaccessible à l'aide de l'appel d'API indiqué ci-dessus.
  2. Rendre le processeur de messages inaccessible.
- Après la mise à jour, procédez comme suit :
  1. Rendez le processeur de messages accessible.
  2. Rendre le routeur accessible.
Sur un seul nœud de routeur :
- Avant la mise à jour, rendez le routeur accessible.
- Après la mise à jour, rendez le routeur accessible.
Sur un seul nœud de processeur de messages :
- Avant la mise à jour, rendez le processeur de messages inaccessible.
- Après la mise à jour, rendez le processeur de messages accessible.

Utiliser un fichier de configuration silencieux

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

Procédure de mise à jour de la version 4.16.05 sur un nœud disposant d'une connexion Internet externe

Pour mettre à jour les composants Edge sur un nœud, procédez comme suit :

Le cas échéant, désactivez les jobs Cron configurés pour effectuer une opération de réparation sur Cassandra jusqu'à ce que la mise à jour soit terminée.
Connectez-vous à votre nœud en tant qu'utilisateur racine pour installer les RPM Edge.
Remarque : Bien que l'installation des RPM nécessite un accès racine, vous pouvez configurer Edge sans accès racine.
Désactivez SELinux comme décrit dans Installer l'utilitaire apigee-setup d'Edge.
Videz tous les caches Yum :
> sudo yum clean all
Téléchargez le dernier 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
Mettez à jour l'utilitaire et les dépendances du service apigee-service d'Edge :
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord

où uName:pWord sont le nom d'utilisateur et le mot de passe que vous avez reçus d'Apigee. Si vous omettez pWord, vous serez invité à le saisir.
Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup :
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

Cette mise à jour d'apigee-service installe l'utilitaire update.sh dans /<inst_dir>/apigee/apigee-setup/bin.
Exécutez l'utilitaire de mise à jour sur vos nœuds dans l'ordre décrit ci-dessous dans la section "Ordre de mise à jour de la machine" :
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

La seule exigence concernant le fichier de configuration est qu'il doit être accessible ou lisible par l'utilisateur "apigee". Par exemple, placez le fichier dans le répertoire /tmp du nœud.

Utilisez l'option "-c" pour spécifier le composant à mettre à jour. La liste des composants possibles inclut les éléments suivants :
- ldap = OpenLDAP
- cs = Cassandr
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =tous les composants Edge, à l'exception de l'interface utilisateur Edge : serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgres
- ui = interface utilisateur Edge
- all = met à jour tous les composants de la machine (à utiliser uniquement pour un profil d'installation Edge aio ou un profil d'installation API BaaS asa)
- e = Elasticsearch
- b = Pile API BaaS
- p = API BaaS Portal
- ebp = ElasticSearch, pile API BaaS et portail API BaaS sur le même nœud
Testez la mise à jour en exécutant l'utilitaire apigee-validate, Tester l'installation.

Procédure de mise à jour de la version 4.16.05 à partir d'un dépôt local

Si vos nœuds Edge se trouvent derrière un pare-feu ou si l'accès au dépôt Apigee via Internet est interdit, vous pouvez effectuer la mise à jour à partir d'un dépôt local ou d'un miroir du dépôt Apigee.

Après avoir créé un dépôt Edge local, vous disposez de 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, mais vous pouvez utiliser votre propre serveur Web.

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

Assurez-vous de disposer d'un dépôt 4.16.05 local, comme décrit dans Installer des composants Edge sur un nœud.
Mettez à jour le dépôt local :
1. Téléchargez le dernier 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
2. Effectuez la synchronisation :> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
Pour installer apigee-service à partir d'un fichier .tar :
1. Sur le nœud contenant le dépôt local, utilisez la commande suivante pour empaqueter le dépôt local dans un seul fichier .tar nommé /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz :
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. Copiez le fichier .tar sur le nœud sur lequel vous souhaitez mettre à jour Edge. Par exemple, copiez-le dans le répertoire /tmp du nouveau nœud.
3. Sur le nouveau nœud, décompressez le fichier dans le répertoire /tmp :
  > tar -xzf apigee-4.16.05.tar.gz
  
  Cette commande crée un répertoire nommé "repos" dans le répertoire contenant le fichier .tar. Par exemple, /tmp/repos.
4. Connectez-vous à votre nœud en tant qu'utilisateur racine pour installer les RPM Edge.
  Remarque : Bien que l'installation des RPM nécessite un accès racine, vous pouvez configurer Edge sans accès racine.
5. Désactivez SELinux comme décrit dans Installer l'utilitaire apigee-setup d'Edge.
6. Installez l'utilitaire apigee-service d'Edge et les dépendances à partir de /tmp/repos :
  > sudo bash /tmp/repos/bootstrap_4.16.05.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.
Pour installer apigee-service à l'aide du serveur Web Nginx :
1. Configurez le serveur Web Nginx comme décrit dans la section "Installer à partir du dépôt à l'aide du serveur Web Nginx" de la page Installer des composants Edge sur un nœud.
2. On the remote node, download the Edge bootstrap_4.16.05.sh file to /tmp/bootstrap_4.16.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  
  where uName:pWord are the username and password you set above for the repo, and remoteRepo is the IP address or DNS name of the repo node.
3. Connectez-vous à votre nœud en tant qu'utilisateur racine pour installer les RPM Edge.
  Remarque : Bien que l'installation des RPM nécessite un accès racine, vous pouvez configurer Edge sans accès racine.
4. Désactivez SELinux comme décrit dans Installer l'utilitaire apigee-setup d'Edge.
5. Sur le nœud distant, installez l'utilitaire apigee-service d'Edge et ses dépendances :
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uNamea pigeepassword=pWord apigeeprotocol=http://
  
  où uName:pWord sont le nom d'utilisateur et le mot de passe du dépôt.
Le cas échéant, désactivez les jobs Cron configurés pour effectuer une opération de réparation sur Cassandra jusqu'à ce que la mise à jour soit terminée.
Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup :
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

Cette mise à jour d'apigee-service installe l'utilitaire update.sh dans <inst_dir>/apigee/apigee-setup/bin.
Exécutez l'utilitaire de mise à jour sur vos nœuds dans l'ordre décrit ci-dessous dans la section "Ordre de mise à jour de la machine" :
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

La seule exigence concernant le fichier de configuration est qu'il doit être accessible ou lisible par l'utilisateur "apigee". Par exemple, placez le fichier dans le répertoire /tmp du nœud.

Utilisez l'option "-c" pour spécifier le composant à mettre à jour. La liste des composants possibles inclut les éléments suivants :
- ldap = OpenLDAP
- cs = Cassandr
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =tous les composants Edge, à l'exception de l'interface utilisateur Edge : serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgres
- ui = interface utilisateur Edge
- all = met à jour tous les composants de la machine (à utiliser uniquement pour un profil d'installation Edge aio ou un profil d'installation API BaaS asa)
- e = Elasticsearch
- b = Pile API BaaS
- p = API BaaS Portal
- ebp = ElasticSearch, pile API BaaS et portail API BaaS sur le même nœud
Testez la mise à jour en exécutant l'utilitaire apigee-validate, Tester l'installation.

Ordre de mise à jour des machines

L'ordre dans lequel vous mettez à jour les machines dans une installation Edge est important. Voici les points les plus importants à prendre en compte lors d'une mise à jour :

Vous devez mettre à jour tous les nœuds Cassandra et ZooKeeper avant de mettre à jour les autres nœuds.
Vous devez mettre à jour tous les nœuds qpidd et postgresql avant de mettre à jour les nœuds du routeur et du processeur de messages.
Pour toute machine dotée de plusieurs composants Edge (serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgres), utilisez l'option "-c edge" pour les mettre à jour simultanément.
Si une étape indique qu'elle doit être effectuée sur plusieurs machines, effectuez-la dans l'ordre 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".
Après avoir mis à jour un nœud de routeur, vous devez supprimer tous les fichiers du répertoire /opt/nginx/conf.d, puis redémarrer le routeur.