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

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X.
info

En esta sección, se describe la versión 4.19.06 de la versión de funciones de Edge para la nube privada.

Resumen de la versión

En la siguiente tabla, se resumen los cambios de esta versión:

Nuevas funciones

Esta versión incluye las siguientes funciones nuevas:

○ Compatibilidad con LDAP para el SSO
○ Compatibilidad con la implementación de HTTP
○ Estadísticas conectables
○ Compatibilidad con racks de Cassandra
○ Compatibilidad con IPv6
○ Instalación simplificada de la nueva experiencia de Edge
○ Excluye las transacciones de INVALID_TSC (monetización)

Para obtener más información sobre cada una de estas funciones nuevas, consulta Funciones nuevas.

Retrocompatibilidad

En esta versión de Apigee Edge para la nube privada, se introdujeron los siguientes problemas que afectan la compatibilidad con versiones anteriores:

     
  • Debido a la corrección del problema 132443137 (como se describe en las notas de la versión 19.03.01 de la nube pública), los procesadores de mensajes ahora ignoran los encabezados que comienzan con X-Apigee-*. Como resultado, debes refactorizar cualquier código que use encabezados X-Apigee-* y reemplazar esos encabezados por los compatibles.

  • Se cambió el nombre de los archivos de registro de Cassandra. Ahora es:

    /opt/apigee/var/log/apigee-cassandra/system.log
Versiones incluidas

Desde la versión de funciones anterior de Edge para la nube privada, se lanzaron las siguientes versiones, que se incluyen en esta:

○ Edge:
   19.07.23 (IU)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
   19.01.14
   18.12.04
   18.08.31
   18.07.31
○ Portal:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02.27
   19.02.21
   19.02.04
   19.01.16
Retiros Ninguno
Bajas

Con el lanzamiento de la versión 4.19.06, los siguientes elementos dejaron de estar disponibles:

  • 4.18.01: La versión 4.18.01 de Apigee Edge para la nube privada ya dejó de estar disponible.

Para obtener más información, consulta Bajas, retiradas y cambios en CPS de Apigee.

Correcciones de errores

Esta versión incluye las siguientes correcciones de errores:

○ UseStringDeduplication no establecido (140270474)
○ Errores de MP (111445518)
○ Fallas de Cassandra con JMX (113342838)
○ Actualizaciones de 13 nodos (138931337)
○ Proxies con el mismo nombre (119802562)
○ No se cargan los almacenes de claves (118851790)
○ Falló Analytics (110988191)
○ Fallas de copia de seguridad (110785400)
○ Solicitudes de HEAD a Node.js (79993247)
○ Copia de seguridad y restablecimiento de apigee-postgres (70291825)
○ Restablecimiento de la contraseña de sysadmin (65737520)

Para obtener más información sobre cada una de estas correcciones, consulta Correcciones de errores.

Errores conocidos

En esta versión, se incluyen los siguientes problemas conocidos:

○ Mint no califica las transacciones inicialmente (141628497)
○ Fuga de memoria de los servidores de calificación de Mint (137865184)
○ Formato de archivo de metadatos para la instalación de apigee-sso (135616498)
apigee-monit no admitido en Amazon Linux 1 (122370980)
○ Message Processor backup no realiza una copia de seguridad del conjunto correcto de archivos (121095148)
○ DataAccessExceptions en configuraciones de varios centros de datos (76087166)
○ Política de MessageLogging que incluye información adicional en el mensaje de registro (68722102)

Para obtener más información sobre cada uno de estos problemas conocidos, incluidas las soluciones alternativas, consulta Problemas conocidos.

Actualiza las rutas

En la siguiente tabla, se muestran las rutas de actualización para esta versión:

A partir de 4.19.01 Actualización directa de 4.19.01 a 4.19.06
A partir de 4.18.05 Actualización directa de 4.18.05 a 4.19.06
Desde 4.18.01 Actualización directa de 4.18.01 a 4.19.06

Nuevas funciones

En esta sección, se enumeran las funciones nuevas de esta versión. Además, esta versión incluye todas las funciones de las versiones de la IU de Edge, Edge Management y Portal que se enumeran en Included Releases.

Además de las siguientes mejoras, esta versión también incluye varias mejoras de usabilidad, rendimiento, seguridad y estabilidad.

Compatibilidad con la implementación de HTTP

