Sunday, July 11, 2021

Database Preupgrade tool check list. (Doc ID 2380601.1)

 

APPLIES TO:

Oracle Database Exadata Express Cloud Service - Version N/A and later
Gen 1 Exadata Cloud at Customer (Oracle Exadata Database Cloud Machine) - Version N/A and later
Oracle Cloud Infrastructure - Database Service - Version N/A and later
Oracle Database Backup Service - Version N/A and later
Oracle Database Cloud Exadata Service - Version N/A and later
Information in this document applies to any platform.

PURPOSE

To list out the checks run by the preupgrade tool. To see which checks will be raised for your database, run the preupgrade tool and check the preupgrade logs.

SCOPE

Database Upgrade

DETAILS

 

Preupgrade Tool Check list

Name of Check

Description

Fixup Action

Severity

Fixup Stage

Min Version (inclusive) Check applies

Max Version (exclusive) Check applies

Manual fix up or automatic

AMD_EXISTS

Starting with Oracle Database 12c, the OLAP Catalog (OLAP AMD) is desupported and will be automatically marked as OPTION OFF during the database upgrade if present. Oracle recommends removing OLAP Catalog (OLAP AMD) before database upgrade. This step can be manually performed before the upgrade to reduce downtime.

Remove OLAP Catalog by running the {1} SQL script $ORACLE_HOME/olap/admin/catnoamd.sql script.

WARNING

PRE

NONE

NONE

MANUAL

APEX_MANUAL_UPGRADE

Starting with Oracle Database Release 18, APEX is not upgraded automatically as part of the database upgrade. Refer to My Oracle Support Note 1088970.1 for information about APEX installation and upgrades.

Upgrade Oracle Application Express (APEX) manually before the database upgrade.

WARNING

PRE

NONE

NONE

MANUAL

APPL_PRINCIPAL

Starting with Oracle Database 19, application principals are no longer supported.

It is strongly advised to remove any application principals. Delete user names and roles using procedure delete_application_principal from package xdb.dbms_xdbz.

WARNING

PRE

NONE

19.1

MANUAL

AUDIT_RECORDS

A large number of Audit Records can slow down database upgrade because these records will be updated during the upgrade.

Review My Oracle Support Note 1329590.1 for a list of options to process a large number of Audit Records before database upgrade, to reduce upgrade down time.

RECOMMEND

PRE

10.1.0.0

11.2.0.0

MANUAL

AUDTAB_ENC_TS

Oracle Encryption Wallet must be opened during database upgrade if there are audit tables stored in encrypted tablespaces.

Open the Oracle Encryption Wallet after the database has been opened in the upgrade mode in the target Oracle home.

WARNING

PRE

NONE

NONE

MANUAL

AWR_DBIDS_PRESENT

Inactve AWR DBIDs should be updated after the upgrade completes.

To update the inactive DBIDs in AWR, run the script awrupd12.sql as SYSDBA.

WARNING

POST

10.2.0.0

12.1.0.1

MANUAL

CASE_INSENSITIVE_AUTH

Starting with Oracle Database release 12.2, Exclusive Mode is the default password-based authentication mode. Case insensitive password authentication is not supported in Exclusive Mode. If your system needs to use case insensitive password authentication, Exclusive Mode must be switched off prior to the upgrade. See the Network Reference Manual chapter about the SQLNET.ORA parameter SQLNET.ALLOWED_LOGON_VERSION_SERVER for more details on Exclusive Mode.

Remove the SEC_CASE_SENSITIVE_LOGON instance initialization parameter setting, to configure your system to use case sensitive password authentication by default.

WARNING

PRE

NONE

NONE

MANUAL

CDB_ONLY_SUPPORT

Starting with Oracle Database Release 21c, non-container databases (non-CDBs) are not supported for direct upgrades.

Refer to Database Upgrade Guide documentation for options on how to handle non-CDB upgrades to Oracle Database Release 21c or to a later release.

ERROR

PRE

NONE

20.0

MANUAL

COMPATIBLE_NOT_SET

COMPATIBLE initialization parameter must be explicitly set in the pfile/spfile.

Set a value for the compatible parameter in pfile/spfile.

ERROR

PRE

NONE

NONE

MANUAL

COMPATIBLE_PARAMETER

The minimum setting for the COMPATIBLE initialization parameter in the target release, {1}, is {2}.

Caution: Oracle strongly recommends that you do not make this change until you are ready to upgrade. After you raise the compatible setting downgrade to earlier releases may not be possible.

Change the COMPATIBLE initialization parameter to at least {2} before database upgrade.

ERROR

PRE

NONE

NONE

MANUAL

CONC_RES_MGR

If the concurrent statistics preference is set to any value other than OFF, then Resource Manager must be enabled, else the concurrent statistics must be changed in DBMS_STATS.SET_GLOBAL_PREFS(). 

For further information see My Oracle Support Note 2049013.1.

Disable concurrent statistics gathering by setting the CONCURRENT statistics preference to OFF or enable Resource Manager.

To disable the CONCURRENT statistics preference use:

 

EXECUTE {2};

WARNING

PRE

NONE

NONE

AUTO

CYCLE_NUMBER

The number of PDBs upgraded in parallel and the number of parallel processes per PDB can be adjusted as described in Database Upgrade Guide.

No action needed.

INFO

PRE

12.1.0.1

NONE

MANUAL

DATA_MINING_OBJECT

If the -T option will be used to set user tablespaces to READ ONLY during the upgrade process, then user tablespaces containing Data Mining objects will not be set to READ ONLY mode as they may require upgrade actions.

No action required.

INFO

VALIDATION

NONE

NONE

MANUAL

DBMS_STATS_METHOD_OPT

