Migrer les données

Exécutez la commande de migration de base de données avec l'indicateur -eval pour valider les composants et la sortie de migration. Une fois la prévérification terminée, utilisez la même commande sans l'indicateur -eval pour commencer la migration vers le cloud.

Effectuer une prévérification

Exécutez une prévérification pour valider les composants du processus de migration et évaluer la sortie afin de déterminer si des ajustements sont nécessaires.

Il est fortement recommandé d'exécuter d'abord la migration de la base de données en mode d'évaluation pour chaque migration. L'évaluation vous permet de corriger les éventuels problèmes d'installation et de configuration avant d'effectuer la migration réelle sur une base de données de production. En mode d'évaluation, le processus de migration s'exécute sans appliquer les modifications. Il est sûr d'exécuter la commande avec l'option -eval autant de fois que nécessaire avant d'exécuter le travail de migration réel.

Connectez-vous à l'hôte du service Zero Downtime Migration et passez à l'utilisateur installé zdmuser, puis passez au répertoire de base /bin Zero Downtime Migration.
Par exemple, le répertoire de base Zero Downtime Migration peut être /oracle/zdm/grid.
```
su - zdmuser
zdmuser> cd /u01/app/oracle/zdm/grid/bin
```
Exécutez la commande zdmcli migrate database à l'aide de l'indicateur -eval. Définissez la base de données source, le noeud source, le noeud cible, le répertoire de base cible, le nom utilisateur de connexion Oracle Cloud Infrastructure Object Storage, l'emplacement du fichier de réponses et le nom utilisateur de connexion au serveur de base de données cible.
Lors de la définition de la base de données source, utilisez -sourcedb database_unique_name. Si une base de données source à instance unique est déployée sans répertoire de base Grid Infrastructure, utilisez -sourcesid source_oracle_sid au lieu de -sourcedb. Utilisez le nom de domaine qualifié complet pour les noms de serveur de base de données source et cible.

Si une base de données source est configurée pour un portefeuille basé sur PASSWORD, ajoutez l'option -tdekeystorepasswd à la commande et, pour l'invite, indiquez la valeur de mot de passe du fichier de clés TDE de la base de données source.

L'utilisateur de sauvegarde est l'utilisateur Oracle Cloud Infrastructure. Pour rechercher le nom utilisateur ou l'ID de sauvegarde dans la console, accédez à Utilisateur, puis à Profil.
```
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
```
A l'invite, saisissez le mot de passe SYS de la base de données source et le mot de passe de l'utilisateur root du serveur de base de données source. Pour la destination de sauvegarde (bucket), entrez le jeton d'authentification utilisateur Oracle Cloud Infrastructure.
Mot de passe SYSDBA de base de données permettant d'accéder aux bases de données source et cible. Le mot de passe doit être le même pour les deux bases de données. Le mot de passe de l'utilisateur est AUTH TOKEN.
```
Enter source database zdmsdb SYS password:
Enter source user "root" password:
Enter user "backup_user@example.com" password:
```
Un élément jobID apparaît dans la sortie de commande lorsque vous soumettez un travail de migration de base de données. Enregistrez le fichier jobID à utiliser pour interroger le statut du travail.
(Facultatif) Utilisez la commande query job pour vérifier le statut d'un travail.
```
./ zdmcli query job -jobid job-id-number
```
Vérifiez le statut de sortie.
Les journaux de service sont disponibles sur les bases de données source et cible. L'emplacement est répertorié dans la sortie.

Migrer les données avec le service ZDM

Exécutez la commande de migration pour lancer la migration des données. La commande et les paramètres sont identiques à ceux de la prévérification, sans l'indicateur -eval.

Connectez-vous à l'hôte du service Zero Downtime Migration et passez à l'utilisateur installé zdmuser, puis passez au répertoire de base /bin Zero Downtime Migration.
Par exemple, le répertoire de base Zero Downtime Migration peut être /oracle/zdm/grid.
```
su - zdmuser
zdmuser> cd /u01/app/oracle/zdm/grid/bin
```
Exécutez la commande zdmcli migrate database. Définissez la base de données source, le noeud source, le noeud cible, le répertoire de base cible, le nom utilisateur de connexion Oracle Cloud Infrastructure Object Storage, l'emplacement du fichier de réponses et le nom utilisateur de connexion au serveur de base de données cible.
Lors de la définition de la base de données source, utilisez -sourcedb database_unique_name. Si une base de données source à instance unique est déployée sans répertoire de base Grid Infrastructure, utilisez -sourcesid source_oracle_sid au lieu de -sourcedb. Utilisez le nom de domaine qualifié complet pour les noms de serveur de base de données source et cible.

Si une base de données source est configurée pour un portefeuille basé sur PASSWORD, ajoutez l'option -tdekeystorepasswd à la commande et, pour l'invite, indiquez la valeur de mot de passe du fichier de clés TDE de la base de données source.

L'utilisateur de sauvegarde est l'utilisateur Oracle Cloud Infrastructure. Pour rechercher le nom utilisateur ou l'ID de sauvegarde dans la console, accédez à Utilisateur, puis à Profil.
```
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
```
A l'invite, saisissez le mot de passe SYS de la base de données source et le mot de passe de l'utilisateur root du serveur de base de données source. Pour la destination de sauvegarde (bucket), entrez le jeton d'authentification utilisateur Oracle Cloud Infrastructure.
Mot de passe SYSDBA de base de données permettant d'accéder aux bases de données source et cible. Le mot de passe doit être le même pour les deux bases de données.
```
Enter source database zdmsdb SYS password:
Enter source user "root" password:
Enter user "backup_user@example.com" password:
```
Un élément jobID apparaît dans la sortie de commande lorsque vous soumettez un travail de migration de base de données. Enregistrez jobID pour interroger le statut du travail.
(Facultatif) Utilisez la commande query job pour vérifier le statut d'un travail.
Les journaux de service sont disponibles sur les bases de données source et cible. L'emplacement est répertorié dans la sortie.
```
./ zdmcli query job -jobid job-id-number
```

