合 手动升级到 Non-CDB Oracle Database 12c Release 2（12.2）的完整核对清单 (Doc ID 2297983.1、2173141.1)
Tags： Oracle升级DBUAupgradeChecklist核对清单
- 适用于:
- 用途
- 适用范围
- 详细信息
- 步骤1：升级到数据库 12.2 的升级路径
- 能够直接升级到 Oracle 12c Release 2 (12.2) 的数据库最小版本：
- 以下的数据库版本需要间接升级：
- 步骤2：推荐/需要在源库上完成的
- 步骤3：推荐/需要在目标库上完成的
- 步骤 4：检查源库的健康状况
- 步骤5：升级前检查
- 清理数据库
- 检查物化视图
- 性能方面
- 检查时区设置
- 备份数据库
- 确保升级前所有的文件都没有处于备份模式
- 清空回收站
- 备份 Oracle EM DB Control 配置及数据
- 备份数据的步骤
- 使用 emremove.sql 手工删除 DB control
- 删除 JSON-Enabled Context search 索引
- 检查使用大小写不敏感密码的用户
- 删除 Unified Auditing Schema and Roles
- 在升级过程中把某些 schema 的表空间置于 offline
- 保留降级的能力
- 关于 Audit table 的升级前要求
- 集群数据库的需要
- 升级前先解决Outstanding分布式事务
- 其它检查
- 步骤6：Preupgrade 步骤
- Network Utility 包的依赖关系
- 检查 Time zone 文件版本
- 步骤7：升级数据库到 12.2
- 步骤8：升级后步骤
- 在 Linux 和 Unix 上设置环境变量
- 更新 oratab 文件
- Post-upgrade fixup 脚本
- 升级依赖 Oracle-Maintained 类型的表
- 启用新的 Extended Data Type 功能（并不是必须的）
- 升级 Recovery Catalog
- 在升级数据库后升级 Time Zone 文件版本
- 升级统计信息表
- 升级外部验证的 SSL 用户
- 在升级数据库后安装 Oracle Text Supplied Knowledge Bases
- 升级数据库后更新 Oracle Application Express Configuration
- 对额外的 Network Services 配置访问控制列表（ACLs）
- 升级后启用 Oracle Database Vault
- 检查参数 SQLNET.ALLOWED_LOGON_VERSION
- 已知问题
- 参考
- APPLIES TO:
- PURPOSE
- SCOPE
- DETAILS
- Step 1: Upgrade Path for 12.2 Oracle database
- Minimum version of the database that can be directly upgraded to Oracle 12c Release 2 (12.2)
- Intermediate upgrades needs to be carried for following releases
- Step 2: Requirements and recommendations for source database
- Step3: Requirements and recommendations for target ORACLE_HOME
- Step 4: Check the health of the source database
- Step 5: Pre-upgrade checks
- Clean up database
- Check materialized views
- Performance
- Checking Time zone settings
- Back up the database
- Ensure no files are in Back up mode before starting the upgrade
- Purge Recycle bin
- Save Oracle EM DB Control Configuration and Data
- Steps to save data
- Manually remove DB control with emremove.sql
- Drop JSON-Enabled Context search Indexes
- Check the accounts use Case-Insensitive password version
- Remove Unified Auditing Schema and Roles
- Put Schema based tablespaces offline during upgrade
- Preserve Downgrade capability
- Audit table preupgrade requirements
- Cluster DB Requirements
- Resolve Outstanding Distributed Transactions Before Upgrade
- Other Checks
- Step 6: Preupgrade step
- Dependencies on Network Utility Packages
- Check Time zone version
- Step7: Upgrade Database to 12.2
- Step 8: Post-upgrade
- Setting Environment variables on Linux and Unix
- Update oratab entries
- Post-upgrade fixup script
- Upgrading Tables Dependent on Oracle-Maintained Types
- Enabling the New Extended Data Type Capability
- Recovery Catalog Upgrade
- Upgrade the Time Zone File Version After Upgrading Oracle Database
- Upgrading Statistics Tables
- Upgrade Externally Authenticated SSL Users
- Install Oracle Text Supplied Knowledge Bases After Upgrading Oracle Database
- Update Oracle Application Express Configuration After Upgrading Oracle Database
- Configure Access Control Lists (ACLs) to External Network Services
- Enabling Oracle Database Vault After Upgrading Oracle Database
- Check for the SQLNET.ALLOWED_LOGON_VERSION Parameter Behavior
- Known issues
- REFERENCES
手动升级到 Non-CDB Oracle Database 12c Release 2（12.2）的完整核对清单 (Doc ID 2297983.1)
适用于:
Oracle Database Exadata Express Cloud Service - 版本 N/A 和更高版本
Oracle Database Exadata Cloud Machine - 版本 N/A 和更高版本
Oracle Cloud Infrastructure - Database Service - 版本 N/A 和更高版本
Oracle Database Backup Service - 版本 N/A 和更高版本
Oracle Database Cloud Exadata Service - 版本 N/A 和更高版本
本文档所含信息适用于所有平台
用途
本文档可用作手工将 Oracle 10gR2 (10.2) 或者 Oracle 11gR1 (11.1) 或者 Oracle 11gR2 (11.2) 或者 Oracle 12cR1 (12.1) 版本数据库升级至 Oracle 12cR2 (12.2) 版本数据库的指南与核对表。
适用范围
数据库管理人员/技术支持
详细信息
步骤1：升级到数据库 12.2 的升级路径
能够直接升级到 Oracle 12c Release 2 (12.2) 的数据库最小版本：
| 源数据库 | 目标数据库 |
|---|---|
| 11.2.0.3 / 11.2.0.4 | 12.2.x |
| 12.1.0.1 / 12.1.0.2 | 12.2.x |
以下的数据库版本需要间接升级：
| 源数据库 | 升级路径 | 目标数据库 | ||
|---|---|---|---|---|
| 11.2.0.1 / 11.2.0.2 | --> | 11.2.0.4 | --> | 12.2.x |
| 11.1.0.6 / 11.1.0.7 | --> | 11.2.0.4 | --> | 12.2.x |
| 10.2.0.2/10.2.0.3/10.2.0.4/10.2.0.5 | --> | 11.2.0.4 / 12.1.0.2 | --> | 12.2.x |
| 10.1.0.5 | --> | 11.2.0.4 / 12.1.0.2 | --> | 12.2.x |
| 9.2.0.8 | --> | 11.2.0.3 / 11.2.0.4 | --> | 12.2.x |
比如
- 如果源库是 11.2.0.2 或者 11.1.0.7，那么你需要先升级至 11.2.0.4。
- 如果源库是 10.2.0.2，10.2.0.3，10.2.0.4，10.2.0.5 或者 10.1.0.5，需要先升级至 11.2.0.4 或者 12.1.0.2。
- 对于 9.2.0.8 版本的数据库，需要先升级至一个中间版本，比如：9.2.0.8 -> 11.2.0.3 或者 11.2.0.4 -> 12.1。
步骤2：推荐/需要在源库上完成的
- 对源库做备份，冷备份或热备份都可以。
- 禁用所有自定义的 before/after DDL 类型的触发器，完成升级后再启用它们。
- 在 11g 数据库上定义的 Data security roles 不能自动转换成 ORAS。所以在升级前，需要删除所有在 11g 数据库上定义的 data security roles。升级后可以使用 Analytic Workspace Manager 12c 重新定义 data security roles。
- 如果从 11g 升级到 12c 之前未删除 data security roles，那么所有的 data security policies 以及 data security role 都会在 12c 上失效。
- Timezone 版本应当小于等于目标数据库的 Timezone 版本。
- 如果源库上已经安装了 APEX 组件，那么升级数据库前需要先在源库上升级 APEX 组件。
步骤3：推荐/需要在目标库上完成的
- 需要先检查您的硬件平台/操作系统是否兼容 12.2。点击此处来确定兼容性。
- 安装数据库软件 12.2.0.1，并确保没有安装方面的问题。
- 如果有的话，下载并应用最新的 PSU。
- 从源库的 ORACLE_HOME/dbs 下拷贝 spfile 或者 pfile 到目标 ORACLE_HOME/dbs。
- 从参数文件中删除所有废弃的参数。
- 注意升级到 12.2 需要的最低的参数 COMPATIBLE 值为”11.2.0”，确保参数 COMPATIBLE 值设置为 11.2.0 或者更高。
- 查看文档 "Patches to apply before upgrading Oracle GI and DB to 12.2.0.1 (Doc ID 2180188.1)" 给出的推荐补丁
- 在目标 ORACLE_HOME 应用补丁 patch 29213893 来避免 ORA-01422 错误 - 参考: Database Upgrade to 12.2, 18c, 19c fails with ORA-01422, ORA-06512 for SYS.DBMS_STATS (Doc ID 2525596.1)
步骤 4：检查源库的健康状况
- 执行 dbupgdiag.sql（可以从 note 556610.1 下载这个脚本），并且确认是否有 SYS/SYSTEM 用户下的失效对象或者失效组件。如果存在的话，那么需要在升级前解决这些问题。你可以多次执行 utlrp.sql 来解决问题。如果在这样做之后仍然存在失效对象，那么开一个 SR 来解决这个问题。
- 多次执行脚本 utlrp.sql 确认数据库中没有失效对象。
步骤5：升级前检查
清理数据库
清空回收站
检查 SYS 及 SYSTEM 用户的失效对象
检查 SYS 及 SYSTEM 用户下的重复对象
检查失效的、必需的、废弃的组件
检查物化视图
检查所有的物化视图的状态，刷新所有没有刷新的物化视图。
检查物化视图日志的大小，如果物化视图日志的行数非零，那么刷新物化视图。
检查 direct loader 日志以及 PMOP 日志（分区维护操作日志），如果 direct loader log 或者 PMOP 日志非空，那么刷新日志显示的物化视图。
升级数据库前，必须确保所有的物化视图都已经刷新完毕。
- 执行下面的 SQL 查询：
SQL> SELECT o.name FROM sys.obj$ o, sys.user$ u, sys.sum$ s WHERE o.type# = 42 AND bitand(s.mflags, 8) =8;
性能方面
保存性能相关指标
检查网络性能
收集优化器统计信息
收集统计信息可以减少停机时间，Oracle建议使用 DBMS_STATS.GATHER_DICTIONARY_STATS 来收集这些统计信息，比如：
SQL> EXEC DBMS_STATS.GATHER_DICTIONARY_STATS;
检查时区设置
Oracle database 12.2 的默认 time zone 文件版本是 V26。
源库的 time zone 文件版本应该小于或者等于目标库的 time zone 文件版本。如果源库的 time zone 文件版本更高，那么需要升级目标库的 time zone 文件版本来对应源库的 time zone 文件。
备份数据库
备份数据库，创建 guaranteed flashback restore point。
在升级数据库窗口前应最少测试一下回滚策略。
确保回滚策略不仅考虑到升级中，同时也要考虑到升级后的失败。
RMAN 连接到 RMAN
rman "target / nocatalog"
执行 RMAN 命令来备份
1 2 3 4 5 6 | RUN { ALLOCATE CHANNEL chan_name TYPE DISK; BACKUP DATABASE FORMAT 'some_backup_directory%U' TAG before_upgrade; BACKUP CURRENT CONTROLFILE FORMAT 'controlfile location and name'; } |
确保升级前所有的文件都没有处于备份模式
执行下面的语句：
1 | SQL> SELECT * FROM v$backup WHERE status != 'NOT ACTIVE'; |
清空回收站
要清空回收站，执行下面的语句：
1 | SQL> PURGE DBA_RECYCLEBIN |
注意：升级前务必清空回收站来避免 ORA-00600 错误并且减少升级时间。
备份 Oracle EM DB Control 配置及数据
如果在升级数据库到 12.2 版本后，有需要再降级，那么我们必须在升级前使用 emdwgrd 工具备份 Database Control 的文件，这样在降级后可以恢复这些文件。
备份数据的步骤
- 安装 12.2 的数据库软件。
- 设置 ORACLE_HOME 到旧的数据库版本。
- 设置 ORACLE_SID 为要升级的数据库 SID。
- 设置 PATH， LD_LIBRARY_PATH 和 SHLIB_PATH 到旧的 ORACLE_HOME 相关的目录下。
- 切换目录到 12c 数据库软件的 ORACLE_HOME/bin。
- 执行 emdwgrd。
对于单数据库实例 （非 RAC） 运行下面的命令：
1 | emdwgrd[sh|bat] -save -sid old_SID -path save_directory |
Oracle Real Application Clusters（Oracle RAC）数据库：
需要跨节点远程拷贝。定义一个环境变量 EM_REMCP 来指向远程拷贝的命令，比如：export EM_REMCP /usr/bin/scp
1 | emdwgrd -save -cluster -sid old_SID -path save_directory |
- 输入 SYS 密码。
使用 emremove.sql 手工删除 DB control
关闭 DB control
1 | emctl stop dbconsole |
使用 sysdba 登陆
1 2 3 | SQL>SET ECHO ON SQL>SET SERVEROUTPUT ON SQL>@emremove.sql >> 脚本位于新的 12c ORACLE_HOME/rdbms/admin |
从系统中手工删除 ORACLE_HOME/HOSTNAME_SID/ 和 ORACLE_HOME/oc4j/j2ee/OC4J_DBConsole_HOSTNAME_SID 目录。
如果是 windows 系统则删除 DB Console service OracleDBConsoleSID。
删除 JSON-Enabled Context search 索引
如果源库版本为 12.1.0.2 并且创建了 JSON search index 那么 Oracle 推荐先删除这些索引，在升级后再创建回来。
检查使用大小写不敏感密码的用户
使用管理用户登录 SQL*Plus，并且执行下面的语句：
1 | SELECT USERNAME,PASSWORD_VERSIONS FROM DBA_USERS; |
如果存在10g 版本的用户，建议根据 Oracle 文档解决这个问题，否则升级后用户会被 LOCK。
删除 Unified Auditing Schema and Roles
注意：如果在 Oracle 12.1 数据库上已经创建了 AUDIT_ADMIN 或者 AUDIT_VIEWER 用户或者 roles，或者数据库是在 12.1 版本上创建（而不是升级上来的），那么不需要删除这些 role 和 AUDSYS 用户。
更多信息请参照 URL： https://docs.oracle.com/database/122/UPGRD/unified-auditing-audit_admin-audit_viewer-changes.htm#UPGRD60010
使用 SYS 以 SYSDBA 权限登录 SQL*Plus，删除 AUDSYS，如果存在的话。以 migrate 模式启动数据库并删除 AUDSYS 用户
1 2 3 | SQL> startup migrate pfile=$T_WORK/t_init1.ora ORACLE instance started. SQL> drop user audsys cascade; |
删除 AUDIT_ADMIN 和 AUDIT_VIEWER roles
1 2 | DROP ROLE AUDIT_ADMIN; DROP ROLE AUDIT_VIEWER; |
在升级过程中把某些 schema 的表空间置于 offline
记下所有在升级过程中需要 offline 的表空间，使用 -T 选项指定表空间的名字
1 | dbupgrade –T |
从 Oracle database 12.2 开始，可以在并行升级时使用 -T 参数来 offline 一些用户表空间。把用户表空间 offline 可以减少升级前的备份工作。并行升级工具（catctl.pl）可以自动选取正确的表空间来设置为只读。这个工具不会把任何包含Oracle 自带的对象的表空间设置为只读。
注意: 不要执行这个步骤，因为 dbupgrade -T 会执行升级的动作。我们在 Pre-upgrade 阶段提及这个命令只是让大家记下 tablespace 的名字，这样在稍后真正升级的步骤里可以把 tablespace name 指定到 dbupgrade 的 -T 参数之后。
保留降级的能力
如果计划把数据库降级到之前的版本，那么需要在源库上打 patch 20898997，否则不能降级。
在源库执行：
1 | $ORACLE_HOME/OPatch/opatch lsinventory -bugs_fixed |grep –i "20898997" |
如果尚未应用这个补丁，那么从 MOS 下载 patch 20898997 并安装。
关于 Audit table 的升级前要求
如果要升级的数据库版本低于 12.1 并且使用了 Oracle database Vault，Oracle Label Security，那么必须先执行 olspreupgrade.sql。从目标 Oracle_home 拷贝 $ORACLE_HOME/rdbms/admin/olspreupgrade.sql 到源库的ORACLE_HOME，使用 DVOWNER 登陆源库
1 | SQL> GRANT DV_PATCH_ADMIN to SYS; |
在把 DV_PATCH_ADMIN 权限赋给 SYS 后，使用 SYSDBA 登陆
CONNECT SYS AS SYSDBA
执行 olspreupgrade.sql
1 | SQL>ORACLE_HOME/rdbms/admin/olspreupgrade.sql |
执行完毕后，以 DVOWNER 登陆数据库并收回 SYS 的 DV_PATCH_ADMIN 权限
1 | SQL> REVOKE DV_PATCH_ADMIN from SYS; |
集群数据库的需要
在升级数据库前需要先升级 GI 软件。如果是 RAC，那么需要把参数文件中的 CLUSTER_DATABASE 参数设置为 false。
注意！在升级完毕后需要把CLUSTER_DATABASE再设置回来
升级前先解决Outstanding分布式事务
要解决 outstanding 分布式事务:
- 执行下面的语句：
1 | SQL> Select * from dba_2pc_pending; |
- 如果有返回数据，则执行下面的语句：
1 2 3 4 5 | SQL> select local_tran_id FROM dba_2pc_pending; SQL> execute dbms_transaction.purge_lost_db_entry(''); SQL> commit; |
其它检查
确保 ARCHIVE_LOG 以及 FLASHBACK 目录有足够的磁盘空间。
执行下面的查询来检查是否有和SDO_GEOMETRY关联的表
1 2 3 4 | col owner format a15 col table_name format a30 col column_name format a30 SELECT owner,table_name,column_name FROM dba_tab_columns WHERE data_type = 'SDO_GEOMETRY' AND owner != 'MDSYS' ORDER BY 1,2,3; |
如果有返回行数，那么在升级前需要往12.2的ORACLE HOME上打补丁 patch 25293022
- 如果安装了 Oracle Spatial (SDO)，那么为了避免碰到 Note 2547520.1 中提到的问题，您需要在升级前应用补丁 29715479
步骤6：Preupgrade 步骤
在源库执行 Preupgrade 脚本
1 | $Earlier_release_Oracle_home/jdk/bin/java -jar $New_release_Oracle_home/rdbms/admin/preupgrade.jar FILE TEXT DIR output_dir |
FILE - 使用这个参数把输出写入输出文件
TEXT - 使用这个参数指定日志格式为 TEXT 模式（如果不指定的话则为 XML 格式）
DIR - 日志会创建在
建议执行 pre-upgrade 的 fixup 脚本，如果发现的问题是可以使用这个脚本修复的话。
Network Utility 包的依赖关系
执行下面的语句
1 | SQL> SELECT * FROM DBA_DEPENDENCIES WHERE referenced_name IN ('UTL_TCP','UTL_SMTP','UTL_MAIL','UTL_HTTP','UTL_INADDR','DBMS_LDAP') AND owner NOT IN ('SYS','PUBLIC','ORDPLUGINS'); |
在升级测试中，确保使用新的访问控制。在升级后确保这些包是可用的，在升级后，根据源库的使用情况赋予正确的权限。
检查 Time zone 文件版本
检查目标数据库的 time zone 文件版本是否低于源库的 time zone 文件版本，如果是的话，需要升级目标数据库的 time zone 文件版本。数据库 DST 补丁可以从 Note 412160.1 下载。
步骤7：升级数据库到 12.2
关闭数据库
1 | SQL> SHUTDOWN IMMEDIATE |
Windows平台的步骤 :
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
如果操作系统是Windows，那么完成下面的步骤：
a. 停掉要升级的数据库 OracleServiceSID Oracle service，这里的SID是实例名。比如，如果SID是ORCL，那么执行下面的命令：
1 | C:\> NET STOP OracleServiceORCL |
b. 使用ORADIM来删除 Oracle service。请参考平台相关的文档来获取ORADIM命令的格式。
比如，如果您的SID是ORCL，那么执行下面的命令。
1 | C:\> ORADIM -DELETE -SID ORCL |
c. 使用新ORACLE软件的ORADIM来创建 service。
比如:
1 | C:\> ORADIM -NEW -SID SID -SYSPWD PASSWORD -MAXUSERS USERS -STARTMODE AUTO -PFILE ORACLE_HOME\DATABASE\INITSID.ORA |
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
设置环境变量指向目标 ORACLE_HOME
1 2 3 | export ORACLE_HOME=<Oracle 12.2的目录> export PATH=$ORACLE_HOME/bin:$PATH export ORACLE_BASE=<安装时指定的Oracle_Base目录> |
注意：删除所有仍指向旧的ORACLE_HOME的环境变量
使用目标 ORACLE_HOME（设置 ORACLE_HOME 为目标 ORACLE_HOME）启动数据库到 upgrade 模式
1 2 3 | CONNECT / AS SYSDBA SQL> startup upgrade; SQL> exit |
在 Linux/Unix 上
1 2 | cd $ORACLE_HOME/bin ./dbupgrade |
在 Windows 上
1 2 | cd %ORACLE_HOME%\bin dbupgrade |
执行 Post-Upgrade Status 工具，utlu122s.sql 并且检查升级的日志。在新的版本下执行 Post-Upgrade Status 工具。
1 2 3 | $ sqlplus "/as sysdba" SQL> STARTUP SQL> @utlu122s.sql |
检查升级日志看是否脚本 catuppst.sql 已被执行。如果尚未执行，那么在新的 ORACLE_HOME 里手工执行。这个脚本被放置在 $ORACLE_HOME/rdbms/admin 目录。
1 | SQL> @catuppst.sql |
在另一个 session 里执行 utlrp.sql 来编译 stored PL/SQL 和 Java 代码。
1 | SQL> @utlrp.sql |
检查诊断升级/迁移相关的状态的 Oracle 数据字典。dbupgdiag.sql 脚本可以收集和升级迁移诊断信息有关的数据字典的信息，可以在升级的数据库上以 SYS 用户来执行它，关于更多信息，请参考文档 Note 556610.1 Script to Collect DB Upgrade/Migrate Diagnostic Information (dbupgdiag.sql)
如果脚本 dbupgdiag.sql 发现了失效对象，执行 $ORACLE_HOME/rdbms/admin/utlrp.sql (多次) 来使它们生效，直到失效对象的个数不再改变。之后重新执行 dbupgdiag.sql 并确保没有任何问题。
如果使用了集群，那么必须升级这个数据库的 Oracle Clusterware keys，运行 srvctl 来完成，比如：
1 | ORACLE_HOME/bin/srvctl upgrade database -db name -o ORACLE_HOME |
步骤8：升级后步骤
在 Linux 和 Unix 上设置环境变量
确保下面的环境变量指向了新的 ORACLE_HOME 对应的目录：
ORACLE_HOME
PATH
更新 oratab 文件
修改 /etc/oratab 文件对应的条目指向新的 ORACLE_HOME 目录
Post-upgrade fixup 脚本
执行 pre-upgrade 产生的 post-upgrade fixup 脚本
升级依赖 Oracle-Maintained 类型的表
从 Oracle 12.2 开始，必须手工升级依赖 Oracle-Maintained 类型的用户表。
在数据库升级后确认需要升级的用户表，使用 SYSDBA 连接到数据库并执行下面的语句来列出这些表：
1 2 3 4 5 6 | COLUMN owner FORMAT A30 COLUMN table_name FORMAT A30 SELECT DISTINCT owner, table_name FROM dba_tab_cols WHERE data_upgraded = 'NO' ORDER BY 1,2; |
使用 sysdba 权限的用户，或者有权限 alter 所有这些表的用户执行脚本 utluptabdata.sql：
1 2 | SET SERVEROUTPUT ON @utluptabdata.sql |
启用新的 Extended Data Type 功能（并不是必须的）
启用 extended data types 需要一些特定的操作。
Oracle 数据库 12c 引入了扩展 VARCHAR2，NVARCHAR2，以及 RAW 数据类型的大小的功能。设置 MAX_STRING_SIZE = EXTENDED 可以扩展这些数据类型最大限制到32767字节。
