Notes de version d'Edge for Private Cloud

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X.
en savoir plus

Cette section décrit la version 4.19.06 de la version de la fonctionnalité Edge for Private Cloud.

Résumé de la version

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

Nouvelles fonctionnalités

Cette version inclut les nouvelles fonctionnalités suivantes :

○ Compatibilité LDAP avec l'authentification unique
○ Compatibilité avec le déploiement HTTP
○ Analyses connectables
○ Compatibilité avec les racks Cassandra
○ Compatibilité IPv6
○ Installation simplifiée de l'expérience New Edge
○ Exclure les transactions INVALID_TSC (monétisation)

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

Rétrocompatibilité

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

     
  • En raison du correctif pour le 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 commençant par X-Apigee-*. Par conséquent, vous devez refactoriser le 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 changé. Aujourd'hui:

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

Depuis la version précédente des fonctionnalités Edge for Private Cloud, les versions suivantes ont eu lieu et sont incluses dans celle-ci:

○ Edge:
   19.07.23 (UI)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
01.01}
{1.0}
19.
19.01.1418.12.0418.08.3118.07.31
○ Portail:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02.2719.02.2119.02.0419.01.16
Retraits Aucun
Abandons

À compter 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 Private Cloud est désormais obsolète.

Pour plus d'informations, consultez Abandons, retraits et modifications de CPS d'Apigee.

Correction de bugs

Cette version inclut les corrections de bugs suivantes:

○140270474 (140270474) ○ ○ 140270474










HEAD

Pour en savoir plus sur chacune de ces corrections, consultez Correction de bugs.

Problèmes connus

Cette version inclut les problèmes connus suivants:

○ Mint Not rating transactions initialement (14 162 8497)
○ les informations de journalisation mint dans les serveurs d'évaluation 8





apigee-monit

Pour en savoir plus sur chacun de ces problèmes connus et obtenir des solutions, consultez la section Problèmes connus.

Chemins de mise à niveau

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

From 4.19.01 Passez directement de la version 4.19.01 à la version 4.19.06.
À partir du 18/04 Passez directement de la version 4.18.05 à la version 4.19.06.
De Passez directement de la version 4.18.01 à la version 4.19.06.

Nouvelles fonctionnalités

Cette section présente les nouvelles fonctionnalités de cette version. De plus, cette version inclut toutes les fonctionnalités des versions d'interface utilisateur Edge, de gestion Edge et de portail répertoriées dans les versions incluses.

Outre les améliorations suivantes, cette version inclut plusieurs améliorations en termes de convivialité, de performances, de sécurité et de stabilité.

Prise en charge du 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 connaître des délais avant expiration lorsqu'un grand nombre d'appels simultanés sont effectués via RPC.

Par conséquent, Apigee recommande que les déploiements plus importants utilisent HTTP plutôt que RPC pour le déploiement. L'activation des déploiements HTTP est désormais prise en charge.

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

Compatibilité avec les racks Cassandra

Apigee fournit désormais des conseils généraux pour le scaling des opérations de Cassandra en rendant Cassandra sur Apigee Edge pour le rack de cloud privé.

Pour en savoir plus, consultez la page Compatibilité avec les racks Cassandra.

Analyse connectable

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

Avec cette version de fonctionnalité, vous pouvez configurer le processeur de messages pour écrire les données d'analyse sur le disque, ou vous pouvez choisir d'utiliser les deux options.

Pour plus d'informations, consultez la section Écrire des données d'analyse dans un fichier.

Installation de la nouvelle expérience Edge simplifiée

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.

Compatibilité de l'IdP LDAP

L'authentification des utilisateurs avec l'interface utilisateur Edge et les appels d'API de gestion Edge prend désormais en charge LDAP en plus de SAML. La prise en charge du protocole LDAP inclut les méthodes de liaison directe et indirecte.

Pour en savoir plus, consultez la page Présentation de l'authentification des IdP externes.

Compatibilité IPv6

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

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