method_opt preference value of dbms_stats must be set to a valid value. An invalid preference value can cause errors and affect upgrade of the database when RDBMS components try to gather statistics.

Please set the dbms_stats preference of method_opt to a valid value. To set the global preference to the Oracle recommended default value use the following command.

 

EXECUTE dbms_stats.set_param('METHOD_OPT', null);

 

The preference can be set for a specific table as well. For example, by setting the preference for SH.SALES as follows, Oracle decides the columns that need histograms automatically, except for column prod_id. For column prod_id, histograms will not be collected.

 

EXECUTE dbms_stats.set_table_prefs('SH', 'SALES', 'METHOD_OPT',

'FOR ALL COLUMNS SIZE AUTO FOR COLUMNS SIZE 1 PROD_ID');

ERROR

PRE

NONE

NONE

MANUAL

DEFAULT_RESOURCE_LIMIT

The RESOURCE_LIMIT initialization parameter default value changed from FALSE to TRUE in 12.1.0.2 onwards. Without an explicit setting, the upgrade may introduce unintented RESOURCE_LIMIT enforcement.

Explicitly set RESOURCE_LIMIT to FALSE in the pfile/spfile to retain the previous behavior.

WARNING

VALIDATION

10.2.0.0

12.1.0.2

MANUAL

DEPEND_USR_TABLES

If the -T option is used to set user tablespaces to READ ONLY during the upgrade, user tables in those tablespaces, that are dependent on Oracle-Maintained types, will not be automatically upgraded. If a type is evolved during the upgrade, any dependent tables need to be re-validated and upgraded to the latest type version AFTER the database upgrade completes.

If you use the -T option for the database upgrade, then run $ORACLE_HOME/rdbms/admin/utluptabdata.sql after the upgrade is complete, to VALIDATE and UPGRADE any user tables affected by changes to Oracle-Maintained types.

WARNING

POST

NONE

NONE

AUTO

DESUPPORT_RAC_ON_SE

Oracle Real Application Clusters is not supported in Oracle Database Standard Edition 19c and later releases. Refer to My Oracle Support note 2504078.1 for more details.

If you plan to continue using Oracle Real Application Clusters on 19c or later releases, install Oracle Database Enterprise Edition to upgrade your database. If you plan to continue using Oracle Database Standard Edition without Oracle Real Application Clusters enabled, convert your database to a single instance Oracle Database before upgrading.

WARNING

PRE

NONE

19.1

MANUAL

DICTIONARY_STATS

Dictionary statistics help the Oracle optimizer find efficient SQL execution plans and are essential for proper upgrade timing. Oracle recommends gathering dictionary statistics in the last 24 hours before database upgrade.

 

For information on managing optimizer statistics, refer to the {1}.

Gather stale data dictionary statistics prior to database upgrade in off-peak time using:

 

EXECUTE DBMS_STATS.GATHER_DICTIONARY_STATS;

RECOMMEND

VALIDATION

NONE

NONE

AUTO

DIR_SYMLINKS

Starting in Release 18c, symbolic links are not allowed in directory object path names used with BFILE data types, the UTL_FILE package, or external tables.

To identify directory objects with symbolic links in the path name, run $ORACLE_HOME/rdbms/admin/utldirsymlink.sql AS SYSDBA after upgrade. Recreate any directory objects listed, using path names that contain no symbolic links.

WARNING

POST

NONE

NONE

MANUAL

DIR_SYMLINKS_EXIST

Starting in Release 18c, symbolic links are not allowed in directory object path names used with BFILE data types, the UTL_FILE package, or external tables.

Recreate any directory objects listed, using path names that contain no symbolic links.

WARNING

PRE

NONE

NONE

MANUAL

DV_NO_OLS

Oracle Label Security must be installed if Oracle Database Vault is installed. Install

Oracle Label Security in the database prior to Database Upgrade. Refer to the {1} Oracle Label Security Administrator's Guide for further details.

ERROR

PRE

NONE

NONE

MANUAL

DV_ROLE_GRANTS

Starting in release 21c, Database Vault roles - DV_PUBLIC, DV_REALM_OWNER, DV_REALM_RESOURCE - are desupported and dropped during database upgrades with no replacement. Refer to 21c Database Upgrade Guide for more information.

You must revoke the following to-be-desupported Database Vault roles from any users or roles: {1}. If needed, create new roles to replace these roles and grant the new roles to appropriate users or roles.

ERROR

PRE

NONE

22.1

MANUAL

DV_SIMULATION

Database Vault simulation log records are specific to the Oracle Database release that generates them, and are unusable upon database upgrade.

Review and remove the existing DV simulation log records. Delete the contents of the DVSYS.OLD_SIMULATION_LOG$ table as user with DV_ADMIN/DV_OWNER role.

INFO

POST

12.2.0.1

NONE

MANUAL

EDS_EXISTS

Starting with Oracle Database 19, dbms_logstdby extended datatype support (EDS) is no longer supported. It is strongly advised to remove any EDS TABLE rules.

Execute dbms_logstdby.eds_remove_table for any EDS enabled table.

WARNING

POST

NONE

19.1

MANUAL

EM_PRESENT

Starting with Oracle Database 12c, the local Enterprise Manager Database Control does not exist anymore. The repository will be removed from your database during the upgrade. This step can be manually performed before the upgrade to reduce downtime.

Remove the EM repository.

 

- Copy the $ORACLE_HOME/rdbms/admin/emremove.sql script from the target {1} ORACLE_HOME into the source {2} ORACLE_HOME.

 

Step 1: If database control is configured, stop EM Database Control, using the following command

 

$> emctl stop dbconsole

 

Step 2: Connect to the database using the SYS account AS SYSDBA

 

