Mise à jour d'Apigee Edge 4.17.0x vers la version 4.18.01

Edge pour Private Cloud v4.18.01

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

Vous pouvez mettre à jour Apigee Edge version 4.17.0x en suivant cette procédure.

<ph type="x-smartling-placeholder">

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.18.01.

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.

Maintenir la compatibilité

Lors de la mise à niveau d'Apigee Edge pour Private Cloud vers la version 4.18.01, vous devez vous assurer que les ne fait référence qu'aux propriétés acceptées dans ses fichiers de configuration.

<ph type="x-smartling-placeholder">
Propriété Lieu Description
conf_load_balancing_load.balancing.
  driver.nginx.server.retry
router.properties Supprimez cette propriété de votre fichier router.properties. Pour définir les options de nouvelle tentative : dans la version 4.18.01, utilisez la classe virtuelle de configuration d'hôte.

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.

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. Lorsque vous mettez à jour une API BaaS à partir de la version 4.17.01 ou 4.17.05, vous devez définir SMTPMAILFROM dans le champ fichier de configuration.

Ce paramètre prend la forme suivante:

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

Mise à niveau requise vers Postgres 9.6

Cette version d'Edge inclut une mise à niveau vers Postgres 9.6. Dans le cadre de cette mise à niveau, Les données Postgres sont migrées vers Postgres 9.6.

La plupart des systèmes de production Edge utilisent deux nœuds Postgres configurés pour la réplication maître en mode veille. Pendant le processus de mise à jour, alors que les nœuds Postgres sont indisponibles pour la mise à jour, les données d'analyse sont toujours écrit dans les nœuds Qpid. Une fois les nœuds Postgres mis à jour et remis en ligne, les données d'analyse est ensuite transmise aux nœuds Postgres.

La méthode de mise à jour Postgres dépend de la configuration du stockage des données Nœuds Postgres:

  • Si vous utilisez le stockage local de données pour vos nœuds Postgres, vous devez installer un nouveau nœud de secours Postgres pendant la durée de la mise à niveau. Après le vous pouvez mettre hors service le nouveau nœud de secours Postgres.

    Le nœud de secours Postgres supplémentaire est requis si vous devez effectuer un rollback de la mise à jour pour quelque raison que ce soit. Si vous devez effectuer un rollback de la mise à jour, devient le nœud Postgres maître après le rollback. Par conséquent, lorsque vous installez nouveau nœud de secours Postgres, il doit se trouver sur un nœud qui répond à tous les besoins les exigences d'un serveur Postgres, telles que définies dans le document Edge Conditions d'installation.

    Dans une installation à un et deux nœuds de Edge, topologies utilisées pour le prototypage et les tests, vous ne disposent que d'un seul nœud Postgres. Vous pouvez mettre à jour ces nœuds Postgres directement pour créer un nœud Postgres.
  • Si vous utilisez un stockage réseau pour vos nœuds Postgres, car recommandé par Apigee, il n'est pas nécessaire d'installer un nouveau nœud Postgres. Dans des procédures ci-dessous, vous pouvez ignorer les étapes consistant à installer, puis à mettre hors service Nœud de secours Postgres.

    Avant de commencer le processus de mise à jour, prenez un instantané réseau du magasin de données utilisé par Postgres. Ensuite, si des erreurs se produisent pendant la mise à jour et que vous êtes obligé d'effectuer un rollback, vous pouvez restaurer le nœud Postgres à partir de cet instantané.

Installation d'un nouveau Postgres nœud de secours

Cette procédure crée un serveur de secours Postgres sur un nouveau nœud. Veillez à installer une nouvelle Serveur de secours Postgres pour votre version existante d'Edge (4.17.0x), et non pour version 4.18.01.

Pour effectuer l'installation, utilisez le même fichier de configuration que celui utilisé pour installer la version actuelle d'Edge.

