Interoperability Notes

Oracle Applications Release 11i
with Oracle9i Release 9.0.1

May 2002

This document describes the process to upgrade an existing Oracle Applications Release 11i database to use Oracle9i Release 9.0.1.x, where x denotes the patch set level (currently 3). The most current version of these notes is document 162091.1 on OracleMetaLink. This document includes a change log so you can track updates.

If you are installing Oracle Applications 11i for the first time, you should obtain and install Release 11.5.5 (or later) of Oracle Applications using Rapid Install.

This document contains two sections. Determine which of the two sections applies to your requirement, and follow the instructions for that section only.

Attention: These notes apply to UNIX and Windows NT/2000 platforms. However, you may need to modify some instructions slightly depending upon your platform. For example, these notes typically use UNIX syntax when specifying a directory, so Windows NT/2000 users will need to substitute the appropriate syntax when accessing that directory(folder).


Section 1: Upgrading Oracle Applications Release 11i database server to Oracle9i Enterprise Edition Release 9.0.1.x from Oracle8i.


Follow instructions in this section, only if you are upgrading an existing Oracle Applications Release 11i database to Oracle9i Release 9.0.1.x from Oracle8i.

  1. Upgrade to the latest 11i version
    You should be using the latest available Oracle Applications Maintenance Pack to run with Oracle 9i. You must at a minimum be running Oracle Applications Release 11i.4 before upgrading to 9.0.1.x. The Oracle Applications Release 11i.7 Maintenance Pack is available separately as patch
    2123967. Applying an 11i Maintenance Pack does not update the technology stack.

  2. Apply Applications Interoperability Patches
    Oracle provides an interoperability patch for those pieces of Applications code that require modification to work with Oracle9i Release 9.0.1.x. Obtain and install patch 1833692.

    In addition, if you are running portions of the CRM suite of applications you may need additional patches as outlined below.

    Product Code Instructions
    Universal Work Queue IEU
    • If running earlier code than IEU patchset I, obtain and install patch 1900420.
    Sales Compensation AS
    • If you are running Sales Compensation at a patch level below Sales and Marketing Family Patch 1809318, obtain and install patch 2015079.
    • If you are running Sales Compensation at or above patch level 1809318, obtain and install patch 2027612.
    eMail Center IEM
    • Obtain and install Oracle eMail Server 5.2 patch set1 (patch 1993561)
    • Obtain and install two Oracle eMail Server patches, 1683419 and 1878580.
    CRM Gateway for Mobile Devices ASG
    • Upgrade your Mobile Device Gateway (MDG) database to Oracle8i Release 8.1.7.2.
    • Obtain and install Oracle8i patch 1836101 against the MDG database
    • Obtain and install Oracle Lite8i 4.0.0.6.0 patch 1748158
    • Obtain and install CRM Gateway for Mobile Devices patch 1809904

  3. Log in as the Oracle user
    Log in as the user who manages (owns) the Oracle9i files and database. Make sure that none of the environment settings such as ORACLE_HOME, PATH, ORA_NLS, etc. refer to the existing Oracle8 Enterprise Edition Release 8.0.x or Oracle8i Enterprise Edition Release 8.1.x environment.

  4. Install Oracle9i Release 9.0.1 Database Server
    If you have not already installed the Oracle9i Release 9.0.1 Oracle Home, follow the instructions in the Oracle9i Installation Guide. Install the files in a location other than the existing 8.1.x Oracle home. Choose to install all components currently used by your 8.1.x database. At a minimum this will include the following components:

    • Oracle9i Server
    • Oracle Spatial
    • Oracle Partitioning
    • Oracle Net Listener
    • Oracle Net Protocol Support
    • Oracle Connection Manager
    • Development Kit
      • Oracle Call C++ Interface (OCI)
      • Object Type Translator
      • Pro*C/C++
      • Oracle XML Developer's Kit
      • Oracle XML SQL Utility

    Attention: Windows NT/2000 customers should not install the following development tools. These tools do not support multiple Oracle Homes and are not used by Oracle Applications.
    • Oracle Objects for OLE
    • Oracle ODBC Drivers
    • Oracle OLE Providers for OLEDB

    We also recommend choosing all the languages, (or at a minimum all the required languages) during the installation.

    Do not run any migration scripts at this time.

  5. Install Latest Certified 9.0.1 Patch Set
    Install the latest Oracle9i Release 9.0.1 patch set certified for Oracle Applications in the Oracle9i Release 9.0.1 Oracle Home. This patch is available via the OracleMetaLink patch download interface, or from Oracle Support.

    Follow the instructions in the readme file of the patch. Do not perform any database update steps or run any SQL scripts at this time.

  6. Apply Oracle9i Consolidated Patch (optional)
    If you are running a UNIX (or Linux) operating system for your database server, we recommend you obtain and install the consolidated patch 2373030 on top of patchset 3.

    If you are using a Windows operating system for your database server, apply database patchset 9.0.1.3 and database patch 9.0.1.3.0 patch 3 or higher. This combination of patches for Windows NT/2000 contains fixes corresponding to those identified above.

  7. Check OracleMetaLink for additional patches
    Additional issues with Applications running on 9.0.1 may have been identified since this document was authored. Check the Certify section of OracleMetaLink for the latest issues.

  8. Log in as the Oracle user
    Log in as the user who manages (owns) the existing Oracle8i Enterprise Edition files and Applications database. Make sure that none of the environment settings such as ORACLE_HOME, PATH, ORA_NLS, etc. refer to the existing Oracle8 Enterprise Edition Release 8.0.x or Oracle9i environment.

  9. Prepare Database for Upgrade
    The Prepare to Upgrade section of Oracle9i Database Migration (9.0.1) contains steps to be executed to the existing database in the existing environment before upgrade. Complete all the steps listed there.

  10. Apply Workaround for JAVA CLASS
    Some databases may encounter an ORA-600 error during the upgrade due to an invalid Java class (bug 1567117). You can determine if your database has the problem by executing the select statement using SQL*Plus connected as INTERNAL:

    	  SQL> select dbms_java.resolver
    	  SQL> ('oracle/xml/parser/v2/XSLTContext',
    	  SQL> 'APPS','JAVA CLASS')
    	  SQL> from dual;
    	  

    If the above command results in an ORA-600 error with the following arguments: [26599], [1], [14] ..., then you have an invalid JAVA CLASS.

    To workaround the issue, start SQL*Plus and connect to the database instance as SYS user. Execute the following command.

    	  SQL>  update idl_ub1$
    	  SQL>     set length = 1935
    	  SQL>  where obj# = ( select obj# from obj$ o, user$ u
    	  SQL>                 where o.type#  =  29
    	  SQL>                 and   u.name   = 'APPS'
    	  SQL>                 and   o.name   = '/577f4ba0_XSLTContext' )
    	  SQL>  and  piece#  =  3 ;
    	  SQL>  commit ; 
    	  SQL>  exit ;
    	  

  11. Shut Down Servers, Concurrent Managers and Database
    All servers and processes such as the Oracle Applications forms server, Web Server and Concurrent Managers must be shut down and all users must be logged out before starting the database upgrade.

    Oracle Applications will be unavailable to users until all tasks in these notes are completed.

  12. Backup the Oracle Applications Database
    Log in as the user who manages (owns) the Oracle9i files and database. We recommend taking a backup of your database before moving up the database to Oracle9i server.

  13. Log in as the Oracle user
    Log in as the user who manages (owns) the Oracle9i files and database. Make sure that none of the environment settings such as ORACLE_HOME, PATH, ORA_NLS, etc. refer to the existing Oracle8 Enterprise Edition Release 8.0.x or Oracle8i Enterprise Edition Release 8.1.x environment.

  14. Ensure Adequate Rollback and System Space
    Ensure that there is sufficient free space in the SYSTEM tablespace (greater than 500 MB) and for the Rollback segments (greater than 750 MB) with each having maxextents greater than 512.

  15. Upgrade the Oracle Applications Database
    Follow instructions in the Oracle9i Database Migration (9.0.1) to migrate the database to the current release. An updated version of this document may be found on the
    Oracle Technology Network. You must follow the manual method of Database Upgrade.

  16. Modify init.ora parameters
    Some database initialization parameters have changed or become obsolete in Oracle9i Release 9.0.1.x. Details are available in the Oracle9i Database Migration manual. In addition to whatever other parameters are appropriate at your site, add or update the following:

    Make sure that compatibility and optimizer_features_enable is not set to a release before 9.0.0. Set both fields to 9.0.1 after Migrating/Upgrading the Database and before the Upgrading Specific Components portion of the Database Migration manual.

    	  _system_trig_enabled = TRUE
    	  o7_dictionary_accessibility = TRUE
              compatible = 9.0.1
    	  optimizer_features_enable = 9.0.1
    	  event="10932 trace name context level 32768"
    	  event="10933 trace name context level 512"
    	  event="10943 trace name context level 16384"
    	  

    Some of the events set above are for maintaining PL/SQL compiler compatibility.

    If your init.ora file contains the following parameters, you should remove them now.

    	  event="10943 trace name context forever, level 2"
    	  _complex_view_merging 
              _new_initial_join_orders 
              _optimizer_mode_force 
              _optimizer_undo_changes
              _or_expand_nvl_predicate 
              _ordered_nested_loop 
              _push_join_predicate 
    	  _push_join_union_view 
              _sort_elimination_cost_ratio
              _use_column_stats_for_function 
    	  

    Attention: During your database migration, instructions in the Oracle9i Database Migration (9.0.1) require the value of _system_trig_enabled to be temporarily set to false at the beginning of the migration, and restored to true before upgrading JServer.

  17. Upgrade the Specific Database Components

    The Oracle Applications Release 11i databases currently uses the following components, you must now complete the steps specific to these components referred in the Migration Document.

    • Upgrading Oracle JServer
    • Upgrading XDK for Java
    • Upgrading Session Namespace, CORBA and OSE
    • Upgrading JSP
    • Upgrading Oracle Spatial
    • Upgrading interMedia
    • Upgrading Oracle Text
    • Upgrading Statistics Tables Created by DBMS_STATS Package
    • Recompiling Invalid PL/SQL Modules

    These are the only components that you must upgrade in a standard Applications database instance. Unless you have specifically enabled other components for your local customizations, you need not perform any other database component upgrades.

    After going through all the necessary steps, if you find invalid JAVA CLASS or UNDEFINED objects, you may recompile then individually. Generally, Snapshots and Materialized Views are marked as UNDEFINED objects. We recommend compiling UNDEFINED objects treating them as snapshots.

    Attention: After completion of the database upgrade, package body JIS817_U_PKGS has a state of invalid. This package is not needed and can be ignored or deleted.

  18. Oracle 9i Patch Set Post Install tasks
    Post Install tasks mentioned in the Oracle 9i Database Server Patch Set README file should be executed now to complete the database migration. In the Post Install Actions step of this readme file, please ignore all the actions from the beginning, up to and including "ALTER SYSTEM DISABLE RESTRICTED SESSION; ". You must perform all actions beginning from the interMedia Text section.

  19. Configure the Oracle Net listener
    The Oracle Net listener must be configured such that the database can be accessed from the Oracle Applications Release 11i file system and the Oracle8 Enterprise Edition Release 8.0.x technology stack. Refer to the Net9 Administrator's Guide. Start the listener once it has been configured.

  20. Ensure configuration of the Oracle Net client
    Configure the Oracle Net client on each Release 11i server (other than the database server) such that the Oracle Applications Release 11i file system can connect to the database on the Release 11i database server. Ensure that your configuration is using the new 9.0.1 ORACLE_HOME. Refer to the Net8 Administrator's Guide.

    The TWO_TASK environment variable on UNIX, or the LOCAL environment setting on Windows NT/2000, must be set to the connect string of the Applications database that you define. Use SQL*Plus to test the connection.

  21. Compile All Apps objects
    Many database objects will become invalid due to the database upgrade. Compile the objects that belong to the APPS schema. Run AD Administration on the administration server and choose the "Compile APPS schema(s)" option from the Maintain Applications Database Objects menu.

    You may use the standard utility utlrp.sql (found in $ORACLE_HOME/rdbms/admin) to compile all the non Oracle Applications schema objects.

  22. Recreate grants and synonyms for APPS schema(s)
    Oracle9i database has additional privileges compared to Oracle8i. Run AD Administration on the administration server and choose the "Recreate grants and synonyms for APPS schema(s)" option from the Maintain Applications Database Objects menu.

  23. Activate optimizer enhancement (optional)
    The Oracle9i consolidated patch includes an optimizer enhancement. If you chose to install the patch, you should activate the enhancement now.

    Add the following line to your init.ora file:

              event="38004 trace name context forever, level 1"
              
    Shut down and restart the database.

    Attention: Everytime the database is upgraded to a higher version of RDBMS, this event has to be removed or commented out as it will cause deadlocks during the upgrade. Do not disable this event from the session level.

  24. Update 8.0.6 ORACLE HOMEs
    The 8.0.6 ORACLE HOME used by Oracle Applications must be updated to connect to Oracle9i database.
    • If you are using a UNIX (or Linux) operating system for your database server, apply latest cerified patchset (patchset 3 or higher) to all Oracle 8.0.6 ORACLE_HOMEs. Follow the instructions in the readme file of the patchset.
    • If you are using a Windows operating system for your database server, apply patch 8.0.6.3.5 to all Oracle 8.0.6 ORACLE_HOMEs. Follow the instructions in the readme file of the patch.

  25. Apply latest certified Forms patchset
    Use of Developer 6i with Oracle 9i requires at a minimum Forms Patch Set 6. Instructions for installing Forms patch sets can be found on OracleMetaLink; see document 125767.1, Upgrading Developer 6i with Oracle Applications 11i .

    Note that use of Developer 6i with the E-Business Suite also requires Oracle JInitiator 1.1.7.32 or higher. Instructions for upgrading Jinitiator can be found on OracleMetaLink; see document 124606.1, Upgrading Oracle JInitiator with Oracle Applications 11i .


