Actualización de Oracle GoldenGate Microservices basada en GUI

Descubra los pasos para cambiar la versión de Oracle GoldenGate Microservices mediante la GUI.

En este punto, debe tener un nuevo directorio raíz de Oracle GoldenGate 26ai Microservices y cualquier directorio raíz de versión anterior de Oracle GoldenGate MA.

Actualizar el gestor de servicios

Después de instalar la última versión de Oracle GoldenGate MA, el siguiente paso es actualizar el gestor de servicios.

Si utiliza el agente de Oracle Grid Infrastructure (XAG), desactive la instancia GoldenGate antes de actualizar el gestor de servicios:

$ agctl disable goldengate <goldengate_name>

Estos son los pasos para realizar la actualización de Service Manager:

Inicie sesión en Service Manager desde la URL: https://hostname:servicemanager_port
Amplíe el enlace ServiceManager de la sección Despliegues de la página Visión general del gestor de servicios.
Haga clic en Detalles y, a continuación, en el icono de lápiz situado junto a la sección Detalle de despliegue para abrir el cuadro de diálogo para editar la ruta de acceso del directorio raíz de GoldenGate.
Actualice la ruta del directorio raíz de Oracle GoldenGate con la ruta de acceso completa al nuevo directorio raíz de Oracle GoldenGate.
Haga clic en Aplicar.
Utilice la lista desplegable Acción para reiniciar el gestor de servicios.

Si utiliza XAG, actualice los parámetros de instancia GoldenGate:
```
 $ agctl modify goldengate <GoldenGate Name>  --gg_home <New OGG_HOME directory> --oracle_home <New OGG_HOME directory>/lib/instantclient
```
NOTA: si se utiliza XAG, también se deben actualizar los despliegues gestionados por el gestor de servicios actualizado. No se admite la ejecución de despliegues en un gestor de servicios mediante una versión de software GoldenGate diferente para el gestor de servicios.

Actualización de un Despliegue

Para cambiar la versión de un despliegue:

Pare todos los procesos de Extract y Replicat correctamente:
- Compruebe si hay una transacción abierta (de larga ejecución) y una recuperación enlazada, ya que puede tardar más en detener Extract correctamente.
- Si se pueden ver transacciones abiertas innecesarias, por ejemplo SEND EXTRACT group_name SHOWTRANS, esas transacciones se pueden omitir o forzar inmediatamente a su detención. En este caso, se puede recuperar un punto de control de recuperación enlazada mediante el siguiente comando:
  
  SEND EXTRACT group_name, BR BRCHECKPOINT immediate
Verifique la ubicación actual del directorio raíz de Oracle GoldenGate 26ai desde el gestor de servicios.
1. Inicie sesión en el gestor de servicios: http://hostname:servicemanager_port
2. Amplíe el enlace ServiceManager de la sección Deployments de la página inicial de Service Manager.
3. Copie la ruta del directorio raíz de Oracle GoldenGate.
Vuelva a la sección Despliegues y amplíe el enlace del despliegue que se va a actualizar.
Haga clic en Detalles y, a continuación, en el icono de lápiz junto a la sección Detalle de despliegue para abrir el cuadro de diálogo para editar la ruta de acceso del directorio raíz de GoldenGate.
Actualice la ruta del directorio raíz de Oracle GoldenGate con la ruta de acceso completa al nuevo directorio raíz de Oracle GoldenGate.
Haga clic en Enviar y confirme que la ruta de acceso del directorio raíz de Oracle GoldenGate se ha actualizado.
En función de la base de datos del despliegue que se esté actualizando, puede que haya cambios adicionales en la configuración de la variable de entorno.

Haga clic en Configuración para modificar los valores de las variables de entorno, si es necesario.

(Solo para Oracle GoldenGate for Oracle AI Database), la función de compilación unificada solo necesita que TNS_ADMIN se ajuste al software del cliente de Oracle Database en Oracle GoldenGate.

TNS_ADMIN = Ubicación de tnsnames.ora y sqlnet.ora

La variable de entorno OGG_HOME puede detectar automáticamente DATABASE_HOME, LD_LIBRARY_PATH y JAVA_HOME. Nota: Al actualizar de 21c a 26ai, este paso no es necesario. Si actualiza de Oracle GoldenGate 19c (o anterior) a 26ai, solo necesita la variable de entorno TNS_ADMIN.

(Solo Oracle GoldenGate para SQL Server) Oracle GoldenGate 26ai para SQL Server en Linux incluye un controlador ODBC para la conectividad de la base de datos. Aunque no es necesario, se recomienda utilizar el controlador empaquetado. Para utilizar el controlador empaquetado, se deben crear dos nuevas variables de entorno y se debe actualizar cualquier archivo odbc.ini creado anteriormente.

Agregue las siguientes variables de entorno al despliegue:
- ODBCSYSINI = ${OGG_HOME}/msodbc
- ODBCINI = ${OGG_HOME}/msodbc/odbc.ini
Después de crear las nuevas variables de entorno, copie el archivo odbc.ini existente en la carpeta GoldenGate msodbc y cambie el valor del controlador ODBC de cualquier entrada DSN a lo siguiente:
```
Driver=Microsoft ODBC Driver for SQL Server
```
Haga clic en Enviar para guardar los cambios realizados en las variables de entorno.
Vuelva a la página inicial de Service Manager.
Haga clic en el icono Reiniciar en el campo Acciones del despliegue y haga clic en Aceptar para reiniciar el despliegue.
Vuelva a conectarse al nuevo servicio de administración e inicie todos los Extracts y Replicats.

Si utiliza XAG, vuelva a activar la instancia GoldenGate después de actualizar el despliegue:
```
 $ agctl enable goldengate <GoldenGate Name>
```

Cuando el gestor de servicios y los despliegues se han reiniciado, se completa la actualización.

Nota: Para Oracle GoldenGate for PostgreSQL, consulte Pasos posteriores al cambio de versión antes de iniciar las extracciones.