Notes de version d'Edge for Private Cloud

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

Cette section décrit la version 4.19.06 de la version de fonctionnalité Edge pour le cloud privé.

Résumé de la version

Le tableau suivant récapitule les modifications apportées dans cette version :

Nouvelles fonctionnalités

Cette version inclut les nouvelles fonctionnalités suivantes :

○ Compatibilité LDAP pour le SSO
○ Compatibilité avec le déploiement HTTP
○ Analytics enfichable
○ Compatibilité avec les racks Cassandra
○ Compatibilité IPv6
○ Installation simplifiée de la nouvelle expérience Edge
○ Exclure les transactions INVALID_TSC (monétisation)

Pour en savoir plus sur chacune de ces nouvelles fonctionnalités, consultez Nouvelles fonctionnalités.

Rétrocompatibilité

Les problèmes de rétrocompatibilité suivants ont été introduits dans cette version d'Apigee Edge pour le cloud privé :

     
  • En raison de la correction du problème 132443137 (comme décrit dans les notes de version du cloud public 19.03.01), les processeurs de messages ignorent désormais les en-têtes qui commencent par X-Apigee-*. Par conséquent, vous devez refactoriser tout code qui utilise des en-têtes X-Apigee-* et remplacer ces en-têtes par des en-têtes compatibles.

  • Le nom des fichiers journaux Cassandra a été modifié. Elle est désormais :

    /opt/apigee/var/log/apigee-cassandra/system.log
Versions incluses

Depuis la version précédente d'Edge pour le cloud privé, les versions suivantes ont été publiées et sont incluses dans cette version :

○ Edge :
   19.07.23 (UI)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
   19.01.14
   18.12.04
   18.08.31
   18.07.31
○ Portail :
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02.27
   19.02.21
   19.02.04
   19.01.16
Retraits Aucun
Abandons

Avec la sortie de la version 4.19.06, les éléments suivants sont obsolètes :

  • 4.18.01: : la version 4.18.01 d'Apigee Edge pour le cloud privé est désormais obsolète.

Pour en savoir plus, consultez Abandons, arrêts et modifications des CPS d'Apigee.

Correction de bugs

Cette version inclut les corrections de bugs suivantes :

○ UseStringDeduplication non défini (140270474)
○ Erreurs MP (111445518)
○ Échecs Cassandra avec JMX (113342838)
○ Mises à niveau de 13 nœuds (138931337)
○ Proxies portant le même nom (119802562)
○ Magasins de clés ne se chargeant pas (118851790)
○ Échec de l'analyse (110988191)
○ Échecs de sauvegarde (110785400)
○ Requêtes HEAD vers Node.js (79993247)
○ Sauvegarde/restauration apigee-postgres (70291825)
○ Réinitialisation du mot de passe administrateur système (65737520)

Pour en savoir plus sur chacun de ces correctifs, consultez Correctifs de bugs.

Problèmes connus

Cette version présente les problèmes connus suivants :

○ Mint ne note pas les transactions au départ (141628497)
○ Fuite de mémoire des serveurs de notation Mint (137865184)
○ Format de fichier de métadonnées pour l'installation d'apigee-sso (135616498)
○ apigee-monit non disponible sur Amazon Linux 1 (122370980)
○ La sauvegarde du processeur de messages ne sauvegarde pas le bon ensemble de fichiers (121095148)
○ Exceptions DataAccess dans les configurations multidata centers (76087166)
○ Stratégie MessageLogging incluant des informations supplémentaires dans le message de journal (68722102)

Pour en savoir plus sur chacun de ces problèmes connus, y compris sur les solutions de contournement, consultez Problèmes connus.

Chemins de mise à niveau

Le tableau suivant indique les chemins de mise à niveau pour cette version :

À partir de la version 4.19.01 Mise à niveau directe de la version 4.19.01 vers la version 4.19.06
À partir de la version 4.18.05 Mise à niveau directe de la version 4.18.05 vers la version 4.19.06
À partir de la version 4.18.01 Mise à niveau directe de la version 4.18.01 vers la version 4.19.06