Pour créer un nœud de secours Postgres:

  1. Dans l'instance maître Postgres actuelle, modifiez la /opt/apigee/customer/application/postgresql.properties pour définir les éléments suivants jeton:
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32
    trust\ \nhost replication apigee new_slave_ip/32 trust

    existing_slave_ip est l'adresse IP du Postgres actuel serveur de secours, et new_slave_ip est l'adresse IP du nouveau nœud de secours.

    Si le fichier postgresql.properties n'existe pas, créez-le et utilisez chown pour autoriser l'utilisateur apigee à y accéder, comme dans l'exemple suivant : affiche:

    chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
  2. Redémarrez apigee-postgresql. sur l'instance maître Postgres:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Vérifiez que le nouveau nœud de secours a été ajouté en affichant le /opt/apigee/apigee-postgresql/conf/pg_hba.conf sur l'instance maître. Les lignes suivantes doivent s'afficher dans ce fichier:
    host replication apigee existing_slave_ip/32 trust
    host replication apigee new_slave_ip/32 trust
  4. Installez le nouveau serveur de secours Postgres: <ph type="x-smartling-placeholder">
      </ph>
    1. Modifiez le fichier de configuration que vous avez utilisé pour installer votre version actuelle d'Edge pour spécifier les éléments suivants:
      # IP address of the current master:
      PG_MASTER=192.168.56.103
      # IP address of the new standby node
      PG_STANDBY=192.168.56.102 
    2. Désactivez SELinux comme décrit dans la section Installer le Utilitaire de configuration périphérique Apigee
    3. Téléchargez le fichier Bootstrap_4.17.0x.sh Edge. (où 4.17.0x correspond à 4.17.01, 4.17.05, ou 4.17.09) par /tmp/bootstrap_4.17.0x.sh :
      curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
    4. Installez l'utilitaire Edge apigee-service et dépendances:
      sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName
        apigeepassword=pWord
    5. Utilisez apigee-service pour installer l'utilitaire apigee-setup:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. Installez Postgres:
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. Sur le nouveau serveur de secours, exécutez la commande suivante:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Vérifiez qu'il s'agit de l'instance de secours.

Mise hors service d'un système Postgres nœud

