Documentación de Oracle Cloud Infrastructure

Mantenimiento de despliegues de OCI GoldenGate

Obtenga información sobre las versiones de GoldenGate, cómo y cuándo actualizar, recibir o posponer notificaciones y cómo revertir actualizaciones.

Acerca de las versiones de GoldenGate

OCI GoldenGate soporta varias versiones simultáneas, por ejemplo, Oracle GoldenGate, Oracle GoldenGate for Big Data y Oracle GoldenGate for MySQL, por nombrar algunas. Consulte la referencia de versiones para obtener detalles sobre la versión adecuada.

Cada versión tiene un número de compilación. Hay tres tipos de versiones:

  • Mayor: el primer número del número de compilación indica una versión principal. Por ejemplo, 21.
  • Paquete: el segundo número indica la versión del paquete. Una versión del paquete es un conjunto de correcciones de errores para una versión principal. 21.5
  • Menor: los números finales indican una versión menor. Una versión secundaria consta de una o más correcciones de errores en una versión del paquete. 0,0,0 21,5.
Nota

Todos los tipos de versión pueden contener correcciones de seguridad.

En función del tipo de versión y de si incluye o no una corrección de seguridad, dispondrá de una cantidad de tiempo específica para actualizar el despliegue cuando haya una nueva versión disponible:

Tipo de publicación Mayor Grupo Secundaria
Corrección no de seguridad 365 días 180 días No aplicable
Corrección de seguridad No aplicable 14 días 14 días

Si no realiza la actualización manualmente en el marco temporal especificado, el despliegue se actualiza automáticamente a la última versión al final de este marco temporal.

Nota

Puede ver la fecha en la que se admite una versión hasta en la pantalla Actualizar despliegue y en la lista Actualizaciones.

Desuso de versiones

Una versión GoldenGate está disponible desde la fecha de lanzamiento hasta la fecha en que está en desuso. Cuando una versión está en desuso, ya no puede seleccionarla para la creación o actualización del despliegue.

Los períodos de desuso utilizan los mismos marcos temporales que las actualizaciones de versión. Por ejemplo:

  • 365 días después de una versión Major, la versión Major anterior está en desuso.
  • 180 días después de la versión del paquete, las versiones anteriores del paquete de la misma versión principal están en desuso.
  • 14 días después de una versión de corrección de seguridad (para versiones de paquete o secundarias), todas las versiones anteriores de la misma versión principal están en desuso.
Nota

A partir de abril de 2027, todos los despliegues de replicación de datos de 21c se actualizarán automáticamente a la última versión disponible. Las fechas de liberación pueden variar entre regiones.

Programar actualizaciones

Puede personalizar ventanas de mantenimiento que definan el inicio del período de tiempo durante el cual se actualizará el despliegue cuando haya disponible una nueva versión de GoldenGate. Si no define una ventana de mantenimiento, OCI GoldenGate calcula el mejor momento para actualizar el despliegue en función de la fecha de lanzamiento de la última versión.

Nota

Cuando no se define una ventana de mantenimiento, OCI GoldenGate programa actualizaciones el fin de semana más cercano al final calculado del período de cambio de versión automático.

Puede personalizar la ventana de mantenimiento GoldenGate de OCI al crear el despliegue o más tarde desde la página de detalles del despliegue. Cuando hay disponible una nueva versión de GoldenGate, el despliegue se actualiza automáticamente el día y la hora exactos seleccionados. Sin embargo, los despliegues se pueden actualizar automáticamente antes del día y la hora seleccionados cuando el marco temporal de la nueva versión para la actualización manual queda fuera de la ventana de mantenimiento personalizada.

Por ejemplo, supongamos que el 1 de enero de 2023 le quedan 30 días para actualizar el despliegue y, a continuación, tiene hasta el martes 31 de enero para actualizarlo manualmente. Sin embargo, la ventana de mantenimiento personalizada comienza los domingos a las 10 p.m. Con esta ventana de mantenimiento, OCI GoldenGate actualizará su despliegue el domingo 4 de febrero a las 10 p.m., porque OCI GoldenGate siempre priorizará su ventana personalizada.