Nouvelles fonctionnalités

Cette section liste les nouvelles fonctionnalités de cette version. De plus, cette version inclut toutes les fonctionnalités des versions de l'UI Edge, de la gestion Edge et du portail listées dans Versions incluses.

En plus des améliorations suivantes, cette version contient également de nombreuses améliorations en termes d'usabilité, de performances, de sécurité et de stabilité.

Compatibilité avec le déploiement HTTP

Par défaut, Edge utilise RPC pour déployer des proxys d'API. Bien que ce mode fonctionne très bien pour la plupart des installations, les topologies plus importantes avec de nombreux MP peuvent rencontrer des délais d'expiration lorsqu'un grand nombre d'appels simultanés sont effectués via RPC.

Par conséquent, Apigee recommande aux déploiements plus importants d'utiliser HTTP plutôt que RPC pour le déploiement. Le déploiement HTTP est désormais possible.

Pour en savoir plus, consultez Activer le déploiement HTTP.

Prise en charge des racks Cassandra

Apigee fournit désormais des conseils généraux pour les opérations de scaling de Cassandra en rendant Cassandra sur Apigee Edge pour Private Cloud compatible avec les racks.

Pour en savoir plus, consultez Prise en charge des racks Cassandra.

Analyse connectable

Par défaut, les données analytiques collectées par le processeur de messages sont importées dans Qpid et Postgres pour traitement. Vous pouvez ensuite afficher les données d'analyse dans l'interface utilisateur Edge.

Cette version de fonctionnalité vous permet de configurer le processeur de messages pour qu'il écrive les données analytiques sur le disque ou d'utiliser les deux options.

Pour en savoir plus, consultez Écrire des données analytiques dans un fichier.

Installation simplifiée de la nouvelle expérience Edge

L'installation de la nouvelle expérience Edge a été simplifiée grâce à un nouveau script.

Pour en savoir plus, consultez Installer la nouvelle expérience Edge.

Prise en charge de l'IdP LDAP

L'authentification des utilisateurs avec l'interface utilisateur Edge et les appels de l'API de gestion Edge est désormais compatible avec LDAP en plus de SAML. La compatibilité LDAP inclut les méthodes de liaison directe et indirecte.

Pour en savoir plus, consultez Présentation de l'authentification avec un IdP externe.

Compatibilité IPv6

Par défaut, tous les appels d'API d'exécution vers Apigee Edge pour le cloud privé utilisent IPv4. Vous pouvez ajouter la prise en charge d'IPv6 au routeur avec une nouvelle propriété.

Pour en savoir plus, consultez Utiliser IPv6 sur le routeur.

Exclure les transactions INVALID_TSC (monétisation)

Vous pouvez désormais exclure les transactions INVALID_TSC de l'ajout à la base de données Postgres lorsque vous utilisez la monétisation.

Pour en savoir plus, consultez Propriétés du serveur de monétisation.

Logiciels compatibles

Cette version inclut les modifications suivantes apportées aux logiciels compatibles :

Assistance ajoutée Non compatibles

Cette version est compatible avec les plates-formes suivantes :

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

Les plates-formes suivantes ne sont plus compatibles avec cette version :

  • Red Hat Enterprise Linux (RHEL) 6.9
  • CentOS 6.9
  • Oracle 6.8

Pour obtenir la liste complète des plates-formes compatibles, consultez Logiciels et versions compatibles.

Correction de bugs

Cette section liste les bugs de Private Cloud qui ont été corrigés dans cette version. De plus, cette version inclut toutes les corrections de bugs des versions de l'UI Edge, de la gestion Edge et du portail indiquées dans Versions incluses.

ID du problème Description
140270474

UseStringDeduplication non défini

UseStringDeduplication n'était pas défini pour les composants edge-message-processor dans les environnements de production.
111445518

Erreurs MP

Les processeurs de messages ont enregistré en continu le message d'erreur suivant toutes les cinq minutes :
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
113342838

Échecs Cassandra avec JMX

