4.52.00.02 - Notes de version d'Edge for Private Cloud

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

Le 25 juillet 2023, nous avons lancé une nouvelle version d'Apigee Edge pour le cloud privé.

Remarque : Cette version sera prise en charge jusqu'au 31 août 2024.

Procédure de mise à jour

Cette section explique comment installer cette version si vous effectuez une mise à jour à partir de la version précédente d'Edge pour Private Cloud. Si vous devez effectuer une mise à jour à partir d'une version antérieure, consultez Appliquer plusieurs versions de correctif.

La mise à jour de cette version mettra à jour les composants de la liste suivante de RPM :

  • edge-gateway-4.52.00-0.0.60193.noarch.rpm
  • edge-management-server-4.52.00-0.0.60193.noarch.rpm
  • edge-postgres-server-4.52.00-0.0.60193.noarch.rpm
  • edge-qpid-server-4.52.00-0.0.60193.noarch.rpm
  • edge-router-4.52.00-0.0.60193.noarch.rpm
  • apigee-cassandra-client-2.1.22-0.0.2521.noarch.rpm
  • edge-analytics-4.52.00-0.0.40092.noarch.rpm
  • apigee-sosreport-5.0-0.0.2513.noarch.rpm
  • edge-management-ui-static-4.52.00-0.0.20045.noarch.rpm
  • apigee-configutil-4.52.00-0.0.621.noarch.rpm
  • apigee-postgresql-14.5-0.0.2743.noarch.rpm

Vous pouvez vérifier les versions RPM actuellement installées pour voir si elles doivent être mises à jour en saisissant :

apigee-all version

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.52.00.sh Edge 4.52.00 sur /tmp/bootstrap_4.52.00.sh :
      curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
    3. Installez l'utilitaire apigee-service Edge 4.52.00 et les dépendances :
      sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord

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

    4. Exécutez le script apigee-service.sh à l'aide de la commande source :
      source /etc/profile.d/apigee-service.sh
  2. Mettez à jour les nœuds Postgres (maître et de secours) :
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Mettez à jour Analytics sur le nœud du serveur de gestion :
    apigee-service edge-analytics update
  4. Sur tous les nœuds Edge, exécutez le script update.sh pour le processus Edge :
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Si vous utilisez la nouvelle expérience Edge, exécutez les commandes suivantes :
    apigee-service edge-management-ui-static update
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile

Problèmes de sécurité résolus

Aucun problème de sécurité n'a été résolu dans cette version.

Modifications apportées aux logiciels compatibles

Aucune modification n'a été apportée aux logiciels compatibles dans cette version.

Abandons et arrêts

Ça y est.

Aucune fonctionnalité n'est abandonnée ni supprimée dans cette version.

Nouvelles fonctionnalités

Cette version inclut la nouvelle fonctionnalité suivante :

Enregistrements d'audit supprimés automatiquement 400 jours après leur création

Une fonctionnalité a été ajoutée pour supprimer automatiquement les journaux d'audit 400 jours après leur création. Auparavant, les journaux d'audit étaient créés sans valeur TTL (Time To Live), ce qui entraînait leur accumulation dans Cassandra.

Vous pouvez rétablir cette fonctionnalité pour que les journaux d'audit ne soient jamais supprimés en définissant conf_audit_cassandra.ttl.value sur -1 sur le serveur de gestion. Vous pouvez également modifier le nombre de jours pendant lesquels vous souhaitez conserver les journaux d'audit en modifiant la valeur de conf_audit_cassandra.ttl.value en millisecondes sur le serveur de gestion. Notez que cette fonctionnalité ne s'applique qu'aux journaux d'audit générés récemment, et non à ceux générés dans votre système par le passé.

Amélioration de conf_keymanagement_oauth_refresh_token_expiry_time_in_millis

Le remplacement de la configuration conf_keymanagement_oauth_refresh_token_expiry_time_in_millis définit désormais non seulement le délai d'expiration du jeton par défaut, mais fournit également un plafond pour l'expiration du jeton d'actualisation dans Cassandra.

Correction de bugs

Cette section liste les bugs liés au cloud privé qui ont été corrigés dans cette version.

ID du problème Description
234582218

Le script Python du calculateur de jetons apigee-cassandra-calc.py, qui est utilisé pour calculer les jetons de démarrage d'un anneau Cassandra en fonction de la propriété CASS_HOSTS dans le fichier de configuration silencieux, ne fonctionnait pas correctement.

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

Certains appels d'API de statistiques avec une dimension contenant groupid échouaient.

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

Correction des scripts Postgres dans edge-postgres-server du fichier de configuration silencieux, afin qu'ils fonctionnent avec les valeurs par défaut des variables non spécifiées lors de l'installation

276444350

Après la mise à niveau d'Edge pour Private Cloud vers la dernière version, il n'était pas possible d'ajouter, d'afficher ni de modifier les détails de l'hôte virtuel dans la nouvelle interface utilisateur Edge sous Admin > Hôtes virtuels.

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

Un correctif a été apporté à config.log pour préserver l'historique des modifications dans le journal.

Problèmes connus

Pour obtenir la liste complète des problèmes connus, consultez Problèmes connus avec Edge pour le cloud privé.

Appliquer plusieurs versions de correctifs

Cette section explique comment appliquer plusieurs versions de correctifs si vous effectuez une mise à jour à partir d'une version d'Edge for Private Cloud antérieure à la version précédente du correctif.

Chaque version corrective contient des mises à jour de composants spécifiques d'Edge pour Private Cloud, tels que edge-management-server. Pour appliquer plusieurs versions correctives, vous devez mettre à jour chaque composant Edge inclus dans une version corrective ultérieure à celle actuellement installée. Pour trouver ces composants, consultez les notes de version d'Edge pour le cloud privé pour toutes les versions ultérieures à la vôtre et vérifiez la liste des RPM pour ces versions. Consultez les notes de version d'Apigee pour obtenir des liens vers toutes les notes de version d'Edge pour le cloud privé.

Remarque : Il vous suffit de mettre à jour chaque composant une seule fois en installant le fichier RPM de la dernière version du composant inclus dans les versions correctives. Suivez les instructions des notes de version de cette version pour mettre à jour le composant.

Remarque : La mise à niveau d'un composant installe automatiquement la dernière version du correctif d'un composant. Si vous souhaitez passer à une version corrective qui n'est pas la dernière, vous devez conserver votre propre copie tarball du dépôt Apigee à l'aide du miroir Apigee et utiliser ce miroir pour les installations Apigee. Pour en savoir plus, consultez Utiliser un dépôt Edge local pour gérer votre version Edge.