Section 2: Applying the latest certified Oracle9i Enterprise Edition Release 9.0.1 patchset.


Follow instructions in this section, only if you have an existing Oracle Applications Release 11i database previously upgraded to 9.0.1.

  1. Shut Down Servers, Concurrent Managers and Database
    All servers and processes such as the Oracle Applications forms server, Web Server and Concurrent Managers must be shut down and all users must be logged out before starting the database upgrade.

    Oracle Applications will be unavailable to users until all tasks in this section are completed.

  2. Log in as the Oracle User
    Log in again as the user who manages (owns) the existing the Oracle9i Enterprise Edition files and database. Make sure that none of the environment settings, such as ORACLE_HOME, PATH, ORA_NLS, etc. refer to the existing Oracle8 Enterprise Edition Release 8.0.x environment.
  3. Ensure Adequate Rollback and System Space
    Ensure that there is sufficient free space in the SYSTEM tablespace (greater than 500 MB) and for the Rollback segments (greater than 750 MB).
  4. Install Latest Certified 9.0.1 Patch Set
    Install the latest Oracle9i Release 9.0.1 patch set certified for Oracle Applications in the Oracle9i Release 9.0.1 Oracle Home. Follow instructions in the How to Install This Patch Set section in the readme file of this patch to upgrade the Oracle Applications Databases.

    This patch is available via the OracleMetaLink patch download interface, or from Oracle Support.

  5. Apply Oracle9i Consolidated Patch (optional)
    If you are running a UNIX (or Linux) operating system for your database server, we recommend you obtain and install the consolidated patch 2373030 on top of patchset 3.

    If you are using a Windows operating system for your database server, apply database patchset 9.0.1.3 and database patch 9.0.1.3.0 patch 3 or higher. This combination of patches for Windows NT/2000 contains fixes corresponding to those identified above.

  6. Check OracleMetaLink for additional patches
    Additional issues with Applications running on 9.0.1 may have been identified since this document was authored. Check the Certify section of OracleMetaLink for the latest issues.
  7. Compile All Apps objects
    You may use the standard utility utlrp.sql (found in $ORACLE_HOME/rdbms/admin) to compile all the invalid objects in the Oracle Applications.

    Many database objects will become invalid due to the database upgrade. Compile the objects that belong to the APPS schema. Run AD Administration on the administration server and choose the "Compile APPS schema(s)" option from the Maintain Applications Database Objects menu.

  8. Activate optimizer enhancement (optional)
    The
    Oracle9i consolidated patch includes an optimizer enhancement. If you chose to install the patch, you should activate the enhancement now.

    Add the following line to your init.ora file:

              event="38004 trace name context forever, level 1"
              
    Shut down and restart the database.

    Attention: Everytime the database is upgraded to a higher version of RDBMS, this event has to be removed or commented out as it will cause deadlocks during the upgrade. Do not disable this event from the session level.

 

Change Log
Date Description
October 29, 2001
  • First Posted
November 27, 2001
January 31, 2002
March 1, 2002
  • updated with 9.0.1.2 patch set information
May 31, 2002
  • updated with 9.0.1.3 patch set information
  • added hypertext links to updates.oracle.com
June 6, 2002

Note 162091.1 by Oracle Applications Development
Copyright © 2002 Oracle Corporation
Last updated: Thu Jun 6, 2002