Les opérations Cassandra ne fonctionnaient pas lorsque l'authentification JMX était activée.
138931337

Mises à niveau à 13 nœuds

Les mises à niveau des installations à 13 nœuds à partir des versions 17.09, 18.01 et 18.05 échouaient.
119802562

Proxys portant le même nom

Si deux utilisateurs de la même organisation ont créé des proxys portant le même nom, le deuxième créé écrase le premier. Cela ne se produisait que lorsque différents utilisateurs ne pouvaient pas voir l'autre proxy.
118851790

Les keystores ne se chargent pas

Lorsque le nombre de keystores pour une organisation/un environnement était supérieur à 100, la section des keystores et des références dans l'interface utilisateur Edge ne se chargeait pas. Au lieu de cela, l'interface utilisateur affichait une erreur Internal Error (Error Fetching Keystores).
110988191

Échec d'Analytics

L'analyse a échoué pour un environnement lorsque des données de la passerelle Microgateway ont été fournies avec une date future.
110785400

Échecs de sauvegarde

ZooKeeper, Cassandra et OpenLDAP n'ont pas réussi à sauvegarder correctement leurs données de manière intermittente, avec l'erreur suivante : File changed as we read it.
79993247

Requêtes HEAD vers Node.js

Les requêtes HEAD vers une cible Node.js pouvaient se bloquer, ce qui laissait des connexions en attente.
70291825

Sauvegarde/Restauration d'apigee-postgres

L'exécution d'une sauvegarde/restauration apigee-postgres sauvegarde désormais les données de tous les composants.
65737520

Réinitialiser le mot de passe administrateur système

La réinitialisation du mot de passe de l'administrateur système pour le serveur de gestion contenant des caractères spéciaux échouait.

Problèmes connus

Le tableau suivant répertorie les problèmes connus dans cette version :

ID du problème Description
141628497

Mint ne note pas les transactions au départ

Edge for Private Cloud n'évalue pas les transactions initialement lorsque vous activez la monétisation pour une organisation. Cela s'applique aux organisations nouvelles et existantes.

L'API d'activation de la monétisation répond avec l'ID du job. Une fois le job terminé, son état indique qu'il a réussi. Toutefois, les appels d'API monétisés effectués initialement ne seront pas traités par la monétisation et ne seront pas évalués. Ces transactions n'apparaîtront que dans les données analytiques standards.

Solution :

Redémarrez tous les processeurs de messages (MP). Pour ce faire, procédez comme suit :
apigee-service edge-message-processor restart

Une fois la monétisation activée, le redémarrage des MP permet à Edge de charger la configuration à partir de ZooKeeper au démarrage. Cela se produit à chaque redémarrage, ce qui signifie que le problème ne s'applique qu'au début.

137865184

Fuite de mémoire des serveurs de notation Mint

Lorsqu'une nouvelle instance Qpid est enregistrée dans un groupe mx, les files d'attente se créent sans consommateurs, ce qui entraîne une augmentation de la profondeur de la file d'attente jusqu'à ce qu'elle utilise toutes les ressources disponibles.

Solution :

Aucune.
135616498

Format du fichier de métadonnées pour l'installation d'apigee-sso

Lors de l'installation de apigee-sso et de l'utilisation d'un fichier metadata.xml au lieu d'une URL, si le fichier metadata.xml n'inclut pas de nouvelle ligne (CRLF) à la fin du fichier, il n'est pas lu entièrement.

Solution :

Pour contourner ce problème, vous pouvez effectuer l'une des opérations suivantes :

  • Ajoutez un CRLF à la fin du fichier metadata.xml.

    OU

  • Utiliser un emplacement basé sur une URL pour les métadonnées
122370980

apigee-monit non compatible avec Amazon Linux 1

Solution :

Aucune.
121095148

La sauvegarde du processeur de messages ne sauvegarde pas le bon ensemble de fichiers

Solution :

Exécutez la sauvegarde une deuxième fois. Elle devrait sauvegarder le bon ensemble de fichiers.

76087166

DataAccessException dans les configurations à plusieurs centres de données

