Despliegue instantáneo de Oracle ZDM 26.1: clonación completa de PDB física con Oracle Key Vault (OKV)

Introducción

Oracle Zero Downtime Migration (ZDM) 26.1 presenta Instant Deploy, que permite migraciones de bases de datos directamente desde el host de la base de datos de origen o destino sin necesidad de un servidor ZDM dedicado. Esta versión también mejora la integración con Oracle Key Vault (OKV) y mejora las capacidades de migración de cartera de cifrado de datos transparente (TDE).

Limitaciones en versiones anteriores de ZDM

Antes de Oracle ZDM 26.1:

Novedades de ZDM 26.1

ZDM 26.1 admite los siguientes escenarios de migración de cartera:

ZDM 26.1 detecta si la base de datos de origen está configurada para utilizar una cartera de OKV y descarga las claves de TDE antes de migrarlas a la base de datos de destino. Si la base de datos de destino también está configurada con una cartera de OKV, ZDM carga las claves de TDE migradas en la cartera de OKV de destino. Deje el parámetro ZDM_SKIP_TDE_WALLET_MIGRATION en su valor por defecto (FALSE) para permitir que ZDM migre automáticamente la cartera de TDE durante el flujo de trabajo de migración.

image

Objetivos

Compatibilidad entre Versiones

En este tutorial se muestra Oracle Zero Downtime Migration (ZDM) 26.1 Instant Deploy con Oracle AI Database 26ai y Oracle Key Vault (OKV) 21.14 para la clonación completa de PDB física y la migración automática de cartera de TDE.

El flujo de trabajo principal de este tutorial se validó mediante:

Nota: Algunas secciones de este tutorial se aplican solo a versiones anteriores de Oracle Database con fines de referencia. Estas secciones están claramente marcadas como Sólo 12.1 o Sólo 18c y 19c y se pueden omitir al utilizar Oracle AI Database 26ai.

Entorno actual antes de la migración

Antes de iniciar el flujo de trabajo de Oracle Zero Downtime Migration (ZDM), verifique que tanto el entorno de origen como el de destino estén configurados correctamente para la clonación de PDB física. En la siguiente tabla se resume el entorno utilizado en este tutorial y el estado de los componentes clave antes de la migración.

image

Requisitos

Nota: Asegúrese de que el entorno cumple todos los requisitos de Oracle Zero Downtime Migration (ZDM) 26.1 antes de iniciar este tutorial. Consulte la sección Preparación para Database Migration de la documentación de Oracle ZDM para obtener la lista completa de requisitos:

https://docs.oracle.com/en/database/oracle/zero-downtime-migration/26.1/zdmug/preparing-for-database-migration.html#GUID-25B07C59-8143-41CB-B431-3D9225CCFDD6

Configuración de la implementación instantánea de Oracle Zero Downtime Migration (ZDM) 26.1

Medio ambiente

Para fines de demostración, este tutorial utiliza OCI Oracle Base Database Service con Oracle AI Database 26ai, versión 23.26.2.0.0.

Origen: nombre de host: sourcedb, nombre de base de datos: ORADB, nombre único de base de datos: ORADB_src TDE está gestionado por Oracle Key Vault (OKV).

image image

Destino: nombre de host: targetdb, nombre de base de datos: ORADB, nombre único de base de datos: ORADB_tgt TDE utiliza una cartera basada en archivos.

image image

Flujo de trabajo de migración

Paso 1: Descargue la última versión de Oracle Zero Downtime Migration (ZDM) 26.1 desde la página de producto de Oracle ZDM (versión 26.1).

Descargue el software más reciente de Oracle Zero Downtime Migration (ZDM) 26.1 desde la página de descarga de Oracle Zero Downtime Migration. El software se distribuye a través de Oracle Software Delivery Cloud (OSDC). Inicie sesión con su cuenta de Oracle Single Sign-On (SSO), acepte el acuerdo de licencia y descargue el último paquete de versión de ZDM (por ejemplo, V1055491-01.zip). Para obtener la última descarga y documentación, consulte los siguientes recursos:

Oracle Zero Downtime Migration Download:
https://www.oracle.com/database/technologies/rac/zdm-downloads.html
Oracle Zero Downtime Migration 26.1 Documentation:
https://docs.oracle.com/en/database/oracle/zero-downtime-migration/26.1/index.html

Paso 2. Copie el archivo V1055491-01.zip en un directorio con suficiente almacenamiento libre.

Después de descargar el software, copie el archivo ZIP en el host de la base de datos de origen (o en el host de destino si tiene previsto utilizar Instant Deploy desde el destino) y continúe con la extracción en el siguiente paso.

image

Al extraer el archivo ZIP se crea el subdirectorio zdm26.1. El software ZDM extraído se encuentra en /opt/opc/zdm/zdm26.1.

Paso 3: Actualice el archivo /etc/hosts en cada host con el nombre y la dirección IP del otro host.

Agregue el nombre de host de origen y la información de IP al archivo /etc/hosts del host de destino.

image

Agregue el nombre de host de destino y la información de IP al archivo /etc/hosts del host de origen.

image

Paso 4: Copie la clave pública SSH para el usuario del sistema operativo (en este caso, opc) en el host de origen y agréguela al archivo authorized_keys para el usuario del sistema operativo (en este caso, también opc) en el host de destino.

En host de origen

image

En host de destino

image

Pruebe la conectividad SSH desde el origen al host de la base de datos destino:

image

Verifique que TTY esté desactivado para el usuario con privilegios SSH. Si TTY está desactivado, el siguiente comando devuelve la fecha del host remoto sin errores:

image

Paso 5: Verifique que Oracle Key Vault (OKV) gestiona TDE en la base de datos de origen.

image

Paso 6: Configurar Oracle Key Vault (OKV) para la base de datos de destino.

1: Registro de la Base de Datos de Destino como Punto Final de Oracle Key Vault (OKV).

image

image

2: Copia del Token de Inscripción de Oracle Key Vault (OKV).

image

3: Inscripción del Punto Final de la Base de Datos de Destino y Descarga del Software de Punto Final de Oracle Key Vault (OKV).

image image

4: Creación de los Directorios Necesarios para OKV en el Host de Destino:

image

5: Instalación del Archivo JAR de Punto Final de Oracle Key Vault:

image image

6: Asignación de la Cartera Virtual de Origen al Punto Final de Destino:

image image image

7: Carga de Carteras Actuales en Oracle Key Vault (OKV) (Migración de Cartera Basada en Archivos a OKV):

Una vez que se haya verificado la conexión a OKV, cargue las carteras actuales en OKV. Para verificar la ubicación actual de WALLET_ROOT, ejecute la siguiente consulta:

image

Después de identificar la ubicación de la cartera, copie las carteras existentes en WALLET_ROOT/tde:

image

Una vez que se haya completado la copia, cargue las carteras en OKV mediante WALLET_ROOT/okv/bin/okvutil con las carteras almacenadas en WALLET_ROOT/tde:

image

8: Adición de la Contraseña de OKV al Almacén de Claves para Activar la Conexión Automática al Almacén de Claves de OKV. (EJECUTAR EN TODOS LOS NODOS):

image

9: Adición de una Clave Secreta para Utilizar el Almacén Externo (EJECUTAR EN TODOS los Nodos):

image

10: Actualización de Parámetros de Inicialización de la Base de Datos:

Actualice los parámetros de inicialización wallet_root y tde_configuration para el uso de OKV. Tenga en cuenta que el parámetro de inicialización tde_configuration depende del parámetro wallet_root. Dado que el parámetro wallet_root tiene un ámbito SPFILE, es necesario reiniciar la base de datos para que se apliquen los cambios.

