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

Mise à jour d'Apigee Edge 4.16.09 vers la version 4.17.09

Edge pour Private Cloud version 4.17.09

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

Vous pouvez mettre à jour la version 4.16.09.0x d'Apigee Edge vers la version 4.17.09 en suivant cette procédure.

Si votre version d’Edge est antérieure à la version 4.16.01, vous devez d’abord migrer vers version 4.16.01.x, puis passer à la version 4.17.09.

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.

Quels composants devez-vous mettre à jour ?

Vous devez mettre à jour tous les composants Edge. Edge ne prend pas en charge une configuration qui contient des composants à partir de plusieurs versions.

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 les routeurs et les processeurs de messages d'écrire 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 Nœud Qpid:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s "nom d'hôte" -i eth0 -j DROP
Attendez que la file d'attente Qpid vide les messages pour vous assurer que le nœud Qpid a traité tous les avant la mise à jour. Utilisez la commande suivante pour vous assurer que la file d'attente de messages Qpid est vide:
> qpid-stat -q
Mettez à jour le nœud Qpid.
Débloquez le port 5672 sur le nœud Qpid pour permettre l'accès depuis les routeurs et les processeurs de messages. Utilisez la commande suivante pour débloquer ce port:
> sudo iptables -F

Notez que si vous utilisez iptables pour d'autres règles, vous pouvez utiliser l'option "-D" pour inverser modification spécifique:
> sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s "nom d'hôte" -i eth0 -j DROP

Ce processus est décrit en détail ci-dessous pour chaque topologie de périphérie.

Obligatoire pour activer le dépôt EPEL

Vous devez activer les packages supplémentaires pour Enterprise Linux (ou EPEL) pour installer ou mettre à jour Edge. La commande à utiliser dépend sur votre version de RedHat/CentOS:

Pour RedHat/CentOS/Oracle 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; tpm -ivh epel-release-latest-7.noarch.rpm
Pour RedHat/CentOS/Oracle 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; tpm -ivh epel-release-latest-6.noarch.rpm

Ajout de SMTPMAILFROM obligatoire paramètre de configuration

Edge 4.17.05 a ajouté un nouveau paramètre requis au fichier de configuration utilisé lorsque vous activez un serveur SMTP. Si vous effectuez la mise à jour depuis la version 4.17.01, vous devez définir SMTPMAILFROM dans le fichier de configuration lors de l'activation du serveur SMTP.

La version 4.17.09 de l'API BaaS est également compatible avec la propriété SMTPMAILFROM. Lors de la mise à jour de l'API BaaS, vous devez définir SMTPMAILFROM dans le champ fichier de configuration.

Ce paramètre prend la forme suivante:

SMTPMAILFROM="My Company <myco@company.com>"

Obligatoire en cas de mise à jour lors de l'utilisation authentification externe

Vous pouvez intégrer un service d'annuaire externe dans un cloud privé Apigee Edge existant l'installation. Cette fonctionnalité est conçue pour fonctionner avec tout service d’annuaire prenant en charge LDAP, comme Active Directory, OpenLDAP, etc. Une solution LDAP externe permet aux systèmes aux administrateurs de gérer les informations d’identification des utilisateurs à partir d’un service de gestion d’annuaire centralisé, externes aux systèmes comme Apigee Edge qui les utilisent.

Consultez la page Ressources externes Configuration de l'authentification.

Lorsque l'authentification externe est activée, la plupart des clients utilisent le compte SAM Active Directory name comme nom d'utilisateur pour l'authentification, au lieu d'une adresse e-mail utilisée par Serveur Edge OpenLDAP.

Si vous avez intégré un service d'annuaire externe, ajoutez la ligne suivante au fichier votre fichier de configuration lors de la mise à jour d'Edge vers la version 4.17.09:

IS_EXTERNAL_AUTH="true"

Cette ligne configure Edge pour prendre en charge un nom de compte, plutôt qu'une adresse e-mail, comme le nom d'utilisateur.

Propagation automatique de la propriété paramètres

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:

> /opt/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 4.17.09 Rollback Process.

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 é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écrits dans la section Activation/Désactivation Joignabilité 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 à 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.09.

