Avec AutoUpgrade et un clone rafraîchissable (refreshable clone PDB), une base 19c non-CDB est copiée à chaud dans une CDB 26ai d'un autre serveur, puis mise à jour et convertie en PDB au moment choisi. La copie des données sort de la fenêtre d'arrêt, et la source reste intacte pour un retour arrière. Cet article suit la note Oracle KB933941, mise à jour le 15 octobre 2026, avec les points à corriger dans ses exemples.
Le principe
AutoUpgrade se connecte à la source par un DB link, avec un utilisateur ordinaire (pas SYS), et enchaîne cinq étapes :
- Étape 1 : il crée dans la CDB cible une PDB clone rafraîchissable de la non-CDB, en copiant ses fichiers de données à travers le DB link.
- Étape 2 : il rafraîchit cette PDB à intervalle régulier en lui appliquant les redo de la source, qui continue de tourner.
- Étape 3 : à l'heure de bascule, il fait un dernier refresh et détache la PDB de la source.
- Étape 4 : il met la PDB à jour en 26ai et la convertit en vraie PDB (noncdb_to_pdb).
- Étape 5 : il exécute les contrôles et les corrections post-migration.
Seules les étapes 3 à 5 tombent dans la fenêtre d'arrêt. La copie initiale, la plus longue sur une grosse base, se fait pendant que la production tourne.
Prérequis et limites
Le clone rafraîchissable vit des redo de la source : tout ce qui les interrompt ou les contourne casse la migration.
- Archivelogs : la source est en ARCHIVELOG et garde ses archivelogs sur disque jusqu'à leur application sur la PDB. Reportez leur sauvegarde avec suppression, ou adaptez la politique de suppression. Un archivelog manquant oblige à recloner.
- Tablespaces : tous en READ WRITE. Le clone rafraîchissable ne prend pas en charge les tablespaces en lecture seule.
- Connexion permanente : pendant la phase de refresh, ne redémarrez pas la source, n'arrêtez pas son listener et n'activez pas RESTRICTED SESSION. La cible doit pouvoir s'y connecter à tout moment.
- NOLOGGING : à éviter. Les données chargées sans redo n'arrivent jamais sur la cible. Le plus sûr est d'activer FORCE LOGGING sur la source.
- Database Vault : à désactiver avant la mise à jour.
- Services : ils ne sont pas migrés et sont à recréer sur la cible.
- Cible : un Oracle home 26ai installé et une CDB déjà créée sur l'autre serveur.
- AutoUpgrade : toujours la dernière version, téléchargeable depuis la note KB123450 ou sur oracle.com/database/upgrades.
Préparer la source et la cible
Sur la source, un utilisateur dédié reçoit uniquement les droits nécessaires au clonage ; il sera supprimé après la migration.
-- Source : non-CDB 19c, en SYSDBA
CREATE USER ncdbuser IDENTIFIED BY "<mot_de_passe>";
GRANT CREATE SESSION, CREATE PLUGGABLE DATABASE, SELECT_CATALOG_ROLE TO ncdbuser;
GRANT READ ON sys.enc$ TO ncdbuser;Sur la cible, le DB link est créé dans la CDB, puis testé.
-- Cible : CDB 26ai, dans CDB$ROOT
CREATE DATABASE LINK clonencdb
CONNECT TO ncdbuser IDENTIFIED BY "<mot_de_passe>"
USING 'db1928';
SELECT name, open_mode, cdb FROM v$database@clonencdb;
-- Attendu : DB1928, READ WRITE, NOUne bonne pratique reprise de la note : créez sur la source une petite table témoin avant la migration, et vérifiez son contenu dans la PDB à la fin.
Deux fichiers de configuration
Source et cible sont sur deux serveurs : l'analyse et les corrections tournent sur la source, avec leur propre fichier, et le déploiement sur la cible.
Sur la source, le home 26ai n'existe pas : target_version remplace target_home.
# src_db1928.cfg (serveur source)
global.global_log_dir=/u01/app/oracle/autoupgrade/logs
upg1.source_home=/u01/app/oracle/product/1928/dbhome_1
upg1.sid=db1928
upg1.target_version=26# dst_db1928.cfg (serveur cible)
global.global_log_dir=/u01/app/oracle/autoupgrade/logs
upg1.source_home=/tmp
upg1.source_base=/u01/app/oracle
upg1.target_home=<ORACLE_HOME 26ai>
upg1.sid=db1928
upg1.target_cdb=orcl
upg1.source_dblink.db1928=clonencdb 1800
upg1.target_pdb_name.db1928=<nom_de_la_pdb>
upg1.start_time=<date lointaine>
upg1.parallel_pdb_creation_clause.db1928=2
upg1.target_pdb_copy_option.db1928=file_name_convert=('/oracle/DB1928','/u01/app/oracle/oradata/ORCL/db1928')
upg1.drop_dblink=yesLe rôle de chaque paramètre du fichier cible :
sid: SID de la non-CDB source.target_cdb: CDB 26ai qui reçoit la PDB.source_dblink.<sid>: nom du DB link, suivi de l'intervalle de refresh en secondes (1800 = 30 min). Ne pas l'oublier.target_pdb_name.<sid>: nom de la PDB. Obligatoire si une PDB du même nom existe déjà, recommandé si la CDB est sur le même serveur que la source.start_time: heure du refresh final et du début de la mise à jour. Une date lointaine laisse piloter la bascule à la main avec proceed.parallel_pdb_creation_clause.<sid>: nombre de processus parallèles de la copie initiale, à limiter pour ne pas surcharger la source.target_pdb_copy_option.<sid>: emplacement des fichiers sur la cible ; avec ASM/OMF :file_name_convert=none.drop_dblink: supprime le DB link quand il ne sert plus.source_homeetsource_base: le home source n'existe pas sur la cible ; source_home pointe vers un répertoire factice et source_base devient nécessaire.
Le déroulé, serveur par serveur
La bascule se déclenche depuis la console AutoUpgrade de la cible, après le gel et les corrections sur la source.
- 1. Analyse, sur la source :
java -jar autoupgrade.jar -config src_db1928.cfg -mode analyze. Précontrôles et rapport status.html. - 2. Copie et refresh, sur la cible :
java -jar autoupgrade.jar -config dst_db1928.cfg -mode deploy. Étape CLONEPDB (la PDB apparaît en MOUNTED), puis REFRESHPDB jusqu'à start_time. - 3. Gel, sur la source : arrêt des applications et déconnexion des sessions. Plus aucune écriture sur la source.
- 4. Corrections, sur la source :
java -jar autoupgrade.jar -config src_db1928.cfg -mode fixups. Un avertissement sur le home cible absent est normal. - 5. Bascule, dans la console AutoUpgrade de la cible :
proceed -job <numéro>. Refresh final, puis DBUPGRADE, NONCDBTOPDB, POSTFIXUPS et POSTUPGRADE.
Trois conseils pour cette phase :
- Gardez la console ouverte : lancez le deploy dans screen ou une session VNC, pas en nohup, car proceed se tape dans cette console. Si la session est perdue, relancez le deploy.
- Suivi :
lsjliste les jobs et leur étape,status -job <numéro>détaille les étapes et leur avancement. - proceed ne lance pas le deploy : il fait sortir le job déjà en cours de la phase de refresh pour démarrer la bascule.
Ce que dure vraiment l'arrêt
Dans l'exemple de la note, l'arrêt dure un peu moins de deux heures, sur une petite base : quelques gigaoctets seulement.
- Corrections sur la source : 3 min 51 s.
- De proceed (12 h 22) à la fin du job (vers 14 h 10) : environ 1 h 50, pour la mise à jour en 26ai, la conversion en PDB et les étapes post-migration.
Ces étapes dépendent surtout du dictionnaire et des composants installés, beaucoup moins du volume de données. Une base de plusieurs téraoctets ne prendra donc pas un temps proportionnel à sa taille, mais seule une répétition sur une copie donne une durée fiable.
Si la source et la cible sont dans la même version, avec seulement des RU différentes, l'étape de mise à jour disparaît : il reste la conversion et datapatch, et la fenêtre est plus courte.
Après la migration et retour arrière
La PDB s'ouvre en READ WRITE à la fin du job ; il reste à la valider et à la remettre en service.
- Contrôles : composants de DBA_REGISTRY, objets invalides (utlrp.sql si besoin), contenu de la table témoin.
- Remise en service : services recréés, sauvegarde de la PDB, jobs planifiés.
- Nettoyage : suppression de l'utilisateur du DB link sur la source.
Le retour arrière est simple tant qu'aucune application n'a écrit dans la PDB : on rebascule les applications sur la source, qui n'a pas été modifiée. La note demande d'arrêter la non-CDB après la migration : arrêtez-la, mais ne la supprimez pas avant la fin de la période de retour arrière.
Un point que la note ne traite pas : si la CDB cible est protégée par Data Guard, une PDB clonée à chaud n'est pas créée sur la standby. Il faut prévoir son instanciation sur la standby, avant ou après la mise en service.
Trois détails à corriger dans les exemples de la note
Les fichiers de configuration de cet article sont déjà corrigés ; si vous partez de la note, adaptez ces trois points.
- Le fichier de configuration de la source décrit une autre base (sid=cdbtest, pdbs=pdb2, home 1931) au lieu de la non-CDB db1928 (home 1928). Son nom diffère aussi de celui utilisé dans les commandes analyze et fixups.
- Le commentaire sur sid le présente comme « la CDB où tourne la PDB ». Pour une non-CDB, sid est simplement le SID de la non-CDB.
- Le mot de passe d'exemple est écrit en clair dans les commandes. Utilisez votre propre mot de passe et ne le laissez pas dans les scripts.
Ce qu'il faut retenir
- La copie initiale et les refresh se font pendant que la production tourne ; l'arrêt ne couvre que le refresh final, la mise à jour, la conversion et les contrôles.
- Gardez les archivelogs de la source jusqu'à leur application, et laissez la source joignable pendant toute la phase de refresh.
- Fixez start_time loin dans le futur et déclenchez la bascule vous-même avec proceed, après le gel et les corrections sur la source.
- Mesurez la durée de l'arrêt lors d'une répétition : elle dépend du dictionnaire plus que du volume.
- La source reste intacte : c'est votre retour arrière, tant que personne n'a écrit dans la PDB.
Avec le clone rafraîchissable, la question n'est plus combien de temps prend la copie, mais quand vous décidez de basculer.
Et vous, avez-vous déjà migré une non-CDB avec un clone rafraîchissable ? Combien de temps a duré votre fenêtre d'arrêt ?
Source : note Oracle KB933941, « AutoUpgrade: How to upgrade 19c Non-CDB to 26ai and convert to PDB using Refreshable Clone PDB's », mise à jour le 15 octobre 2026 (accès My Oracle Support).
