4.19.01 Notas de la versión de Edge para la nube privada

Formato de archivo de metadatos para la instalación de Apigee

Cuando instalas apigee-sso y usas un archivo metadata.xml en lugar de una URL, si el archivo metadata.xml no incluye una nueva línea (CRLF) al final del archivo, el archivo metadata.xml no se leerá por completo.

Solución alternativa:

Para solucionar este problema, realiza una de las siguientes acciones:

• Agregue una CRLF al final del archivo metadata.xml

  O

• Usa una ubicación basada en URL para los metadatos

apigee-monit no es compatible con Amazon Linux 1

Solución alternativa:

La copia de seguridad del procesador de mensajes no crea una copia de seguridad del conjunto de archivos correcto

Solución alternativa:

Ejecuta la copia de seguridad por segunda vez. Debería crear una copia de seguridad del conjunto de archivos correcto.

Tokens de sesión no validados

Los tokens de sesión no se invalidan en el servidor cuando el usuario hace clic en el botón Salir de Apigee Edge.

Solución alternativa:

Las operaciones de Cassandra no funcionan cuando la autenticación JMX está habilitada

Solución alternativa:

Las solicitudes HEAD a destinos de Node.js se interrumpen

Las solicitudes HEAD a un destino Node.js pueden suspenderse, lo que deja pendientes las conexiones.

Solución alternativa:

Para solucionar este problema, define un controlador para las solicitudes HEAD a fin de que muestren una respuesta vacía de forma explícita.

No se resuelven los nombres de host

Después de instalar o actualizar Edge para la nube privada, es posible que los nombres de host no se resuelvan en sus direcciones.

Solución alternativa:

Para resolver este problema, reinicia el componente de IU de Edge:

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

DataAccessException en varias configuraciones de centros de datos

En varias configuraciones del centro de datos, si un almacén de datos deja de estar disponible, es posible que veas el siguiente error:

DataAccessException: Error while accessing datastore;
Please retry later

Es posible que el servidor de administración no se inicie porque intenta conectarse a nodos de Cassandra en dc-1 y dc-2. DataAccessExceptions ocurre si un nodo de Cassandra no funciona. Esto también puede provocar una interrupción del tráfico de la API, en la que el procesador de mensajes informa DataAccessExceptions mientras intenta recuperar KVM.

Ten en cuenta que el estado esperado es que el servidor de administración no se conecte a los componentes del almacén de datos entre regiones.

Solución alternativa

La solución alternativa es cancelar el registro de los siguientes tipos de nodos de Cassandra en el centro de datos no disponible y, luego, volver a registrarlos una vez que los nodos de Cassandra vuelvan a estar disponibles:

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

Para cancelar el registro y volver a registrar estos tipos de nodos de Cassandra:

1. Obtén los UUID de los nodos de Cassandra con el siguiente comando curl:

   curl -u ADMIN_EMAIL:ADMIN_PW \
     "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
     &type=CASSANDRA_NODE_TYPE"

   Aquí:

   • ADMIN_EMAIL y ADMIN_PW son las credenciales de tu cuenta de Apigee.
   • MS_IP y MS_PORT son la dirección IP y el número de puerto del servidor de administración.
   • REGION es el nombre del centro de datos en el que se encuentra el servidor de administración.
   • GATEWAY_POD es el nombre del Pod, que es la “puerta de enlace” de forma predeterminada. Sin embargo, es posible que la hayas cambiado a otro nombre, por lo que debes verificar tu implementación.
   • CASSANDRA_NODE_TYPE es uno de kms-datastore, dc-datastore y keyvaluemap-datastore.

   Por ejemplo:

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

   La respuesta usa el siguiente formato:

   {
     "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"
   }

   Por ejemplo:

   {
     "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"
   }

   Anota los valores del campo uUID en la respuesta. Las usarás para cancelar el registro de los nodos.

2. Repite el paso uno para cada tipo de nodo de Cassandra: kms-datastore, dc-datastore y keyvaluemap-datastore. Asegúrate de tomar nota de los UUID que se muestran.
3. Cancela el registro de los nodos con el siguiente comando:

   curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

   .

   Donde UUID es el UUID que se muestra en la respuesta del comando anterior.

4. Repita el paso 3 para cada UUID que haya recopilado en los pasos 1 y 2.
5. Vuelve a registrar los nodos con el siguiente comando:

   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

Ten en cuenta que estas operaciones registran y cancelan el registro de nodos en Zookeeper, y no tienen ningún impacto en el clúster de Cassandra. Para obtener más información sobre estos comandos, consulta Cómo actualizar los registros del almacén de datos.

Política de MessageLogging que incluye información adicional en el mensaje de registro

El elemento FormatMessage de la política MessageLogging controla el formato del mensaje registrado. Cuando es FormatMessage=false, el mensaje registrado no debe incluir información generada por Apigee. Sin embargo, incluso si configuras FormatMessage=false, el mensaje de registro seguirá incluyendo la siguiente información:

• La puntuación de prioridad
• La marca de tiempo

Solución alternativa:

No se puede restablecer la contraseña del administrador del sistema

El restablecimiento de la contraseña de administrador del sistema para el servidor de administración que contiene caracteres especiales fallará.

Solución alternativa:

Define la contraseña en un archivo de datos que pasas al extremo /users en la API de Management. Para obtener más información, consulta Cómo restablecer la contraseña de administrador del sistema.