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:

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

  OU

• Utiliser un emplacement basé sur l'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 bloquées

Les requêtes HEAD adressées à une cible Node.js peuvent être bloquées, laissant ainsi les 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 Private Cloud, les noms d'hôte peuvent ne pas correspondre à leurs 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 plusieurs configurations de centre de données

Dans plusieurs configurations de centre de données, si un datastore devient indisponible, vous pouvez voir l'erreur suivante:

DataAccessException: Error while accessing datastore;
Please retry later

Il se peut donc que le serveur de gestion ne démarre pas, car il tente de se connecter à Cassandra. nœuds dans dc-1 et dc-2. Le DataAccessExceptions se produit si un nœud Cassandra est vers le bas. Cela peut également entraîner une perturbation du trafic des API, où les processeurs de messages signalent DataAccessExceptions lors de la tentative de récupération des KVM.

Notez que l'état attendu indique que le serveur de gestion ne se connecte pas aux composants du datastore. entre 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, puis 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. Google Cloud.
   • MS_IP et MS_PORT sont l'adresse IP et le port du serveur de gestion. numéro.
   • REGION est le nom du centre de données dans lequel le serveur de gestion localisés.
   • GATEWAY_POD est le nom du pod, qui est la "passerelle" par défaut. Vous avez peut-être l'avoir renommé différemment, vérifiez donc votre implémentation.
   • CASSANDRA_NODE_TYPE est l'une des valeurs suivantes : kms-datastore, dc-datastore, et 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 la première étape pour chaque type de nœud Cassandra: kms-datastore, dc-datastore et keyvaluemap-datastore. N'oubliez pas de noter 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 annulent l'enregistrement des nœuds dans Zookeeper et n'ont aucune sur l'amas Cassandra. Pour en savoir plus sur ces commandes, consultez Mettez à jour les enregistrements du datastore.

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 journalisé. Lorsqu'il est défini sur FormatMessage=false, le message journalisé 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 :

Impossible de réinitialiser le mot de passe d'administrateur système

La réinitialisation du mot de passe d'administrateur système pour le serveur de gestion qui contient 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 dans l'API Management. Pour en savoir plus, consultez Réinitialiser le mot de passe de l'administrateur système.