Autoupgrade 是oracle 提供的专门用于数据库版本升级工具，通过一条命令和一个配置文件允许dba升级一个或者多个数据库而无需人工干预。
Autoupgrade 是java程序包，支持oracle 12.2 以及以上版本数据库，自oracle 19.3开始，该工具存在于$ORACLE_HOME/rdbms/admin 目录，oracle 推荐下载改工具的最新版本以代替默认的较低版本,Autoupgrade 最新版本下载地址如下(需购买oracle support):
在进行数据库版本升级之前，需确保升级版本间的兼容性，支持版本间升级可至如下地址查询(需购买oracle support):
这里演示将oracle 19c Non-CDB 升级至21c CDB(位于同一服务器,21c版本提前建立好不含pdb的cdb数据库)，查询oracle support 支持19c 升级至21c。
源版本: 19c non-cdb sid:frdb db home: /u01/app/oracle/product/19.3.0/db_1/ gi home:/u01/app/19.3.0/grid
目标版本：21c cdb sid:testdb db home: /u01/app/oracle/product/21.3.0/db_1/ gi home:/u01/app/21.3.0/grid
1、首先升级gi home，使用gridSetup.sh 升级 asm
su – grid
export ORACLE_HOME=/u01/app/21.3.0/grid
$ORACLE_HOME/gridSetup.sh
2、生成范例配置文件，根据范例配置文件创建实际升级环境的配置文件:
su – oracle --确保oracle环境变量指向新的21c
$ $ORACLE_HOME/jdk/bin/java -jar $ORACLE_HOME/rdbms/admin/autoupgrade.jar -create_sample_file config
Created sample configuration file /home/oracle/sample_config.cfg
实际升级环境的配置文件config.cfg 内容如下:
global.autoupg_log_dir=/u01/app/oracle/cfgtoollogs/autoupgrade
# Database Noncdb to PDB upgrade
upg1.sid=frdb
upg1.source_home=/u01/app/oracle/product/19.3.0/db_1
upg1.target_cdb=testdb
upg1.target_home=/u01/app/oracle/product/21.3.0/db_1
upg1.start_time=now # Optional. 10 Minutes from now
upg1.upgrade_node=zjg-dba-bidbdr # Optional. To find out the name of your node, run
the hostname utility. Default is ''localhost''
upg1.run_utlrp=yes # Optional. Whether or not to run utlrp after upgrade
upg1.timezone_upg=yes # Optional. Whether or not to run the timezone upgrade
3、执行升级前的检查分析任务:
su – oracle --确保oracle 环境变量指向旧的19c
$ /u01/app/oracle/product/21.3.0/db_1/jdk/bin/java -jar /u01/app/oracle/product/21.3.0/db_1/rdbms/admin/autoupgrade.jar -config config.cfg -mode analyze
生成一个升级前的检查、分析html 报告，查看分析报告，根据报告内容进行升级前后的调整动作：
4、执行升级动作:
su – oracle --确保oracle 环境变量指向旧的19c
$ /u01/app/oracle/product/21.3.0/db_1/jdk/bin/java -jar /u01/app/oracle/product/21.3.0/db_1/rdbms/admin/autoupgrade.jar -config config.cfg -mode deploy
可以看到，autoupgrade 工具帮我们搞定了升级过程中的一系列操作，升级完成后，会生成一个html格式报告，阅读报告确认升级是否成功：
升级完成后，发现数据库数据文件路径没有发生变化,这个可以在autoupgrade 工具配置文件中增加
参数 upg1.target_pdb_copy_option=file_name_convert=('+DATA/FRDB/', '+DATA/TESTDB/FRDB/')，这样升级过程中会自动帮我们更正数据文件路径。
