Migrar os Dados

Execute o comando migrar banco de dados com o flag -eval para validar os componentes de migração e a saída. Quando a pré-verificação for concluída com sucesso, use o mesmo comando sem o flag -eval para começar a migrar para a nuvem.

Executar uma Pré-verificação

Execute uma pré-verificação para validar os componentes do processo de migração e avaliar a saída para determinar se os ajustes são necessários.

É altamente recomendável que, para cada migração executada, migre o banco de dados primeiro no modo de avaliação. A avaliação permite corrigir possíveis problemas na configuração e na configuração antes de executar a migração real em um banco de dados de produção. No modo de avaliação, o processo de migração é executado sem afetar as alterações. É seguro executar o comando com a opção -eval quantas vezes forem necessárias antes de executar o job de migração real.

Faça log-in no host do serviço Zero Downtime Migration e alterne para o usuário instalado zdmuser e, em seguida, altere para o diretório home /bin do Zero Downtime Migration.
Por exemplo, o diretório home do Zero Downtime Migration pode ser /oracle/zdm/grid.
```
su - zdmuser
zdmuser> cd /u01/app/oracle/zdm/grid/bin
```
Execute o comando zdmcli migrate database usando o flag -eval. Defina o banco de dados de origem, o nó de origem, o nó de destino, o home de destino, o nome do usuário de log-in do Oracle Cloud Infrastructure Object Storage, o local do arquivo de resposta e o nome do usuário de log-in do servidor de banco de dados de destino.
Ao definir o banco de dados de origem, use -sourcedb database_unique_name. Se um banco de dados de instância única de origem for implantado sem um home do Grid Infrastructure, use -sourcesid source_oracle_sid em vez de -sourcedb. Use o nome de domínio totalmente qualificado (FQDN) para os nomes de servidor do banco de dados de origem e de destino.

Se um banco de dados de origem estiver configurado para uma wallet baseada em PASSWORD, adicione a opção -tdekeystorepasswd ao comando e, para o prompt, especifique o valor da senha do armazenamento de chaves TDE do banco de dados de origem.

O usuário de backup é o usuário do Oracle Cloud Infrastructure. Para localizar o nome ou o ID do usuário de backup na Console, vá para Usuário e, em seguida, 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
```
Quando solicitado, informe a senha SYS do banco de dados de origem e a senha do usuário raiz do servidor de banco de dados de origem. Para o destino de backup (bucket), informe o token de autenticação do usuário do Oracle Cloud Infrastructure.
A senha SYSDBA do BD para acessar os bancos de dados de origem e de destino. A senha deve ser a mesma para ambos os bancos de dados. A senha do usuário é AUTH TOKEN.
```
Enter source database zdmsdb SYS password:
Enter source user "root" password:
Enter user "backup_user@example.com" password:
```
Um jobID é exibido na saída do comando quando você submete um job de migração de banco de dados. Salve o jobID a ser usado para consultar o status do job.
(Opcional) Use o comando do job de consulta para verificar o status de um job.
```
./ zdmcli query job -jobid job-id-number
```
Verifique o status da saída.
Os logs de serviço estão disponíveis nos bancos de dados de origem e destino. O local é listado na saída.

Migrar os Dados com o Serviço ZDM

Execute o comando de migração para iniciar a migração de dados. O comando e os parâmetros são iguais à pré-verificação, sem o flag -eval.

Faça log-in no host do serviço Zero Downtime Migration e alterne para o usuário instalado zdmuser e, em seguida, altere para o diretório home /bin do Zero Downtime Migration.
Por exemplo, o diretório home do Zero Downtime Migration pode ser /oracle/zdm/grid.
```
su - zdmuser
zdmuser> cd /u01/app/oracle/zdm/grid/bin
```
Execute o comando zdmcli migrate database. Defina o banco de dados de origem, o nó de origem, o nó de destino, o home de destino, o nome do usuário de log-in do Oracle Cloud Infrastructure Object Storage, o local do arquivo de resposta e o nome do usuário de log-in do servidor de banco de dados de destino.
Ao definir o banco de dados de origem, use -sourcedb database_unique_name. Se um banco de dados de instância única de origem for implantado sem um home do Grid Infrastructure, use -sourcesid source_oracle_sid em vez de -sourcedb. Use o nome de domínio totalmente qualificado (FQDN) para os nomes de servidor do banco de dados de origem e de destino.

Se um banco de dados de origem estiver configurado para uma wallet baseada em PASSWORD, adicione a opção -tdekeystorepasswd ao comando e, para o prompt, especifique o valor da senha do armazenamento de chaves TDE do banco de dados de origem.

O usuário de backup é o usuário do Oracle Cloud Infrastructure. Para localizar o nome ou o ID do usuário de backup na Console, vá para Usuário e, em seguida, 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
```
Quando solicitado, informe a senha SYS do banco de dados de origem e a senha do usuário raiz do servidor de banco de dados de origem. Para o destino de backup (bucket), informe o token de autenticação do usuário do Oracle Cloud Infrastructure.
A senha SYSDBA do BD para acessar os bancos de dados de origem e de destino. A senha deve ser a mesma para ambos os bancos de dados.
```
Enter source database zdmsdb SYS password:
Enter source user "root" password:
Enter user "backup_user@example.com" password:
```
Um jobID é exibido na saída do comando quando você submete um job de migração de banco de dados. Salve jobID para consultar o status do job.
(Opcional) Use o comando do job de consulta para verificar o status de um job.
Os logs de serviço estão disponíveis nos bancos de dados de origem e destino. O local é listado na saída.
```
./ zdmcli query job -jobid job-id-number
```

