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

Estás viendo la documentación de Apigee Edge.
Ve a la Documentación de Apigee X.
información

En esta sección, se describe la versión 4.19.06 de Edge para el lanzamiento 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
○ Compatibilidad con la implementación de HTTP
○ Estadísticas conectables
○ Compatibilidad con bastidores Cassandra
○ Compatibilidad con IPv6
○ Instalación simplificada de una nueva experiencia de Edge
○ Excluir INVALID_TSC transacciones (monetización)

Para obtener más información sobre estas nuevas funciones, consulta Nuevas funciones.

Retrocompatibilidad

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

     
  • Debido a la solución del problema 132443137 (como se describe en la Encuesta pública 19/03/01 notas de la versión de Cloud), los procesadores de mensajes ahora ignoran los encabezados que comienzan con X-Apigee-* Como resultado, debes refactorizar cualquier código que use X-Apigee-* y reemplazar esos encabezados por los 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 Edge para la función de nube privada, las siguientes versiones que se incluyen en esta versión:

○ Perímetro:
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
Jubilaciones Ninguno
Bajas

Con la actualización 4.19.06, las siguientes funciones 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 CPS de Apigee de la configuración.

Correcciones de errores

En esta versión, se incluyen las siguientes correcciones de errores:

○ UseStringDeDuplicación no establecida (140270474)
○ Errores de MP (111445518)
○ Fallas de Cassandra con JMX (113342838)
○ Actualizaciones de 13 nodos (138931337)
○ Proxies con el mismo nombre (119802562)
○ Los almacenes de claves no se cargan (118851790)
○ Error de análisis (110988191)
○ Fallas de las copias de seguridad (110785400)
○ Solicitudes HEAD a Node.js (79993247)
○ Copia de seguridad y restablecimiento de apigee-postgres (70291825)
○ Restablecimiento de la contraseña del administrador del sistema (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 en los servidores de clasificación Mint (137865184)
○ Formato de archivo de metadatos para la instalación de Apigee-SO (135616498)
apigee-monit no es compatible con Amazon Linux 1 (122370980)
○ La copia de seguridad del procesador de mensajes no crea una copia de seguridad del conjunto correcto de archivos (121095148)
○ Excepciones de DataAccessExceptions en la configuración 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 de esta versión:

Desde el 19/04/01 Actualización directa desde la versión 4.19.01 → 4.19.06
Desde el 18/4/05 Actualización directa desde la versión 4.18.05 → 4.19.06
Desde el 18/4/01 Actualización directa desde la versión 4.18.01 → 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 de la IU de Edge, de Edge Management y de las versiones del portal que se enumeran en Lanzamientos incluidos.

Además de las siguientes mejoras, esta versión también contiene diversas funciones mejoras de 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 instalaciones, las topologías más grandes con muchos MP pueden experimentar tiempos de espera cuando una gran cantidad de las llamadas simultáneas se realizan a través de RPC.

Como resultado, Apigee recomienda que las implementaciones más grandes usen HTTP en lugar de RPC para de Google Workspace. Ahora se admiten implementaciones HTTP.

Para obtener más información, consulta Cómo habilitar HTTP del proyecto.

Compatibilidad con bastidores Cassandra

Apigee ahora proporciona una guía general para escalar operaciones de Cassandra haciendo que Cassandra en Apigee Edge para reconocimiento de bastidores en la nube privada.

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

Estadísticas conectables

De forma predeterminada, los datos de estadísticas que recopila el procesador de mensajes 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 el Message Processor para escribir datos de estadísticas en disco o 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 de Edge

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

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 las llamadas a la API de Edge Management ahora admite LDAP en además de SAML. La compatibilidad con LDAP incluye tanto métodos de enlace directo como indirectos.

Para obtener más información, consulta Descripción general de los recursos Autenticación del IdP.

Compatibilidad con IPv6

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

Para obtener más información, consulta Usa IPv6 en la Router.

Excluir INVALID_TSC transacciones (monetización)

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

Para obtener más información, consulta Monetización propiedades del servidor.

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 la nube privada que se corrigieron en esta versión. Además, este incluye todas las correcciones de errores de la IU de Edge, administración de perímetro y las versiones del portal que se muestran en Lanzamientos incluidos.

ID del problema Descripción
140270474

UseStringDeDuplicación no establecida

UseStringDeduplication no era se está configurando para los componentes de edge-message-processor en producción entornos de prueba.
111445518

Errores de MP

Los procesadores de mensajes registran 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 la autenticación JMX estaba habilitada
138931337

Actualizaciones de 13 nodos

Las actualizaciones de las instalaciones de 13 nodos desde las versiones 17.09, 18.01 y 18.05 estaban fallando.
119802562

Proxies con el mismo nombre

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

Los almacenes de claves no se cargan

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

Error en Analytics

Analytics falló para un entorno cuando se le proporcionaron datos de la Microgateway que se establecido en una fecha futura.
110785400

Fallas de la copia de seguridad

ZooKeeper, Cassandra y OpenLDAP no lograban hacer lo siguiente: cree una copia de seguridad de sus datos de forma correcta con el siguiente error: File changed as we read it.
79993247

Solicitudes HEAD a Node.js

Las solicitudes de HEAD a un destino de Node.js se podrían bloquear, lo que dejó conexiones pendientes.
70291825

Copia de seguridad y restablecimiento de apigee-postgres

Cuando se ejecuta una copia de seguridad o 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

Restablecer la contraseña del administrador del sistema para el servidor de gestión que contenía caracteres no funcionarán.

Problemas conocidos

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

ID del problema Descripción
141628497

La acuñación no califica las transacciones en un principio

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

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

Solución alternativa:

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

Después de habilitar la monetización, reiniciar los MPs provoca que Edge cargue la configuración de ZooKeeper al inicio. Esto sucede con cada reinicio, lo que significa que el problema solo se aplica al principio.

137865184

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

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

Solución alternativa:

Ninguno
135616498

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

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, 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

  • Usar 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 procesador de mensajes no crea una copia de seguridad del conjunto correcto de archivos

Solución alternativa:

Ejecuta la copia de seguridad por segunda vez. Debería crearse el conjunto de archivos correcto.

76087166

DataAccessException en varias configuraciones de centros de datos

En 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 Cassandra. en dc-1 y dc-2. El DataAccessExceptions se produce si un nodo de Cassandra está fuera de servicio. Esto también podría provocar la interrupción del tráfico de la API, en la que Message Processors informa DataAccessExceptions mientras se 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. entre 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, luego, volver a registrarlos cuando los nodos de Cassandra estén disponibles nuevamente:

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

Para anular el registro de estos tipos de nodos de Cassandra y volver a registrarlos, haz lo siguiente:

  1. Obtén los UUID de los nodos de Cassandra con el siguiente comando de 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 de servicio predeterminada.
    • MS_IP y MS_PORT son la dirección IP y el puerto del servidor de administración de la fila.
    • REGION es el nombre del centro de datos en el que se encuentra el servidor de administración. ubicado.
    • GATEWAY_POD es el nombre del Pod, que es “puerta de enlace” de forma predeterminada. Es posible que tengas le cambiaste el nombre a otro 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 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

    Donde 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 anulan el registro de nodos de Zookeeper y no tienen 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 de MessageLogging que incluye información adicional en el mensaje de registro

El elemento FormatMessage de la política de 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 incluirá 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 for Private Cloud 4.19.06, usa los siguientes vínculos:

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