4.19.01 Edge for Private Cloud Notes de version

Format de 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, il n'est pas entièrement lu.

Solution :

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

• Ajoutez un fichier 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 :

Les sauvegardes du processeur de messages ne sauvegardent pas le bon ensemble de fichiers

Solution :

Exécutez la sauvegarde une deuxième fois pour que l'ensemble de fichiers approprié soit sauvegardé.

Jetons de session non valides

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 :

Blocage des requêtes HEAD sur les cibles Node.js

Les requêtes HEAD envoyées à une cible Node.js peuvent se figer, laissant 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.

Impossible de résoudre les noms d'hôte

Après l'installation ou la mise à niveau d'Edge pour Private Cloud, les noms d'hôte peuvent ne pas être résolus avec leurs adresses.

Solution :

Pour résoudre ce problème, redémarrez le composant de l'interface utilisateur Edge:

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

DataAccessException dans plusieurs configurations de centres de données

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

DataAccessException: Error while accessing datastore;
Please retry later

Par conséquent, il est possible que le serveur de gestion ne démarre pas, car il tente de se connecter aux nœuds Cassandra dans dc-1 et dc-2. DataAccessExceptions se produit si un nœud Cassandra est arrêté. Cela peut également perturber le 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 les nœuds Cassandra disponibles:

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

Pour annuler l'inscription de ces types de nœuds Cassandra, puis les réenregistrer, procédez comme suit:

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 par défaut "gateway". Toutefois, vous l'avez peut-être renommé, vérifiez 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 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 est l'UUID renvoyé dans la réponse de la commande précédente.

4. Répétez l'étape 3 pour chaque UUID 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 des nœuds de Zookeeper. Elles n'ont aucune incidence sur le cluster Cassandra. Pour en savoir plus sur ces commandes, consultez la page Mettre à jour les enregistrements du datastore.

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

L'élément FormatMessage de la stratégie MessageLogging contrôle le format du message journalisé. Lorsque FormatMessage=false, le message journalisé n'est pas censé inclure d'informations générées par Apigee. Toutefois, même si vous définissez FormatMessage=false, le message de journal comprend les informations suivantes:

• Score de priorité
• Horodatage

Solution :

Échec de la réinitialisation du mot de passe administrateur système

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