4.19.06.07 - Notes de version d'Edge for Private Cloud

Vous consultez la documentation Apigee Edge.
Accédez à la documentation Apigee X.
info

Le 5 juin 2020, nous avons lancé une nouvelle version d'Apigee Edge pour le cloud privé.

Procédure de mise à jour

Pour mettre à jour votre installation, procédez comme suit sur les nœuds Edge :

  1. Sur tous les nœuds Edge :

    1. Nettoyez les dépôts Yum :
      sudo yum clean all
    2. Téléchargez le dernier fichier bootstrap_4.19.06.sh d'Edge 4.19.06 dans /tmp/bootstrap_4.19.06.sh :
      curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
    3. Installez l'utilitaire apigee-service et les dépendances d'Edge 4.19.06 :
      sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord

      uName:pWord correspondent au nom d'utilisateur et au mot de passe que vous avez reçus d'Apigee. Si vous omettez pWord, vous serez invité à le saisir.

    4. Mettez à jour l'utilitaire apigee-setup :
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    5. Utilisez la commande source pour exécuter le script apigee-service.sh :
      source /etc/profile.d/apigee-service.sh
  2. Exécutez le script update.sh pour OpenLDAP sur tous les nœuds. Sur chaque nœud, exécutez la commande suivante :
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

    configFile spécifie le fichier de configuration que vous avez utilisé pour installer Apigee Edge pour le cloud privé.

  3. Exécutez le script update.sh pour Edge sur tous les nœuds. Sur chaque nœud, exécutez la commande suivante :
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

    configFile spécifie le fichier de configuration que vous avez utilisé pour installer Apigee Edge pour le cloud privé.

  4. Exécutez le script update.sh pour l'interface utilisateur sur tous les nœuds. Sur chaque nœud, exécutez la commande suivante :
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

    configFile spécifie le fichier de configuration que vous avez utilisé pour installer Apigee Edge pour le cloud privé.

  5. Exécutez le script update.sh pour l'authentification unique sur tous les nœuds. Sur chaque nœud, exécutez la commande suivante :
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile

    configFile spécifie le fichier de configuration que vous avez utilisé pour installer Apigee Edge pour le cloud privé.

  6. Exécutez le script update.sh pour le portail des développeurs sur tous les nœuds. Sur chaque nœud, exécutez la commande suivante :
    /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

    configFile spécifie le fichier de configuration que vous avez utilisé pour installer Apigee Edge pour le cloud privé.

  7. Si vous utilisez Apigee mTLS et que vous avez mis à jour votre configuration en fonction des nouvelles fonctionnalités ou des corrections de bugs de ce correctif, vous devez désinstaller, puis réinstaller le apigee-mtls service sur tous les nœuds pour que ces modifications prennent effet. Pour en savoir plus, consultez la section Modifier une configuration apigee-mtls existante.

Logiciels compatibles

Apigee Edge pour le cloud privé est compatible avec OpenJDK version 1.8.0.252.

Tomcat a été mis à jour vers la version 7.0.103.

Abandon et mise hors service

Aucune modification.

Nouvelles fonctionnalités

Le tableau suivant décrit les nouvelles fonctionnalités de cette version :

Description

mTLS sécurise la connexion entre le serveur de gestion et le routeur

Apigee mTLS est désormais compatible avec la connexion entre le serveur de gestion et le routeur sur le port 8081.

La durée de validité du certificat est désormais configurable

Lorsque vous utilisez un certificat personnalisé, vous pouvez définir le nombre de jours pendant lesquels le certificat est valide. Pour ce faire, définissez la valeur de APIGEE_MTLS_NUM_DAYS_CERT_VALID_FOR dans votre fichier de configuration. La valeur par défaut est 365. Pour en savoir plus, consultez l'étape 1 : Mettre à jour votre fichier de configuration. Si vous apportez une modification après avoir installé Apigee mTLS, veillez à suivre les instructions de la section Modifier une configuration apigee-mtls existante.

Bugs résolus

Le tableau suivant répertorie les bugs résolus dans cette version :

