Cette page a été traduite par l'API Cloud Translation.

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

Edge pour Private Cloud version 4.16.05

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

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

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

Si vous exécutez actuellement Edge version 4.16.01.0x ou antérieure, vous devez d'abord migrer vers 4.16.05. Consultez Mettre à jour Apigee Edge 4.16.01 vers la version 4.16.05. pour obtenir des informations sur la migration vers la version 4.16.05.

Qui peut effectuer la mise à jour

L'utilisateur qui exécute la mise à jour doit être celui qui a installé Edge à l'origine, ou un 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 l' mise à jour.

Propagation automatique de la propriété paramètres 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 sont conservées lors de la mise à jour.

Mettre à jour les prérequis

Vérifiez les conditions préalables suivantes avant de mettre à niveau Apigee Edge:

Sauvegarder tous les nœuds
Pour des raisons de sécurité, nous vous recommandons d'effectuer une sauvegarde complète de tous les nœuds avant d'effectuer la mise à jour raisons. Utilisez la procédure relative à votre version actuelle de Edge pour effectuer la sauvegarde.

Cela vous permet de disposer d'un plan de sauvegarde, au cas où la mise à jour vers une nouvelle version fonctionne correctement. Pour en savoir plus sur la sauvegarde, consultez Sauvegarde et restauration.
Vérifier qu'Edge est en cours d'exécution
Assurez-vous qu'Edge est opérationnel pendant le processus de mise à jour à l'aide de la commande suivante:

> /<statut_root>/apigee/apigee-service/bin/apigee-all statut

Gérer une mise à jour ayant échoué

Si la mise à jour échoue, vous pouvez essayer de résoudre le problème, puis exécuter update.sh à nouveau. Vous pouvez exécuter la mise à jour plusieurs fois pour qu'elle continue à l'endroit où elle s'était arrêtée désactivée.

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

Informations sur la mise à jour de la journalisation

Par défaut, le fichier 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 celui-ci, 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 est défaillant.

Mise à jour sans temps d'arrêt

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

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

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

Mettez à jour les machines dans le bon ordre pour votre installation, comme décrit ci-dessous dans la section "Commander de mise à jour de la machine.
Au moment de mettre à jour les routeurs, sélectionnez un routeur et rendez-le inaccessible, car décrits 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.
Continuez la mise à jour pour toutes les machines restantes de votre installation.

Faire un routeur et Processeur de messages inaccessible

Dans une configuration de production, vous aurez plusieurs routeurs et processeurs de messages à atteindre des performances optimales et vous devez activer/désactiver la joignabilité de ces routeurs et messages Processeurs 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 accessible est défini sur true ou false.

Si vous devez identifier 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

Prenez soin des points suivants avant/après la mise à jour:

Sur les nœuds de routeur et de processeur de messages combinés: <ph type="x-smartling-placeholder">
- Avant la mise à jour: <ph type="x-smartling-placeholder">
  1. Rendez le routeur inaccessible à l'aide de l'appel d'API ci-dessus.
  2. Rendre le processeur de messages inaccessible.
- Après la mise à jour, procédez comme suit: <ph type="x-smartling-placeholder">
  1. Rendez le processeur de messages accessible.
  2. Rendez le routeur accessible.
Sur un nœud de routeur unique: <ph type="x-smartling-placeholder">
- Avant la mise à jour, rendez le routeur accessible.
- Rendez le routeur accessible après la mise à jour.
Sur un nœud de processeur de messages unique: <ph type="x-smartling-placeholder">
- Avant la mise à jour, rendez le processeur de messages inaccessible.
- Après la mise à jour, rendez le processeur de messages accessible.

Utiliser un fichier de configuration silencieuse

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

Procédure de mise à jour 4.16.05 sur un nœud avec une connexion Internet externe

Procédez comme suit pour mettre à jour les composants Edge sur un nœud:

Le cas échéant, désactivez les tâches CRON configurées pour effectuer une opération de réparation sur Cassandra. avant la fin de la mise à jour.
Connectez-vous à votre nœud en tant qu'utilisateur racine pour installer les RPM Edge
Remarque: Bien que l'installation de RPM nécessite un accès root, vous pouvez effectuer sans accès racine.
Désactivez SELinux comme décrit dans la section Installer Edge apigee-setup utilitaire.
Nettoyez 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 Edge apigee-service et les dépendances:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord

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

Cette mise à jour de 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 "Ordre des mettre à jour" ci-dessous:
> /opt/apigee/apigee-setup/bin/update.sh -c composant -f configFile

La seule condition requise sur le fichier de configuration est qu'il doit être accessible ou lisible par la fonction « apigee » utilisateur. Par exemple, placez-le dans le répertoire /tmp d'un nœud.