De forma predeterminada, Edge usa RPC para implementar proxies de API. Si bien este modo funciona muy bien para la mayoría de las instalaciones, las topologías más grandes con muchos MPs pueden experimentar tiempos de espera cuando se realizan una gran cantidad de llamadas simultáneas a través de RPC.

Por lo tanto, Apigee recomienda que las implementaciones más grandes usen HTTP en lugar de RPC para la implementación. Ahora se admiten las implementaciones de HTTP.

Para obtener más información, consulta Habilita la implementación de HTTP.

Compatibilidad con racks de Cassandra

Apigee ahora proporciona orientación general para las operaciones de escalamiento de Cassandra, ya que hace que Cassandra en Apigee Edge para la nube privada sea compatible con racks.

Para obtener más información, consulta Compatibilidad con racks de Cassandra.

Análisis conectables

De forma predeterminada, los datos de análisis recopilados por el Message Processor se suben a Qpid y Postgres para su procesamiento. Luego, puedes ver los datos de estadísticas en la IU de Edge.

Con esta versión de la función, puedes configurar el Message Processor para que escriba datos de análisis en el disco o puedes optar por usar ambas opciones.

Para obtener más información, consulta Cómo escribir datos de Analytics en un archivo.

Instalación simplificada de la nueva experiencia de Edge

Se simplificó la instalación de la nueva experiencia de Edge con una nueva secuencia de comandos.

Para obtener más información, consulta Instala la nueva experiencia de Edge.

Compatibilidad con IdP de LDAP

La autenticación de usuarios con llamadas a la IU de Edge y a la API de administración de Edge ahora admite LDAP además de SAML. La compatibilidad con LDAP incluye métodos de vinculación directa e indirecta.

Para obtener más información, consulta Descripción general de la autenticación con IDP externo.

Compatibilidad con IPv6

De forma predeterminada, todas las llamadas a la API del entorno de ejecución de Apigee Edge para Private Cloud usan IPv4. Puedes agregar compatibilidad con IPv6 al objeto Router con una propiedad nueva.

Para obtener más información, consulta Usa IPv6 en el router.

Excluir transacciones de INVALID_TSC (Monetización)

Ahora puedes excluir las transacciones de INVALID_TSC para que no se agreguen a la base de datos de Postgres cuando uses la Monetización.

Para obtener más información, consulta Propiedades del servidor de monetización.

Software compatible

En esta versión, se incluyen los siguientes cambios en el software compatible:

Se agregó compatibilidad Ya no se admite

Esta versión agrega compatibilidad con las siguientes plataformas:

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

Las siguientes plataformas ya no son compatibles con esta versión:

  • Red Hat Enterprise Linux (RHEL) 6.9
  • CentOS 6.9
  • Oracle 6.8

Para obtener una lista completa de las plataformas compatibles, consulta Software y versiones compatibles.

Correcciones de errores

En esta sección, se enumeran los errores de Private Cloud que se corrigieron en esta versión. Además, esta versión incluye todas las correcciones de errores en las versiones de la IU de Edge, Edge Management y el portal que se muestran en Included Releases.

ID del problema Descripción
140270474

UseStringDeduplication no está configurado

UseStringDeduplication no se configuraba para los componentes de edge-message-processor en los entornos de producción.
111445518

Errores de MP

Los Message Processors registraron continuamente el siguiente mensaje de error cada 5 minutos:
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
113342838

Fallas de Cassandra con JMX

Las operaciones de Cassandra no funcionaban cuando se habilitaba la autenticación de JMX
138931337

Actualizaciones de 13 nodos

Fallaban las actualizaciones de instalaciones de 13 nodos desde las versiones 17.09, 18.01 y 18.05.
119802562

Proxies con el mismo nombre

Si dos usuarios de la misma organización crearon proxies con los mismos nombres, el segundo que se creó reemplazaría al primero. Esto solo ocurría cuando diferentes usuarios no podían ver el otro proxy.
118851790

No se cargan los almacenes de claves

Cuando había más de 100 almacenes de claves para una organización o un entorno, no se cargaba la sección de almacén de claves y referencia en la IU de Edge. En cambio, la IU mostró un error Internal Error (Error Fetching Keystores).
110988191

Error de Analytics

Las estadísticas fallaron para un entorno cuando se proporcionaron datos del Microgateway que se configuraron para una fecha futura.
110785400

Problemas relacionados con las copias de seguridad