Procédure pour mise à jour vers la version 4.17.09 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.
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 la section Installer Edge apigee-setup utilitaire.
Activez le dépôt EPEL comme décrit ci-dessus.
Si vous effectuez l'installation sur AWS, exécutez la commande yum-configure-manager suivante:
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Téléchargez le fichier bootstrap_4.17.09.sh d'Edge 4.17.09 dans /tmp/bootstrap_4.17.09.sh:
> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
Installez l'utilitaire Edge 4.17.09 apigee-service et dépendances:
> sudo bash /tmp/bootstrap_4.17.09.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 mettre à jour le configuration-apigee utilitaire:
> /opt/apigee/apigee-service/bin/apigee-service mise à jour de apigee-setup
Mettez à jour la validation apigee-validate sur le serveur de gestion:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate mise à jour
Mettez à jour le apigee-provision utilitaire:
> /opt/apigee/apigee-service/bin/apigee-service mise à jour apigee-provision
Exécutez l'utilitaire de mise à jour sur vos nœuds dans l'ordre décrit ci-dessous dans "Ordre des mise à 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.

Utilisez l'option "-c" pour spécifier le composant à mettre à jour. La liste des possibilités composants inclut:
ldap = OpenLDAP
cs = Cassandra
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 = Edge UI
all = mettre à jour tous les composants sur machine (à utiliser uniquement pour un profil d'installation Edge aio ou une installation API BaaS en tant que profil)
e = ElasticSearch
b = pile d'API BaaS
p = portail BaaS de l'API
ebp = ElasticSearch, API BaaS et le 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 4.17.09 Processus de rollback.

Procédure de mise à jour vers la version 4.17.09 à 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 une mise à jour à partir d'un dépôt local 4.17.09:

Créez un dépôt 4.17.09 local comme décrit dans la section "Créer un dépôt Apigee local". à Installez l'utilitaire de configuration Edge apigee.
Remarque: Si vous disposez déjà d'un dépôt 4.16.09, vous pouvez ajouter le dépôt comme décrit dans la section "Mettre à jour un dépôt Apigee local". à Installez l'utilitaire de configuration Edge Apigee.
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.17.09.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.17.09.tar.gz
  
  Cette commande crée un répertoire nommé "repos" dans le répertoire contenant le fichier .tar. . Par exemple, /tmp/repos.
4. Installez l'utilitaire Edge apigee-service et les dépendances à partir de /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.17.09.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" dans la section Installer Edge utilitaire de configuration apigee.
2. Sur le nœud distant, téléchargez le fichier Edge bootstrap_4.17.09.sh pour /tmp/bootstrap_4.17.09.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  
  où uName:pWord est le nom d'utilisateur et le mot de passe que vous avez définis ci-dessus pour le dépôt, et remoteRepo est l'adresse IP ou le nom DNS de votre nœud de dépôt.
3. Sur le nœud distant, installez l'utilitaire Edge apigee-service et les dépendances:
  > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  où uName:pWord correspond au nom d'utilisateur et au mot de passe du dépôt.
Utilisez apigee-service pour Mettez à jour l'utilitaire apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service mise à jour concernant apigee-setup
Mettez à jour la validation apigee-validate sur le serveur de gestion.
> /opt/apigee/apigee-service/bin/apigee-service mise à jour apigee-validate
Mettez à jour le apigee-provision utilitaire:
> /opt/apigee/apigee-service/bin/apigee-service mise à jour apigee-provision
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.

Utilisez l'option "-c" pour spécifier le composant à mettre à jour. La liste des possibilités composants inclut:
ldap = OpenLDAP
cs = Cassandra
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 = Edge UI
all = mettre à jour tous les composants sur machine (à utiliser uniquement pour un profil d'installation Edge aio ou une installation API BaaS en tant que profil)
e = ElasticSearch
b = pile d'API BaaS
p = portail BaaS de l'API
ebp = ElasticSearch, API BaaS et le 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 4.17.09 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.
Pour toute machine dotée de plusieurs composants Edge (serveur de gestion, processeur de messages, (routeur, serveur QPID, mais pas serveur Postgres), utilisez "-c Edge" permet de tous les mettre à jour en même temps.
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" .