Para editar la ventana de mantenimiento personalizada:

  1. En la página de detalles del despliegue, en GoldenGate, en el área de información Despliegue, en Mantenimiento, haga clic en Editar.
  2. En el cuadro de diálogo Editar parámetros de mantenimiento:
    1. (Opcional) Seleccione Personalizar ventana de mantenimiento para cambiar los siguientes campos de sus valores por defecto.
    2. En Período de actualización automática de versión principal en días, introduzca un valor entre 0 y 365.
    3. En Período de actualización automática de liberación de paquete en días, introduzca un valor entre 0 y 180.
    4. En Período de cambio de versión automático de ruta de seguridad en días, introduzca un valor entre 0 y 14.
    5. (Opcional) Seleccione Activar cambio automático de versión secundaria y, a continuación, introduzca un valor para Período de cambio automático de versión secundaria en días.
  3. Haga clic en Guardar cambios.

Antes de Realizar una Actualización

Antes de actualizar un despliegue, asegúrese de realizar las siguientes tareas y de comprobar si hay transacciones de larga ejecución.

Asegúrese de que los archive logs están disponibles para la recuperación

Utilice el siguiente comando en el cliente de administración para determinar el archive log más antiguo que puede que necesite restaurar al iniciar Extract. El campo Recovery Checkpoint muestra el log más antiguo necesario para la recuperación.
Admin Client > INFO EXTRACT group_name, SHOWCH

Es mejor realizar actividades de actualización fuera de las horas pico. Si hay transacciones grandes y de larga ejecución, puede tener en cuenta que en el sistema de origen, es posible que el nuevo Extract deba iniciar el procesamiento desde el punto de control de recuperación normal, en lugar de que el punto de control de recuperación enlazado, si el primer registro de la transacción abierta más antigua en el momento en que se detiene Extract está en un log que no está en el sistema.

Borrar transacciones de larga ejecución