Exclure INVALID_TSC transactions (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 apporte les modifications suivantes aux logiciels compatibles:

Assistance ajoutée N'est plus disponible

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 la section Logiciels et versions compatibles.

Corrections de bugs

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

ID du problème Description
140270474

UseStringDeduplication non défini

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

Erreurs du protocole de mesure

Les processeurs de messages consignent en continu le message d'erreur suivant toutes les 5 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 depuis les versions 17.09, 18.01 et 18.05 échouaient.
119802562

Proxys portant le même nom

Si deux utilisateurs de la même organisation créaient des proxys portant les mêmes noms, le second écraserait 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

Lorsqu'il y avait plus de 100 keystores pour une organisation/un environnement, le keystore et la section de référence de l'interface utilisateur Edge ne se chargeaient pas. Au lieu de cela, l'interface utilisateur a affiché une erreur Internal Error (Error Fetching Keystores).
110988191

Échec de l'analyse

Analytics a échoué pour un environnement lorsqu'il a été fourni avec des données provenant de Microgateway dont la date est postérieure à la date du jour.
110785400

Échecs de sauvegarde

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

Requêtes HEAD envoyées à Node.js

Les requêtes HEAD adressées à une cible Node.js pouvaient être bloquées, ce qui restait des connexions en attente.
70291825

sauvegarde/restauration apigee-postgres

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

Réinitialiser le mot de passe d'un administrateur système

La réinitialisation du mot de passe de l'administrateur système du serveur de gestion qui contenait des caractères spéciaux échouerait.

Problèmes connus

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

ID du problème Description
141628497

Dans un premier temps, Mint n'évalue pas les transactions

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

L'API d'activation de la monétisation répond avec l'ID de la tâche et, une fois celle-ci terminée, l'état de celle-ci indique la réussite de celle-ci. 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. 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 entraîne le chargement par Edge de la configuration de ZooKeeper au démarrage. Cela se produit à chaque redémarrage, ce qui signifie que le problème ne s'applique qu'au départ.

137865184

Fuite de mémoire des serveurs d'évaluation Mint

Lorsqu'une nouvelle instance Qpid est enregistrée dans un mxgroup, les files d'attente se créent sans les utilisateurs. La profondeur de la file d'attente augmente donc jusqu'à ce qu'elle utilise toutes les ressources disponibles.

Solution :

Aucune
135616498

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

Lors de l'installation de apigee-sso et de l'utilisation d'un fichiermetadata.xml au lieu d'une URL, si celui-ci ne comporte pas de nouvelle ligne (CRLF) à la fin, 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 fichiermetadata.xml

    OU

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

apigee-monit n'est pas 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 plusieurs configurations de centres de données

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

DataAccessException: Error while accessing datastore;
Please retry later

Il se peut donc que Management Server ne démarre pas, car il tente de se connecter aux nœuds Cassandra à la fois dans dc-1 et dc-2. Le DataAccessExceptions se produit si un nœud Cassandra est en panne. Cela peut également entraîner une interruption du trafic de l'API, où les processeurs de messages signalent DataAccessExceptions lors de la tentative de récupération des KVM.

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

Solution

La solution 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 de ces types de nœuds Cassandra et les réenregistrer:

  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 correspond par défaut à "passerelle". Il se peut toutefois que vous l'ayez renommé autrement. Vérifiez votre implémentation.
    • CASSANDRA_NODE_TYPE est l'une des valeurs suivantes : 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 annuler l'enregistrement des nœuds.

  2. Répétez l'étape 1 pour chaque type de nœud Cassandra: kms-datastore, dc-datastore et keyvaluemap-datastore. Prenez note des 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 annulent l'enregistrement des nœuds auprès de Zookeeper et n'ont aucune incidence sur le cluster Cassandra. Pour en savoir plus sur ces commandes, consultez la page Mettre à jour les enregistrements dans le datastore.

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 journal n'est pas censé inclure des informations générées par Apigee. Toutefois, même si vous définissez FormatMessage=false, le message de journal inclut toujours les informations suivantes:

  • Le niveau de priorité
  • Le code temporel

Solution :

Aucune

Étape suivante

Pour commencer à utiliser Edge for Private Cloud 4.19.06, utilisez les liens suivants:

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