Notes de version d'Edge for Private Cloud 4.19.01

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

apigee-monit non compatible avec Amazon Linux 1

Solution :

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.

Jetons de session non invalidés

Les jetons de session ne sont pas invalidés sur le serveur lorsque l'utilisateur clique sur le bouton de déconnexion d'Apigee Edge.

Solution :

Les opérations Cassandra ne fonctionnent pas lorsque l'authentification JMX est activée

Solution :

Les requêtes HEAD envoyées aux cibles Node.js sont suspendues

Les requêtes HEAD envoyées à une cible Node.js peuvent se bloquer, laissant des connexions en attente.

Solution :

Pour contourner ce problème, définissez un gestionnaire pour les requêtes HEAD afin de renvoyer explicitement une réponse vide.

Noms d'hôte non résolus

Après l'installation ou la mise à niveau d'Edge pour le cloud privé, il est possible que les noms d'hôte ne soient pas résolus en adresses.

Solution :

Pour résoudre ce problème, redémarrez le composant Edge UI :

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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

   Où 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.

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 :

Échec de la réinitialisation du 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 échouera.

Solution :

Définissez le mot de passe dans un fichier de données que vous transmettez ensuite au point de terminaison /users de l'API Management. Pour en savoir plus, consultez Réinitialiser le mot de passe de l'administrateur système.