ID du problème Description
154428338

Le processeur de messages ne parvient pas à charger les environnements lorsque les keystores sont configurés avec des noms ou des alias similaires.

Nous avons corrigé un conflit de recherche d'expression régulière lors du chargement de keystores dont la convention de dénomination est similaire. Cela empêchait le processeur de messages de charger les environnements associés au keystore ou de démarrer lorsque plusieurs keystores en conflit étaient renvoyés lors de la recherche.

130653816

Erreurs 404 intermittentes dans le trafic d'exécution.

Une condition de concurrence empêchait les processeurs de messages de charger tous les proxys au démarrage, ce qui entraînait des erreurs 404 ApplicationNotFound intermittentes dans le trafic d'exécution.

Ce problème a été résolu.

157275131

Mise à niveau de Drupal

Le processus de mise à niveau du portail des développeurs était interrompu dans la version 4.19.06.

155840972 Mise à niveau de Tomcat

Tomcat a été mis à niveau vers la version 7.0.103.

155595660

Format du fuseau horaire

Les valeurs utilisées pour les jetons sss et SSS dans le format de fuseau horaire défini par la propriété conf_system_apigee.syslogger.dateFormat n'étaient pas correctes.

155340541

Compatibilité avec OpenJDK

Apigee est compatible avec OpenJDK version 1.8.0.252.

155105930
76087166

Mappages clé-valeur dans les environnements multicentres de données

Le serveur de gestion se connectait de manière aléatoire à l'un des centres de données si une organisation s'étendait sur plusieurs centres de données (par exemple, dc-1, dc-2). Cela affectait les connexions aux nœuds Cassandra du centre de données local pour la gestion des clés et les opérations de mappage clé-valeur.

152382545

Utilisation de la plage de ports mTLS

La documentation indique désormais correctement que la plage de ports ZooKeeper pour Apigee mTLS commence à 10001.

150717738

Clusters sans leader

Les clusters sans leader empêchaient l'arrêt ou le redémarrage du service mTLS. La durée du délai d'inactivité a également été réduite.

148486685

Interopérabilité de la réplication OpenLDAP et de l'authentification unique avec liaison indirecte

Avec la liaison indirecte, le service OpenLDAP ne recherchait pas l'objet utilisateur lorsque la réplication était activée (il existait plusieurs instances OpenLDAP).

148179907

Réajout de apigee-analytics-collector

L'utilitaire apigee-analytics-collector a été réajouté. Cet utilitaire vous permet de signaler le nombre de volumes d'API.

146511254

La règle ExtractVariables ne génère pas d'erreurs

Lorsqu'une variable XML n'était pas résolue via une expression XPath, la règle ExtractVariables continuait à s'exécuter dans le proxy. Cela se produisait même lorsque l' IgnoreUnresolvedVariables élément ou l'continueOnError attribut étaient définis sur "false".

130013746

Désactivation des entreprises

Le bouton permettant de désactiver des entreprises dans la monétisation n'était pas disponible.

120799182

Mise à niveau d'OpenLDAP

Le processus de mise à niveau d'OpenLDAP dans un environnement multicentres de données a entraîné un état corrompu.

145236083

Longueur du nom d'utilisateur et du mot de passe de l'administrateur système

Un nom d'utilisateur et un mot de passe d'administrateur système de plus de 57 caractères ont entraîné l'échec d'un script d'installation de l'authentification unique Edge.

135616498

Échec du script de configuration de l'authentification unique

Un problème a été résolu : l'utilisation d'URL de schéma de fichier entraînait l'échec du script de configuration de l'authentification unique.

111420263

Correction de ConcurrentModificationException dans la règle de journalisation des messages

Élimination de plusieurs conditions de concurrence qui se produisent lors de l'utilisation de la règle de journalisation des messages.

147458330

Correction du problème de sauvegarde de PostgreSQL qui ne stocke pas les informations d'authentification unique

Correction du problème lié à l'absence de données de configuration d'authentification unique dans les sauvegardes PostgreSQL.