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

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

En esta sección, se describe la versión 4.19.06 de Edge para la actualización de funciones de 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 SSO
○ Asistencia de implementación HTTP
○ Estadísticas conectables
○ Compatibilidad con bastidores de Cassandra
○ Compatibilidad con IPv6
○ Nueva instalación simplificada de la experiencia Edge
○ Excluir INVALID_TSC transacciones (monetización)

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

Retrocompatibilidad

Los siguientes problemas que afectan la retrocompatibilidad se introdujeron en esta versión de Apigee Edge para nube privada:

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

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

    /opt/apigee/var/log/apigee-cassandra/system.log
Lanzamientos incluidos

Desde la versión anterior de la función de Edge para nube privada, se produjeron las siguientes versiones y se incluyen en esta:

}








19.03.0119.02.1919.02.0419.01.2319.01.1418.12.0418.08.3118.07.31
○ Portal:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02.2719.02.2119.02.0419.01.16
Jubilaciones Ninguna
Bajas

Con 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 ahora está obsoleta.

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

Correcciones de errores

Esta versión incluye las siguientes correcciones de errores:

○ 80










HEAD

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

Errores conocidos

Esta versión incluye los siguientes problemas conocidos:

○ la información de registro de la menta no está clasificada inicialmente (141628497)
○ La fuga de memoria del centro de calificación de los servidores de calificación de la menta (137865184)
1 Formato de archivo de metadatos de la instalación de apigee-sso (135616498)
0 apigee-monit de los archivos de copia de seguridad de mensajes
7 no se admite en Amazon Linux copia de seguridad 1 (122337098)


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:

From 4.19.01 Actualiza directamente de 4.19.01 → 4.19.06.
Desde el 18/4/05 Actualiza directamente de 4.18.05 → 4.19.06.
Desde el 18/4/01 Actualiza directamente de 4.18.01 → 4.19.06.

Funciones nuevas

En esta sección, se enumeran las nuevas funciones de esta versión. Además, esta versión incluye todas las funciones de la IU de Edge, la administración de Edge y las versiones del portal que se enumeran en las versiones incluidas.

Además de las siguientes mejoras, esta versión también contiene 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 MP pueden experimentar tiempos de espera cuando se realiza una gran cantidad de llamadas simultáneas a través de RPC.

Como resultado, Apigee recomienda que las implementaciones más grandes usen HTTP en lugar de RPC. Ahora se pueden habilitar las implementaciones de HTTP.

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

Compatibilidad con el bastidor de Cassandra

Apigee ahora proporciona orientación general para escalar operaciones de Cassandra haciendo que Cassandra en Apigee Edge para bastidores de nube privada reconozca los bastidores.

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

Estadísticas enchufables

De forma predeterminada, los datos de estadísticas que recopila 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 actualización de funciones, puedes configurar Message Processor para que escriba datos de estadísticas en el disco, o bien puedes usar ambas opciones.

Para obtener más información, consulta Escribe datos de estadísticas en un archivo.

Instalación simplificada de la nueva experiencia 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 la IU de Edge y llamadas a la API de Edge Management ahora admite LDAP además de SAML. La compatibilidad con LDAP incluye los métodos de vinculación directa y indirecta.

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

Compatibilidad con IPv6

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

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

Excluir INVALID_TSC transacciones (monetización)

Ahora puedes excluir las transacciones INVALID_TSC para evitar que 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

Esta versión incluye 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 la nube privada que se corrigieron en esta versión. Además, esta versión incluye todas las correcciones de errores de la IU de Edge, Edge Management y las versiones del portal que se muestran en las Versiones incluidas.

ID del problema Descripción
140270474

No se estableció UseStringDeDuplicación.

No se estaba configurando UseStringDeduplication para los componentes de edge-message-processor en los entornos de producción.
111445518

Errores MP

Message Processors registró continuamente el siguiente mensaje de error cada 5 min:
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 habilitó la autenticación JMX
138931337

Actualizaciones de 13 nodos

Las actualizaciones de las instalaciones de 13 nodos de las versiones 17.09, 18.01 y 18.05 fallaban.
119802562

Proxies con el mismo nombre

Si dos usuarios de la misma organización crearon proxies con los mismos nombres, el segundo usuario reemplazará al primero. Esto solo se producí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 entorno, la sección de referencia y el almacén de claves en la IU de Edge no se cargaban. En cambio, la IU mostraba un error Internal Error (Error Fetching Keystores).
110988191

Error al realizar estadísticas

Se produjo un error en las estadísticas de un entorno cuando se proporcionaron datos de Microgateway que se establecieron en una fecha futura.
110785400

Fallas de copia de seguridad

De forma intermitente, ZooKeeper, Cassandra y OpenLDAP no pudieron crear una copia de seguridad correcta de sus datos, con el siguiente error: File changed as we read it..
79993247

Solicitudes HEAD a Node.js

Las solicitudes HEAD a un destino de Node.js podrían bloquearse, lo que dejaba las conexiones pendientes.
70291825

Copia de seguridad o restablecimiento de apigee-postgres

Cuando se ejecuta una copia de seguridad o un restablecimiento de Apigee-postgres, ahora se crean copias de seguridad de los datos de todos los componentes.
65737520

Restablece la contraseña del administrador del sistema

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

Errores conocidos

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

ID del problema Descripción
141628497

Mint no califica las transacciones inicialmente

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

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

Solución alternativa:

Reinicia cualquier procesador de mensajes (MP). Esto se puede hacer de la siguiente manera:
apigee-service edge-message-processor restart

Una vez habilitada la monetización, cuando se reinician los MP, Edge carga la configuración desde ZooKeeper en el inicio. Esto sucede en cada reinicio, lo que significa que el problema solo se aplica inicialmente.

137865184

Fuga de memoria de los servidores de calificación inicial

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

Solución alternativa:

Ningún contenido de este tipo
135616498

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

Cuando instalas apigee-sso y usas 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, no se lee por completo.

Solución alternativa:

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

  • Agregar 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:

Ningún contenido de este tipo
121095148

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

Solución alternativa:

Vuelve a ejecutar la copia de seguridad para que se cree una copia del conjunto de archivos correcto.

76087166

DataAccessException en varias configuraciones de centros de datos

Cuando hay varias configuraciones de 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 está intentando conectarse a los nodos de Cassandra en dc-1 y dc-2. DataAccessExceptions se produce si un nodo de Cassandra no funciona. Esto también puede provocar la interrupción del tráfico de la API, en la que Message Processor informa DataAccessExceptions mientras intenta recuperar los 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 las regiones.

Solución alternativa

La solución alternativa es anular el registro de los siguientes tipos de nodos de Cassandra en el centro de datos no disponible y volver a registrarlos después de que los nodos de Cassandra vuelvan a estar disponibles:

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

Para anular el registro de estos tipos de nodos de Cassandra y volver a registrarlos, sigue estos pasos:

  1. Obtén los UUID de los nodos de Cassandra mediante 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 "puerta de enlace" de forma predeterminada. Sin embargo, es posible que hayas cambiado el nombre por otro, 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. Las 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 muestran.
  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

    En el ejemplo anterior, UUID es el UUID que se muestra 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 cancelan los 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 registros del almacén de datos.

68722102

Política de MessageLogging, incluida 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 incluirá la siguiente información:

  • Puntuación prioritaria
  • La marca de tiempo

Solución alternativa:

Ningún contenido de este tipo

Próximo paso

Si deseas 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