Une fois la mise à jour terminée, mettez le nouveau nœud de secours hors service:

  1. Vérifiez que Postgres est en cours d'exécution:
    &gt; /opt/apigee/apigee-service/bin/apigee-all statut

    Si Postgres n'est pas en cours d'exécution, démarrez-le:
    &gt; /opt/apigee/apigee-service/bin/apigee-all démarrage
  2. Obtenez l'UUID du nouveau nœud de secours en exécutant la commande cURL suivante sur le nouveau nœud de secours:
    &gt; curl -u sysAdminEmail:password http://&lt;node_IP&gt;:8084/v1/servers/self

    L'UUID du nœud doit s'afficher à la fin du résultat, sous la forme:
    "type" : [ "postgres-server" ],
    "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  3. Arrêtez le nouveau nœud de secours en exécutant la commande suivante sur le nouveau nœud de secours:
    &gt; /opt/apigee/apigee-service/bin/apigee-all stop
  4. Sur le nœud maître Postgres, modifiez /opt/apigee/customer/application/postgresql.properties pour supprimer le nouveau nœud de secours de conf_pg_hba_replication.connection:
    conf_pg_hba_replication.connection=host approbation de l'existing_slave_ip/32 de réplication
  5. Redémarrez apigee-postgresql sur le maître Postgres:
    &gt; /opt/apigee/apigee-service/bin/apigee-service redémarrage d'apigee-postgresql
  6. Vérifiez que le nouveau nœud de secours a été supprimé en affichant le fichier /opt/apigee/apigee-postgresql/conf/pg_hba.conf sur l'instance maître. Seule la ligne suivante devrait s'afficher dans ce fichier:
    réplication de l'hôte apigee existing_slave_ip/32 confiance
  7. Supprimez l'UUID du nœud de secours de ZooKeeper en effectuant la gestion Edge suivante : Appel d'API sur le nœud du serveur de gestion:
    &gt; curl -u sysAdminEmail:password -X DELETE http://&lt;ms_IP&gt;:8080/v1/servers/&lt;new_slave_uuid&gt;

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 la section Sauvegarde et Restaurer.
  • 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:

    &gt; /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 la section Processus de rollback de la version 4.18.01 pour en savoir plus.

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 chaque routeur de la charge, 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.

  1. 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.
  2. 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).
  3. 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.
  4. Rendez le routeur à nouveau accessible.
  5. Répétez les étapes 2 à 4 pour les routeurs restants.
  6. 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">
      </ph>
    • Avant la mise à jour: <ph type="x-smartling-placeholder">
        </ph>
      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">
        </ph>
      1. Rendez le processeur de messages accessible.
      2. Rendez le routeur accessible.
  • Sur un nœud de routeur unique: <ph type="x-smartling-placeholder">
      </ph>
    • 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">
      </ph>
    • 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.17.0x.

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

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

  1. Si vous utilisez actuellement la réplication principale Postgres avec stockage local, installer un nouveau nœud de secours Postgres comme décrit ci-dessus dans la section Installation d'une nouvelle de secours.

    Si vous utilisez un stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Prenez plutôt un instantané réseau du data store utilisé par Postgres. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.
  2. 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.
  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. Installez yum-utils et yum-plugin-priorities:
    &gt; sudo yum install yum-utils
    &gt; sudo yum install yum-plugin-priorities
  5. Désactivez SELinux comme décrit dans la section Installer l'utilitaire de configuration Edge Apigee.
  6. Si vous effectuez l'installation sur Oracle 7.x, exécutez la commande suivante:
    &gt; sudo yum-config-manager : activer ol7_optional_latest
  7. Si vous effectuez l'installation sur AWS, exécutez les commandes yum-configure-manager suivantes:
    &gt; mise à jour miam rh-amazon-rhui-client.noarch
    &gt; sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  8. Téléchargez le fichier Edge 4.18.01 bootstrap_4.18.01.sh dans /tmp/bootstrap_4.18.01.sh:
    &gt; curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  9. Installez l'utilitaire Edge 4.18.01 apigee-service et dépendances:
    &gt; sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    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.
  10. Utilisez apigee-service pour mettez à jour apigee-setup utilitaire:
    &gt; /opt/apigee/apigee-service/bin/apigee-service mise à jour de apigee-setup
  11. Mettez à jour la validation apigee-validate sur le serveur de gestion:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-validate mise à jour
  12. Mettez à jour le apigee-provision utilitaire:
    &gt; /opt/apigee/apigee-service/bin/apigee-service mise à jour apigee-provision
  13. 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:
    &gt; /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
  14. Testez la mise à jour en exécutant l'utilitaire apigee-validate sur le gestionnaire serveur, comme décrit dans la section Tester l'installation.
  15. Si vous avez installé un nouveau nœud de secours Postgres, mettez-le hors service comme décrit ci-dessus. de la section Mise hors service Nœud Postgres

    Si vous utilisez un stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.

Pour effectuer un rollback ultérieur de la mise à jour, suivez la procédure décrite dans la section 4.18.01 Processus de rollback.

Procédure de mise à jour vers la version 4.18.01 à 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.18.01 local:

  1. Si vous utilisez actuellement la réplication maître Postgres, installez une nouvelle instance de secours comme décrit ci-dessus dans la section Installation d'un nouveau système Postgres de secours.

    Si vous utilisez un stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Prenez plutôt un instantané réseau du data store utilisé par Postgres. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.
  2. Créez un dépôt 4.18.01 local comme décrit dans la section "Créer un dépôt Apigee local". dans la section Installer l'utilitaire Edge apigee-setup.
    Remarque: Si vous disposez déjà d'un dépôt 4.17.0x, vous pouvez ajouter le fichier 4.18.01, comme décrit dans la section "Mettre à jour un dépôt Apigee local" dans Installez l'utilitaire de configuration Edge apigee.
  3. Pour installer apigee-service à partir d'un fichier .tar: <ph type="x-smartling-placeholder">
      </ph>
    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.18.01.tar.gz:
      &gt; /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:
      &gt; tar -xzf apigee-4.18.01.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:
      &gt; sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Notez que vous incluez dans cette commande le chemin d'accès au répertoire "dépôts".
  4. Pour installer apigee-service à l'aide du serveur Web Nginx: <ph type="x-smartling-placeholder">
      </ph>
    1. Configurez le serveur Web Nginx comme indiqué dans la section "Installer à partir du dépôt à l'aide de la commande webserver&quot; dans la section Installer Edge utilitaire de configuration apigee.
    2. Sur le nœud distant, téléchargez le fichier Edge bootstrap_4.18.01.sh pour /tmp/bootstrap_4.18.01.sh:
      &gt; /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh

      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:
      &gt; sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      uName:pWord correspond au nom d'utilisateur et au mot de passe du dépôt.
  5. Utilisez apigee-service pour Mettez à jour l'utilitaire apigee-setup:
    &gt; /opt/apigee/apigee-service/bin/apigee-service mise à jour de apigee-setup
  6. Mettez à jour la validation apigee-validate sur le serveur de gestion.
    &gt; /opt/apigee/apigee-service/bin/apigee-service mise à jour apigee-validate
  7. Mettez à jour le apigee-provision utilitaire:
    &gt; /opt/apigee/apigee-service/bin/apigee-service mise à jour apigee-provision
  8. 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:
    &gt; /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
  9. Testez la mise à jour en exécutant l'utilitaire apigee-validate sur le gestionnaire serveur, comme décrit dans la section Tester l'installation.
  10. Si vous avez installé un nouveau nœud de secours Postgres, mettez-le hors service comme décrit ci-dessus, dans la section Mise hors service un nœud Postgres.

    Si vous utilisez un stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.

