Mantenimiento de los 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.

Temas relacionados

Acerca de las versiones GoldenGate

OCI GoldenGate soporta varias versiones simultáneas, por ejemplo, Oracle GoldenGate, Oracle GoldenGate para Big Data y Oracle GoldenGate para 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 en el número de compilación indica una versión principal. Por ejemplo, 21.
  • Paquete: el segundo número indica la liberación del paquete. Una versión de paquete es un conjunto de correcciones de bugs para una versión principal. Por ejemplo, 21.5
  • Menor: los números finales indican una versión menor. Una versión menor consta de una o más correcciones de errores en una versión de paquete. Por ejemplo, 21.5.0.0.0.

Note:

Todos los tipos de versiones 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 Principal Bundle Secundaria
Corrección sin seguridad 365 días 180 días No se aplica
Corrección de seguridad No se aplica 14 días 14 días

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

Note:

Puede ver la fecha en la que está soportada una versión hasta que aparezca en la pantalla Upgrade deployment y la lista Upgrades.

Desuso de versiones

Hay disponible una versión GoldenGate 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 principal, la versión principal 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.

Note:

La fecha de publicación puede 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 tiempo para actualizar el despliegue en función de la fecha de versión de la última versión.

Note:

Cuando no se define una ventana de mantenimiento, OCI GoldenGate programa los cambios de versión 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 de OCI GoldenGate 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., ya que 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 Edit maintenance parameters:
    1. (Opcional) Seleccione Personalizar ventana de mantenimiento para cambiar los siguientes campos de sus valores por defecto.
    2. En Período de cambio automático de versión principal en días, introduzca un valor entre 0 y 365.
    3. En Período de cambio automático de versión de paquete en días, introduzca un valor entre 0 y 180.
    4. En Período de actualización automática 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 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 Admin Client para determinar el archive log más antiguo que podría necesitar restaurar cuando se inicie Extract. El campo Recovery Checkpoint muestra el log más antiguo necesario para la recuperación.
Admin Client > INFO EXTRACT group_name, SHOWCH

Lo mejor es realizar actividades de actualización fuera de las horas pico. Si hay transacciones grandes y de larga ejecución, puede considerar que en el sistema de origen, el nuevo Extract puede necesitar 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 duración

Para borrar transacciones de larga duración, tiene 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 de origen soporta esto.)
  • Puede borrar las transacciones de larga ejecución que se aplican al Extract que está actualizando. Para ello, omita las transacciones o forzándolas a la pista como transacciones confirmadas. Omitir una transacción puede causar pérdida de 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. Ver 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 bien FORCETRANS para forzar una transacción en su estado actual a la pista como una 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 los replicados 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 de 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 Cambiar de versión.
  3. En el panel Despliegue de actualización, seleccione una versión de GoldenGate disponible a la que realizar la actualización y, a continuación, haga clic en Actualizar.

    Note:

    Obtenga 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 finalice el cambio de la versión para ver el historial de cambios de versión o si se ha producido una incidencia durante 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 adicionales para realizar un seguimiento de la posición de reinicio 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 Actualizar en el menú 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 de actualización < 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

Note:

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.

Posterizar notificaciones

Puede posponer o retrasar las notificaciones de eventos y banners. El período de posponer 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
Período de aplazamiento 30 días 7 días No permitido

Note:

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

Puede cancelar la interrupción en cualquier momento.

Restituir 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.

Note:

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 realizar un rollback de un cambio de versión:

  1. En la página Despliegues, 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 Realizar rollback.
  4. Seleccione la versión a la que desea realizar el rollback y, a continuación, haga clic en Realizar rollback.

    Note:

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

El estado del despliegue cambia a actualización 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.

Note:

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 GoldenGate para obtener más información.

Para reprogramar una actualización:

  1. En la página Deployments, seleccione el despliegue cuya actualizació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 la 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.

Note:

La cancelación de una actualización a una versión secundaria no desactivará implícitamente las actualizaciones automáticas para versiones secundarias y se debe desactivar manualmente. Puede desactivar la actualización automática de versiones menores desde la página de detalles del despliegue. Para obtener más información sobre la programación de actualizaciones.

Para cancelar una actualización:

  1. En la página Despliegues, seleccione el despliegue cuya actualizació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 Cancel deployment upgrade, haga clic en Cancel deployment upgrade.

El estado de la actualización se actualiza a Cancelado.

Incidencias conocidas

Problemas detectados durante la reversión de las versiones 21.15 o 23.x a 21.14

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 versión 21.14 más reciente disponible en la serie. Póngase en contacto con los Servicios de Soporte Oracle si el problema continúa.