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

Mise à jour d'Apigee Edge 4.16.01 vers la version 4.16.05

Edge pour Private Cloud version 4.16.05

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

Vous ne pouvez mettre à jour Apigee Edge que de la version 4.16.01.x vers la version 4.16.05.

Si vous disposez d'une version d'Edge antérieure à la version 4.16.01.x, vous devez d'abord migrer vers la version 4.16.01.x, puis passer à la version 4.16.05.

Qui peut effectuer la mise à jour ?

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

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

Mise à niveau requise vers Java JDK version 8

Cette version d'Edge nécessite que vous ayez installé Java JDK version 8 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 l'installer 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 Disabled Cipher Suites" (Suites de chiffrement désactivées par défaut) http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Avertissement: Cette version d'Edge n'est pas compatible avec JDK 7. Si vous utilisez actuellement JDK 7, vous devez passer à JDK 8. Si vous effectuez un rollback de l'installation d'Edge 4.16.05, vous pouvez éventuellement reconfigurer Edge pour utiliser Java JDK 7.

Revenir à une version antérieure de ZooKeeper

La version du RPM de Zookeeper dans Edge for Private Cloud 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.948. Cela empêche yum de mettre à niveau Zookeeper vers une version ultérieure de la version 4.16.01. Pour résoudre ce problème, exécutez la commande yum down apigee-zookeeper avant de mettre à jour Zookeeper.

Pour vérifier la version de ZooKeeper, exécutez 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 à une version antérieure.

Espace disque requis pour la mise à jour

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

Propagation automatique des paramètres de propriété à partir de la version 4.16.01.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 lors de la mise à jour.

Mettre à jour l'utilitaire apigee-validate

Dans la version 4.16.01, vous avez installé et exécuté l'utilitaire apigee-validate sur un nœud Processeur de messages. Dans la version 4.16.05, l'utilitaire apigee-validate a été mis à jour pour s'exécuter sur le nœud Management Server (Serveur de gestion).

Lors de la mise à jour vers la version 4.16.05, vous avez deux options pour mettre à jour l'utilitaire apigee-validate:

Apigee recommandé - Installez et exécutez l'utilitaire apigee-validate sur le nœud du serveur de gestion.

Vous pouvez aussi désinstaller l'utilitaire apigee-validate des nœuds du processeur de messages. Si vous le laissez sur le nœud de processeur de messages, vous devez le mettre à jour vers la version 4.16.05.
Vous pouvez également mettre à jour l'utilitaire apigee-validate sur le nœud de processeur de messages et l'exécuter à partir de là. Toutefois, Apigee vous recommande de l'installer et de l'exécuter à partir du serveur de gestion.

Mettre à jour les prérequis

Avant de mettre à niveau Apigee Edge, remplissez les conditions préalables suivantes:

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.

Cela vous permet de disposer 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 la page 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:

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

Gérer les échecs de mise à jour

Si une mise à jour échoue, essayez de corriger le problème, puis exécutez à nouveau update.sh. Vous pouvez exécuter la mise à jour plusieurs fois et elle reprendra là où elle s'était arrêtée.

Si l'échec nécessite un rollback de la mise à jour vers la version précédente, voir 4.16.05 Processus de rollback pour plus d'informations.

Informations sur les mises à jour de Logging

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 une mise à jour progressive vous permet de mettre à jour votre installation Edge sans désactiver Edge.

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

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

Mettez à jour les machines dans le bon ordre pour votre installation, comme décrit ci-dessous dans la section "Ordre des mises à jour des machines".
Au moment de mettre à jour les routeurs, sélectionnez un routeur et rendez-le inaccessible, comme décrit dans la section Activer/Désactiver l'accessibilité du serveur (processeur de messages/routeur).
Mettez à jour le routeur sélectionné et tous les autres composants Edge sur la même machine que le routeur. Toutes les configurations Edge montrent 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 autres routeurs.
Continuez la mise à jour pour toutes les machines restantes de votre installation.

Effectuez les actions suivantes avant/après la mise à jour:

Sur le nœud à la fois de routeur et de processeur de messages :
- Avant la mise à jour, effectuez les opérations suivantes :
  1. Rendez le routeur inaccessible.
  2. Rend le processeur de messages inaccessible.
- Après la mise à jour, procédez comme suit :
  1. Rend le processeur de messages accessible.
  2. Rendez le routeur accessible.
Sur un seul nœud de routeur :
- Avant la mise à jour, rendez le routeur inaccessible.
- 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.

Utilisation d'un fichier de configuration silencieux

Vous devez transmettre un fichier de configuration silencieuse à la commande "update". Le fichier de configuration silencieuse doit être le même que celui que vous avez utilisé pour installer Edge 4.16.01.

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

