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 la version 4.16.01.x vers la version 4.16.05.

Si votre version d’Edge est antérieure à la version 4.16.01.x, vous devez d’abord migrer vers version 4.16.01.x, puis passer à 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.

Mise à niveau requise vers la version 8 du JDK Java

Cette version d'Edge nécessite que vous ayez installé la version 8 du JDK Java sur tous les appareils Edge les nœuds de traitement. Vous pouvez installer Oracle JDK 8 ou OpenJDK 8. Si Java JDK 8 n'est pas installé déjà, 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 la liste complète, consultez la section « 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 si vous utilisez 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 Zookeeper dans Edge for Private Cloud 4.16.01 est apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. Dans versions ultérieures d'Edge, la version de ZooKeeper a été reconvertie à apigee-zookeeper-3.4.5-0.0.948. Cela permet d'éviter yum de la mise à niveau de Zookeeper vers une version ultérieure de 4.16.01. La façon de corrompre cette situation est d'exécuter yum rétrograder apigee-zookeeper avant de mettre à jour ZooKeeper.

Vous pouvez vérifier votre 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.

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.01.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 l'utilitaire apigee-validate

Dans la version 4.16.01, vous avez installé et exécuté l'utilitaire apigee-validate sur un message Processeur. 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).

Lorsque vous passez à la version 4.16.05, deux options s'offrent à vous pour mettre à jour l'utilitaire apigee-validate:

Apigee recommandé : installez et exécutez l'utilitaire apigee-validate sur le Nœud de serveur de gestion.

Vous pouvez éventuellement désinstaller l'utilitaire apigee-validate de les nœuds du processeur de messages. Si vous le laissez sur le nœud du processeur de messages, vous devez le mettre à jour au 04/16/05.
Vous pouvez également mettre à jour l'utilitaire apigee-validate sur le et exécutez-le à partir de ce nœud. Apigee vous recommande toutefois d'installer l'exécuter à partir du serveur de gestion.

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 corriger le problème, puis exécuter à nouveau update.sh. Vous pouvez exécuter la mise à jour plusieurs fois et il reprend la mise à jour à partir de là où elle s’était arrêtée.

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

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 dans 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 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écrit dans la section Activation/Désactivation du serveur Joignabilité (processeur/routeur de messages).
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.

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.
  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 inaccessible.
- 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.01.

Procédure pour mise à jour vers la version 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.
Téléchargez le fichier bootstrap_4.16.05.sh d'Edge 4.16.05 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 Edge 4.16.05 apigee-service et 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.
Par défaut, le programme d'installation vérifie que Java 1.8 est bien installé. Si ce n'est pas le cas, l'installe pour vous. Utilisez l'option JAVA_FIX pour spécifier comment gérer 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 mettez à jour apigee-setup utilitaire: <ph type="x-smartling-placeholder">
1. Si vous avez installé la version 4.16.01 en mettant à niveau la version 4.15.07.0x d'Edge, vous devez Installez l'utilitaire apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service installation apigee-setup
  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 à jour ce:
  > /opt/apigee/apigee-service/bin/apigee-service mise à jour de apigee-setup
2. Si vous avez installé directement la version 4.16.01, ce qui signifie que vous n'avez pas effectué de mise à niveau 4.15.07.0x, vous devez mettre à jour l'utilitaire apigee-setup:
  > /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.
Installez apigee-validate sur le serveur de gestion:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate installer
Remarque: Si vous avez installé l'utilitaire apigee-validate sur un de processeur de messages, vous pouvez le mettre à jour en exécutant 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 version d'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 le 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 "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 = Cassandra
- zk = ZooKeeper
- qpid = qpidd
- ps = postgresql
- edge =Tous les bords à l'exception de l'interface utilisateur Edge: serveur de gestion, processeur de messages, routeur, serveur QPID, Serveur Postgres
- ui = Edge UI
- all = mettre à jour tout sur la machine (à utiliser uniquement pour un profil d'installation Edge Aio ou une API BaaS en tant que) profil d'installation)
- e = ElasticSearch
- b = pile d'API BaaS
- p = API BaaS Portail
- ebp = ElasticSearch, Pile BaaS d'API et portail BaaS d'API sur le même nœud
Testez la mise à jour en exécutant l'utilitaire apigee-validate sur le serveur de gestion, en tant que décrit dans la section Tester l'installation.

Pour effectuer un rollback ultérieur de la mise à jour, 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'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:

Créez un dépôt 4.16.05 local comme décrit dans la section "Créer un dépôt Apigee local". dans la section Installer le package Edge utilitaire.
Remarque: Si vous disposez déjà d'un dépôt 4.16.01, vous pouvez ajouter le dépôt 4.16.05 de votre dépôt.
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, dans le répertoire contenant le fichier .tar. Exemple : /tmp/repos.
4. 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 le chemin d'accès dans le répertoire "repos" dans cette commande.
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" consultez l'article Installer Edge utilitaire de configuration apigee.
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 le remoteRepo est l'adresse IP ou le nom DNS du dépôt. d'un nœud.
3. 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=uName apigeepassword=pWord apigeeprotocol=http://
  où uName:pWord correspond au nom d'utilisateur du dépôt et mot de passe.
Utilisez apigee-service pour Mettez à jour l'utilitaire apigee-setup: <ph type="x-smartling-placeholder">
1. Si vous avez installé la version 4.16.01 en mettant à niveau la version 4.15.07.0x d'Edge, vous devez Installez l'utilitaire apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service installation apigee-setup
  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 à jour ce:
  > /opt/apigee/apigee-service/bin/apigee-service mise à jour de apigee-setup
2. Si vous avez installé directement la version 4.16.01, ce qui signifie que vous n'avez pas effectué de mise à niveau 4.15.07.0x, vous devez mettre à jour l'utilitaire apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service mise à jour de apigee-setup
  Cette mise à jour des installations de apigee-service l'utilitaire update.sh ; dans <inst_dir>/apigee/apigee-setup/bin.
Installez l'utilitaire apigee-validate sur le nœud du serveur de gestion:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate installer
Remarque: Si vous avez installé l'utilitaire apigee-validate sur un d'un nœud de processeur de messages, vous pouvez le mettre à jour en exécutant 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 la commande 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 le 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 le 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 "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 = Cassandra
- zk = ZooKeeper
- qpid = qpidd
- ps = postgresql
- edge =Tous les bords à l'exception de l'interface utilisateur Edge: serveur de gestion, processeur de messages, routeur, serveur QPID, Serveur Postgres
- ui = Edge UI
- all = mettre à jour tout sur la machine (à utiliser uniquement pour un profil d'installation Edge Aio ou une API BaaS en tant que) profil d'installation)
- e = ElasticSearch
- b = pile d'API BaaS
- p = API BaaS Portail
- ebp = ElasticSearch, Pile BaaS d'API et portail BaaS d'API sur le même nœud
Testez la mise à jour en exécutant l'utilitaire apigee-validate sur le serveur de gestion, en tant que décrit dans la section Tester l'installation.

Pour effectuer un rollback ultérieur de la mise à jour, 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. 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.