Implantação Instantânea do Oracle ZDM 26.1: Clonagem Física do PDB de Ponta a Ponta com o Oracle Key Vault (OKV)

Introdução

O Oracle Zero Downtime Migration (ZDM) 26.1 apresenta a Implantação Instantânea, permitindo migrações de banco de dados diretamente do host de banco de dados de origem ou de destino sem exigir um servidor ZDM dedicado. Esta release também aprimora a integração com o Oracle Key Vault (OKV) e melhora os recursos de migração da wallet de TDE (Transparent Data Encryption).

Limitações em versões anteriores do ZDM

Antes do Oracle ZDM 26.1:

Novidades do ZDM 26.1

O ZDM 26.1 suporta os seguintes cenários de migração de wallet:

O ZDM 26.1 detecta se o banco de dados de origem está configurado para usar uma wallet do OKV e faz download das chaves de TDE antes de migrá-las para o banco de dados de destino. Se o banco de dados de destino também estiver configurado com uma wallet do OKV, o ZDM fará upload das chaves de TDE migradas para a wallet do OKV de destino. Deixe o parâmetro ZDM_SKIP_TDE_WALLET_MIGRATION em seu valor padrão (FALSE) para permitir que o ZDM migre automaticamente a wallet de TDE durante o workflow de migração.

image

Objetivos

Compatibilidade de Versão

Este tutorial demonstra a Implantação Instantânea do Oracle Zero Downtime Migration (ZDM) 26.1 com o Oracle AI Database 26ai e o Oracle Key Vault (OKV) 21.14 para clonagem física de PDB de ponta a ponta e migração automática de wallet de TDE.

O workflow principal neste tutorial foi validado usando:

Observação: algumas seções deste tutorial são aplicáveis somente a versões anteriores do Oracle Database para fins de referência. Essas seções são marcadas claramente como Somente 12.1 ou Somente 18c e 19c e podem ser ignoradas ao usar o Oracle AI Database 26ai.

Ambiente Atual Antes da Migração

Antes de iniciar o workflow do Oracle Zero Downtime Migration (ZDM), verifique se os ambientes de origem e de destino estão configurados corretamente para Clonagem Física do PDB. A tabela a seguir resume o ambiente usado neste tutorial e o status dos principais componentes antes da migração.

image

Pré-requisitos

Observação: Antes de iniciar este tutorial, certifique-se de que seu ambiente atenda a todos os pré-requisitos do Oracle Zero Downtime Migration (ZDM) 26.1. Consulte a seção Preparação para o Serviço Database Migration na documentação do Oracle ZDM para obter a lista completa de pré-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

Configurar a Implantação Instantânea do Oracle Zero Downtime Migration (ZDM) 26.1

O Ambiente

Para fins de demonstração, este tutorial usa o OCI Oracle Base Database Service com o Oracle AI Database 26ai, versão 23.26.2.0.0.

Origem: nome do host: sourcedb, nome do BD: ORADB, nome exclusivo do BD: ORADB_src TDE é gerenciado pelo Oracle Key Vault (OKV).

image image

Destino: nome do host: targetdb, nome do banco de dados: ORADB, nome exclusivo do banco de dados: ORADB_tgt TDE usa uma wallet baseada em arquivo.

image image

Workflow de Migração

Etapa 1: Faça o download da versão mais recente do Oracle Zero Downtime Migration (ZDM) 26.1 na página do produto Oracle ZDM (versão 26.1).

Faça download do software mais recente do Oracle Zero Downtime Migration (ZDM) 26.1 na página de download do Oracle Zero Downtime Migration. O software é distribuído por meio do Oracle Software Delivery Cloud (OSDC). Efetue sign-in usando sua conta do Oracle Single Sign-On (SSO), aceite o contrato de licença e faça download do pacote de versão ZDM mais recente (por exemplo, V1055491-01.zip). Para obter o download e a documentação mais recentes, consulte os seguintes 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

Etapa 2. Copie o arquivo V1055491-01.zip para um diretório com armazenamento gratuito suficiente.

Após fazer download do software, copie o arquivo ZIP para o host do banco de dados de origem (ou o host de destino se você planeja usar a Implantação Instantânea do destino) e prossiga com a extração na próxima etapa.

image

A extração do arquivo ZIP cria o subdiretório zdm26.1. O software ZDM extraído está localizado em /opt/opc/zdm/zdm26.1.

Passo 3: Atualize o arquivo /etc/hosts em cada host com o nome do outro host e endereço IP.

Adicione o nome do host de origem e as informações de IP ao arquivo /etc/hosts do host de destino.

image

Adicione o nome do host de destino e as informações de IP ao arquivo /etc/hosts do host de origem.

image

Etapa 4: Copie a chave pública SSH para o usuário do sistema operacional (neste caso, opc) no host de origem e adicione-a ao arquivo allowed_keys para o usuário do sistema operacional (neste caso, também opc) no host de destino.

No host de Origem

image

No host de Destino

image

Teste a conectividade SSH da origem com o host do banco de dados de destino:

image

Verifique se o TTY está desativado para o usuário com privilégios SSH. Se o TTY estiver desativado, o seguinte comando retornará a data do host remoto sem erros:

image

Etapa 5: Verifique se a TDE no banco de dados de origem é gerenciada pelo Oracle Key Vault (OKV).

image

Etapa 6: Configurar o OKV (Oracle Key Vault) para o Banco de Dados de Destino.

1: Registrar o Banco de Dados de Destino como um Ponto Final do OKV (Oracle Key Vault).