SET ECHO ON;

SET SERVEROUTPUT ON;

@emremove.sql

 

Without the set echo and serveroutput commands, you will not be able to follow the progress of the script.

WARNING

PRE

NONE

12.1.0.1

MANUAL

ENABLED_INDEXES_TBL

Table sys.enabled$indexes should not exist in the source database prior to upgrade.

Drop table sys.enabled$indexes.

WARNING

PRE

NONE

NONE

AUTO

EXCLUSIVE_MODE_AUTH

Starting with Oracle Database release 12.2.0.1, Exclusive Mode is the new default password-based authentication mode. All Exclusive Mode login/authentication attempts will fail for preexisting user accounts which only have the 10G password version and neither the 11G or 12C password version (see DBA_USERS.PASSWORD_VERSIONS.) For more information, refer to "Understanding Password Case Sensitivity and Upgrades" in the Oracle Database Upgrade Guide.

Perform one of the following:

1) Expire user accounts that use only the old 10G password version and follow the procedure recommended in Oracle Database Upgrade Guide under the section entitled, "Checking for Accounts Using Case-Insensitive Password Version".

2) Explicitly set SQLNET.ALLOWED_LOGON_VERSION_SERVER in the {1} SQLNET.ORA to a non-Exclusive Mode value, such as "11". (This is a short term approach and is not recommended because it will retain known security risks associated with the 10G password version.)

WARNING

PRE

NONE

12.2.0.1

MANUAL

EXF_RUL_EXISTS

Starting with Oracle Database release 12.1, the Expression Filter (EXF) and Database Rules Manager (RUL) features are desupported, and are removed during the upgrade process. This step can be manually performed before the upgrade to reduce downtime.

Run $ORACLE_HOME/rdbms/admin/catnoexf.sql located in the new Oracle Database Oracle home to remove both EXF and RUL.

INFO

PRE

NONE

12.1.0.1

MANUAL

FILES_BACKUP_MODE

No files should be in backup mode prior to database upgrade.

Ensure that no files are in backup mode before database upgrade.

ERROR

PRE

10.2.0.0

12.1.0.1

MANUAL

FILES_NEED_RECOVERY

There cannot be any files that need media recovery in the database.

Recover files listed in v$recover_file.

ERROR

PRE

NONE

NONE

MANUAL

FIXED_TABLES_DEPENDENCY

Oracle does not guarantee that dictionary fixed tables structure remain unchanged between releases. Therefore, users should not create objects that depends on these fixed tables. Any customer-created objects dependent on fixed tables may become invalid during upgrades. Refer to My Oracle Support Note 361757.1 for details.

Drop the non-Oracle-Maintained objects which have a dependency on dictionary fixed tables.

WARNING

PRE

NONE

NONE

MANUAL

HIDDEN_PARAMS

Remove hidden parameters before database upgrade unless your application vendors and/or Oracle Support state differently. Changes will need to be made in the pfile/spfile.

Review and remove any unnecessary HIDDEN/UNDERSCORE parameters.

RECOMMEND

PRE

NONE

NONE

MANUAL

INVALID_LAF

The LOG_ARCHIVE_FORMAT initialization parameter must contain the format strings %s, %t, and %r.

Update the value of LOG_ARCHIVE_FORMAT initialization parameter.

ERROR

PRE

NONE

NONE

MANUAL

INVALID_OBJECTS_EXIST

There should be no INVALID objects in SYS/SYSTEM or user schemas before database upgrade.

Run {1} $ORACLE_HOME/rdbms/admin/utlrp.sql to recompile invalid objects. You can view the individual invalid objects with

 

SET SERVEROUTPUT ON;

EXECUTE DBMS_PREUP.INVALID_OBJECTS;

WARNING

PRE

NONE

NONE

MANUAL

INVALID_SYS_TABLEDATA

To prevent data loss during database upgrade, all object type columns in tables owned by Oracle-Supplied users must be current prior to the upgrade or plugin.

You must upgrade Oracle-Maintained tables using prior versions of evolved types. Use ALTER TABLE ... UPGRADE INCLUDING DATA.

ERROR

VALIDATION

NONE

NONE

AUTO

INVALID_USR_TABLEDATA

To prevent data loss during database upgrade, all table columns dependent on Oracle-Maintained object types must be current prior to the upgrade or plugin.

You must upgrade user table data to the latest versions of Oracle-Maintained object types. Use ALTER TABLE ... UPGRADE INCLUDING DATA.

ERROR

VALIDATION

NONE

NONE

AUTO

JAVAVM_JIT_MEMORY

The JAVAVM JIT uses POSIX or file based shared memory on UNIX/LINUX platforms to store compiled methods. This memory is NOT managed as part of the SGA. A minimum of 1.25M bytes of space is required to upgrade a non-CDB database or for each PDB database in a CDB. A minimum of 16M bytes is required for applications or triggers in a non-CDB database or for each PDB database in a CDB.

Check JAVA JIT shared memory size and adjust the size as needed. At the minimum, the size should be enough for the database upgrade. Consult the Oracle Database Java Developers Guide, the platform specific Database Installation Guide, and the O/S documentation for details on how to check or modify the size of this shared memory.

RECOMMEND

PRE

18.0.0.0

NONE

MANUAL

JAVAVM_STATUS

JAVAVM component must be functioning properly before database upgrade.

Contact Oracle Support for instructions on how to resolve this error.

ERROR: ORA{1} {2}

ERROR

PRE

NONE

NONE

MANUAL

JOB_QUEUE_PROCESS_0

Starting with Oracle Database 11.2, setting JOB_QUEUE_PROCESSES=0 will disable job execution via DBMS_JOBS and DBMS_SCHEDULER.