Para compensar transacciones de larga ejecución, dispone de dos opciones:

  • Puede restaurar los archivos de nuevo en el punto de control de recuperación que se muestra con:
    Admin Client > INFO EXTRACT
    (Si la base de datos origen lo soporta).
  • Puede borrar las transacciones de larga ejecución que se aplican al Extract que está actualizando. Esto se puede hacer omitiendo las transacciones o forzándolas a la pista como transacciones confirmadas. Si se omite una transacción, se pueden perder datos y forzar una transacción a la pista puede agregar datos no deseados a la pista si se realiza un rollback de la transacción. Para omitir o forzar una transacción:
    1. Consulta de transacciones abiertas:
      Admin Client > SEND EXTRACT group_name, SHOWTRANS
    2. Registre el ID de transacción de cualquier transacción que desee limpiar.
    3. Limpie las transacciones antiguas mediante SEND EXTRACT y la opción SKIPTRANS para omitir una transacción o FORCETRANS para forzar una transacción en su estado actual a la pista como transacción confirmada. Por ejemplo:
      Admin Client > SEND EXTRACT group_name, {SKIPTRANS | FORCETRANS transaction_ID [THREAD n] [FORCE]
    4. Después de terminar de limpiar las transacciones de larga ejecución, fuerce un punto de control de recuperación enlazada. 
      Admin Client> SEND EXTRACT group_name, BR BRCHECKPOINT IMMEDIATE

Sincronizar réplicas

Para despliegues con Parallel Replicats, asegúrese de sincronizar Replicats antes de actualizar:
Admin Client > SYNCHRONIZE REPLICAT group_name

Para obtener más información, consulte la referencia de la interfaz de línea de comandos SYNCHRONIZE REPLICAT.

Cambio de versión de un despliegue

Asegúrese de completar primero los pasos Antes de actualizar.

Cuando cambia la versión de un despliegue,

  • Se para el despliegue y se reinicia a continuación una vez completado el cambio de versión.
  • Todos los procesos de Oracle GoldenGate se paran y se reinician a continuación si están configurados para iniciarse automáticamente.
Para cambiar la versión de un despliegue:
  1. En la página Despliegues, seleccione el despliegue cuya versión desea cambiar.
  2. En la página de detalles del despliegue, en el menú Acciones, seleccione Cambio de versión.
  3. En el panel Despliegue de cambio de versión, seleccione una versión de GoldenGate disponible a la que cambiar de versión y, a continuación, haga clic en Cambiar de versión.
    Nota

    Más información sobre las versiones.

El cambio de versión tarda unos minutos en completarse. Haga clic en Actualizaciones en la página Detalles de despliegue después de que se complete el cambio de versiones para ver el historial de cambios de versión o si se produce una incidencia al realizar el proceso.

Actualizar tablas de latidos
También debe actualizar las tablas de latidos si se utilizan en el despliegue. Después de completar la actualización, puede:
  • Ejecute el comando UPGRADE HEARTBEATTABLE en el cliente de administración para agregar columnas adicionales para tablas y vistas de demora. GoldenGate utiliza estas columnas extra para realizar un seguimiento de la posición de inicio de Extract. Más información.
  • En la consola de despliegue, abra el menú de navegación de la consola de administración y, a continuación, haga clic en Configuration. Conéctese a la base de datos. Cuando aparezcan las tablas de latidos, seleccione Upgrade (Actualizar) en el menú Action (Acción).

Notificaciones de cambio de versión

OCI GoldenGate le envía notificaciones de eventos para cuando un cambio de versión está disponible y cuando se programa un cambio de versión. Consulte GoldenGate Tipos de eventos de actualización para obtener más información o obtenga más información sobre los eventos.

Tiempo para actualizar < 180 días < 30 días < 7 días
Período de notificación Cada 30 días Cada 7 días Cada Día
Nota

OCI GoldenGate envía una notificación para las correcciones de seguridad todos los días.

También puede obtener información sobre las próximas actualizaciones en los banners de notificación que aparecen en la página de detalles del despliegue.

Postergar notificaciones

Puede posponer o retrasar las notificaciones de eventos y banners. El período de interrupción cambia a medida que se acerca al final del marco temporal para la actualización manual.

Tiempo para actualizar < 180 días < 30 días < 7 días
Periodo de aplazamiento 30 días 7 días No permitido
Nota

No se permite posponer las correcciones de seguridad de actualizaciones secundarias o de paquetes.

Puede cancelar la posposición en cualquier momento.

Revertir actualizaciones

Puede realizar un rollback de una versión de despliegue a la anterior. La reversión solo está permitida para la última actualización correcta a su versión anterior.

Nota

Durante el rollback, el sistema de archivos de despliegue se restaura a su último estado antes del cambio de versión.

No se permite la reversión cuando la versión anterior está en desuso.

Para revertir un cambio de versión:

  1. En la página Deployments, seleccione el despliegue del que desea realizar un rollback.
  2. En la página de detalles del despliegue, seleccione Actualizaciones.
  3. En la lista Actualizaciones, busque la versión anterior más reciente y, a continuación, en el menú Acción, seleccione Anular.
  4. Seleccione la versión a la que desea realizar un rollback y, a continuación, haga clic en Anular.
    Nota

    Consulte la referencia de versiones para obtener una lista de las versiones disponibles.

El estado del despliegue cambia a Update y tarda unos minutos en completarse.

Reprogramar actualizaciones

Puede reprogramar las actualizaciones programadas automáticamente. Puede reprogramar la actualización a una fecha más próxima o posponerla a una fecha posterior.
Nota

La reprogramación no tiene en cuenta las ventanas de mantenimiento. La fecha recién programada no puede ser posterior al valor definido de OCI GoldenGate. Consulte Acerca de las versiones de GoldenGate para obtener más información.

Para reprogramar una actualización:

  1. En la página Deployments, seleccione el despliegue cuyo cambio de versión desea reprogramar.
  2. En la página de detalles del despliegue, seleccione Actualizaciones.
  3. En la lista Actualizaciones, busque la versión anterior más reciente y, a continuación, en el menú Acción, seleccione Volver a programar.
  4. En la ventana Reprogramar cambio de versión de despliegue, seleccione la fecha y hora para realizar el cambio de versión.
  5. Haga clic en Guardar cambios.

En la lista Actualizaciones, la fecha y hora programadas reflejan los cambios.

Cancelar actualizaciones

Solo puede cancelar una actualización programada automáticamente si la versión de destino es una versión secundaria.
Nota

La cancelación de una actualización a una versión secundaria no desactivará las actualizaciones automáticas de versiones secundarias de forma implícita y se debe desactivar manualmente. Puede desactivar el cambio de versión automático de versión secundaria desde la página de detalles del despliegue. Para obtener más información, consulte Programación de Actualizaciones.

Para cancelar una actualización:

  1. En la página Deployments, seleccione el despliegue cuyo cambio de versión desea cancelar.
  2. En la página de detalles del despliegue, seleccione Actualizaciones.
  3. En la lista Actualizaciones, busque la versión anterior más reciente y, a continuación, en el menú Acción, seleccione Cancelar.
  4. En la ventana Cancelar cambio de versión de despliegue, haga clic en Cancelar cambio de versión de despliegue.

El estado del cambio de versión se actualiza a Cancelado.

Incidencias conocidas

Problemas al actualizar a Oracle GoldenGate 21.17 para Big Data

Los usuarios que actualizan de las versiones 21.14, 21.15 o 21.16 de Oracle GoldenGate para Big Data a la versión 21.17 con propiedades de conexión de almacén de confianza y/o almacén de claves configuradas fallan con los siguientes errores informados:

Caused by: oracle.goldengate.util.GGException: An exception occurred when creating the Kafka Producer object. 
Caused by: org.apache.kafka.common.KafkaException: Failed to construct kafka producer 
Caused by: org.apache.kafka.common.KafkaException: Failed to load SSL  keystore /u02/connections/<connection OCID>/trustStore of type JKS 
Caused by: java.io.IOException: keystore password was incorrect

Solución Alternativa:

  1. Convierta el almacén de confianza y el almacén de claves de JKS a PKCS12.
    1. Para el almacén de claves, debe solicitar una contraseña. Keytool es una utilidad en el JDK. 
      keytool -importkeystore -srckeystore [MY_KEYSTORE.jks] -destkeystore [MY_KEYSTORE.p12] -srcstoretype JKS -deststoretype PKCS12 -deststorepass [PASSWORD_PKCS12]
    2. Para el almacén de confianza, debe solicitar una contraseña.
      keytool -importkeystore -srckeystore [MY_TRUSTSTORE.jks] -destkeystore [MY_TRUSTSTORE.p12] -srcstoretype JKS -deststoretype PKCS12 -deststorepass [PASSWORD_PKCS12]
  2. En el archivo de propiedades del productor de Kafka, defina lo siguiente:
    ssl.truststore.type=PKCS12
ssl.keystore.type=PKCS12

Las rutas de distribución y receptor pueden fallar después de actualizar los despliegues de la versión 21.x a la versión 21.17

A partir de las versiones 21.17 y 23ai de Oracle GoldenGate, las rutas utilizan el nombre de dominio reservado por defecto, "Red", por lo que las rutas existentes que utilizan cualquier otro nombre de dominio fallan con el siguiente error informado: 

ERROR| Exception Message: The network connection could not be established: 'OGG-10351' - 'Generic error -1 noticed. Error description - credential store alias not found in domain.'

Solución alternativa: en la consola de despliegue GoldenGate de OCI, edite cada ruta y cambie el nombre de dominio a "Red" y, a continuación, reinicie la ruta. Para verificarlo, compruebe el dominio del usuario de autenticación de ruta de acceso en la sección Almacén de credenciales de la página Configuración.

Si prefiere utilizar el cliente de administración, ejecute los siguientes comandos para actualizar el nombre de dominio. Asegúrese de sustituir los marcadores de posición <path_name> y <alias>:

Para rutas iniciadas por el origen:

ALTER DISTPATH <path_name> TARGET AUTHENTICATION USERIDALIAS <alias> domain
    Network

Para rutas iniciadas en el destino:

ALTER RECVPATH <path_name> SOURCE AUTHENTICATION USERIDALIAS <alias> domain
    Network

Problemas durante el rollback de versiones 21.15 o 23.x a 21.14

(Obligatorio) <Introduzca aquí un texto introductorio, incluida la definición y finalidad del concepto.>

Al intentar revertir una compilación 21.15 o 23.x a:

  • Oracle (21.14.0.0.0_240525)
  • Big Data (21.14.0.0.0_240515)
  • MySQL (21.14.0.0.0.0_240404)
  • MSSQL (21.14.0.0_240404)

Puede encontrar uno de los siguientes problemas:

  • Falta el problema de conexiones/credenciales debido a la nueva función de cifrado de cartera introducida a partir de la versión 21.15.

    Solución alternativa: debe anular la asignación y reasignar las conexiones existentes al despliegue y volver a crear los usuarios faltantes necesarios para cualquier ruta de distribución o de receptor en uso.

  • El gestor de servicios no se puede iniciar debido a un problema con el servicio de métricas de rendimiento en los rollbacks de 23.x a 21.14. Póngase en contacto con los Servicios de Soporte Oracle si encuentra este problema.
  • Los procesos de Oracle GoldenGate fallan con el error "OGG-02431 Se ha encontrado una cabecera de registro no válida en el archivo de punto de control".

    Solución alternativa: actualice el despliegue a la última versión de la versión 21.14 disponible en la serie. Póngase en contacto con Servicios de Soporte Oracle si el problema continúa.