Utilisez l'option "-c" pour spécifier le composant à mettre à jour. La liste des possibilités comprend: <ph type="x-smartling-placeholder">
- 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, QPID Server, Postgres Server
- ui = Edge UI
- all = mettre à jour tous les composants sur la machine (à utiliser uniquement pour un profil d'installation Edge aio ou un profil d'installation API BaaS asa)
- e = ElasticSearch
- b = Pile BaaS d'API
- p = Portail API BaaS
- 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'une version locale dépôt

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

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

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

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

Assurez-vous de disposer d'un dépôt 4.16.05 local, comme décrit dans la section Installer les composants Edge sur un d'entraînement.
Mettez à jour le dépôt local: <ph type="x-smartling-placeholder">
1. Téléchargez le dernier fichier Edge bootstrap_4.16.05.sh pour /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:
  > synchronisation /opt/apigee/apigee-service/bin/apigee-service --only-new-rpms
Pour installer apigee-service à partir d'un fichier .tar: <ph type="x-smartling-placeholder">
1. Sur le nœud contenant le dépôt local, empaquetez le dépôt à l'aide de la commande suivante : dans un seul fichier .tar nommé /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz:
  > /opt/apigee/apigee-service/bin/apigee-service package apigee-mirror
2. Copiez le fichier .tar sur le nœud où vous souhaitez mettre à jour Edge. Par exemple, copiez-le dans le répertoire /tmp un 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 de RPM nécessite un accès root, vous pouvez effectuer sans accès racine.
5. Désactivez SELinux comme décrit dans la section Installer Edge utilitaire de configuration apigee.
6. Installez l'utilitaire Edge apigee-service 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 dans cette commande le chemin d'accès au répertoire "dépôts".
Pour installer apigee-service à l'aide du serveur Web Nginx: <ph type="x-smartling-placeholder">
1. Configurez le serveur Web Nginx comme indiqué dans la section "Installer à partir du dépôt à l'aide de la commande webserver" à l'adresse Installer Composants Edge sur un nœud
2. Sur le nœud distant, téléchargez le fichier Edge bootstrap_4.16.05.sh pour /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
  
  où uName:pWord correspond au nom d'utilisateur et au mot de passe que vous avez définis ci-dessus pour du dépôt, et remoteRepo est l'adresse IP ou le nom DNS de votre nœud de dépôt.
3. Connectez-vous à votre nœud en tant qu'utilisateur racine pour installer les RPM Edge
  Remarque: Bien que l'installation de RPM nécessite un accès root, vous pouvez effectuer sans accès racine.
4. Désactivez SELinux comme décrit dans la section Installer Edge utilitaire de configuration apigee.
5. Sur le nœud distant, installez l'utilitaire Edge apigee-service et les dépendances:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uNamea pigeepassword=pWord apigeeprotocol=http://
  
  où uName:pWord correspond au nom d'utilisateur et au mot de passe du dépôt.
Le cas échéant, désactivez les tâches CRON configurées pour effectuer une opération de réparation sur Cassandra. avant la fin de la mise à jour.
Utilisez apigee-service pour mettre à jour l'utilitaire de configuration apigee:
> /opt/apigee/apigee-service/bin/apigee-service mise à jour de apigee-setup

Cette mise à jour de 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 "Ordre des mettre à jour" ci-dessous:
> /opt/apigee/apigee-setup/bin/update.sh -c composant -f configFile

La seule condition requise sur le fichier de configuration est qu'il doit être accessible ou lisible par la fonction « apigee » utilisateur. Par exemple, placez-le dans le répertoire /tmp d'un nœud.

Utilisez l'option "-c" pour spécifier le composant à mettre à jour. La liste des possibilités comprend: <ph type="x-smartling-placeholder">
- 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, QPID Server, Postgres Server
- ui = Edge UI
- all = mettre à jour tous les composants sur la machine (à utiliser uniquement pour un profil d'installation Edge aio ou un profil d'installation API BaaS asa)
- e = ElasticSearch
- b = Pile BaaS d'API
- p = Portail API BaaS
- 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, testez l'installation.

Ordre des mises à jour de la machine

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

Vous devez mettre à jour tous les nœuds Cassandra et ZooKeeper avant d'effectuer la mise à jour d'autres nœuds.
Vous devez mettre à jour tous les nœuds qpidd et postgresql avant d'effectuer la mise à jour les nœuds de routeur et de processeur de messages.
Pour toute machine dotée de plusieurs composants Edge (serveur de gestion, processeur de messages, (routeur, serveur QPID, serveur Postgres), utilisez "-c Edge" permet de les modifier tous en même temps en temps réel.
Si une étape indique qu'elle doit être exécutée sur plusieurs machines, effectuez-la dans le l'ordre de machine spécifié.
Il n'y a pas d'étape distincte pour mettre à jour la monétisation. Elle est mise à jour lorsque vous spécifiez "-c" bord" .
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émarrez le routeur.