Migrar los datos

Ejecute el comando de migración de base de datos con el indicador -eval para validar los componentes y la salida de la migración. Cuando la comprobación previa se complete correctamente, utilice el mismo comando sin el indicador -eval para comenzar la migración a la nube.

Realización de una comprobación previa

Ejecute una comprobación previa para validar los componentes del proceso de migración y evalúe la salida para determinar si se necesitan ajustes.

Se recomienda encarecidamente que, para cada migración, ejecute primero la migración de base de datos en modo de evaluación. La evaluación permite corregir posibles problemas en la configuración antes de realizar la migración real en una base de datos de producción. En el modo de evaluación, el proceso de migración se ejecuta sin afectar los cambios. Es seguro ejecutar el comando con la opción -eval tantas veces como sea necesario antes de ejecutar el trabajo de migración real.

Inicie sesión en el host del servicio Zero Downtime Migration y cambie al usuario instalado zdmuser y, a continuación, cambie al directorio raíz /bin de Zero Downtime Migration.
Por ejemplo, el directorio raíz de Zero Downtime Migration puede ser /oracle/zdm/grid.
```
su - zdmuser
zdmuser> cd /u01/app/oracle/zdm/grid/bin
```
Ejecute el comando zdmcli migrate database mediante el indicador -eval. Defina la base de datos de origen, el nodo de origen, el nodo de destino, el directorio raíz de destino, el nombre de usuario de conexión de Oracle Cloud Infrastructure Object Storage, la ubicación del archivo de respuesta y el nombre de usuario de conexión del servidor de base de datos de destino.
Al definir la base de datos origen, utilice -sourcedb database_unique_name. Si se despliega una base de datos de instancia única de origen sin un directorio raíz de Grid Infrastructure, utilice -sourcesid source_oracle_sid en lugar de -sourcedb. Utilice el nombre de dominio completo (FQDN) para los nombres de servidor de base de datos de origen y destino.

Si se configura una base de datos de origen para una cartera basada en PASSWORD, agregue la opción -tdekeystorepasswd al comando y, para la petición de datos, especifique el valor de contraseña del almacén de claves de TDE de la base de datos de origen.

El usuario de copia de seguridad es el usuario de Oracle Cloud Infrastructure. Para buscar el nombre de usuario o ID de copia de seguridad en la consola, vaya a Usuario y, a continuación, a Perfil.
```
zdmuser> ./zdmcli migrate database -sourcesid source_oracle_sid \.
-sourcenode source_FQDN_database_server_name 
-srcauth zdmauth \
-srcarg1 user: opc \
-srcarg2 identity file: /home/zdmuser/.ssh/zdm_service_tool.ppk
-srcarg3 sudo_location: /usr/bin/sudo \
-targetnode target_FQDN_database_server_name \
-targethome target_database_ORACLE_HOME \  
-backupuser Object_store_login_user_name \  
-rsp response_file_location
-tgtauth zdmauth 
-tgtarg1 user:target_database_server_login_user_name 
-tgtarg2 identity_file:/home/zdmuser/.ssh/zdm_service_tool.ppk \
-tgtarg3 sudo_location:/usr/bin/sudo 
-ignore ALL -eval
```
Cuando se le solicite, introduzca la contraseña SYS de la base de datos origen y la contraseña del usuario root del servidor de la base de datos origen. En el destino de copia de seguridad (cubo), introduzca el token de autenticación de usuario de Oracle Cloud Infrastructure.
Contraseña SYSDBA de la base de datos para acceder a las bases de datos de origen y destino. La contraseña debe ser la misma para ambas bases de datos. La contraseña de usuario es AUTH TOKEN.
```
Enter source database zdmsdb SYS password:
Enter source user "root" password:
Enter user "backup_user@example.com" password:
```
Se muestra jobID en la salida del comando al ejecutar un trabajo de migración de base de datos. Guarde jobID para utilizarlo para consultar el estado del trabajo.
(Opcional) Utilice el comando query job para comprobar el estado de un trabajo.
```
./ zdmcli query job -jobid job-id-number
```
Revise el estado de salida.
Los logs de servicio están disponibles en las bases de datos de origen y destino. La ubicación se muestra en la salida.