Además, al definir wallet_root y tde_configuration, se sustituye el valor ENCRYPTION_WALLET_LOCATION en sqlnet.ora.

Antes de actualizar los parámetros de inicialización de la base de datos, ejecute una copia de seguridad del archivo spfile.

image

11: Configuración del Entorno de la Base de Datos RAC y sqlnet.ora (SOLO 12.1):

Dado que los parámetros wallet_root y tde_configuration init.ora no existen en la versión 12.1, debemos realizar cambios en sqlnet.ora y en la configuración del entorno de la base de datos RAC.

Sqlnet.ora:

Change only the method under the ENCRYPTION_WALLET_LOCATION entry to HSM:

ENCRYPTION_WALLET_LOCATION=
(SOURCE=
(METHOD=HSM)
(METHOD_DATA=(DIRECTORY=/var/opt/oracle/dbaas_acfs/DBNAME/tde_wallet)))

Valores del Entorno de la Base de Datos RAC: Agregue las variables de entorno ORACLE_BASE y ORACLE_UNQNAME a los valores del entorno de la base de datos RAC:

[opc@targetdb ~]$ srvctl getenv database -d DBNAMEUNIQUE
DBNAMEUNIQUE:
TNS_ADMIN=/u02/app/oracle/product/12.1.0/dbhome_1/network/admin/DBNAME
bash-3.2$ srvctl setenv database -d DBNAMEUNIQUE -T "ORACLE_BASE=/u02/app/oracle"
bash-3.2$ srvctl setenv database -d DBNAMEUNIQUE -T "ORACLE_UNQNAME=DBNAMEUNIQUE"
bash-3.2$ srvctl getenv database -d DBNAMEUNIQUE

12: Reiniciar la Base de Datos.

[opc@targetdb ~]$ srvctl stop database -d DBNAMEUNIQUE
[opc@targetdb ~]$ srvctl start database -d DBNAMEUNIQUE

13: Migración del almacén de claves de TDE a Oracle Key Vault (OKV).

Ejecute el siguiente comando en un nodo de base de datos para migrar el almacén de claves de software de TDE a Oracle Key Vault (OKV).

SQL>ADMINISTER KEY MANAGEMENT set key identified by "<OKV-pwd>" force keystore migrate using "TDE-wallet-password";

image

Una vez que el comando se devuelva correctamente, reinicie la base de datos para verificar que la comunicación con Oracle Key Vault funciona correctamente:

[opc@targetdb ~]$ srvctl stop database -d DBNAMEUNIQUE
[opc@targetdb ~]$ srvctl start database -d DBNAMEUNIQUE

14: Verificación de la Configuración de Oracle Key Vault (OKV)

Ejecute las siguientes consultas para verificar que la configuración de Oracle Key Vault (OKV) está configurada correctamente y que la base de datos puede acceder al almacén de claves externo.

image

Paso 7: Cree el archivo de respuesta ZDM en el host de la base de datos origen. Este archivo define la configuración de migración, incluida la información de la base de datos de origen y destino, los parámetros de Oracle Key Vault (OKV) y los valores de clonación de PDB física.

En el siguiente ejemplo, se muestra el archivo de respuesta utilizado para esta migración:

[opc@sourcedb ~]$ more /opt/opc/zdm/zdm26.1/template/26.1.0/zdm_physical_PDB_Cloning.rsp
ZDM_SRC_DB_OKV_HOME=/u01/app/oracle/admin/ORADB_src/okv_home/okv
ZDM_TGT_DB_OKV_HOME=/u01/app/oracle/admin/ORADB_tgt/okv_home/okv
ZDM_SRC_DB_OKV_VIRTUAL_WALLET_NAME=sourcedbwallet
ZDM_TGT_DB_OKV_VIRTUAL_WALLET_NAME=sourcedbwallet
ZDM_SKIP_TDE_WALLET_MIGRATION=FALSE
PLATFORM_TYPE=VMDB
TGT_DB_UNIQUE_NAME=ORADB_tgt
MIGRATION_METHOD=ONLINE_PHYSICAL
DATA_TRANSFER_MEDIUM=DBLINK
ZDM_PDB_CLONE_METHOD=REFRESHABLE
ZDM_SRC_PDB_NAME=ORADB_PDB1
ZDM_TGT_PDB_NAME=ORADB_PDB1
ZDM_TGT_DBLINK_NAME=clonedblink
ZDM_TGT_DBLINK_USERNAME=
ZDM_TGT_DBLINK_PASSWORD_WALLET=
ZDM_PDB_REFRESH_INTERVAL=60
ZDM_SWITCHOVER=FALSE
ZDM_SRC_DB_RESTORE_SERVICE_NAME=ORADB_PDB1

Paso 8: Ejecute el siguiente comando en el host de la base de datos de origen para evaluar la migración y validar que los entornos de origen y destino están listos para la migración.

[opc@sourcedb ~]$ /opt/opc/zdm/zdm26.1/zdmcli migrate database \
> -rsp /opt/opc/zdm/zdm26.1/template/26.1.0/zdm_physical_PDB_Cloning.rsp \
> -sourcedb ORADB_src \
> -sourcenode sourcedb \
> -targethome /u01/app/oracle/product/23.0.0.0/dbhome_1 \
> -tdekeystorepasswd \
> -tgttdekeystorepasswd \
> -targetnode targetdb \
> -schedule NOW \
> -eval
Enter source database ORADB_src SYS password:
Enter source database ORADB_src TDE keystore password:
Enter target container database TDE keystore password:
Migration evaluation job started
Result file path: /opt/opc/zdm/zdm26.1/zdmbase/chkbase/scheduled/job-6-2026-06-27-09:08:10.log
======================JOB_EXECUTION_DETAILS_START======================
User: opc
Client: dbSysyabixhpq
 ...............................................
 .........................

Nota:

Si la contraseña de punto final de Oracle Key Vault (OKV) es la misma que la contraseña de almacén de claves de TDE, las opciones -tdekeystorepasswd y -tgttdekeystorepasswd son suficientes.

Si la contraseña de punto final de OKV es diferente de la contraseña de almacén de claves de TDE, también especifique las siguientes opciones:

Estas opciones permiten a ZDM autenticarse con los puntos finales de Oracle Key Vault independientemente de las contraseñas del almacén de claves de TDE durante la migración de la cartera.

Verifique el estado del trabajo de migración, como se muestra a continuación.

image

Paso 9: Inicie la migración y utilice la opción -pauseafter para detener la migración después de la fase ZDM_CLONE_PDB_TGT. Durante esta fase, los cambios realizados en la PDB de origen se sincronizan con la PDB de destino en el intervalo especificado por ZDM_PDB_REFRESH_INTERVAL.

image

Paso 10: Verifique el estado del trabajo de migración.

image

Verifique el estado de la PDB de destino.

image

Paso 11: Reanude el trabajo de migración cuando esté listo para realizar el switchover final de la aplicación.

[opc@sourcedb ~]$ /opt/opc/zdm/zdm26.1/zdmcli resume job -jobid 6

image

Verifique el estado de la PDB de destino después de que finalice la migración:

image

Verificar migración automática de cartera de TDE

El siguiente log muestra que ZDM descarga automáticamente la cartera de TDE de Oracle Key Vault (OKV) en el host de la base de datos origen:

image

Referencias

Acuses de recibo

Autor: Amresh Kumar Singh (consultor principal)

Más recursos de aprendizaje

Explore otros laboratorios en docs.oracle.com/learn o acceda a más contenido de aprendizaje gratuito en el canal de YouTube de Oracle Learning. Además, visite education.oracle.com/learning-explorer para convertirse en un explorador de Oracle Learning.

Para obtener documentación sobre el producto, visite Oracle Help Center.