ZooKeeper, Cassandra y OpenLDAP fallaron de forma intermitente en realizar copias de seguridad de sus datos correctamente con el siguiente error: File changed as we read it.
79993247

Solicitudes de HEAD a Node.js

Las solicitudes HEAD a un destino de Node.js podían quedar pendientes, lo que dejaba conexiones pendientes.
70291825

Copia de seguridad y restablecimiento de apigee-postgres

Ahora, cuando se ejecuta una copia de seguridad o un restablecimiento de apigee-postgres, se crea una copia de seguridad de los datos de todos los componentes.
65737520

Cómo restablecer la contraseña del administrador del sistema

Se produciría un error al restablecer la contraseña del administrador del sistema para el servidor de administración que contenía caracteres especiales.

Problemas conocidos

En la siguiente tabla, se enumeran los problemas conocidos en esta versión:

ID del problema Descripción
141628497

Mint no califica las transacciones inicialmente

Edge para la Nube privada no califica las transacciones inicialmente cuando habilitas la monetización por primera vez para una organización. Esto se aplica a las organizaciones nuevas y existentes.

La API de habilitación de la monetización responde con el ID del trabajo y, cuando se completa, el estado del trabajo indicará que se realizó correctamente. Sin embargo, las llamadas a la API monetizadas que se realicen inicialmente no se procesarán para la monetización ni se calificarán. Estas transacciones solo se mostrarán en las estadísticas normales.

Solución alternativa:

Reinicia los Message Processors (MPs) con el siguiente comando:
apigee-service edge-message-processor restart

Después de habilitar la monetización, reiniciar los MP hace que Edge cargue la configuración de ZooKeeper al inicio. Esto sucede cada vez que se reinicia el dispositivo, lo que significa que el problema solo se aplica inicialmente.

137865184

Fuga de memoria en los servidores de calificación de Mint

Cuando se registra una nueva instancia de Qpid en un mxgroup, las colas se compilan sin consumidores, lo que hace que la profundidad de la cola aumente hasta que se utilizan todos los recursos disponibles.

Solución alternativa:

Ninguno
135616498

Formato de archivo de metadatos para la instalación de apigee-sso

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

Solución alternativa:

Para solucionar este problema, puedes realizar una de las siguientes acciones:

  • Agrega un CRLF al final del archivo metadata.xml

    O

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

apigee-monit no es compatible con Amazon Linux 1

Solución alternativa:

Ninguno
121095148

La copia de seguridad del Message Processor no crea una copia de seguridad del conjunto correcto de archivos

Solución alternativa:

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

76087166

DataAccessException en configuraciones de varios centros de datos

En las configuraciones de varios centros 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

El resultado es que es posible que el servidor de administración no se inicie porque intenta conectarse a los nodos de Cassandra en dc-1 y dc-2. El error DataAccessExceptions se produce si un nodo de Cassandra está inactivo. Esto también podría provocar interrupciones en el tráfico de la API, en las que los procesadores de mensajes informen DataAccessExceptions cuando intenten 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 en todas las regiones.

Solución alternativa

La solución alternativa consiste en anular el registro de los siguientes tipos de nodos de Cassandra en el centro de datos no disponible y, luego, volver a registrarlos después de que los nodos de Cassandra estén disponibles nuevamente:

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

Para anular y volver a registrar estos tipos de nodos de Cassandra, haz lo siguiente:

  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"

    Donde:

    • 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, de forma predeterminada, es "gateway". Sin embargo, es posible que le hayas cambiado el nombre, así que verifica 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. Los usarás para anular 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 devuelven.
  3. Anula 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

    Aquí, UUID es el UUID que se devolvió en la respuesta del comando anterior.

  4. Repite el paso 3 para cada UUID que recopilaste 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 anulan el registro de nodos de Zookeeper, y no tienen ningún impacto en el clúster de Cassandra. Para obtener más información sobre estos comandos, consulta Actualiza los registros del almacén de datos.

68722102

Política 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, se supone que el mensaje registrado no debe incluir ninguna información generada por Apigee. Sin embargo, incluso si configuras FormatMessage=false, el mensaje de registro aún incluye la siguiente información:

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

Solución alternativa:

Ninguno

Próximo paso

Para comenzar a usar Edge para la nube privada 4.19.06, usa los siguientes vínculos:

Nuevas instalaciones:
Nueva descripción general de la instalación
Instalaciones existentes:
Rutas de actualización