Dans les configurations à plusieurs centres de données, si un datastore devient indisponible, l'erreur suivante peut s'afficher :

DataAccessException: Error while accessing datastore;
Please retry later

Le serveur de gestion risque de ne pas démarrer, car il tente de se connecter aux nœuds Cassandra dans dc-1 et dc-2. Le code d'erreur DataAccessExceptions se produit si un nœud Cassandra est hors service. Cela peut également entraîner une perturbation du trafic d'API, où les processeurs de messages signalent DataAccessExceptions lors de la récupération des KVM.

Notez que l'état attendu est que le serveur de gestion ne se connecte pas aux composants du datastore dans les régions.

Solution

La solution de contournement consiste à annuler l'enregistrement des types de nœuds Cassandra suivants dans le centre de données indisponible, puis à les réenregistrer une fois que les nœuds Cassandra sont à nouveau disponibles :

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

Pour annuler l'enregistrement et réenregistrer ces types de nœuds Cassandra :

  1. Obtenez les UUID des nœuds Cassandra à l'aide de la commande curl suivante :
    curl -u ADMIN_EMAIL:ADMIN_PW \
      "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
      &type=CASSANDRA_NODE_TYPE"

    Où :

    • ADMIN_EMAIL et ADMIN_PW sont les identifiants de votre compte Apigee.
    • MS_IP et MS_PORT sont l'adresse IP et le numéro de port du serveur de gestion.
    • REGION est le nom du centre de données dans lequel se trouve le serveur de gestion.
    • GATEWAY_POD est le nom du pod, qui est "gateway" par défaut. Vous l'avez peut-être renommé, alors vérifiez votre implémentation.
    • CASSANDRA_NODE_TYPE correspond à kms-datastore, dc-datastore ou keyvaluemap-datastore.

    Exemple :

    curl -u nickdanger@google.com:myP@$$w0rD
      "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    La réponse utilise le format suivant :

    {
      "internalIP" : "POD_IP_ADDRESS",
      "isUp" : [true|false],
      "pod" : "GATEWAY_POD",
      "reachable" : [true|false],
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
        "uUID" : "POD_UUID"
    }

    Exemple :

    {
      "internalIP" : "192.168.1.11",
      "isUp" : false,
      "pod" : "gateway",
      "reachable" : false,
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : "dc-datastore",
      "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
    }

    Notez les valeurs du champ uUID dans la réponse. Vous les utiliserez pour désenregistrer les nœuds.

  2. Répétez l'étape 1 pour chaque type de nœud Cassandra : kms-datastore, dc-datastore et keyvaluemap-datastore. Veillez à noter les UUID renvoyés.
  3. Annulez l'enregistrement des nœuds à l'aide de la commande suivante :
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    UUID correspond à l'UUID renvoyé dans la réponse de la commande précédente.

  4. Répétez l'étape 3 pour chaque UUID que vous avez collecté aux étapes 1 et 2.
  5. Réenregistrez les nœuds à l'aide de la commande suivante :
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
      "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
      Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
      region=REGION&pod=GATEWAY_POD" -H \
      'content-type: application/x-www-form-urlencoded' -X POST

Notez que ces opérations enregistrent et désenregistrent les nœuds de ZooKeeper, et n'ont aucun impact sur le cluster Cassandra. Pour en savoir plus sur ces commandes, consultez Mettre à jour les enregistrements de data stores.

68722102

Règle MessageLogging incluant des informations supplémentaires dans le message de journal

L'élément FormatMessage de la règle MessageLogging contrôle le format du message enregistré. Lorsque la valeur est FormatMessage=false, le message consigné ne doit inclure aucune information générée par Apigee. Toutefois, même si vous définissez FormatMessage=false, le message de journal inclut toujours les informations suivantes :

  • Score de priorité
  • Code temporel

Solution :

Aucune.

Étape suivante

Pour commencer à utiliser Edge pour le cloud privé 4.19.06, consultez les liens suivants :

Nouvelles installations:
Présentation de la nouvelle installation
Installations existantes:
Processus de mise à niveau