Upgrade de 19c → Oracle AI Database 26ai (23ai): AutoUpgrade

Use este guia para um upgrade de release principal (19c → 26ai); para um RU trimestral dentro da mesma release, use o guia "Aplicar um Release Update (RU) no Oracle Database 19c". Com o AutoUpgrade, a ferramenta recomendada pela Oracle: o autoupgrade.jar mais recente, arquivo de configuração, analyze → fixups → deploy, ponto de retorno automático com guaranteed restore point, upgrade in-place de um CDB 19c ou conversão de um non-CDB em PDB de um CDB 26ai. Em seguida, time zone, estatísticas, o aviso sobre COMPATIBLE e o caminho de restore/rollback. Inclui caminhos separados para instância única, Oracle Restart e RAC (o AutoUpgrade gerencia sozinho o cluster_database e o registro no srvctl).

Topologia: 1 servidor, Oracle Restart ou RAC (home 26ai em todos os nodes)

Antes de começar

• Caminho de upgrade direto: segundo o 26ai Upgrade Guide da Oracle, o upgrade direto para 26ai só é possível a partir de 19c e 21c (versões mais antigas são atualizadas primeiro para 19c). Recomenda-se que a origem 19c esteja no RU mais recente; a documentação não exige um RU mínimo, mas o analyze do AutoUpgrade reporta patches/one-offs ausentes.
• Na origem, COMPATIBLE de no mínimo 19.0.0 (o menor valor aceito pelo 26ai). Se for menor (11.2/12.x), ele precisa ser elevado antes no 19c; essa operação é irreversível e invalida os restore points.
• O software 26ai está instalado em … (caminho ZIP/gold image) com o RU 26ai mais recente aplicado; o Java do home (…) está disponível.… No RAC, o home 26ai deve estar instalado no mesmo caminho em todos os nodes, como instalação RAC (cluster); esta verificação é executada em cada node.…
• O CDB de destino … foi criado com o dbca no home 26ai e está aberto; o character set é compatível com a origem (recomenda-se CDB AL32UTF8), db_create_file_dest está definido… e há espaço livre equivalente ao tamanho do banco de origem (cópia)….
• A origem está em modo ARCHIVELOG, a FRA está definida e há espaço livre suficiente (para os flashback logs e archive logs gerados durante o upgrade; em torno de 10–20% do tamanho do banco como espaço adicional).
• Existe um backup RMAN completo feito imediatamente antes do upgrade, com restore já testado (também incluído como passo neste guia).… Na conversão de non-CDB sem cópia, este é o único caminho de volta.…
• A aplicação foi testada com o 26ai e os passos deste guia foram ensaiados antes em um banco de teste; os drivers de cliente (JDBC/OCI) suportam o 26ai.
• A janela de manutenção foi aprovada; o monitoramento está em blackout; jobs agendados e conexões da aplicação serão interrompidos durante o upgrade.
• O servidor tem acesso a download.oracle.com (para o autoupgrade.jar) ou o jar mais recente será copiado manualmente.
• O Grid Infrastructure já foi atualizado para 26ai (…): a versão do banco não pode ser superior à do Grid. …O Clusterware está na mesma versão e saudável em todos os nodes.…A stack do Oracle Restart está em execução a partir do novo Grid home.…
• O banco está registrado no Clusterware e aponta para o home de origem (Oracle home: …).
• O sistema operacional do servidor suporta o 26ai (Oracle Linux / RHEL 8 ou 9). Um banco 19c em OL7/RHEL 7 não pode ser atualizado in-place para 26ai: primeiro atualize o sistema operacional ou migre para um novo servidor.

Fases do guia

• Verificações prévias — Verificar o estado do banco de origem · Verificar o estado do CDB de destino · Baixar o autoupgrade.jar mais recente · Escrever o arquivo de configuração do AutoUpgrade · Executar o analyze · Analisar o relatório do analyze …
• Backup e ponto de retorno — Fazer um backup RMAN completo · Verificar o espaço da FRA
• Upgrade (deploy) — Parar a aplicação · Iniciar o deploy · Acompanhar o progresso · Verificar o resultado
• Pós-upgrade — Apontar os arquivos de ambiente para o novo home… (…)… · Mover o listener para o home 26ai · Validar o registro no Clusterware · Verificar a versão, os componentes, o time zone e os avisos · Garantir que os PDBs permaneçam abertos · Coletar as estatísticas do dicionário …
• Rollback (somente se necessário) — Voltar ao restore point com o restore do AutoUpgrade · Validar o banco de origem no 19c · Restaurar a partir do backup · Validar o dicionário e os componentes do 19c