Pour effectuer un rollback ultérieur de la mise à jour, suivez la procédure décrite dans la section 4.18.01 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" .

Pour une version autonome à 1 hôte installation

  1. Si vous effectuez la mise à jour depuis la version 4.17.01, définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre prend la forme suivante:
    SMTPMAILFROM="Mon entreprise <monco@entreprise.com>"
  2. Mettez à jour Cassandra et ZooKeeper:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Mettre à jour Qpid:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Mettre à jour LDAP:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Arrêtez Postgres Server, Qpid Server et PostgreSQL:
    &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql arrêter
  6. Mettez à jour postgresql:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. Mettez à jour la base de données Postgres:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  8. Mettez à jour les composants Edge restants:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  9. Mettre à jour l'interface utilisateur Edge:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Pour une instance autonome à 2 hôtes installation

Consultez la section Topologies d'installation pour obtenir la liste des éléments Edge et les numéros de nœuds.

  1. Si vous effectuez la mise à jour depuis la version 4.17.01, définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre prend la forme suivante:
    SMTPMAILFROM="Mon entreprise <monco@entreprise.com>"
  2. Mettez à jour Cassandra et ZooKeeper sur la machine 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Mise à jour de Qpid sur la machine 2:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Mettre à jour LDAP sur la machine 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Mettre à jour les composants Edge sur la machine 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  6. Mettre à jour l'UI sur la machine 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. Mettez à jour postgresql sur la machine 2: <ph type="x-smartling-placeholder">
      </ph>
    1. Arrêtez Postgres Server, Qpid Server et postgresql:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql arrêter
    2. Mettez à jour postgresql:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Mettez à jour la base de données Postgres:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. Mettez à jour les composants Edge sur la machine 2:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

Pour un cluster à 5 hôtes installation