Pour mettre à jour les composants Edge d'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
Remarque: Bien que l'installation RPM nécessite un accès racine, vous pouvez effectuer la configuration Edge sans accès racine.
Désactivez SELinux comme décrit dans la section Installer l'utilitaire de configuration Edge Apigee.
Téléchargez le fichier Edge 4.16.05 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
Installez l'utilitaire apigee-service d'Edge 4.16.05 et ses 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 recevez d'Apigee. Si vous omettez pWord, vous serez invité à le faire.
Par défaut, le programme d'installation vérifie que Java 1.8 est installé. Dans le cas contraire, il l'installe pour vous. Utilisez l'option JAVA_FIX pour indiquer comment gérer l'installation de Java. JAVA_FIX prend les valeurs suivantes:
I = Installer OpenJDK 1.8 (par défaut)
C = Continuer sans installer Java
Q = Quitter. Pour utiliser cette option, vous devez installer Java vous-même.
Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup :
1. Si vous avez installé la version 4.16.01 en mettant à niveau Edge version 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 <inst_dir>/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
2. 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 de apigee-service installe l'utilitaire update/apigee/apigee_dir dans update/apigee/apigee_dir.
Installez l'utilitaire apigee-validate sur le serveur de gestion:
apigee-validate
Remarque: si vous avez installé l'utilitaire apigee-validate sur un nœud de processeur de messages, vous pouvez le mettre à jour en utilisant la commande suivante sur ce nœud:
apigee-validate
Modifiez le fichier de configuration transmis à l'utilitaire apigee-validate. Dans la version Edge précédente, 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 nécessite que la propriété APIGEE_ADMINPW. Vous pouvez supprimer les deux autres propriétés du fichier.
Exécutez l'utilitaire de mise à jour sur vos nœuds dans l'ordre décrit ci-dessous dans la section "Ordre des mises à jour de la machine" ci-dessous:
> /opt/apigee/apigee-setup/bin/update.sh -c composant -f configFile
La seule condition requise dans 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 comprend les éléments suivants :
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Tous les composants Edge à l'exception de l'UI Edge: serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgres
- ui = interface utilisateur Edge
- all = mettre à jour tous les composants sur la machine (à n'utiliser que pour un profil d'installation Edge AI ou un profil d'installation API BaaS en tant que profil d'installation)
- e = ElasticSearch
- b = pile BaaS de l'API
- p = portail BaaS de l'API
- ebp = ElasticSearch, pile BaaS de l'API et portail BaaS de l'API sur le même nœud
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.

Pour annuler la mise à jour ultérieurement, suivez la procédure décrite dans la section 4.16.05 Processus de rollback.

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

Si vos nœuds périphériques sont protégés par un pare-feu ou qu'ils ne sont pas autorisés à accéder au dépôt Apigee sur Internet, vous pouvez effectuer la mise à jour à partir d'un dépôt local ou en 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 contenant le dépôt local afin que les autres nœuds puissent y accéder. Apigee met à votre disposition le serveur Web Nginx. Vous pouvez aussi utiliser votre propre serveur Web.

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

Créez un dépôt local 4.16.05 comme décrit dans la section "Créer un dépôt Apigee local" de la section Installer l'utilitaire de configuration d'Apigee Edge.
Remarque: Si vous disposez déjà d'un dépôt 4.16.01, vous pouvez y ajouter le dépôt 4.16.05.
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 où 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 nouveau répertoire, nommé "re", dans le répertoire contenant le fichier .tar. Exemple : /tmp/repos.
4. Installez l'utilitaire et les dépendances Edge apigee-service à 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 de 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 section Installer l'utilitaire de configuration Edge apigee-setup.
2. Sur le nœud distant, téléchargez le fichier Edge bootstrap_4.16.05.sh dans /tmp/bootstrap_4.16.05.sh :
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.
3. Sur le nœud distant, installez l'utilitaire et les dépendances Edge apigee-service :
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeName=http://
Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup :
1. Si vous avez installé la version 4.16.01 en mettant à niveau Edge version 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 <inst_dir>/apigee/apigee-/bin
  
  Si vous avez déjà installé l'utilitaire apigee-setup, mettez-le à jour:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. 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 de apigee-service installe l'utilitaire update/bin/apigee_dir dans update/bin/apigee_dir.
Installez l'utilitaire apigee-validate sur le nœud du serveur de gestion:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
Remarque: Si vous avez installé l'utilitaire apigee-validate sur un nœud de processeur de messages, vous pouvez le mettre à jour à l'aide de la commande suivante sur ce nœud:

> /opt/apigee/apigee-service/bin/apigee-service apigee-validate mise à jour
Toutefois, pour la version 4.16.05, Apigee vous recommande d'installer et d'exécuter l'utilitaire apigee-validate sur le serveur de gestion.
Modifiez le fichier de configuration transmis à l'utilitaire apigee-validate. Dans la version Edge précédente, 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.
Exécutez l'utilitaire de mise à jour sur vos nœuds dans l'ordre décrit ci-dessous dans la section "Ordre des mises à jour de la machine" ci-dessous:
> /opt/apigee/apigee-setup/bin/update.sh -c composant -f configFile
La seule condition requise dans 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 comprend les éléments suivants :
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Tous les composants Edge à l'exception de l'UI Edge: serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgres
- ui = interface utilisateur Edge
- all = mettre à jour tous les composants sur la machine (à n'utiliser que pour un profil d'installation Edge AI ou un profil d'installation API BaaS en tant que profil d'installation)
- e = ElasticSearch
- b = pile BaaS de l'API
- p = portail BaaS de l'API
- ebp = ElasticSearch, pile BaaS de l'API et portail BaaS de l'API sur le même nœud
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.

Pour annuler la mise à jour ultérieurement, suivez la procédure décrite dans la section 4.16.05 Processus de rollback.

Ordre des mises à jour de la machine

L'ordre dans lequel vous mettez à jour les machines dans une installation Edge est important. Voici les points les plus importants à prendre en compte avant 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 comportant plusieurs composants Edge (serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgres), utilisez l'option "-c bord" pour tous les mettre à jour en même temps.
Si une étape indique qu'elle doit être effectuée sur plusieurs machines, exécutez-la dans l'ordre des machines spécifié.
Il n'existe aucune étape distincte pour mettre à jour la monétisation. Elle est mise à jour lorsque vous spécifiez l'option "-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émarrer le routeur.