Database Notes
Database Notes
Database Notes
21c
F31869-09
August 2022
Oracle Database Database Release Notes, 21c
F31869-09
This software and related documentation are provided under a license agreement containing restrictions on
use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your
license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license,
transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse
engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is
prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If
you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on
behalf of the U.S. Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs (including any operating system, integrated software,
any programs embedded, installed or activated on delivered hardware, and modifications of such programs)
and Oracle computer documentation or other Oracle data delivered to or accessed by U.S. Government end
users are "commercial computer software" or "commercial computer software documentation" pursuant to the
applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use,
reproduction, duplication, release, display, disclosure, modification, preparation of derivative works, and/or
adaptation of i) Oracle programs (including any operating system, integrated software, any programs
embedded, installed or activated on delivered hardware, and modifications of such programs), ii) Oracle
computer documentation and/or iii) other Oracle data, is subject to the rights and limitations specified in the
license contained in the applicable contract. The terms governing the U.S. Government’s use of Oracle cloud
services are defined by the applicable contract for such services. No other rights are granted to the U.S.
Government.
This software or hardware is developed for general use in a variety of information management applications.
It is not developed or intended for use in any inherently dangerous applications, including applications that
may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you
shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its
safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this
software or hardware in dangerous applications.
Oracle, Java, and MySQL are registered trademarks of Oracle and/or its affiliates. Other names may be
trademarks of their respective owners.
Intel and Intel Inside are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are
used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Epyc,
and the AMD logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered
trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content, products,
and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly
disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise
set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be
responsible for any loss, costs, or damages incurred due to your access to or use of third-party content,
products, or services, except as set forth in an applicable agreement between you and Oracle.
Contents
Preface
Audience v
Documentation Accessibility v
Related Resources v
Conventions vi
iii
Linking Applications with Oracle Client Libraries for Linux 3-2
Preinstallation Requirements for the Linux Platform 3-2
Known Issues and Bugs for SUSE Linux Enterprise Server 15 3-2
Bug 32560231 3-2
Open Bugs Affecting Linux 3-3
Bug 33222396 3-3
Bug 33326105 3-3
iv
Preface
This document describes last-minute features and changes that are not included in the
Oracle Database Documentation Library for Oracle Database 21c.
Starting with Oracle Database 18c, the readme and platform-specific release notes have
been combined into one document. The second chapter of this document contains generic
information. Subsequent chapters of this document contain platform-specific information. The
last chapter of this document contains last-minute changes not included in the Oracle
Database documentation library.
• Audience
• Documentation Accessibility
• Related Resources
• Conventions
Audience
This document is relevant only to Oracle Database 21c and documents new features,
changes, unsupported products, preinstallation requirements, generic and platform-specific
bug fixes, and known issues that are not included in the Oracle Database documentation
library.
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility
Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.
Related Resources
Refer to the following documentation for more information related to this release:
• http://docs.oracle.com/en/database/database.html
• For licensing information, refer to Oracle Database Licensing Information User Manual.
• Additional readme or release notes files also exist. Refer to Other Readmes, Release
Notes, or Installation Guides.
v
Preface
Conventions
The following text conventions are used in this document:
Convention Meaning
boldface Boldface type indicates graphical user interface elements associated
with an action, or terms defined in text or the glossary.
italic Italic type indicates book titles, emphasis, or placeholder variables for
which you supply particular values.
monospace Monospace type indicates commands within a paragraph, URLs, code
in examples, text that appears on the screen, or text that you enter.
vi
1
Purpose of These Release Notes
This topic briefly describes the purpose of these release notes.
Updates to this document can occur after it is released. Check for updates to this document
and view other Oracle documentation at:
http://docs.oracle.com/en/database/database.html
For licensing information, refer to Oracle Database Licensing Information User Manual.
Additional readme or release notes files also exist. Refer to the Other Readmes, Release
Notes, or Installation Guides.
1-1
2
Issues Affecting All Platforms for Oracle
Database 21c
These topics contain last-minute features and changes that affect all platforms for Oracle
Database 21c.
• Features Not Available or Restricted in This Release of Oracle Database 21c
This topic describes features that are not available or are restricted for Oracle Database
21c.
• Deprecated and Desupported Features for Oracle Database
This topic describes deprecated and desupported features for Oracle Database 21c.
• Other Readmes, Release Notes, or Installation Guides
There are additional documents for Oracle products that are associated with this Oracle
Database release.
• Open Bugs Affecting All Platforms
This section describes known bugs in Oracle Database 21c that affect all platforms.
2-1
Chapter 2
Open Bugs Affecting All Platforms
Refer to the following Oracle products and the location of their associated readme,
release notes, or installation guide for additional information:
Product Document
Oracle Application Oracle Application Express Release Notes and the Oracle Application
Express Express Installation Guide.
Oracle ODBC Driver ODBC Driver Release Notes
Pro*C Pro*C/C++ Release Notes
Pro*COBOL Pro*COBOL Release Notes
SQL*Plus SQL*Plus Release Notes
Bug 33096609
Users who have enabled Oracle Sharding and are using Oracle Native Encryption to
communicate between the shard catalog and the shards should be aware that
sharding uses database links to communicate from the catalog database to the
shards, and also enables shared servers (dispatcher) on the catalog database. This
combination of settings is currently an issue and some sharding features such as
cross-shard queries fail.
Workaround:
In Oracle Database Release 19c or later, it is no longer necessary to enable shared
servers on the catalog database and we recommend that, if you are using Oracle
Native Encryption with sharding, you should disable shared servers on the catalog
database. This can be done by setting the database parameter shared_servers to 0
2-2
Chapter 2
Open Bugs Affecting All Platforms
and restarting Oracle. This is a global parameter that must be set in the multitenant container
database.
Bug 33090781
If the Oracle Database user password has expired, then you might not be able to use the
password command to change the password if the network encryption is enabled.
Workaround:
Contact your database administrator to change or reset the password.
Bug 33109335
For all Oracle Scheduler jobs, if the following conditions are met, then the jobs fail with error
ORA-01031:
Workaround:
For all jobs failing with error ORA-01031, disable and reenable the job with a user with Oracle
Database Vault enabled. If the user enabling the job is not same as the job owner, then
scheduler authorization is necessary. The authorization looks like:
execute dbms_macadm.authorize_scheduler_user(‘user_who_enabled_job’,
‘job_owner’);
Bug 31557965
If there is a failure while running the root script and the following information is found in the
installation log, then the Apache Tomcat port is already in use by another process:
2-3
Chapter 2
Open Bugs Affecting All Platforms
Workaround:
Identify the process holding the Apache Tomcat port, shut it down, and rerun the root
script. If this is not possible, then do the following (where the <newrmiport> and
<newhttpport> are port numbers that are not in use, not in the privileged range, and
are not 8888 or 8895) and then rerun the root script:
Bug 33156635
When running Oracle RAC or Oracle Restart in a role-separated environment, where
the Oracle RAC or Oracle Restart account is different from the Oracle Database
account, performing administrative operations for sharding or for Global Data Services
(GDS) can result in error GSM-45029: SQL ERROR NO MORE DATA TO READ FROM
SOCKET when connected through a listener that runs in the Oracle RAC or Oracle
Restart account.
Workaround:
In order to mitigate this issue, start a listener in the Oracle Database account on the
sharded catalog database, and on each shard, if one is not already running. This
listener can be used to connect and perform administrative operations, and can also
be used when providing an Oracle Database Transparent Network Substrate (TNS)
address when one is required for administrative commands, such as add shard.
Bug 27120934
After downgrading Oracle Clusterware using the Grid Setup Wizard, from Oracle
Database 21c to Oracle Clusterware release 12.1 or release 11.2, the unused data
files of the Oracle Grid Infrastructure Management Repository (GIMR) of the 21c
Oracle Grid Infrastructure home could still be present in the disk group.
2-4
Chapter 2
Open Bugs Affecting All Platforms
Workaround:
Before starting the downgrade procedure using the Grid Setup Wizard, delete the GIMR
database using the following command:
Bug 27080535
When deinstalling Oracle Grid Infrastructure for a standalone server home with an Oracle
Management Server configuration, the emConfig.txt file in ORACLE_BASE/admin/emca is not
deleted.
Workaround:
To remove the emConfig.txt file, run the following command:
rm -rf $ORACLE_BASE/admin/emca/emConfig.txt
During the last ORACLE_HOME deinstallation, to remove ORACLE_BASE, run the following
command after the deinstallation tool exits:
rm -rf $ORACLE_BASE
Bug 18336219
Oracle Database installer does not check if the password specified for ASMSNMP on the
Specify Management Options screen is correct. If you proceed with the configuration and
specify an incorrect password, then Oracle Enterprise Manager Cloud Control cannot
discover details and monitor the Oracle ASM instance.
Workaround #1:
Ensure that the correct password (the same password specified earlier during the Oracle Grid
Infrastructure for a cluster installation) is specified in the Specify Management Options screen
of Oracle Database installer.
Workaround #2:
On the Oracle Enterprise Manager Cloud Control portal, navigate to the Oracle ASM
credentials screen and update the password for ASMSNMP. Once the password is saved on
Oracle Enterprise Manager Cloud Control, the Oracle ASM monitoring starts working.
2-5
3
Issues Affecting Linux for Oracle Database
21c
These topics contain last-minute features and changes for Linux for Oracle Database 21c.
• Unsupported Products for Linux
This topic describes products or features that are unavailable for Oracle Database 21c.
• Product Support
This topic describes the supported products or features for Oracle Database 21c.
• Linking Applications with Oracle Client Libraries for Linux
You must use the dynamic Oracle client libraries to link the client code on Linux.
• Preinstallation Requirements for the Linux Platform
Refer to the installation guides for the preinstallation requirements for Oracle Database
21c.
• Known Issues and Bugs for SUSE Linux Enterprise Server 15
• Open Bugs Affecting Linux
This topic contains last-minute features and changes for Oracle Database 21c.
Product Support
This topic describes the supported products or features for Oracle Database 21c.
The supported products or features are:
• Database Smart Flash Cache Support
Database Smart Flash Cache is supported on Oracle Linux.
• Oracle ACFS and Oracle ADVM Support
Although Oracle ADVM supports raw disks in Oracle Automatic Storage Management
disk groups, Oracle ADVM device special files created through raw are not supported;
Oracle ADVM only supports block device special files.
For the latest information about supported platforms and releases, see the Note
1369107.1 on My Oracle Support at https://support.oracle.com
3-1
Chapter 3
Linking Applications with Oracle Client Libraries for Linux
Bug 32560231
The shell environment variable set to /bin/csh and $HOME/.cshrc contains a syntax
where the directories in the PATH environment variable are delimited by the :
character.
Workaround:
Perform one of the following workarounds:
Workaround 1
Correct the syntax in $HOME/.cshrc.
Workaround 2
Explicitly set the shell environment variable to /bin/sh.
3-2
Chapter 3
Open Bugs Affecting Linux
Workaround 3
Unset the shell environment variable.
Bug 33222396
Unable to build Oracle C++ Call Interface (OCCI) applications with g++8 using the demo
make file.
Workaround
To ensure that C++ applications built with g++8 work with Oracle C++ Call Interface (OCCI),
use these compilation options:
• If the application does not use C++ 11 features, then use the compilation option:
-D_GLIBCXX_USE_CXX11_ABI=0 -Wno-narrowing
• If the application uses C++ 11 features, then use the compilation option:
-Wno-narrowing
Note:
libocci_gcc53.so.21.1 is not part of the Instant Client zip or RPMs.
libocci_gcc53.so.21.1 is available from the regular client installation.
Bug 33326105
Building Pro*C Applications on Debian Systems.
Workaround
To build Pro*C applications on Debian systems:
Apply patch 33326105 or manually add the following GCC path to the Pro*C configuration file
pcscfg.cfg:
sys_include=/usr/lib/gcc/x86_64-linux-gnu/8/include
3-3
4
Issues Affecting HP-UX Itanium for Oracle
Database 21c
These topics contain last-minute features and changes for HP-UX Itanium for Oracle
Database 21c.
• Product Support
There are no supported products or features for Oracle Database 21c on HP-UX Itanium
at this time.
• Linking Applications with Oracle Client Libraries for HP-UX Itanium
You must use the dynamic Oracle client libraries to link the client code on HP-UX Itanium.
• Preinstallation Requirements for HP-UX Itanium
Refer to the installation guides for the preinstallation requirements for Oracle Database
21c.
• Installation, Configuration, and Upgrade Issues for HP-UX Itanium
This topic describes information about issues that affect Oracle Database installation,
configuration, and upgrade.
Product Support
There are no supported products or features for Oracle Database 21c on HP-UX Itanium at
this time.
4-1
Chapter 4
Installation, Configuration, and Upgrade Issues for HP-UX Itanium
Bug 33072934
When you install Oracle Grid infrastructure 21c on an IPv6 cluster, you get the
following error during the Oracle home and Oracle base check:
Workround
This issue occurs due to Java 8 built with Oracle Grid infrastructure 21c. To resolve
this issue:
1. Contact HPE and apply the fix for SR/Ticket QXCR1001807522.
2. Refer to the Known Issues section of the HPE Java 8 web page.
3. Perform the following steps to apply patch libnet.so:
a. Download the libnet.so file from the HPE website.
b. Update the libnet.so file in the path jdk/jre/lib/IA64W/ of the Oracle
Grid Infrastructure home.
c. Run gridSetup.sh.
4-2
5
Issues Affecting Microsoft Windows for Oracle
Database 21c
These topics contain last-minute features and changes for Microsoft Windows for Oracle
Database 21c.
5-1
Chapter 5
Installation, Configuration, and Upgrade Issues for Microsoft Windows
• Bug 33382160
• Bug 33605836
Bug 31618110
tfactl help with invalid parameters display the results but did not return any invalid
argument error.
Workaround
Download the latest Oracle Autonomous Health Framework (AHF) from My Oracle
Support note 2550798.1 and upgrade Oracle Autonomous Health Framework (AHF).
https://support.oracle.com/epmos/faces/DocContentDisplay?
id=2550798.1&parent=DOCUMENTATION&sourceId=USERGUIDE
Bug 31623788
Oracle Autonomous Health Framework (AHF) and Trace File Analyzer (TFA) tfactl
print configuration does not update the configuration value in all nodes.
Workaround
Download the latest Oracle Autonomous Health Framework (AHF) from My Oracle
Support note 2550798.1 and upgrade Oracle Autonomous Health Framework (AHF).
https://support.oracle.com/epmos/faces/DocContentDisplay?
id=2550798.1&parent=DOCUMENTATION&sourceId=USERGUIDE
Bug 31624542
tfactl access add -group is not supported, but the document contains details to add
the user group.
Workaround
Download the latest Oracle Autonomous Health Framework (AHF) from My Oracle
Support note 2550798.1 and upgrade Oracle Autonomous Health Framework (AHF).
https://support.oracle.com/epmos/faces/DocContentDisplay?
id=2550798.1&parent=DOCUMENTATION&sourceId=USERGUIDE
Bug 31654946
tfactl diagcollect -collectdir -help command starts collecting reports
instead of displaying the help.
Workaround
Download the latest Oracle Autonomous Health Framework (AHF) from My Oracle
Support note 2550798.1 and upgrade Oracle Autonomous Health Framework (AHF).
https://support.oracle.com/epmos/faces/DocContentDisplay?
id=2550798.1&parent=DOCUMENTATION&sourceId=USERGUIDE
5-2
Chapter 5
Installation, Configuration, and Upgrade Issues for Microsoft Windows
Bug 31660201
tfactl does not uninstall Trace File Analyzer (TFA) in all the nodes, it uninstalls only in the
local node.
Workaround
Download the latest Oracle Autonomous Health Framework (AHF) from My Oracle Support
note 2550798.1 and upgrade Oracle Autonomous Health Framework (AHF).
https://support.oracle.com/epmos/faces/DocContentDisplay?
id=2550798.1&parent=DOCUMENTATION&sourceId=USERGUIDE
Bug 31666299
tfactl analyze command does not give results and returns errors in the log.
Workaround
Download the latest Oracle Autonomous Health Framework (AHF) from My Oracle Support
note 2550798.1 and upgrade Oracle Autonomous Health Framework (AHF).
https://support.oracle.com/epmos/faces/DocContentDisplay?
id=2550798.1&parent=DOCUMENTATION&sourceId=USERGUIDE
Bug 32987272
Oracle Trace File Analyzer (TFA) was not installed, but validateenv shows "TFA
Successfully installed".
Workaround
Download the latest Oracle Autonomous Health Framework (AHF) from My Oracle Support
note 2550798.1 and upgrade Oracle Autonomous Health Framework (AHF).
https://support.oracle.com/epmos/faces/DocContentDisplay?
id=2550798.1&parent=DOCUMENTATION&sourceId=USERGUIDE
Bug 33030281
When you upgrade Grid Infrastructure Management Repository (GIMR) home from a lower
home version to Oracle Database 21c, it fails with the following error message:
INS-20801.
If the user list in ACL of the mgmtdb resource is empty.
Workaround
Modify the ACL attribute of the mgmtdb resource using the crsctl command. Add the owner
of the mgmtdb resource to the user list in the ACL of mgmtdb. When the user list is updated in
ACL of the mgmtdb resource, upgrade GIMR.
5-3
Chapter 5
Installation, Configuration, and Upgrade Issues for Microsoft Windows
If the user list is empty in the ACL retrieved for the mgmtdb resource, then add the
owner of the mgmtdb resource to the user list in ACL.
Run this command to modify or add the user list in the ACL command:
Bug 33169497
tfactl analyze command does not work and returns an error.
Workaround
Download the latest Oracle Autonomous Health Framework (AHF) from My Oracle
Support note 2550798.1 and upgrade Oracle Autonomous Health Framework (AHF).
https://support.oracle.com/epmos/faces/DocContentDisplay?
id=2550798.1&parent=DOCUMENTATION&sourceId=USERGUIDE
Bug 33212356
Creating a gold image operation fails and returns the following error:
Workaround
Set the TEMP environment variable to c:\ or c:\Temp before performing the -
createGoldImage operation.
Bug 33279556
On a pure IPv6 Windows environment, the IPv6 addresses fail to resolve during the
SCAN verification check due to a known issue.
Workaround
Apply a one off patch explicitly on such an IPv6 environment to ensure that the Java
code attempting to resolve the IPv6 addresses uses the correct network property when
you start the Java Virtual Machine (JVM) by running the prerequisite checks.
5-4
Chapter 5
Installation, Configuration, and Upgrade Issues for Microsoft Windows
Bug 33382160
The edition column in the table registry$database incorrectly displays as Oracle Database
Enterprise Edition for an Oracle Database 21c Express Edition (XE). This is not a functional
issue but rather a display problem only.
The edition is displayed as EE instead of XE. However, the edition column in the table
registry$ correctly displays as XE.
Workaround
Manually update the edition column value in registry$database.
Bug 33605836
Database token authentication fails in Windows for Oracle Client Libraries with the following
error:
ORA-01017: Invalid username/password; Logon denied.
Workaround
Perform the following steps:
• Specify the parameters TOKEN_AUTH, TOKEN_LOCATION, SSL_SERVER_DN_MATCH,
PASSWORD_AUTH, OCI_IAM_URL, OCI_TENANCY, OCI_COMPARTMENT, OCI_DATABASE in a
sqlnet.ora file instead of a tnsnames.ora file.
• Set the TZ environment variable to the Greenwich Mean Time (GMT) as follows:
set TZ=GMT
• Specify the TOKEN_LOCATION for the IAM Proof Of Possession (POP) token in a
sqlnet.ora file. Do not rely on the default token location.
5-5
Chapter 5
Installation, Configuration, and Upgrade Issues for Microsoft Windows
Related Topics
• Troubleshooting IAM Logins
5-6