Set the value of JOB_QUEUE_PROCESSES to a non-zero value, or remove the setting entirely and accept the Oracle default.

ERROR

PRE

NONE

NONE

MANUAL

JOB_TABLE_INTEGRITY

Starting with Oracle Database 19c, jobs created and managed through DBMS_JOB package in previous database versions will be re-created using Oracle Scheduler architecture. Jobs not successfully re-created may not function properly after upgrade.

Fix the metadata for the DBMS_JOB jobs listed below before upgrading the database to ensure these jobs can be properly re-created, or drop them if no longer needed. For reference, check the section "Summary of DBMS_JOB Subprograms" in the Oracle Database PL/SQL Packages and Types Reference documentation.

 

{1}

WARNING

PRE

NONE

19.1

MANUAL

JVM_MITIGATION_PATCH

The upgrade may fail if Java development is disabled. When active, the OJVM Mitigation patch disables Java development in the database. Oracle strongly recommends installing the latest OJVM PSU in both the {1} and {2} ORACLE_HOMEs which will eliminate the need for the mitigation patch. Doing that in {2} will not incur any database downtime and will eliminate the same vulnerability during the next upgrade. If you cannot apply the OJVM PSU, you may opt to retain the mitigation patch in {1}, but Java development still must be enabled during the upgrade. Please refer to MOS note 1929745.1 for more details.

If you plan on continuing to use the Oracle mitigation patch instead of installing the Oracle recommended Oracle JavaVM (OJVM) Patch Set Update (PSU), then you should enable Java development just before upgrade using the command:

 

EXECUTE SYS.DBMS_JAVA_DEV.ENABLE;

 

Taking this action will make your database subject to a known security vulnerability, but without the PSU patch, Java development must still be enabled to allow some upgrade actions to complete. The execution of the fixup provided by this check in the preupgrade_fixups.sql script will enable Java development. Extreme caution is advised.

WARNING

PRE

NONE

NONE

AUTO

MIN_ARCHIVE_DEST_SIZE

The database has archiving enabled. The upgrade process will need free disk space in the archive log destination(s) to generate archived logs to.

Ensure there is additional disk space in {2} for at least {3} of archived logs. Check alert log during the upgrade that there is no write error to the destination due to lack of disk space.

INFO

PRE

NONE

NONE

MANUAL

MIN_RECOVERY_AREA_SIZE

The database has {1} enabled, and the upgrade process will need free space to generate {2} to the recovery area specified by initialization parameter DB_RECOVERY_FILE_DEST. The logs generated must not overflow the limit set by DB_RECOVERY_FILE_DEST_SIZE, as that can cause the upgrade to not proceed.

Set DB_RECOVERY_FILE_DEST_SIZE initialization parameter to at least {7}. Check alert log during the upgrade to ensure there is remaining free space available in the recovery area.

ERROR

PRE

NONE

NONE

MANUAL

MV_REFRESH

