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 las 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 para usted.

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

Principal: 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 versión del paquete. Una versión de paquete es un conjunto de correcciones de errores 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.

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 un tiempo específico para actualizar el despliegue cuando haya una nueva versión disponible:

Tipo de publicación	Principal	Bundle	Secundaria
Corrección no de 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 dentro del 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 una versión está soportada hasta que aparezca en la pantalla de despliegue de actualización y en la lista de actualizaciones.

Desuso de versiones

Una versión de GoldenGate está disponible desde la fecha en que se lanzó 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 periodos de desuso utilizan los mismos periodos de tiempo que las actualizaciones de versión. Por ejemplo:

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

Nota: A partir de abril de 2027, todos los despliegues de replicación de datos 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 las ventanas de mantenimiento que definen cuándo actualizar el despliegue. Si no define una ventana de mantenimiento, OCI GoldenGate calcula el mejor momento para actualizar el despliegue en función de la fecha de versión más reciente y, a continuación, actualiza automáticamente el despliegue durante el fin de semana más cercano al final calculado del período de cambio de versión automático.

Nota: Cuando se publica una nueva versión de una versión principal, de un paquete o secundaria, OCI GoldenGate programa un cambio de versión en función de la cronología aplicable (365 días para principal, 180 días para paquete y 14 días para menor con corrección de seguridad). Si hay disponible una versión más reciente de la misma versión, el servicio actualiza el despliegue con la última versión disponible, pero la fecha programada no cambia.

Puede personalizar la ventana de mantenimiento de OCI GoldenGate al crear el despliegue o al editar un despliegue existente. Cuando hay disponible una nueva versión de GoldenGate, el despliegue se actualiza automáticamente el día y la hora exactos elegidos. Sin embargo, es posible que los despliegues se actualicen automáticamente antes del día y la hora elegidos, cuando el marco temporal de actualización elegido para la actualización manual queda fuera de la ventana de mantenimiento.

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

Para editar la ventana de mantenimiento personalizada:

En la página de detalles del despliegue, en GoldenGate, en el área de información de despliegue, para Mantenimiento, seleccione Editar.
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 la versión del 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 de versión automático de versión secundaria y, a continuación, introduzca un valor para Período de cambio de versión automático de versión secundaria en días.
Seleccione Guardar cambios.

Antes de actualizar

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

Es mejor realizar actividades de actualización fuera de las horas punta. Si hay transacciones grandes y de larga ejecución, puede que tenga en cuenta que en el sistema de origen, puede que la nueva extracción tenga que 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 borrar transacciones de larga ejecución, existen dos opciones:

Puede restaurar los archivos e incluirlos en el que se muestra en el punto de control de recuperación que se muestra con:
```
Admin Client > INFO EXTRACT
```
(Si la base de datos origen soporta esto.)
Puede borrar las transacciones de larga ejecución que se aplican al Extract que está actualizando. Para ello, se pueden omitir las transacciones o forzarlas a la pista como transacciones confirmadas. La omisión de una transacción puede provocar la 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. 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 bien 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 los despliegues con Parallel Replicats, asegúrese de sincronizar los 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 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:

En la página Despliegues, seleccione el despliegue cuya versión desea cambiar.
En la página de detalles del despliegue, en el menú Acciones, seleccione Cambiar de versión.
En el panel Actualizar despliegue, seleccione una versión disponible de GoldenGate a la que cambiar de versión y, a continuación, seleccione Actualizar.

Nota: Obtenga más información sobre las versiones.

El cambio de versión tarda unos minutos en completarse. Seleccione Actualizaciones en la página Detalles de despliegue después de completar el cambio de la versión para ver el historial de cambio de la 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, seleccione 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 cuando hay un cambio de versión disponible y cuando se programa un cambio de versión. Consulte Tipos de eventos de actualización de GoldenGate para obtener más información o Obtenga más información sobre 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

Nota: OCI GoldenGate envía notificaciones de correcciones de seguridad todos los días.

También puede obtener información sobre las próximas actualizaciones a partir de 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 suspensión cambia a medida que se acerca al final del período de tiempo para la actualización manual.

Tiempo de actualización	< 180 días	< 30 días	< 7 días
Período de aplazamiento	30 días	7 días	No permitido

Nota: No se permite posponer las correcciones de seguridad de las actualizaciones menores o del paquete.

Puede cancelar el aplazamiento en cualquier momento.

Realizar rollback de actualizaciones

Puede realizar un rollback de una versión de despliegue a la anterior. Solo se permite el rollback 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 de la actualización.

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

Para realizar un rollback de una actualización:

En la página Despliegues, seleccione el despliegue cuyo rollback desea realizar.
En la página de detalles del despliegue, seleccione Actualizaciones.
En la lista Actualizaciones, busque la versión anterior más reciente y, a continuación, en el menú Acción, seleccione Anular.
Seleccione la versión a la que desea realizar un rollback y, a continuación, seleccione Anular.

Nota: 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.

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:

En la página Deployments, seleccione el despliegue cuyo cambio de versión desea reprogramar.
En la página de detalles del despliegue, seleccione Actualizaciones.
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.
En la ventana Reprogramar cambio de versión de despliegue, seleccione la fecha y hora para realizar el cambio de versión.
Seleccione Guardar cambios.

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

Cancelar cambios de versión

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 un cambio de versión a una versión secundaria no desactivará implícitamente los cambios de versión automáticos para versiones secundarias y se debe desactivar manualmente. Puede desactivar la actualización automática de versiones secundarias desde la página de detalles del despliegue. Consulte Programación de actualizaciones para obtener más información.

Para cancelar una actualización:

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

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

Incidencias conocidas

Tras la actualización a Oracle GoldenGate 23.26.x, error de gateway incorrecto en la consola de despliegue 502 o fallo al mostrar los procesos de GoldenGate después de la conexión

Es posible que los despliegues de Oracle Cloud Infrastructure GoldenGate 23.26 no estén en buen estado después de actualizar de etiquetas anteriores a la versión 23.26.x o después de realizar una operación de parada/inicio en un despliegue de 23.26.x.

Solución alternativa: la actualización de los despliegues de Oracle afectados a la etiqueta oggoracle:23.26.1.0.0_260331 para solucionar este problema.

En el caso de Big Data y otras etiquetas que no sean de Oracle, se anunciará una corrección en breve. Póngase en contacto con el servicio de soporte para la mitigación manual provisional a fin de evitar el impacto.

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

Al intentar realizar un rollback de una compilación 21.15 o 23.x en una de las siguientes compilaciones:

Oracle (21.14.0.0.0_240525)
Big Data (21.14.0.0.0_240515)
MySQL (21.14.0.0.0_240404)
MSSQL (21.14.0.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 en 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 que faltan necesarios para cualquier ruta de distribución o receptor en uso.
El gestor de servicios no se puede iniciar debido a un problema con el servicio de métricas de rendimiento en las reversiones 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. Si el problema continúa, póngase en contacto con los Servicios de Soporte Oracle.