Dépannage de la migration

Si votre travail de migration rencontre une erreur, reportez-vous aux journaux de sortie du travail de migration, aux journaux du service Zero Downtime Migration et aux journaux de phase opérationnelle propres au serveur présents sur les serveurs de base de données source ou cible respectifs.

Si le travail de migration rencontre une exception, les journaux peuvent fournir une indication de la nature de l'erreur. Les journaux des procédures de migration exécutées dans les environnements source et cible sont stockés sur les serveurs dans les environnements source et cible respectifs. L'emplacement du fichier journal est inclus dans la sortie de migration et dans la sortie lorsque vous interrogez le statut d'un travail.

Le tableau suivant répertorie les phases de migration et la description de chaque nom de phase.

Nom de phase	Description
ZDM_GET_SRC_INFO	Repérer des informations sur la base de données source
ZDM_GET_TGT_INFO	Repérer des informations sur la base de données cible
ZDM_SETUP_SRC	Configurer les modules d'aide ZDM sur le serveur source
ZDM_SETUP_TGT	Configurer des modules d'aide ZDM sur le serveur cible
ZDM_PREUSERACTIONS	Exécuter les actions de pré-utilisateur de migration, le cas échéant, à la source
ZDM_PREUSERACTIONS_TGT	Exécuter les actions de pré-utilisateur de migration, le cas échéant, sur la cible
ZDM_OBC_INST_SRC	Installation du module Oracle Database Cloud Backup à la source
ZDM_OBC_INST_TGT	Installation du module Oracle Database Cloud Backup sur la cible
ZDM_GEN_RMAN_PASSWD	Générer un mot de passe aléatoire pour le cryptage de la sauvegarde Oracle Recovery Manager (RMAN)
ZDM_BACKUP_FULL_SRC	Effectuer une sauvegarde complète de la base de données source
ZDM_BACKUP_INCREMENTAL_SRC	Effectuer une sauvegarde incrémentielle de la base de données source
ZDM_VALIDATE_SRC	Effectuer des validations à la source
ZDM_VALIDATE_TGT	Effectuer des validations sur la cible
ZDM_DISCOVER_SRC	Effectuer le repérage de base de données à la source pour configurer Oracle Data Guard
ZDM_COPYFILES	Copier le fichier de mots de passe Oracle et les portefeuilles Transparent Data Encryption (TDE) de la source vers la cible
ZDM_OSS_STANDBY_SETUP_TDE_TGT	Copier les fichiers de portefeuille TDE de la source vers l'emplacement de clé de remplacement cible
ZDM_PREPARE_TGT	Préparer la cible pour la création de la base de données de secours Oracle Data Guard
ZDM_CLONE_TGT	Création d'une base de données de secours Oracle Data Guard à partir de la sauvegarde cloud
ZDM_FINALIZE_TGT	Finaliser la préparation de la base de données de secours Oracle Data Guard de la cible
ZDM_CONFIGURE_DG_SRC	Inscrire la base de données de secours cloud auprès de la source
ZDM_SWITCHOVER_SRC	Lancer des actions de permutation à la source
ZDM_SWITCHOVER_TGT	Effectuer des actions de permutation au niveau de la cible
ZDM_POSTUSERACTIONS	Effectuer toutes les actions utilisateur post-migration à la source
ZDM_POSTUSERACTIONS_TGT	Effectuer toutes les actions utilisateur post-migration sur la cible
ZDM_CLEANUP_SRC	Effectuer le nettoyage au niveau de la source
ZDM_CLEANUP_TGT	Effectuer le nettoyage sur la cible
ZDM_POSTUSERACTIONS_TGT	Effectuer toutes les actions utilisateur post-migration sur la cible

Si le service Zero Downtime Migration ne démarre pas, vérifiez les erreurs de démarrage de processus dans les journaux du service Zero Downtime Migration afin de déterminer la cause de l'erreur signalée. Le journal du service Zero Downtime Migration se trouve à l'adresse $ZDM_BASE/crsdata/zdm_service_node/rhp/rhpserver.log.0.
Utilisez la commande query job pour vérifier le statut d'un travail.
Les journaux de service sont disponibles sur les bases de données source et cible. L'emplacement est répertorié dans la sortie.
```
./ zdmcli query job -jobid job-id-number
```
Déterminez la phase opérationnelle dans laquelle le travail de migration se trouvait au moment de l'échec et indiquez si la phase appartient à la base de données source ou cible.
Consultez le journal de l'hôte du service Zero Downtime Migration dans $ZDM_BASE/crsdata/zdm_service_node/rhp/rhpserver.log.0 et accédez au serveur source ou cible respectif pour consulter le journal associé à la phase opérationnelle dans le répertoire /tmp/zdm-unique id/zdm/log.

Pour plus d'informations sur le dépannage de Zero Downtime Migration et des problèmes connus dans la version actuelle, reportez-vous aux notes sur la version de Zero Downtime Migration.