Consultez la section Topologies d'installation pour obtenir la liste des éléments Edge et les numéros de nœuds.

  1. Si vous effectuez la mise à jour depuis la version 4.17.01, définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre prend la forme suivante:
    SMTPMAILFROM="Mon entreprise <monco@entreprise.com>"
  2. Assurez-vous d'avoir installé un nouveau nœud de secours Postgres comme décrit ci-dessus. de la section Installation un nouveau nœud de secours Postgres.

    Si vous utilisez un stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Prenez plutôt un instantané réseau du data store utilisé par Postgres. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.
  3. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Mettez à jour Qpid sur les machines 4 et 5:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Mettre à jour LDAP sur la machine 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Mettre à jour les composants Edge sur les machines 1, 2 et 3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Mettre à jour l'UI sur la machine 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. ??Mettre à jour machines 4 et 5: <ph type="x-smartling-placeholder">
      </ph>
    1. Arrêtez le serveur Postgres et le serveur Qpid sur la machine 4:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    2. Arrêtez le serveur Postgres, le serveur Qpid et postgresql sur la machine 5:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql arrêter
    3. Si installé, arrêtez le serveur Postgres et postgresql sur le nouveau système de secours que vous avez ajouté pour le rollback:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql arrêter
    4. Mise à jour de postgresql sur les machines 4:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Mettez à jour la base de données Postgres sur la machine 4 (instance maître Postgres uniquement):
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. Mise à jour de postgresql sur les machines 5:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Démarrez le serveur Postgres et le serveur Qpid sur les machines 4 et 5:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    8. Configurez Postgres en tant que nœud de secours en exécutant les commandes suivantes sur la machine 5:
      &gt; cd /opt/apigee/data/apigee-postgresql/pgdata
      &gt; rm -rf *
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f
      configFile
    9. Vérifiez l'état de la réplication en émettant les scripts suivants sur les deux serveurs. La doit afficher des résultats identiques sur les deux serveurs afin de garantir la réussite réplication:

      Sur la machine 4 (le nœud maître), exécutez la commande suivante:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Vérifiez qu'il s'agit de l'instance maître.

      Sur la machine 5, le nœud de secours:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Vérifiez qu'il s'agit de l'instance de secours.
  9. Mettre à jour les composants Edge sur les machines 4 et 5:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. Veillez à mettre le nouveau nœud de secours hors service en suivant la procédure ci-dessus. pour la mise hors service un nœud Postgres

    Si vous utilisez un stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.

Pour un cluster à 9 hôtes installation

Consultez la section Topologies d'installation pour obtenir la liste des éléments Edge et les numéros de nœuds.

  1. Si vous effectuez la mise à jour depuis la version 4.17.01, définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre prend la forme suivante:
    SMTPMAILFROM="Mon entreprise <monco@entreprise.com>"
  2. Assurez-vous d'avoir installé un nouveau nœud de secours Postgres comme décrit ci-dessus. de la section Installation un nouveau nœud de secours Postgres.

    Si vous utilisez un stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Prenez plutôt un instantané réseau du data store utilisé par Postgres. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.
  3. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Mettez à jour Qpid sur les machines 6 et 7:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Mettre à jour LDAP sur la machine 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Mettez à jour les composants Edge sur les machines 6, 7, 1, 4 et 5, dans cet ordre:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Mettre à jour l'UI sur la machine 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile?
  8. Mettez à jour les machines 8 et 9: <ph type="x-smartling-placeholder">
      </ph>
    1. Arrêtez le serveur Postgres sur la machine 8:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server arrêter
    2. Arrêtez le serveur Postgres et postgresql sur la machine 9:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql arrêter
    3. Arrêtez le serveur Qpid sur les machines 6 et 7:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. Si installé, arrêtez le serveur Postgres et postgresql sur le nouveau système de secours que vous avez ajouté pour le rollback:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql arrêter
    5. Mise à jour de postgresql sur les machines 8:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Mettez à jour la base de données Postgres sur la machine 8 (instance maître Postgres uniquement):
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Mise à jour de postgresql sur les machines 9:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Démarrez le serveur du serveur Postgres sur les machines 8 et 9:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. Démarrez le serveur du serveur Qpid sur les machines 6 et 7:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Configurez Postgres en tant que nœud de secours en exécutant les commandes suivantes sur la machine 9:
      &gt; cd /opt/apigee/data/apigee-postgresql/pgdata
      &gt; rm -rf *
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f
      configFile
    11. Vérifiez l'état de la réplication en émettant les scripts suivants sur les deux serveurs. La doit afficher des résultats identiques sur les deux serveurs afin de garantir la réussite réplication:
      Sur la machine 8, le nœud maître, exécutez la commande suivante:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Vérifiez qu'il s'agit de l'instance maître.

      Sur la machine 9, le nœud de secours:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Vérifiez qu'il s'agit de l'instance de secours.
  9. Mettez à jour les composants Edge sur les machines 8 et 9:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. Veillez à mettre le nouveau nœud de secours hors service en suivant la procédure ci-dessus. pour la mise hors service un nœud Postgres

    Si vous utilisez un stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.

Pour un cluster à 13 hôtes installation

