Interoperability Notes Oracle E-Business Suite Release 120 or 121 With Oracle Database 11g
Interoperability Notes Oracle E-Business Suite Release 120 or 121 With Oracle Database 11g
Interoperability Notes: Oracle E-Business Suite Release 12.0 or 12.1 with Oracle Database 11g
Release 2 (11.2.0) (Doc ID 1058763.1)
This note is the primary document describing the use of Oracle E-Business Suite Release 12 (12.0.x and 12.1.x) with Oracle
Database 11g Release 2 (11.2.0.x), where x denotes the patch set level (currently 4). It may refer to related interoperability
notes, which you should review if they apply to your specific release of the Oracle Database.
The most current version of this document is document 1058763.1 on My Oracle Support. There is a change log at the end of
this document.
Attention: Interoperability notes of previous patch sets are available through the following links:
11.2.0.1 Interoperability Notes
Attention: Check My Oracle Support to make sure that your platform and environment configuration are certified to
work with Oracle Database 11g before performing any instruction in this document.
Attention: If you are going to use 11g Real Application Clusters (RAC) or Automatic Storage Management (ASM), see
Using Oracle 11g Release 2 Real Application Clusters with Oracle E-Business Suite Release 12 on My Oracle Support.
Subsections:
Before the Database Installation
Database Installation
Database Upgrade
After the Database Upgrade
Attention: These notes apply to UNIX, Linux, and Windows platforms. However, you may need to modify some
instructions slightly depending on your platform. For example, these notes typically use UNIX/Linux syntax when
specifying a directory, so Windows users will need to substitute the appropriate syntax when accessing that directory.
Attention: You can obtain the 11.2.0.4 software from Patch 13390677 on My Oracle Support.
Section 1: Upgrading an R12 Database to Oracle Database 11g Release 2 (11.2.0)
Follow the instructions in this section if you plan to upgrade the database server and instance to the latest version of Oracle
Database 11g Release 2 (11.2.0).
Minimum
Software Tier Details
Version
Oracle
Read the "Determine the Upgrade Path" subsection in Chapter 2 of
Database
N/A Database the Oracle Database Upgrade Guide 11g Release 2 (11.2). Make
Enterprise
sure that direct upgrade is supported from your current release.
Edition
Demand
If you are using Demand Signal Repository (DSR), apply
Signal 12.1.2 with
Application Patch 7303033 - Oracle E-Business Suite 12.1.2
Repository 9182368
Patch 9182368
(conditional)
Attention: The interoperability patch for 12.0.4 requires R12.TXK.A.delta.6. When performing the instructions
implementing AutoConfig, apply R12.TXK.A.delta.6 (or a later version of TXK) then apply the 12.0.4
interoperability patch with 11g Release 2 before running AutoConfig. This ensures that you have the right code
level when running AutoConfig.
If you are on a UNIX/Linux platform, apply the 10.1.0.5 version of Patch 6400501 to the iAS 10.1.2 Applications tier
Oracle home.
Note: For Linux x86-64 environments, download the Linux 32-bit version of the patch as the Applications tier
Oracle home is 32-bit.
3. Update application tier context file with new database listener port number (conditional)
The new 11.2.0 Oracle home uses its own database listener for the database instance, replacing the current database
listener. Use the Context Editor to update the following variables in the Applications context file on each application tier
server node to reflect the 11.2.0 configuration:
s_apps_jdbc_connect_descriptor NULL
See Using AutoConfig to Manage System Configurations with Oracle E-Business Suite Release 12 on My Oracle Support
for instructions on how to update and run the Context Editor.
Attention: Do not run AutoConfig on the application tier once the context file has been updated. Doing so will cut
off the entire application tier from the database instance until after the upgrade is complete. You will be instructed
to run AutoConfig on the application tier to configure the system for the new port number once the upgrade is
finished and the new database listener is in use.
Database Installation:
The 11.2.0 Oracle home must be installed on the database server node in a different directory than the current Oracle
home.
Read Chapters 1 and 2 of the Oracle Database Installation Guide 11g Release 2 (11.2) for your platform. Also read
Chapter 1 and the "System Considerations and Requirements" section of Chapter 3 of the Oracle Database Upgrade
Guide 11g Release 2 (11.2). Make sure you thoroughly understand the installation and upgrade processes. Perform any
step that is relevant for your environment.
Attention: For HP Itanium and HP PA RISC platforms using the NFS file system, choose a disk to install the 11g
Oracle home separate from the database files. The mount options of the disk containing the database files must
include forcedirectio. The 11g Oracle home (or any other binaries) must not include the forcedirectio mount
option.
Log in to the database server node as the owner of the Oracle RDBMS file system and database instance. Ensure that
environment settings, such as ORACLE_HOME, are set for the new Oracle home you are about to create, and not for
any existing Oracle homes on the database server node. Perform all the steps in Chapter 4, "Installing Oracle Database"
of the Oracle Database Installation Guide 11g Release 2 (11.2) for your platform.
In the Installation Types window, use the Product Languages button to select any languages other than American
English that are used by your Applications database instance. Choose the Enterprise Edition installation type. In the
subsequent windows, select the options not to upgrade an existing database and to install the database software only.
Note:
1. When installing 11.2.0.4 on Oracle Linux 7 or Red Hat Linux 7, ignore the warning regarding missing
package 'pdksh-5.2.14' during pre-requisite checks.
2. When installing 11.2.0.4 on Oracle Linux 7 or Red Hat Linux 7 and encountering the installer error in
invoking target 'agent nmhs' of makefile with the log file showing an undefined reference to symbol
'B_DestroyKeyObject', users should review and implement the workaround noted in the document
Installation of Oracle 11.2.0.4 Database Software on OL7 fails with "undefined reference to symbol
'B_DestroyKeyObject'" error".
6. Install Oracle Database 11g Products from the 11g Examples CD (mandatory)
On the database server node, as the owner of the Oracle RDBMS file system and database instance, perform the tasks
in the "Install Oracle Database Examples" section in the Oracle Database Examples Installation Guide.
In the Installation Types window, use the Product Languages button to select any languages other than American
English that are used by your Applications database instance.
b. The ORACLE_HOME environment variable points to the new 11.2.0 Oracle home.
c. The PATH environment variable includes $ORACLE_HOME/bin and the directory where the new perl executable is
located (usually $ORACLE_HOME/perl/bin).
d. The LD_LIBRARY_PATH environment variable includes $ORACLE_HOME/lib.
e. The PERL5LIB environment variable points to the directories where the new perl libraries are located
($ORACLE_HOME/perl/lib/[perl version] and $ORACLE_HOME/perl/lib/site_perl/[perl version] for UNIX/Linux,
$ORACLE_HOME/perl/lib and $ORACLE_HOME/perl/site/lib for Windows)
On the database server node, as the owner of the Oracle RDBMS file system and database instance, run the following
command to create the $ORACLE_HOME/nls/data/9idata directory.
$ perl $ORACLE_HOME/nls/data/old/cr9idata.pl
After creating the directory, make sure that the ORA_NLS10 environment variable is set to the full path of the 9idata
directory whenever you enable the 11g Oracle home.
Patch 4247037
Patch 17402822
Patch 17468141
Patch 17501296
Patch 17892268
Patch 19393542
Patch 22731026
Patch 25136212
Attention: For Oracle Exadata customers, see Oracle E-Business Suite Release 11i & R12 Patches Required with
Oracle Database 11g Release 2 (11.2.0) on Exadata for more information on patches to apply.
Attention: While not mandatory for the interoperability of Oracle E-Business Suite with the Oracle Database,
customers may choose to apply Database Patch Set Updates (PSU) on their Oracle E-Business Suite Database. If
so, please see Document 1147107.1 ('Database Patch Set Update Overlay Patches Required for Use with PSUs and
Oracle E-Business Suite') on My Oracle Support for more information.
Do not run any of the post install instructions as those will be done after the upgrade.
Database Upgrade:
On each application tier server node, shut down all server processes or services. On the database tier server node, shut
down the Oracle Net or Net8 database listener in the old Oracle home.
Note: The Applications will be unavailable to users until all remaining tasks in this section are completed.
Attention: Make sure that you do not have the LOCAL_LISTENER initialization parameter set to ensure that the
database does not inadvertently point to a non-existent listener during upgrade.
If the SYS.ENABLED$INDEXES table exists, use SQL*Plus to connect to the database as SYSDBA and running the
following command to drop it:
If you have Database Vault installed, perform steps 1 to 6 of Part 2 of document 1091083.1 on My Oracle Support to
disable Database Vault.
Read Chapter 2 of Oracle Database Upgrade Guide 11g Release 2 (11.2). Take note of the section pertaining to the
Database Upgrade Assistant (DBUA).
Note: Ensure that the oratab file contains an entry for the database to be upgraded.
Attention (Windows only): Make sure that the Services applet window is closed on the database server node.
You cannot remove the current database instance service during the upgrade if this window is open.
The instructions for the database upgrade are outlined in Oracle Database Upgrade Guide 11g Release 2 (11.2)
Chapters 3 and 4.
Perform the steps from the "Run the Pre-Upgrade Information Tool" section to the "Upgrade the Database Using the
Database Upgrade Assistant" section of chapter 3 and any step in chapter 4 that is relevant to your environment.
In Oracle Database 11g, the DMSYS schema is no longer used. The Data Mining option is installed in the SYS schema.
The 11.2 pre-upgrade tool has been extended to include a warning that the DMSYS schema should be dropped. If this
warning is reported, it is recommended to drop the schema as per the Oracle Data Mining Administrator's Guide 11g
Release 2 (11.2). Removing the DMSYS schema has no effect on the functioning of Data Mining.
Disregard warnings related to Network ACLs. AutoConfig manages all the E-Business Suite Network ACLs.
When upgrading all statistics tables, note that Oracle E-Business Suite has only one statistics table,
APPLSYS.FND_STATTAB, that needs to be upgraded.
If you plan to change the PL/SQL compilation mode, disable the compilation of objects.
Use the following sections in document 396009.1, Database Initialization Parameter Settings for Oracle Applications
Release 12 on My Oracle Support as a guideline:
If native compilation of PL/SQL code is disabled in your database instance, ignore the initialization parameters that
pertain to the native compilation of PL/SQL code. Ensure that the temporary tablespace is properly defined. Follow the
instructions in the Temporary Tablespace Setup section.
Note: There are many ways to generate the parameter file (for example, copying and updating an old init.ora
parameter file). You are not confined to using the parameter files generated by the database upgrade assistant.
You can choose to run Oracle E-Business Suite 12.1 PL/SQL database objects in natively compiled mode with Oracle
Database 11g. See the "Compiling PL/SQL Program Units for Native Execution" section of Chapter 12 of Oracle
Database PL/SQL Language Reference 11g Release 2 (11.2).
If the Oracle Net listener for the database instance in the new Oracle home has not been started, you must start it now.
Since AutoConfig has not yet been implemented, start the listener with the lsnrctl executable (UNIX/Linux) or Services
(Windows). See the Oracle Database Net Services Administrator's Guide, 11g Release 2 (11.2) for more information.
Attention: Set the TNS_ADMIN environment variable to the directory where you created your listener.ora and
tnsnames.ora files.
Copy $APPL_TOP/admin/adgrants.sql (adgrants_nt.sql for Windows) from the administration server node to the
database server node. Use SQL*Plus to connect to the database as SYSDBA and run the script using the following
command:
Note: Verify the usage of adgrants.sql in the adgrants.sql script. Older versions of adgrants.sql require the
APPLSYS schema name parameter to be passed instead of APPS.
Copy $AD_TOP/patch/115/sql/adctxprv.sql from the administration server node to the database server node. Use
SQL*Plus to connect to the database as APPS and run the script using the following command:
$ sqlplus apps/[APPS password] @adctxprv.sql \
[SYSTEM password] CTXSYS
Use SQL*Plus to connect to the database as SYSDBA and run the following command:
On the administration server node, use SQL*Plus to connect to the database as APPS and run the
$FND_TOP/patch/115/sql/wfaqupfix.sql script using the following command:
If you plan to change the database port, host, SID, or database name parameter on the database server, you must also
update AutoConfig on the database tier and deregister the current database server node.
Use SQL*Plus to connect to the database as APPS and run the following command:
Implement and run AutoConfig in the new Oracle home on the database server node. If the database listener of the
new Oracle home is defined differently than the old Oracle home, you must also run AutoConfig on each application tier
server node to update the system with the new listener.
See Using AutoConfig to Manage System Configurations with Oracle E-Business Suite Release 12 on My Oracle Support
for instructions on how to implement and run AutoConfig. Section 3.2 explains how to generate a context file on the
database tier.
Shut down all processes, including the database and the listener, and restart them to load the new environment
settings.
Attention: For Windows customers, after creating the XML context file, ensure that the variable s_dlsnname has
the proper listener service name.
Attention: After creating the XML context file, ensure the variable s_jretop points to $ORACLE_HOME/jdk/jre and
is not altered to any other value.
If you are on E-Business Suite Release 12.0, apply ECX Patch 9922442. If you are on E-Business Suite Release 12.1,
apply Patch 9151516.
Note: Make sure that you have at least 1.5 GB of free default temporary tablespace.
If you are using Demantra, perform the steps in document 730883.1 on My Oracle Support.
If the Oracle Net listener in the 11.2.0 Oracle home is defined differently than the one used by the old Oracle home,
you must re-create any custom self-referential database links that exist in the Applications database instance. To check
for the existence of database links, use SQL*Plus on the database server node to connect to the Applications database
instance as APPS and run the following query:
The EDW_APPS_TO_WH and APPS_TO_APPS database links, if they exist, should have been updated with the new port
number by AutoConfig in the previous step.
If you have custom self-referential database links in the database instance, use the following commands to drop and re-
create them:
where [custom database link], [user], [password], [hostname], [port number], and [ORACLE_SID] reflect the new
Oracle Net listener for the database instance.
If you disabled Database Vault, enable it by performing step 7 of Part 2 of document 1091083.1 on My Oracle Support.
Restart all the Application tier server processes that you shut down previously. Remember that the Oracle Net listener
for the database instance, as well as the database instance itself, need to be started in the 11.2 Oracle home. Users
may return to the system.
Log on to Oracle E-Business Suite with the "System Administrator" responsibility. Click Requests > Run > Single
Request and the OK button. Enter the following parameters:
The following EBS products are currently not supported with E-Business Suite Release 12 on Oracle Database 11g Release 2
(11.2.0):
The following are known issues with E-Business Suite 12.0 and 12.1 on Database 11.2:
is encountered when trying to create sales contacts. More information may be found in bug 17441178.
2. FRM-99999: Error 408 occurs when trying to modify HRMS contact information. More information may be found in bug
17446933.
Change Record
REFERENCES
NOTE:1091083.1 - Integrating Oracle E-Business Suite Release 12 with Oracle Database Vault 11gR2
NOTE:1147107.1 - Database Patch Set Update Overlay Patches Required for Use with PSUs and Oracle E-Business Suite
NOTE:396009.1 - Database Initialization Parameters for Oracle E-Business Suite Release 12
NOTE:1058763.1 - Interoperability Notes EBS 12.0 and 12.1 with Database 11gR2