Migrar los datos con el servicio ZDM

Ejecute el comando de migración para iniciar la migración de datos. El comando y los parámetros son los mismos que la comprobación previa, sin el indicador -eval.

Inicie sesión en el host del servicio Zero Downtime Migration y cambie al usuario instalado zdmuser y, a continuación, cambie al directorio raíz /bin de Zero Downtime Migration.
Por ejemplo, el directorio raíz de Zero Downtime Migration puede ser /oracle/zdm/grid.
```
su - zdmuser
zdmuser> cd /u01/app/oracle/zdm/grid/bin
```
Ejecute el comando zdmcli migrate database. Defina la base de datos de origen, el nodo de origen, el nodo de destino, el directorio raíz de destino, el nombre de usuario de conexión de Oracle Cloud Infrastructure Object Storage, la ubicación del archivo de respuesta y el nombre de usuario de conexión del servidor de base de datos de destino.
Al definir la base de datos origen, utilice -sourcedb database_unique_name. Si se despliega una base de datos de instancia única de origen sin un directorio raíz de Grid Infrastructure, utilice -sourcesid source_oracle_sid en lugar de -sourcedb. Utilice el nombre de dominio completo (FQDN) para los nombres de servidor de base de datos de origen y destino.

Si se configura una base de datos de origen para una cartera basada en PASSWORD, agregue la opción -tdekeystorepasswd al comando y, para la petición de datos, especifique el valor de contraseña del almacén de claves de TDE de la base de datos de origen.

El usuario de copia de seguridad es el usuario de Oracle Cloud Infrastructure. Para buscar el nombre de usuario o ID de copia de seguridad en la consola, vaya a Usuario y, a continuación, a Perfil.
```
zdmuser> ./zdmcli migrate database -sourceid source_db_ID \.
-sourcenode source_database_server_name 
-srcauth zdmauth \
-srcarg1 user: opc \
-srcarg2 identity file: /home/zdmuser/.ssh/zdm_service_tool.ppk
-srcarg3 sudo_location: /usr/bin/sudo \
-targetnode target_database_server_name \
-targethome target_database_ORACLE_HOME \  
-backupuser Object_store_login_user_name \  
-rsp response_file_location
-tgtauth zdmauth 
-tgtarg1 user:target_database_server_login_user_name 
-tgtarg2 identity_file:/home/zdmuser/.ssh/zdm_service_tool.ppk \
-tgtarg3 sudo_location:/usr/bin/sudo \
-ignore ALL
```
Cuando se le solicite, introduzca la contraseña SYS de la base de datos origen y la contraseña del usuario root del servidor de la base de datos origen. En el destino de copia de seguridad (cubo), introduzca el token de autenticación de usuario de Oracle Cloud Infrastructure.
Contraseña SYSDBA de la base de datos para acceder a las bases de datos de origen y destino. La contraseña debe ser la misma para ambas bases de datos.
```
Enter source database zdmsdb SYS password:
Enter source user "root" password:
Enter user "backup_user@example.com" password:
```
Se muestra jobID en la salida del comando al ejecutar un trabajo de migración de base de datos. Guarde jobID para consultar el estado del trabajo.
(Opcional) Utilice el comando query job para comprobar el estado de un trabajo.
Los logs de servicio están disponibles en las bases de datos de origen y destino. La ubicación se muestra en la salida.
```
./ zdmcli query job -jobid job-id-number
```

Resolución de problemas de migración

Si el trabajo de migración encuentra un error, consulte los logs de salida del trabajo de migración, los logs del servicio Zero Downtime Migration y los logs de fase operativa específicos del servidor presentes en los respectivos servidores de base de datos de origen o destino.

Si el trabajo de migración encuentra una excepción, los logs pueden proporcionar alguna indicación de la naturaleza del fallo. Los logs de los procedimientos de migración ejecutados en los entornos de origen y destino se almacenan en los servidores de los respectivos entornos de origen y destino. La ubicación del archivo log se incluye en la salida de migración y en la salida al consultar el estado de un trabajo.

En la siguiente tabla, se muestran las fases de migración y la descripción de cada nombre de fase.