Consultez la section Topologies d'installation pour obtenir la liste des éléments Edge et les numéros de nœuds.

  1. Si vous effectuez la mise à jour depuis la version 4.17.01, définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre prend la forme suivante:
    SMTPMAILFROM="Mon entreprise <monco@entreprise.com>"
  2. Assurez-vous d'avoir installé un nouveau nœud de secours Postgres comme décrit ci-dessus. de la section Installation un nouveau nœud de secours Postgres.

    Si vous utilisez un stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Prenez plutôt un instantané réseau du data store utilisé par Postgres. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.
  3. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Mettez à jour Qpid sur les machines 12 et 13:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Mettre à jour LDAP sur les machines 4 et 5:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Mettez à jour les composants Edge sur les machines 12, 13, 6, 7, 10 et 11, dans cet ordre:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Mettre à jour l'interface utilisateur sur les machines 6 et 7:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile??
  8. Mettez à jour les machines 8 et 9: <ph type="x-smartling-placeholder">
      </ph>
    1. Arrêtez le serveur Postgres sur la machine 8:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server arrêter
    2. Arrêtez le serveur Postgres et postgresql sur la machine 9:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql arrêter
    3. Arrêtez le serveur Qpid sur les machines 12 et 13:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. Si installé, arrêtez le serveur Postgres et postgresql sur le nouveau système de secours que vous avez ajouté pour le rollback:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql arrêter
    5. Mise à jour de postgresql sur les machines 8:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Mettez à jour la base de données Postgres sur la machine 8 (instance maître Postgres uniquement):
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Mise à jour de postgresql sur les machines 9:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Démarrez le serveur Postgres sur les machines 8 et 9:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. Démarrez le serveur du serveur Qpid sur les machines 12 et 13:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Configurez Postgres en tant que nœud de secours en exécutant les commandes suivantes sur la machine 9:
      &gt; cd /opt/apigee/data/apigee-postgresql/pgdata
      &gt; rm -rf *
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f
      configFile
    11. Vérifiez l'état de la réplication en émettant les scripts suivants sur les deux serveurs. La doit afficher des résultats identiques sur les deux serveurs afin de garantir la réussite réplication:
      Sur la machine 8, le nœud maître, exécutez la commande suivante:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Vérifiez qu'il s'agit de l'instance maître.

      Sur la machine 9, le nœud de secours:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Vérifiez qu'il s'agit de l'instance de secours.
  9. Mettez à jour les composants Edge sur les machines 8 et 9:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile??
  10. Veillez à mettre le nouveau nœud de secours hors service en suivant la procédure ci-dessus. pour la mise hors service un nœud Postgres

    Si vous utilisez un stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.

Pour un cluster à 12 hôtes installation