Oracle recommends that all materialized views (MV's) are refreshed before upgrading the database because this will clear the MV logs and the sumdelta$ table, and make the UPGRADE process faster. If you choose to not refresh some MVs, the change data for those MV's will be carried through the UPGRADE process. After UPGRADE, you can refresh the MV's and MV incremental refresh should work in normal cases.

Please make sure that all the MVs are refreshed and sys.sumdelta$ becomes empty before doing upgrade, unless you have strong business reasons not to do so. You can use dbms_mview.refresh() to refresh the MVs except those stale ones to be kept due to business need. If there are any stale MVs depending on changes in sys.sumdelta$, do not truncate it, because doing so will cause wrong results after refresh.

RECOMMEND

PRE

NONE

NONE

MANUAL

NETWORK_ACL_PRIV

Network access control list (ACL) privileges in 11g will be migrated to a new format in 12c. As part of the migration, new DBMS_NETWORK_ACL_ADMIN interfaces and dictionary views are provided, and privileges in the existing ACLs will be converted to the new format with new ACL names. The old ACL names, DBMS_NETWORK_ACL_ADMIN interfaces and dictionary views may continue to be used but are deprecated and their use is discouraged. For further information, refer to My Oracle Support note number 2078710.1.

Backup the existing ACLs and their assignments for reference. Use the new DBMS_NETWORK_ACL_ADMIN interfaces and dictionary views to administer network privileges after upgrade.

WARNING

PRE

NONE

12.1.0.1

MANUAL

NEW_TIME_ZONES_EXIST

The time zone file version used in your database must exist in the new Oracle home before upgrading the database.

Patch the new {3} $ORACLE_HOME/oracore/zoneinfo/ with the version {2} time zone data file from the {1} $ORACLE_HOME/oracore/zoneinfo/.

WARNING

PRE

NONE

NONE

MANUAL

OBJERROR

Objerror$ should have rows only for objects with errors.

Sys.objerror$ must be clean before upgrading. To remove rows that do not belong in this table, run AutoUpgrade in fixups mode.

WARNING

PRE

NONE

NONE

AUTO

OLAP_PAGE_POOL_SIZE

The OLAP_PAGE_POOL_SIZE initialization parameter controls the size of of the OLAP page pool. Without an explicit setting or with it set to 0, OLAP will dynamically resize the pool as needed. Setting it to a non-zero value will cause OLAP to allocate that amount of memory as a fixed-size pool, and never resize the pool. Oracle recommends removing the parameter from the pfile/spfile.

Set OLAP_PAGE_POOL_SIZE in the pfile/spfile to 0 before the upgrade, or remove the setting entirely and accept the Oracle default.

WARNING

PRE

NONE

NONE

MANUAL

OLD_TIME_ZONES_EXIST

Oracle recommends upgrading to the desired (latest) version of the time zone file. For more information, refer to "Upgrading the Time Zone File and Timestamp with Time Zone Data" in the {3} Oracle Database Globalization Support Guide.

Upgrade the database time zone file using the DBMS_DST package.

WARNING

POST

NONE

NONE

MANUAL

OLS_SYS_MOVE

As part of the upgrade to {2}, records in the {1} audit table SYSTEM.AUD$ are moved to SYS.AUD$. This step can be manually performed before the upgrade to reduce downtime. Refer to the {2} Oracle Label Security Administrator's Guide, or to Oracle Database Upgrade Guide for further details.

Logged in AS SYSDBA, run $ORACLE_HOME/rdbms/admin/olspreupgrade.sql from the new Oracle Database {2} home.

ERROR

PRE

10.2.0.0

12.1.0.1

MANUAL

OLS_VERSION

Label Security must either be at the same version as the database or at a version supported for direct database upgrades.

Uninstall Label Security. Refer to My Oracle Support Note 2046002.1 for more details.

WARNING

PRE

NONE

NONE

MANUAL

ORACLE_RESERVED_USERS

Oracle occasionally adds new internal USERs and ROLEs as the database evolves. To avoid a name conflict in the upgraded version, a source database must not contain any USER or ROLE with a name that matches one reserved by Oracle in the target release.

You must drop the following USERs or ROLEs from the database: {1}

ERROR

PRE

NONE

NONE

MANUAL

ORDIMAGEINDEX

The Oracle Multimedia image domain index, ORDSYS.OrdImageIndex, is no longer supported starting in Oracle Database 11g Release 2 (11.2) and will be removed during database upgrade to version {1}. This step can be manually performed before the upgrade to reduce downtime.

Remove Oracle Multimedia image domain index ORDSYS.OrdImageIndex.

INFO

PRE

11.2.0.0

NONE

MANUAL

ORDIM_DESUPPORT

Starting in release 19c, Oracle Multimedia is desupported. Object types still exist, but methods and procedures will raise an exception. Refer to {1} Oracle Database Upgrade Guide or the Oracle Multimedia README.txt file in <{1} ORACLE_HOME>/ord/im/admin/README.txt for more information.

After upgrade, move data stored in Oracle Multimedia object types to SecureFiles LOBs.

INFO

PRE

NONE

NONE

MANUAL

ORDIM_INFO_DESUPPORT

Starting in release 19c, Oracle Multimedia is desupported. Object types still exist, but methods and procedures will raise an exception. Refer to {1} Oracle Database Upgrade Guide, the Oracle Multimedia README.txt file in <{1} ORACLE_HOME>/ord/im/admin/README.txt, or MOS note 2555923.1 for more information.

Follow the instructions in the Oracle Multimedia README.txt file in <{1} ORACLE_HOME>/ord/im/admin/README.txt, or MOS note 2555923.1 to determine if Oracle Multimedia is being used. If Oracle Multimedia is being used, refer to MOS note 2347372.1 for suggestions on replacing Oracle Multimedia.

INFO

PRE

NONE

NONE

MANUAL

OVERLAP_NETWORK_ACL

Network Access Control Lists for a host with overlapping port range assignments cannot be upgraded. Refer to the {1} Oracle Database Security Guide for instructions.

Unassign network ACLs. The overlapping ACLs can be found by executing the query:

 

SELECT n1.acl, n1.host, n1.lower_port, n1.upper_port

FROM dba_network_acls n1 WHERE EXISTS

(SELECT * FROM dba_network_acls n2

WHERE n1.host = n2.host AND NOT

(n1.lower_port = n2.lower_port AND n2.upper_port = n1.upper_port) AND

((n1.lower_port <= n2.lower_port AND n2.lower_port <= n1.upper_port) OR

(n1.lower_port <= n2.upper_port AND n2.upper_port <= n1.upper_port) OR

(n2.lower_port <= n1.lower_port AND n1.lower_port <= n2.upper_port) OR

(n2.lower_port <= n1.upper_port AND n1.upper_port <= n2.upper_port)));

ERROR

PRE

11.1.0.7

12.1.0.1

MANUAL

PARAMETER_DEPRECATED

These deprecated parameters probably will be obsolete in a future release.

Consider removing the following deprecated initialization parameters.

INFO

PRE

NONE

NONE

MANUAL

PARAMETER_MIN_VAL

The database upgrade process requires certain initialization parameters to meet minimum values. The Oracle upgrade process itself has minimum values which may be higher and are marked with an asterisk. After upgrading, those asterisked parameter values may be reset if needed.

Update NUMERIC INITIALIZATION PARAMETERS to meet estimated minimums. This action may be done now or when starting the database in upgrade mode using the {1} ORACLE HOME.

WARNING

PRE

NONE

NONE

MANUAL

PARAMETER_NEW_NAME_VAL

Oracle has renamed some of the initialization parameter values since the earlier release. See Oracle documentation for details.

Rename the following initialization parameters and their values when starting the database in upgrade mode using the {1} ORACLE HOME.

WARNING

PRE

NONE

NONE

MANUAL

PARAMETER_OBSOLETE

If parameters that are obsolete or removed from the target release are present in the pfile/spfile, the Oracle database may not start, or it may start with an ORA- error.

Remove initialization parameters that Oracle has obsoleted or removed. This action may be done now or when starting the database in upgrade mode using the target ORACLE HOME.

WARNING

PRE

NONE

NONE

MANUAL

PARAMETER_RENAME

Oracle has renamed some of the initialization parameters since the earlier release. See Oracle documentation for details.

Rename the following initialization parameters when starting the database in upgrade mode using the {2} ORACLE HOME.

WARNING

PRE

NONE

NONE

MANUAL

PA_PROFILE

Privilege Analysis profiles should be disabled and generated results before an upgrade to version {1}.

Disable and generate results for profiles or drop profiles.

WARNING

PRE

12.1

NONE

MANUAL

PENDING_DST_SESSION

There must not be any Daylight Savings Time (DST) update operations pending in the database before starting the upgrade process.

Refer to My Oracle Support Note 1509653.1 for more information.

Complete any pending DST update operation before starting the database upgrade.

ERROR

PRE

NONE

NONE

MANUAL

PGA_AGGREGATE_LIMIT

PGA_AGGREGATE_LIMIT has to meet a minimum size for database startup in {1} Oracle home.

Set PGA_AGGREGATE_LIMIT in the pfile/spfile to at least {3} before upgrade or remove the setting entirely to accept the Oracle default.

ERROR

PRE

12.1.0.1

NONE

MANUAL

POST_DICTIONARY

Dictionary statistics provide essential information to the Oracle optimizer to help it find efficient SQL execution plans. After a database upgrade, statistics need to be re-gathered as there can now be tables that have significantly changed during the upgrade or new tables that do not have statistics gathered yet.

Gather dictionary statistics after the upgrade using the command:

 

EXECUTE DBMS_STATS.GATHER_DICTIONARY_STATS;

RECOMMEND

POST

NONE

NONE

AUTO

POST_DISABLE_BCT_UPG

If Block Change Tracking was disabled for the database upgrade, then re-enable it after upgrade. (CAUTION: Before disabling Block Change Tracking, take into account the time to do a level 0 backup after upgrade.)

Enable Block Change Tracking and perform a level 0 backup before resuming incremental backups for the database. Refer to Oracle Backup and Recovery User's Guide for more details on how to perform and manage Oracle Database Backups.

WARNING

POST

NONE

NONE

MANUAL

POST_FIXED_OBJECTS

Fixed object statistics provide essential information to the Oracle optimizer to help it find efficient SQL execution plans. Those statistics are specific to the Oracle Database release that generates them, and can be stale upon database upgrade.

 

For information on managing optimizer statistics, refer to the {1}.

Gather statistics on fixed objects after the upgrade and when there is a representative workload on the system using the command:

 

EXECUTE DBMS_STATS.GATHER_FIXED_OBJECTS_STATS;

RECOMMEND

POST

NONE

NONE

MANUAL

POST_JVM_MITIGAT_PATCH

Oracle JavaVM Component Database PSU is released as part of the Critical Patch Update program from October 2014 onwards. Oracle recommends applying the latest OJVM PSU patch to ALL databases that have Oracle JavaVM present in the database, regardless of whether you are explicitly using it or not. Even if Oracle JavaVM is not present in the database it is best practice to install the OJVM PSU in case a new database is created in the ORACLE_HOME.

Apply latest Oracle JavaVM (OJVM) Bundle Patch (BP) or Patch Set Update (PSU) if it was not applied before database upgrade on {1} ORACLE_HOME. Please refer to MOS note 1929745.1 for more details. The execution of the fixup provided by this check in the postupgrade_fixups.sql script will disable Java development.

INFO

POST

NONE

NONE

AUTO

PRE_DISABLE_BCT_UPG

Performing database upgrade process while Block Change Tracking feature is enabled may lead to memory overhead.

CAUTION: Before disabling Block Change Tracking, take into account the time to do a level 0 backup after upgrade.
If you decide to disable Block Change Tracking, here is the command
ALTER DATABASE DISABLE BLOCK CHANGE TRACKING;
in the lower version Oracle home before upgrading.
Note: After upgrade, re-enable Block Change Tracking and perform a level 0 backup before resuming incremental backups for the database. Refer to Oracle Backup and Recovery User's Guide for more details on how to perform and manage Oracle Database Backups.

INFO

PRE

NONE

NONE

MANUAL

PRE_FIXED_OBJECTS

Gathering statistics on fixed objects, if none have been gathered yet, is recommended prior to upgrading.

 

For information on managing optimizer statistics, refer to the {1}.

Gather statistics on fixed objects prior the upgrade.

RECOMMEND

PRE

NONE

NONE

AUTO

PURGE_RECYCLEBIN

The recycle bin must be completely empty before database upgrade.

Empty the RECYCLEBIN immediately before database upgrade.

ERROR

VALIDATION

NONE

NONE

AUTO

PWD_VFN_FUNC

The password verification routines VERIFY_FUNCTION and VERIFY_FUNCTION_11G will be dropped during database upgrade, PROFILES making use of them will become unusable. Such routines are part of PASSWORD_VERIFY_FUNCTION to enforce password complexity.

Alter profiles using VERIFY_FUNCTION and VERIFY_FUNCTION_11G routines as PASSWORD_VERIFY_FUNCTION to use a different password verify function.

ERROR

PRE

18.1

NONE

MANUAL

PWFILE_LOCAL_ADMIN

Oracle Password File needs to be present in target ORACLE_HOME during upgrade when altering
PDB local administrative users to NO AUTHENTICATION.

If upgrading a CDB, migrate/copy the Oracle Password File to its respective location in target ORACLE_HOME before upgrade.

WARNING

PRE

12.1.0.1

NONE

MANUAL

REMOTE_REDO

The source database must either be configured with an explicit LOCAL archiving destination using the LOCATION attribute (the preferred method,) or you must move the current REMOTE LOG_ARCHIVE_DEST_1 setting to some other LOG_ARCHIVE_DEST_n, so that LOG_ARCHIVE_DEST_1 is available for local default use by Oracle Data Guard.

The database must either be configured with an explicit LOCAL archiving destination using the LOCATION attribute (the preferred method,) or it must move the current REMOTE LOG_ARCHIVE_DEST_1 setting to some other LOG_ARCHIVE_DEST_n, so that LOG_ARCHIVE_DEST_1 is available for local default use by Oracle Data Guard.

ERROR

PRE

10.2.0.0

11.2.0.1

MANUAL

REPCAT_SETUP

Advanced Replication is not supported beyond 12.2. All related objects will be removed during the upgrade process. It is advised to remove all Master sites first (if any), for more information and steps to remove a Master site look at section 7-31 of the Oracle Database Advanced Replication Management API Reference. It is advised to remove all MV sites (if any), for more information and steps to remove a MV site look at sections 8-1 to 8-10 of the Oracle Database Advanced Replication Management API Reference.

Remove the Advanced Replication feature.

WARNING

PRE

NONE

12.2.0.1

MANUAL

RLP_PARAM

Setting the REMOTE_LOGIN_PASSWORDFILE to SHARED does not enforce secure behavior for administrative users, and certain DDLs like GRANT SYSDBA and ALTER USER are not allowed.

Set REMOTE_LOGIN_PASSWORDFILE initialization parameter to EXCLUSIVE prior to upgrading.

WARNING

PRE

11.2.0.0

12.2.0.1

MANUAL

RMAN_RECOVERY_VERSION

It is good practice to have the catalog schema the same or higher version than the RMAN client version you are using.

Check the Oracle Backup and Recovery User's Guide for information on how to manage an RMAN recovery catalog schema.

INFO

PRE

NONE

NONE

MANUAL

ROLLBACK_SEGMENTS

Rollback Segments must be sized for the upgrade process.

Use a large (minimum 70M) public rollback segment for the upgrade and take smaller public rollback segments OFFLINE.

WARNING

PRE

NONE

NONE

MANUAL

STREAMS_SETUP

Starting with Oracle Database 19, Oracle Streams is desupported. It is strongly advised to remove any streams configuration manually.

Remove Streams setup. For detailed steps, refer to the section "Removing an Oracle Streams Configuration" in the Oracle Streams Concepts and Administration Guide specific for the Oracle release from which you are removing. For versions pre-12.1.0.2, the procedure dbms_streams_adm.remove_streams_configuration must not be used as may lead to unwanted results. Instead, use the other procedures (dbms_capture_adm.drop_capture, dbms_apply_adm.drop_apply, dbms_streams_adm.remove_queue, etc). For 12.1.0.2 and higher, procedure dbms_streams_adm.remove_streams_configuration can be safely used.

WARNING

PRE

NONE

19.1

MANUAL

SYNC_STANDBY_DB

To keep data in the source primary database synchronized with its associated standby databases, all standby databases must be synchronized before database upgrade. See My Oracle Support Note 2064281.1 for details.

Synchronize your standby databases before database upgrade.

INFO

PRE

NONE

NONE

MANUAL

SYS_DEFAULT_TABLESPACE

Having a default tablespace other than SYSTEM for the users SYS and SYSTEM is not supported. The system tablespace is reset to SYSTEM automatically as part of the upgrade process.

Ensure that the default tablespace for both the SYS and SYSTEM users is set to SYSTEM.

WARNING

PRE

NONE

NONE

AUTO

TABLESPACES

Tablespaces that are not AUTOEXTEND must have sufficient space for the upgrade process. Minimum sizes are estimates.

If an AUTOEXTEND tablespace is listed above, it is because datafile maximum size is limited and has to be increased to meet upgrade process requirements.

Ensure there is adequate tablespace for the upgrade.

WARNING

PRE

NONE

NONE

MANUAL

TABLESPACES_INFO

Minimum tablespace sizes for upgrade are estimates.

To help you keep track of your tablespace allocations, the following AUTOEXTEND tablespaces are expected to successfully EXTEND during the upgrade process.

INFO

PRE

NONE

NONE

MANUAL

TDE_IN_USE

If Oracle Transparent Data Encryption (TDE) is in use, the database system must have access to its Oracle Transparent Data Encryption Master Encryption Key during database upgrade. For more information on configuring Transparent Data Encryption, refer to the {1}.

If an auto-login Oracle Transparent Data Encryption (TDE) Keystore is correctly set up, no action needs to be taken. Otherwise, before starting up the database in upgrade mode in the new Oracle Database Oracle Home, either open the TDE Keystore, or ensure that an auto-login TDE Keystore is configured for the system. If errors are seen while the database upgrade is running because the TDE Keystore is closed, then open the TDE Keystore and resume the upgrade (see "catctl.pl -R"). It may be necessary to open the TDE Keystore as the upgrade progresses in a non-CDB or CDB (e.g., in CDB$ROOT and PDB) if no auto-login TDE Keystore has been configured, as the upgrade process can shutdown and startup the database.

WARNING

PRE

11.2.0.4

NONE

MANUAL

TEMPTS_ALLOFFLINE

The default temporary tablespace or tablespace group must include at least one temp file that is online.

Bring at least one temp file online in the default temporary tablespace or tablespace group.

ERROR

PRE

NONE

NONE

MANUAL

TEMPTS_NOTEMPFILE

The default temporary tablespace must have at least one temp file associated.

Add at least one temp file to the listed temporary tablespace.

ERROR

PRE

NONE

NONE

MANUAL

TRGOWNER_NO_ADMNDBTRG

The creation of database triggers must be done by users granted with ADMINISTER DATABASE TRIGGER privilege. Privilege must have been granted directly.

Directly grant ADMINISTER DATABASE TRIGGER privilege to the owner of the trigger or drop and re-create the trigger with a user that was granted directly with such. You can list those triggers using: SELECT OWNER, TRIGGER_NAME FROM DBA_TRIGGERS WHERE TRIM(BASE_OBJECT_TYPE)='DATABASE' AND OWNER NOT IN (SELECT GRANTEE FROM DBA_SYS_PRIVS WHERE PRIVILEGE='ADMINISTER DATABASE TRIGGER').

RECOMMEND

PRE

NONE

NONE

AUTO

TS_FORUPG_STATUS

All default tablespaces storing Oracle-maintained dictionary objects must allow write operations during database upgrade.

Modify the tablespace(s) below with ALTER TABLESPACE command to allow write operations before starting database upgrade. Not doing so can lead to failures during upgrade.

 

{1}

ERROR

PRE

NONE

NONE

MANUAL

TWO_PC_TXN_EXIST

There can be no unresolved distributed transactions prior to database upgrade because the data they contain would be lost during the upgrade. You can view the unresolved distributed transactions with

 

SELECT * FROM sys.dba_2pc_pending;

Resolve all outstanding distributed transactions prior to database upgrade.

ERROR

PRE

NONE

NONE

MANUAL

ULTRASEARCH_DATA

The source database must not contain Oracle Ultra Search software because starting in version 11.2, Oracle Ultra Search is no longer supported. The Ultra Search software will be removed as part of database upgrade to version {1} and any existing Ultra Search data in your database will be lost.

Remove Oracle Ultra Search software by executing $ORACLE_HOME/rdbms/admin/wkremov.sql located in the new {1} Oracle Database Oracle home. If you want to preserve the Ultra Search data, then perform a manual cold backup prior to database upgrade.

ERROR

PRE

NONE

12.2.0.1

MANUAL

UNDERSCORE_EVENTS

There are events set that should be removed before upgrade, unless your application vendors and/or Oracle Support state differently. Changes will need to be made in the pfile/spfile.

Review and remove any unnecessary EVENTS.

RECOMMEND

PRE

NONE

NONE

MANUAL

UNIAUD_RECORDS_IN_FILE

Oracle Unified Audit records present in the OS spillover audit files must be loaded to the database audit table before database upgrade to ensure they can be read after upgrade. For more information, refer to "LOAD_UNIFIED_AUDIT_FILES Procedure" in Database PL/SQL Packages and Types Reference.

Load the Unified Audit records from OS spillover audit files to database audit table using DBMS_AUDIT_MGMT.LOAD_UNIFIED_AUDIT_FILES api before upgrade.

WARNING

PRE

12.2.0.1

NONE

AUTO

UNIAUD_TAB

"AUDSYS.AUD$UNIFIED" is going to be Oracle defined Unified Audit internal table.

"AUDSYS.AUD$UNIFIED" table must be dropped prior to database upgrade. Please make sure to take the backup of the existing contents of this table if any.

ERROR

PRE

NONE

NONE

MANUAL

UPG_BY_STD_UPGRD

The Oracle database upgrade script upgrades most, but not all Oracle Database components that may be installed. Some components that are not upgraded may have their own upgrade scripts, or they may be deprecated or obsolete.

Check the Oracle documentation for the identified components for their specific upgrade procedure.

INFO

POST

NONE

NONE

MANUAL

UTLRP_RUN_SERIAL

By default, the execution of rdbms/admin/utlrp.sql to recompile invalid objects can spawn multiple DBMS_SCHEDULER jobs in parallel if the value of JOB_QUEUE_PROCESSES parameter, which limits the maximum number of concurrent jobs running at a time, is higher than 1. For more information on UTL_RECOMP package, refer to the "Oracle Database PL/SQL Packages and Types Reference" guide. For more information on JOB_QUEUE_PROCESSES initialization parameter, refer to the "Oracle Database Reference" guide.

Review and adjust the value in initialization parameter JOB_QUEUE_PROCESSES.

WARNING

PRE

NONE

NONE

MANUAL

XBRL_VERSION

The XBRL Extension to XML DB is not upgraded by the standard upgrade. Refer to My Oracle Support Note 1547380.2 for details.

The XBRL Extension to XML DB must be upgraded separately.

WARNING

PRE

11.2.0.0

NONE

MANUAL

XDB_RESOURCE_TYPE

Direct access to either TYPE XDB.XDB$RESOURCE_T or TABLE XDB.XDB$RESOURCE is restricted to Oracle internal code only.

Please contact Oracle Support to resolve the problem.

ERROR

PRE

11.1.0.0

NONE

MANUAL

 

 

MATERIALIZED VIEWS

You can query the ALL_MVIEWS catalog view to get the list of stale MV's:

select owner, mview_name from all_mviews where staleness = 'STALE';


You can also query ALL_MVIEWS catalog view to get the list of MV's which are in an invalid or unusable state:

select owner, mview_name from all_mviews where staleness not in
('FRESH', 'STALE', 'UNKNOWN') or compile_state not in ('VALID');


A MV is considered unusable when it has inconsistent data and invalid when it has a inconsistent metadata such as when a dependent object has changed.  In such cases, the root cause must be determined, addressed and the MV must be recompiled and refreshed. You can also find the MV's which are being currently refreshed with the following query:

SELECT u.name owner, o.name mview_name
FROM sys.obj$ o, sys.user$ u, sys.sum$
s WHERE o.type# = 42 AND o.owner# = u.user# and s.obj# = o.obj# and
bitand(s.mflags, 8) = 8;


In such cases, you must wait for the refresh to complete before proceeding with Upgrade.

No comments:

Post a Comment

Database Options/Management Packs Usage Reporting for Oracle Databases 11.2 and later (Doc ID 1317265.1)

  Database Options/Management Packs Usage Report You can determine whether an option is currently in use in a database by running options_pa...