image

image

2: Copiar o Token de Inscrição do Oracle Key Vault (OKV).

image

3: Inscrever o Ponto Final do Banco de Dados de Destino e Fazer Download do Software do Ponto Final do Oracle Key Vault (OKV).

image image

4: Crie os diretórios necessários para o OKV no host de destino:

image

5: Instalar o arquivo JAR do ponto final do Oracle Key Vault:

image image

6: Designar a wallet virtual de origem ao ponto final de destino:

image image image

7: Fazer upload das wallets atuais para o OKV (Oracle Key Vault) (Migração da Wallet Baseada em Arquivo para o OKV):

Depois que a conexão com o OKV for verificada, faça upload das wallets atuais para o OKV. Para verificar a localização atual de WALLET_ROOT, execute a seguinte consulta:

image

Após identificar o local da wallet, copie as wallets existentes para WALLET_ROOT/tde:

image

Quando a cópia estiver concluída, faça upload das wallets para o OKV usando WALLET_ROOT/okv/bin/okvutil com as wallets armazenadas em WALLET_ROOT/tde:

image

8: Adicione a senha do OKV à área de armazenamento de chaves para ativar o log-in automático na área de armazenamento de chaves do OKV.(RUN ON ALL NODES):

image

9: Adicionar Chave Secreta para usar o armazenamento externo (RUN ON ALL Nodes):

image

10: Atualizar Parâmetros de Inicialização do Banco de Dados:

Atualize os parâmetros de inicialização wallet_root e tde_configuration para uso do OKV. Observe que o parâmetro de inicialização tde_configuration depende do parâmetro wallet_root. Como o parâmetro wallet_root tem escopo SPFILE, é necessária uma reinicialização do banco de dados para que as alterações tenham efeito.

Além disso, definir wallet_root e tde_configuration substitui a definição ENCRYPTION_WALLET_LOCATION no sqlnet.ora.

Antes de atualizar os parâmetros de inicialização do banco de dados, execute um backup do spfile.

image

11: sqlnet.ora e Definições do Ambiente de Banco de Dados RAC (SOMENTE 12.1):

Como os parâmetros init.ora wallet_root e tde_configuration não existem na versão 12.1, precisamos fazer alterações nas definições ambientais do banco de dados sqlnet.ora e 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)))

Definições de Ambiente de Banco de Dados RAC: Adicione as variáveis de ambiente ORACLE_BASE e ORACLE_UNQNAME às definições de ambiente de banco de dados 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 o Banco De Dados.

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

13: Migrar a Área de Armazenamento de Chaves TDE para o Oracle Key Vault (OKV).

Execute o comando a seguir em um nó do banco de dados para migrar o armazenamento de chaves do software TDE para o Oracle Key Vault (OKV).

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

image

Quando o comando retornar com sucesso, reinicie o banco de dados para verificar se a comunicação com o Oracle Key Vault está funcionando corretamente:

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

14: Verificar a Configuração do OKV (Oracle Key Vault)

Execute as consultas a seguir para verificar se a configuração do Oracle Key Vault (OKV) está configurada corretamente e se o banco de dados pode acessar o armazenamento de chaves externo.

image

Etapa 7: Crie o arquivo de resposta ZDM no host do banco de dados de origem. Esse arquivo define a configuração de migração, incluindo as informações do banco de dados de origem e destino, os parâmetros do OKV (Oracle Key Vault) e as definições de Clonagem Física do PDB.

O exemplo a seguir mostra o arquivo de resposta usado para esta migração:

[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

Etapa 8: Execute o seguinte comando no host do banco de dados de origem para avaliar a migração e validar se os ambientes de origem e destino estão prontos para migração.

[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
 ...............................................
 .........................

Observação:

Se a senha do ponto final do Oracle Key Vault (OKV) for igual à senha do armazenamento de chaves TDE, as opções -tdekeystorepasswd e -tgttdekeystorepasswd serão suficientes.

Se a senha do ponto final do OKV for diferente da senha da área de armazenamento de chaves TDE, especifique também as seguintes opções:

Essas opções permitem que o ZDM seja autenticado com os pontos finais do Oracle Key Vault independentemente das senhas do armazenamento de chaves de TDE durante a migração da wallet.

Verifique o status do job de migração, conforme mostrado abaixo.

image

Etapa 9: Inicie a migração e use a opção -pauseafter para interromper a migração após a fase ZDM_CLONE_PDB_TGT. Durante essa fase, as alterações feitas no PDB de origem são sincronizadas com o PDB de destino no intervalo especificado por ZDM_PDB_REFRESH_INTERVAL.

image

Etapa 10: Verifique o status do job de migração.

image

Verifique o status do PDB de destino.

image

Etapa 11: Retome o job de migração quando estiver pronto para executar o switchover final do aplicativo.

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

image

Verifique o status do PDB de destino após a conclusão da migração:

image

Verificar Migração Automática da Wallet de TDE

O seguinte log mostra que o ZDM faz download automaticamente da wallet de TDE do Oracle Key Vault (OKV) no host do banco de dados de origem:

image

Referências

Confirmações

Autor: Amresh Kumar Singh (Consultor Principal)

Mais Recursos de Aprendizado

Explore outros laboratórios em docs.oracle.com/learn ou acesse mais conteúdo de aprendizado gratuito no canal do Oracle Learning no YouTube. Além disso, acesse education.oracle.com/learning-explorer para se tornar um Oracle Learning Explorer.

Para obter a documentação do produto, visite o Oracle Help Center.