Consultez la section Topologies d'installation pour obtenir la liste des éléments Edge et les numéros de nœuds.

  1. Si vous effectuez la mise à jour depuis la version 4.17.01, définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre prend la forme suivante:
    SMTPMAILFROM="Mon entreprise <monco@entreprise.com>"
  2. Assurez-vous d'avoir installé un nouveau nœud de secours Postgres comme décrit ci-dessus. de la section Installation un nouveau nœud de secours Postgres.

    Si vous utilisez un stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Prenez plutôt un instantané réseau du data store utilisé par Postgres. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.
  3. Mettez à jour Cassandra et ZooKeeper: <ph type="x-smartling-placeholder">
      </ph>
    1. Sur les machines 1, 2 et 3 du centre de données 1:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Sur les machines 7, 8 et 9 du centre de données 2
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Mettre à jour Qpidd: <ph type="x-smartling-placeholder">
      </ph>
    1. Machines 4 et 5 dans le centre de données 1 <ph type="x-smartling-placeholder">
        </ph>
      1. Mettre à jour qpidd sur machine 4:
        &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Répétez l'étape 1 sur la machine 5.
    2. Machines 10 et 11 dans le centre de données 2 <ph type="x-smartling-placeholder">
        </ph>
      1. Mettre à jour qpidd sur machine 10:
        &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Répétez l'étape 1 sur la machine 11.
  5. Mettre à jour LDAP: <ph type="x-smartling-placeholder">
      </ph>
    1. Machines 1 dans le centre de données 1
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Machines 7 dans le centre de données 2
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Mettez à jour les composants Edge: <ph type="x-smartling-placeholder">
      </ph>
    1. Machines 4, 5, 1, 2, 3 dans le centre de données 1
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
    2. Machines 10, 11, 7, 8 et 9 du centre de données 2
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Mettre à jour l'interface utilisateur: <ph type="x-smartling-placeholder">
      </ph>
    1. Machine 1 dans le centre de données 1:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. Machine 7 dans le centre de données 2:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. ?Mettre à jour machine 6 dans les centres de données 1 et 12 dans le centre de données 2: <ph type="x-smartling-placeholder">
      </ph>
    1. Arrêtez le serveur Postgres sur la machine 6:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server arrêter
    2. Arrêtez le serveur Postgres et postgresql sur la machine 12:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql arrêter
    3. Arrêtez le serveur Qpid sur les machines 4, 5, 10 et 11:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. Si installé, arrêtez le serveur Postgres et postgresql sur le nouveau système de secours que vous avez ajouté pour le rollback:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql arrêter
    5. Mise à jour de postgresql sur les machines 6:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Mettez à jour la base de données Postgres sur la machine 6 (instance maître Postgres uniquement):
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Mettre à jour postgresql sur les machines 12:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Démarrage du serveur Postgres sur les machines 6 et 12:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. Démarrez le serveur Qpid sur les machines 4, 5, 10 et 11:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Configurez Postgres en tant que nœud de secours en exécutant les commandes suivantes sur la machine 12h
      &gt; cd /opt/apigee/data/apigee-postgresql/pgdata
      &gt; rm -rf *
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f
      configFile
    11. Vérifiez l'état de la réplication en émettant les scripts suivants sur les deux serveurs. La doit afficher des résultats identiques sur les deux serveurs afin de garantir la réussite réplication:
      Sur la machine 6, le nœud maître, exécutez la commande suivante:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Vérifiez qu'il s'agit de l'instance maître.

      Sur la machine 12, le nœud de secours:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Vérifiez qu'il s'agit de l'instance de secours.
  9. Mettez à jour les composants Edge sur les machines 6 et 12:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. Veillez à mettre le nouveau nœud de secours hors service en suivant la procédure ci-dessus. pour la mise hors service un nœud Postgres

    Si vous utilisez un stockage réseau, vous n'avez pas besoin d'installer le nouveau nœud. Pour en savoir plus, consultez la section Mise à niveau requise vers Postgres 9.6.

Pour une API BaaS à sept hôtes installation

  1. Définissez SMTPMAILFROM dans votre fichier de configuration. Ce paramètre prend la forme suivante:
    SMTPMAILFROM="Mon entreprise <monco@entreprise.com>"
  2. Mettez à jour Cassandra sur les machines 5, 6 et 7:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  3. Mettez à jour ElasticSearch et la pile BaaS de l'API sur les machines 1, 2 et 3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

  4. Mise à jour du portail API BaaS sur la machine 4:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Pour une API BaaS à 10 hôtes installation

  1. Définissez SMTPMAILFROM dans votre fichier de configuration. Ce paramètre prend la forme suivante:
    SMTPMAILFROM="Mon entreprise <monco@entreprise.com>"
  2. Mettez à jour Cassandra sur les machines 8, 9 et 10:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  3. Mettez à jour ElasticSearch sur les machines 1, 2 et 3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  4. Mettez à jour la pile d'API BaaS sur les machines 4, 5 et 6:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  5. Mettez à jour le portail API BaaS sur la machine 7:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Pour une API Baas à deux centres de données installation