Nombre de la Fase	Descripción
ZDM_GET_SRC_INFO	Detectar información sobre la base de datos origen
ZDM_GET_TGT_INFO	Detectar información sobre la base de datos destino
ZDM_SETUP_SRC	Configurar módulos auxiliares de ZDM en el servidor de origen
ZDM_SETUP_TGT	Configurar módulos auxiliares de ZDM en el servidor de destino
ZDM_PREUSERACTIONS	Ejecutar acciones de usuario previo de migración, si las hay, en el origen
ZDM_PREUSERACTIONS_TGT	Ejecutar acciones de usuario previo de migración, si las hay, en el destino
ZDM_OBC_INST_SRC	Instalación del módulo de Oracle Database Cloud Backup en el origen
ZDM_OBC_INST_TGT	Instalación del módulo de Oracle Database Cloud Backup en el destino
ZDM_GEN_RMAN_PASSWD	Generar contraseña aleatoria para cifrar la copia de seguridad de Oracle Recovery Manager (RMAN)
ZDM_BACKUP_FULL_SRC	Realice una copia de seguridad completa de la base de datos origen
ZDM_BACKUP_INCREMENTAL_SRC	Realizar una copia de seguridad incremental de la base de datos origen
ZDM_VALIDATE_SRC	Realizar validaciones en el origen
ZDM_VALIDATE_TGT	Realizar validaciones en el destino
ZDM_DISCOVER_SRC	Realizar la detección de bases de datos en el origen para configurar Oracle Data Guard
ZDM_COPYFILES	Copiar el archivo de contraseñas de Oracle y las carteras de cifrado de datos transparente (TDE) del origen al destino
ZDM_OSS_STANDBY_SETUP_TDE_TGT	Copie los archivos de cartera de TDE del origen a la ubicación de keystone de destino.
ZDM_PREPARE_TGT	Preparar el destino para la creación de la base de datos en espera de Oracle Data Guard
ZDM_CLONE_TGT	Crear una base de datos en espera de Oracle Data Guard a partir de la copia de seguridad en la nube
ZDM_FINALIZE_TGT	Finalizar la preparación en espera de Oracle Data Guard del destino
ZDM_CONFIGURE_DG_SRC	Registrar la base de datos en espera en la nube con el origen
ZDM_SWITCHOVER_SRC	Iniciar acciones de switchover en el origen
ZDM_SWITCHOVER_TGT	Complete las acciones de switchover en el destino
ZDM_POSTUSERACTIONS	Realizar cualquier acción de usuario posterior a la migración en el origen
ZDM_POSTUSERACTIONS_TGT	Realizar cualquier acción de usuario posterior a la migración en el destino
ZDM_CLEANUP_SRC	Realizar limpieza en el origen
ZDM_CLEANUP_TGT	Realizar limpieza en el destino
ZDM_POSTUSERACTIONS_TGT	Realizar cualquier acción de usuario posterior a la migración en el destino

Si el servicio Zero Downtime Migration no se inicia, compruebe los logs del servicio Zero Downtime Migration en busca de errores de inicio del proceso para determinar la causa del error informado. El log del servicio Zero Downtime Migration se encuentra en $ZDM_BASE/crsdata/zdm_service_node/rhp/rhpserver.log.0.
Utilice el comando query job para comprobar el estado de un trabajo.
Los logs de servicio están disponibles en las bases de datos de origen y destino. La ubicación se muestra en la salida.
```
./ zdmcli query job -jobid job-id-number
```
Determine en qué fase operativa se encontraba el trabajo de migración en el momento del fallo y si la fase pertenece a la base de datos de origen o de destino.
Compruebe el log de host del servicio Zero Downtime Migration en $ZDM_BASE/crsdata/zdm_service_node/rhp/rhpserver.log.0 y acceda al servidor de origen o de destino correspondiente para comprobar el log asociado a la fase operativa en el directorio /tmp/zdm-unique id/zdm/log.

Para obtener más información sobre la resolución de problemas de Zero Downtime Migration y problemas conocidos en la versión actual, consulte las Notas de la versión de Zero Downtime Migration.