Diagnosticar e Solucionar Problemas da Migração

Se seu job de migração encontrar um erro, consulte os logs de saída do job de migração, os logs do serviço Zero Downtime Migration e os logs de fase operacional específicos do servidor presentes nos respectivos servidores de banco de dados de origem ou de destino.

Se o job de migração encontrar uma exceção, os logs poderão fornecer alguma indicação da natureza da falha. Os logs dos procedimentos de migração executados nos ambientes de origem e destino são armazenados nos servidores nos respectivos ambientes de origem e destino. O local do arquivo de log é incluído na saída de migração e na saída quando você consulta o status de um job.

A tabela a seguir lista as fases de migração e a descrição de cada nome de fase.

Nome da Fase	Descrição
ZDM_GET_SRC_INFO	Descobrir informações sobre o banco de dados de origem
ZDM_GET_TGT_INFO	Descobrir informações sobre o banco de dados de destino
ZDM_SETUP_SRC	Configurar módulos auxiliares do ZDM no servidor de origem
ZDM_SETUP_TGT	Configurar módulos auxiliares do ZDM no servidor de destino
ZDM_PREUSERACTIONS	Execute ações de pré-usuário de migração, se houver, na origem
ZDM_PREUSERACTIONS_TGT	Executar ações de pré-usuário de migração, se houver, no destino
ZDM_OBC_INST_SRC	Instalar o Módulo de Oracle Database Cloud Backup na origem
ZDM_OBC_INST_TGT	Instalar o Módulo Oracle Database Cloud Backup no destino
ZDM_GEN_RMAN_PASSWD	Gerar senha aleatória para criptografar o backup do Oracle Recovery Manager (RMAN)
ZDM_BACKUP_FULL_SRC	Execute o backup completo do banco de dados de origem
ZDM_BACKUP_INCREMENTAL_SRC	Executar backup incremental do banco de dados de origem
ZDM_VALIDATE_SRC	Executar validações na origem
ZDM_VALIDATE_TGT	Executar validações no destino
ZDM_DISCOVER_SRC	Execute a descoberta de banco de dados na origem para configurar o Oracle Data Guard
ZDM_COPYFILES	Copie o arquivo de senha da Oracle e as wallets de Criptografia Transparente de Dados (TDE) da origem para o destino
ZDM_OSS_STANDBY_SETUP_TDE_TGT	Copie os arquivos da wallet de TDE da origem para o local do keystone de destino
ZDM_PREPARE_TGT	Preparar o destino para a criação stand-by do Oracle Data Guard
ZDM_CLONE_TGT	Criar stand-by do Oracle Data Guard com base no backup na nuvem
ZDM_FINALIZE_TGT	Finalizar a preparação stand-by do destino do Oracle Data Guard
ZDM_CONFIGURE_DG_SRC	Registrar o stand-by na nuvem com a origem
ZDM_SWITCHOVER_SRC	Iniciar ações de switchover na origem
ZDM_SWITCHOVER_TGT	Concluir ações de switchover no destino
ZDM_POSTUSERACTIONS	Executar qualquer ação do usuário pós-migração na origem
ZDM_POSTUSERACTIONS_TGT	Executar qualquer ação do usuário pós-migração no destino
ZDM_CLEANUP_SRC	Executar limpeza na origem
ZDM_CLEANUP_TGT	Executar limpeza no destino
ZDM_POSTUSERACTIONS_TGT	Executar qualquer ação do usuário pós-migração no destino

Se o serviço Zero Downtime Migration não for iniciado, verifique os logs do serviço Zero Downtime Migration em busca de erros de inicialização do processo para determinar a causa do erro reportado. O log do serviço Zero Downtime Migration está localizado em $ZDM_BASE/crsdata/zdm_service_node/rhp/rhpserver.log.0.
Use o comando do job de consulta para verificar o status de um job.
Os logs de serviço estão disponíveis nos bancos de dados de origem e destino. O local é listado na saída.
```
./ zdmcli query job -jobid job-id-number
```
Determine em qual fase operacional o job de migração estava no momento da falha e se a fase pertence ao banco de dados de origem ou de destino.
Verifique o log do host do serviço Zero Downtime Migration em $ZDM_BASE/crsdata/zdm_service_node/rhp/rhpserver.log.0 e acesse o respectivo servidor de origem ou destino para verificar o log associado à fase operacional no diretório /tmp/zdm-unique id/zdm/log.

Para obter mais informações sobre a solução de problemas do Zero Downtime Migration e problemas conhecidos na versão atual, consulte as Notas da Versão do Zero Downtime Migration.