Cette procédure nécessite la mise à jour des nœuds Cassandra dans les deux centres de données. Si vous utilisez partageant ces nœuds Cassandra avec Edge, vous mettez généralement à jour ces nœuds dans le cadre mise à jour de Edge.

  1. Définissez SMTPMAILFROM dans votre de configuration. Ce paramètre prend la forme suivante:
    SMTPMAILFROM="Mon entreprise <monco@entreprise.com>"
  2. Mettez à jour les espaces de clés Cassandra avec un facteur de réplication correct pour les deux centres de données. Toi cette étape n'est nécessaire qu'une seule fois sur n'importe quel serveur Cassandra de l'un ou l'autre des centres de données:

    Remarque: Les commandes ci-dessous définissent le facteur de réplication sur "3", ce qui indique trois nœuds Cassandra dans le cluster. Modifiez cette valeur si nécessaire pour votre installation.
    1. Lancez l'utilitaire Cassandra cqlsh:
      &gt; /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Exécutez les commandes CQL suivantes au niveau de la commande "cqlsh>" pour définir la réplication pour les espaces de clés Cassandra: <ph type="x-smartling-placeholder">
        </ph>
      1. cqlsh&gt; MODIFICATION ESPACE CLÉ "Apigee_Baas_dc_1" AVEC réplication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      2. cqlsh&gt; MODIFICATION KEYSPACE "Apigee_Baas" AVEC réplication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. cqlsh&gt; MODIFICATION ESPACE CLÉ "Apigee_Baas_Locks" AVEC réplication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      4. cqlsh&gt; ALTER KEYSPACE "system_traces" AVEC réplication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      5. cqlsh&gt; MODIFICATION ESPACE DE CLÉS "Apigee_Baas_dc_2" AVEC réplication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      6. Affichez les espaces de clés à l'aide de la commande suivante:
        cqlsh&gt; sélectionnez * à partir de system.schema_keyspaces;
      7. Quitter cqlsh:
        cqlsh&gt; sortie
  3. (Uniquement si vous n'avez pas mis à jour Cassandra lors de Edge) Mettez à jour les nœuds Cassandra dans le centre de données 1, une machine à la fois:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  4. (Uniquement si vous n'avez pas mis à jour Cassandra lors de Edge) Mettez à jour les nœuds Cassandra dans le centre de données 2, une machine à la fois:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. Mettez à jour ElasticSearch sur les machines du centre de données 1, une machine à la fois:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  6. Mettez à jour ElasticSearch sur les machines du centre de données 2, une machine à la fois:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  7. Mettez à jour la pile d'API BaaS sur les machines du centre de données 1, une machine à la fois:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  8. Mettez à jour la pile d'API BaaS sur les machines du centre de données 2, une machine à la fois:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  9. Mettez à jour le portail API BaaS sur les machines du centre de données 1, une machine à la fois:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  10. Mettez à jour le portail API BaaS sur les machines du centre de données 2, une machine à la fois:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  11. Mettre à jour les valeurs d'espace de clés BaaS Cet espace de clés doit être défini pour la réplication au moment de l'installation, mais pas nécessairement au moment de l'exécution. La suppression de la réplication permet également d'économiser la mémoire Cassandra.

    Vous n'avez besoin d'exécuter cette étape qu'une seule fois sur les serveurs Cassandra de l'un ou l'autre des centres de données: <ph type="x-smartling-placeholder">
      </ph>
    1. Lancez l'utilitaire Cassandra cqlsh:
      &gt; /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Exécutez les commandes CQL suivantes pour définir les niveaux de réplication pour Cassandra espaces de clés: <ph type="x-smartling-placeholder">
        </ph>
      1. cqlsh&gt; ALTER KEYSPACE &quot;Apigee_Baas_dc_1&quot; AVEC réplication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
      2. cqlsh&gt; ALTER KEYSPACE &quot;Apigee_Baas_dc_2&quot; AVEC réplication = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
      3. Affichez les espaces de clés à l'aide de la commande suivante:
        cqlsh&gt; sélectionnez * à partir de system.schema_keyspaces;
      4. Quitter cqlsh:
        cqlsh&gt; quitter

Pour une installation non standard

Si votre installation n'est pas standard, mettez à jour les composants Edge à la commande:

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Edge, qui signifie « -c bord » profil sur tous les nœuds dans l'ordre: nœuds avec serveur Qpid, Serveur Postgres, serveur de gestion, processeur de messages et routeur.
    Remarque: Si le serveur Qpid et le serveur Postgres sont installés sur le nœud, exécutez la commande "-c bord" étape du profil.
  6. Interface utilisateur périphérique
Mise à jour d'Apigee Edge 4.17.01/4.17.05 vers la version 4.17.09