4.19.01.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 d'Edge 4.19.01 bootstrap_4.19.01.sh dans /tmp/bootstrap_4.19.01.sh :
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    3. Installez l'utilitaire apigee-service et les dépendances d'Edge 4.19.01 :
      sudo bash /tmp/bootstrap_4.19.01.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. Exécutez le script apigee-service.sh à l'aide de la commande source :
      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. 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
155840972 Mise à niveau de Tomcat

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

155595660

Format de 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 multidata center

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.

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 avant expiration a également été réduite.

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.

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 les entreprises à partir de la monétisation n'était pas disponible.

120799182

Mise à niveau d'OpenLDAP

Le processus de mise à niveau d'OpenLDAP dans un environnement multidata center 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.