Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Structure
• Changes in This Revision
• Related Documents
• Conventions

1 Things You Should Know Before Upgrading

• 1.1 Reviewing Your Current Oracle Application Server Installations
• 1.1.1 Identifying the Oracle Homes to Upgrade
• 1.1.2 Reviewing Your Current OracleAS Infrastructure Configuration
• 1.1.3 Determining Whether Your Database is a Seed Database or OracleAS Metadata Repository Creation Assistant Database
• 1.2 Summary of the New Oracle Application Server 10g Release 2 (10.1.2) Releases
• 1.2.1 Oracle Application Server 10g Release 2 (10.1.2.0.0)
• 1.2.2 Oracle Application Server 10g Release 2 (10.1.2.0.2)
• 1.2.3 Oracle Application Server 10g Release 2 (10.1.2.0.1) Standard Edition One
• 1.2.4 Oracle Application Server 10g Release 2 (10.1.2.x) Patchsets
• 1.2.5 Summary of the Components Available with Each 10g Release 2 (10.1.2) Release
• 1.3 Introduction to the Upgrade Tools
• 1.4 Upgrade Rules to Follow
• 1.4.1 You Cannot Upgrade or Expand from Oracle Application Server 10g Release 2 (10.1.2.0.0) to 10g Release 2 (10.1.2.0.2)
• 1.4.2 Upgrade All Components to the Same Version
• 1.4.3 Middle Tiers Must Be Upgraded Before the OracleAS Metadata Repository
• 1.4.4 Upgrade Cannot Be Performed Across Hosts or Platforms
• 1.5 Typical Upgrade Scenarios
• 1.5.1 Upgrading a Standalone Middle Tier
• 1.5.2 Upgrading Multiple Middle Tiers and a Colocated Infrastructure
• 1.5.2.1 Starting with the Middle Tiers and a Colocated Infrastructure
• 1.5.2.2 Starting with 10g (9.0.4) OracleAS Identity Management in a Colocated Infrastructure
• 1.5.3 Upgrading Multiple Middle Tiers and a 10g (9.0.4) Non-Colocated Infrastructure
• 1.5.3.1 Starting with the Middle Tiers and a 10g (9.0.4) Non-Colocated Infrastructure
• 1.5.3.2 Starting with OracleAS Identity Management in a 10g (9.0.4) Non-Colocated Infrastructure
• 1.6 Upgrade Paths Organized by Installation Type
• 1.6.1 Middle Tier Upgrade Paths
• 1.6.1.1 Upgrading From Release 2 (9.0.2) Middle-Tier Installation Types
• 1.6.1.2 Upgrading From Release 2 (9.0.3) Middle-Tier Installation Types
• 1.6.1.3 Upgrading From 10g (9.0.4) Middle-Tier Installation Types
• 1.6.2 Infrastructure Upgrade Paths
• 1.6.2.1 Upgrading From Release 2 (9.0.2) Infrastructure Installation Types
• 1.6.2.2 Upgrading From 10g (9.0.4) Infrastructure Installation Types
• 1.6.3 A Note About Expanding or Changing an Installation Type
• 1.7 Understanding Transitional, Stable, and Unsupported Configurations
• 1.8 Additional Upgrade Scenarios
• 1.9 Verifying Support for Third-Party Products

2 Understanding Version Compatibility

• 2.1 Using the 10g Release 2 (10.1.2.0.2) Compatibility Matrix
• 2.2 10g Release 2 (10.1.2) Middle Tier Compatibility Issues
• 2.2.1 Running 10.1.2 Middle Tiers with 9.0.2 or 9.0.3 Middle Tiers
• 2.2.2 Running 10.1.2 Middle Tiers with a Release 2 (9.0.2) Infrastructure
• 2.2.3 Running 10.1.2 Middle Tiers with 9.0.4 Middle Tiers
• 2.2.4 Running 10.1.2 Middle Tiers with a 9.0.4 Infrastructure
• 2.2.5 Running 10.1.2.0.2 Middle Tiers with a 10.1.2.0.0 Infrastructure
• 2.3 10g Release 2 (10.1.2) OracleAS Identity Management Compatibility Issues
• 2.3.1 Running 10.1.2 Identity Management with 9.0.2 and 9.0.3 Middle Tiers
• 2.3.2 Running 10.1.2 Identity Management with a 9.0.2 Metadata Repository
• 2.3.3 Running 10.1.2 OracleAS Identity Management with a 9.0.4 Metadata Repository
• 2.4 10g Release 2 (10.1.2) OracleAS Metadata Repository Compatibility Issues
• 2.4.1 Running a 10.1.2 Metadata Repository with 9.0.2, 9.0.3, and 9.0.4 Middle Tiers
• 2.4.2 Running a 10.1.2 Metadata Repository with 9.0.2 Identity Management
• 2.5 10g Release 2 (10.1.2) Database Version Compatibility Issues
• 2.6 Complete List of the 10g Release 2 (10.1.2) Compatibility Issues
• 2.6.1 Configuring Oracle Internet Directory 10g Release 2 (10.1.2) for Use With Release 2 (9.0.2) Middle Tiers
• 2.6.2 Assigning the Enterprise Manager Web Site Port When Installing Release 2 (9.0.2) or Release 2 (9.0.3) on a 10g (9.0.4) or 10g Release 2 (10.1.2) Host
• 2.6.3 Problems Accessing 10g Release 2 (10.1.2) Instances from the Release 2 (9.0.2) or Release 2 (9.0.3) Farm Page
• 2.6.4 Running the dcmctl getState Command from a 10g Release 2 (10.1.2) Instance
• 2.6.5 Updating an Entry in the Release 2 (9.0.2) Oracle Internet Directory Before Installing the 10g Release 2 (10.1.2) Middle Tier
• 2.6.6 Problems Logging In to OracleAS Portal
• 2.6.7 Oracle Application Server Forms Services Gives Error FRM-92102
• 2.6.8 Oracle Delegated Administration Services: "Resource Access Information" Section Shows Incorrect User Resources
• 2.6.9 UDDI: Ping the Servlet Endpoint Returns "500 Internal Server Error"
• 2.6.10 Using OracleAS Wireless 10g Release 2 (10.1.2) with a Release 2 (9.0.2) OracleAS Metadata Repository
• 2.6.11 Cannot Register Oracle Database 10g Against Release 2 (9.0.2) Identity Management
• 2.6.12 Release 2 (9.0.2) OracleAS Metadata Repository Cannot Operate Within an Oracle Database 10g Instance
• 2.6.13 Middle Tiers Within an OracleAS Cluster Must Be the Same Version
• 2.6.14 Cannot Install 10g Release 2 (10.1.2) OracleAS Identity Management Against a Release 2 (9.0.2) or 10g (9.0.4) OracleAS Metadata Repository
• 2.6.15 10g Release 2 (10.1.2) OracleAS Identity Management General Compatibility Requirements
• 2.6.15.1 OracleAS Identity Management Components Must Be the Same Version as Their Required Schemas
• 2.6.15.2 OracleAS Identity Management Components Must Use an Oracle Internet Directory Of the Same Version

3 Backup Strategies and System Availability During an Upgrade

• 3.1 Backup Strategies Before Upgrade
• 3.1.1 Backup Strategies for Middle Tier Upgrades
• 3.1.2 Backup Strategies for OracleAS Metadata Repository Upgrades
• 3.1.2.1 Backing Up the Database Before Upgrading the Database Version
• 3.1.2.2 Backing Up the Database Before Running MRUA
• 3.1.3 Backup Strategies for Identity Management Upgrades
• 3.1.4 Backup Strategies After Upgrading Your Oracle Application Server Instances
• 3.2 System Availability During Upgrade
• 3.3 Planning for System Downtime

4 Upgrading the Middle Tier

• 4.1 Overview of the Middle Tier Upgrade Process
• 4.2 Task 1: Install a New 10g Release 2 (10.1.2) Middle Tier In Preparation for Upgrade
• 4.2.1 Before Installing the 10g Release 2 (10.1.2) Middle Tier Against a Release 2 (9.0.2) Oracle Internet Directory
• 4.2.2 Registering the OracleAS Web Cache Port Before Upgrading OracleAS Single Sign-On from Release 2 (9.0.2)
• 4.2.3 Applying Required Release 2 (9.0.2) Patchsets
• 4.2.4 Installing the Oracle Application Server 10g Release 2 (10.1.2) Middle Tier
• 4.3 Task 2: Prepare to Use the OracleAS Upgrade Assistant
• 4.3.1 Stopping the Enterprise Manager Web Site in a Release 2 (9.0.2) or Release 2 (9.0.3) Source Oracle Home
• 4.3.2 Optionally Increasing JVM Memory for Large OC4J Upgrades
• 4.3.3 Verifying that the Infrastructure Used by the Middle Tier is Running
• 4.4 Task 3: Run the OracleAS Upgrade Assistant
• 4.4.1 Optionally Specifying Logging Behaviors for the OracleAS Upgrade Assistant
• 4.4.2 Performing an Upgrade with the OracleAS Upgrade Assistant (Graphical User Interface (GUI) Version)
• 4.4.3 Performing an Upgrade with the OracleAS Upgrade Assistant (Command-line Version)
• 4.5 Task 4: Troubleshoot Any Upgrade Problems
• 4.5.1 Resolving OracleAS Upgrade Assistant Errors
• 4.5.1.1 Resolving Common Errors
• 4.5.1.2 Examining the Log File
• 4.5.1.3 Reasons for Oracle Application Server Containers for J2EE Upgrade and Deployment Failures
• 4.5.2 Restarting the OracleAS Upgrade Assistant
• 4.6 Task 5: Complete the Middle Tier Upgrade
• 4.6.1 About Port Values and the portlist.ini File After Upgrade
• 4.6.1.1 About the portlist.ini File
• 4.6.1.2 Using the Ports Page in the Application Server Control Console to Identity Port Assignments
• 4.6.1.3 About the Application Server Control Console Ports Before and After Upgrade
• 4.6.1.4 Examples of Port Assignments Before and After Upgrade
• 4.6.2 About Administration Passwords After Upgrade
• 4.6.3 Completing the Oracle HTTP Server Upgrade
• 4.6.3.1 Verifying the Secure Sockets Layer (SSL) Configuration After Upgrade
• 4.6.3.2 Manual Upgrade Tasks You May Need to Perform
• 4.6.4 Completing the Oracle Application Server Containers for J2EE (OC4J) Upgrade
• 4.6.4.1 Upgrading Oracle Application Server Java Authentication and Authorization Service (JAAS) Provider (JAZN) Security Settings
• 4.6.4.2 Upgrading JAZN Library Path Entries After Upgrading From Release 2 (9.0.2)
• 4.6.4.3 Reviewing the Default OC4J Instances After Upgrade
• 4.6.4.4 Completing the Upgrade of User-Created OC4J Instances
• 4.6.4.5 Upgrading application.xml Entries
• 4.6.4.6 Using the Compatibility Test Suite (CTS) Compatibility Flag for Backward Compatibility
• 4.6.4.7 Upgrade Considerations for Enterprise Java Beans
• 4.6.4.8 Upgrade Considerations for the OC4J Java Server Pages (JSP) Container
• 4.6.4.9 Considering JDK 1.4 Issues: Cannot Invoke Classes Not in Packages
• 4.6.4.10 Considering Modified Servlet APIs and Behavior
• 4.6.4.11 Deploying Oracle Business Components for Java (BC4J) Applications After Upgrade
• 4.6.5 Completing the Upgrade of OracleAS Web Cache
• 4.6.5.1 Using Multiple Versions of OracleAS Web Cache within an OracleAS Web Cache Cluster
• 4.6.5.2 Synchronizing the Upgraded OracleAS Web Cache Cluster Configuration
• 4.6.5.3 Upgrading an OracleAS Web Cache Cluster from Release 2 (9.0.2.x) to 10g Release 2 (10.1.2)
• 4.6.5.4 About Linking to the Application Server Control From the OracleAS Web Cache Welcome Page
• 4.6.5.5 Verifying the Location of OracleAS Web Cache Wallets
• 4.6.6 Completing the OracleAS Portal Middle Tier Upgrade
• 4.6.6.1 Verifying Oracle Internet Directory Properties for Custom Portals in the OracleAS Portal Dependency File
• 4.6.6.2 Updating Deployment Properties for Portal Development Kit Services for Java (JPDK) Web Providers
• 4.6.7 Completing the Oracle Business Intelligence Discoverer Viewer Upgrade
• 4.6.8 Completing the Oracle Application Server Reports Services Upgrade
• 4.6.8.1 Upgrading OracleAS Reports Services Customizations
• 4.6.8.2 Enabling Management of OracleAS Reports Services from the Application Server Control Console
• 4.6.8.3 Registering Standalone Reports Servers with OPMN and Oracle Enterprise Manager
• 4.6.8.4 Upgrading User-Defined OC4J Instances With OracleAS Reports Services Deployments
• 4.6.8.5 Configuring OracleAS Reports Services After Upgrading from Business Intelligence & Forms to Forms and Reports Services
• 4.6.9 Completing the Oracle Application Server Wireless Upgrade
• 4.6.9.1 Using the Oracle Application Server Wireless Notification Service Upgrade Script
• 4.6.9.2 Operating OracleAS Wireless Release 2 (9.0.2), 10g (9.0.4), and 10g Release 2 (10.1.2) Middle Tiers Together
• 4.6.9.3 Configuring Site-Level Drivers in a Mixed Mode Environment
• 4.6.9.4 Restoring the OracleAS Wireless Release 2 (9.0.2) Schema
• 4.6.9.5 Manually Creating Oracle Sensor Edge Server Processes After the OracleAS Metadata Repository Upgrade
• 4.6.9.6 OracleAS Wireless Middle Tier Applications Require Upgrade of the OracleAS Metadata Repository
• 4.6.10 Completing the Oracle Application Server Forms Services Upgrade
• 4.6.10.1 New Names for OracleAS Forms Services Files, Directories, URLs, and Environment Variables
• 4.6.10.2 Upgrading Forms *.fmx Files
• 4.6.10.3 Upgrading OracleAS Forms Services EAR File Deployed in User-defined OC4J Instances
• 4.7 Task 6: Start the Upgraded Middle Tier and Perform Final Upgrade Tasks
• 4.7.1 Starting the Upgraded Middle Tier
• 4.7.2 Updating the OracleAS Portal Provider Information
• 4.7.3 Refreshing the Event/Parameter Passing Samples Provider for OracleAS Portal
• 4.8 Task 7: Validate the Upgraded Middle Tier
• 4.8.1 Verify Operation of Middle Tier Components
• 4.8.2 Check Significant URLs
• 4.8.3 Reverting to the Source Oracle Home Resetting the Portal Service Monitoring Link
• 4.8.3.1 Resetting the OracleAS Portal Service Monitoring Link In the Source Oracle Home
• 4.8.3.2 Resetting the OracleAS Portal Services Monitoring Link When Reverting Back to the Destination Oracle Home
• 4.9 Task 8: Decommission the Middle-Tier Source Oracle Home
• 4.9.1 Preserving Application Files and Log Files
• 4.9.2 Retaining the Source Home for Future Language Loading
• 4.9.3 Removing the Source Oracle Home from the OracleAS Farm
• 4.9.4 Deinstalling a Release 2 (9.0.2) or Release 2 (9.0.3) Source Oracle Home
• 4.9.4.1 Deinstallation of 9.0.2 or 9.0.3 Instances from a Computer that Also Contains 10g Release 2 (10.1.2) Instances
• 4.9.4.2 Issue: 10g Release 2 (10.1.2) Instance Must Not Contain the Active Oracle Enterprise Manager
• 4.9.4.3 If a 10g Release 2 (10.1.2) Instance Becomes the Active Oracle Enterprise Manager
• 4.9.5 Deinstalling a 10g (9.0.4) Oracle Home
• 4.10 Special Considerations When Upgrading OracleAS Clusters, OracleAS Wireless, or Oracle Workflow
• 4.10.1 Special Instructions When Upgrading an Oracle Application Server Cluster
• 4.10.1.1 Understanding the Components of Oracle Application Server Cluster
• 4.10.1.2 Upgrading Oracle Application Server Cluster in a Database-Based Repository
• 4.10.1.3 Upgrading Oracle Application Server Cluster in a File-Based Repository
• 4.10.1.4 Updating the mod_oc4j Configuration File for an Upgraded Cluster
• 4.10.2 Special Instructions When Upgrading an OracleAS Wireless Release 2 (9.0.2) Middle Tier
• 4.10.3 Special Instructions When Upgrading Oracle Workflow Middle Tier Components

5 Upgrading Identity Management Services

• 5.1 Overview of the OracleAS Identity Management Components
• 5.2 Task 1: Review Your OracleAS Identity Management Configuration
• 5.2.1 Oracle Application Server Release 2 (9.0.2) OracleAS Identity Management Configuration Options
• 5.2.2 Oracle Application Server 10g (9.0.4) OracleAS Identity Management Configuration Options
• 5.2.3 About Oracle Application Server Certificate Authority
• 5.3 Task 2: Understand the OracleAS Identity Management Database Requirements
• 5.3.1 Database Upgrade Requirements When the OracleAS Identity Management is Part of a Colocated Infrastructure
• 5.3.2 Database Upgrade Requirements When the OracleAS Identity Management is Part of Non-Colocated Infrastructure
• 5.3.3 Stopping the Database Listener When Prompted During the OracleAS Identity Management Upgrade
• 5.3.4 Summary of the OracleAS Identity Management Database Upgrade Requirements
• 5.4 Task 3: Back Up the OracleAS Identity Management Installation
• 5.5 Task 4: Perform the OracleAS Identity Management Upgrade
• 5.5.1 Upgrading OracleAS Identity Management in a Colocated Infrastructure
• 5.5.2 Upgrading OracleAS Identity Management in a Non-Colocated 10g (9.0.4) Infrastructure
• 5.5.3 Upgrading Distributed OracleAS Identity Management Configurations
• 5.5.3.1 Upgrading Release 2 (9.0.2) Distributed OracleAS Identity Management Configurations
• 5.5.3.2 Upgrading 10g (9.0.4) Distributed OracleAS Identity Management Configurations
• 5.5.3.3 Verifying Whether OracleAS Identity Management Components are Enabled or Disabled
• 5.6 Task 5: Complete the OracleAS Identity Management Upgrade
• 5.6.1 Verifying the Application Server Control Console Port
• 5.6.2 About Administration Passwords After Upgrade
• 5.6.3 Enabling Secure Sockets Layer (SSL) for OracleAS Identity Management Components
• 5.6.3.1 Enabling SSL for Oracle Internet Directory After Upgrade
• 5.6.3.2 Enabling SSL for OracleAS Single Sign-On After Upgrade
• 5.6.3.3 Enabling SSL for Oracle Delegated Administration Services After Upgrade
• 5.6.4 Completing the Oracle Internet Directory Upgrade
• 5.6.4.1 Running the oidpu904.sql Script to Recreate the orclnormdn Catalog
• 5.6.4.2 Running the Certificate Upgrade Tool (upgradecert.pl)
• 5.6.4.3 Configuring Oracle Internet Directory 10g Release 2 (10.1.2) for Release 2 (9.0.2) Middle Tiers
• 5.6.4.4 Modifying Access Policies After Oracle Internet Directory Upgrade
• 5.6.4.5 Resetting the Replication Wallet Password
• 5.6.4.6 Completing the Upgrade for the Oracle Directory Integration and Provisioning
• 5.6.4.7 Oracle Internet Directory Post-Upgrade Steps Required for OracleAS Portal
• 5.6.4.8 Running the oidstats.sql Script After Upgrading Oracle Internet Directory from 10g (9.0.4)
• 5.6.4.9 Modifying DSA Configuration Entries After Upgrade
• 5.6.4.10 Recreating Oracle Internet Directory Indexes After Upgrade
• 5.6.5 Completing the OracleAS Single Sign-On Upgrade
• 5.6.5.1 Re-configuring the OracleAS Single Sign-On Middle Tier
• 5.6.5.2 Configuring Third-party Authentication
• 5.6.5.3 Installing Customized Pages in the Upgraded Server
• 5.6.5.4 Converting External Application IDs
• 5.6.5.5 Setting Up OracleAS Single Sign-On Replication
• 5.6.5.6 Upgrading the OracleAS Single Sign-On Server with a Customized Middle Tier
• 5.6.5.7 Troubleshooting Wireless Voice Authentication
• 5.6.5.8 Installing Languages in the OracleAS Single Sign-On Server
• 5.6.5.9 Re-Registering OracleAS Portal with the Upgraded OracleAS Single Sign-On Server
• 5.6.5.10 Re-Registering mod_osso with the Upgraded OracleAS Single Sign-On Server
• 5.6.5.11 Using an Upgraded Identity Management Configuration with Oracle9iAS Discoverer Release 2 (9.0.2)
• 5.6.5.12 Inactivity Timeout Issues When Upgrading From Release 2 (9.0.2) to 10g Release 2 (10.1.2)
• 5.6.5.13 Removing Obsolete OracleAS Single Sign-On Partner Applications
• 5.6.6 Completing the Oracle Application Server Certificate Authority Upgrade
• 5.6.7 Completing the OracleAS Wireless Upgrade
• 5.6.7.1 Upgrading Wireless User Accounts in Oracle Internet Directory
• 5.6.7.2 Adding Unique Constraint on the orclWirelessAccountNumber Attribute in Oracle Internet Directory
• 5.6.7.3 Disabling Oracle Application Server Wireless Upgrade Triggers in the Infrastructure Repository
• 5.6.7.4 Activating All OracleAS Wireless 10g Release 2 (10.1.2) Features
• 5.6.7.5 Assigning Change Password Privilege to OracleAS Wireless
• 5.6.7.6 Specifying URL Query Parameters for Wireless Services That Use the HTTP Adapter
• 5.6.8 Configuring Oracle Enterprise Manager 10g Database Control After OracleAS Identity Management Upgrade
• 5.7 Task 6: Validate the Identity Management Upgrade
• 5.7.1 Testing OracleAS Single Sign-On Connectivity
• 5.7.2 Testing Oracle Application Server Certificate Authority After Upgrade
• 5.8 Task 7: Decommission the OracleAS Identity Management Source Oracle Home
• 5.8.1 Relocating the Database Datafiles, Control Files, and Log Files After Upgrading a Colocated Infrastructure
• 5.8.2 Preserving Application Files and Log Files
• 5.8.3 Before You Deinstall Release 2 (9.0.2) OracleAS Identity Management from a Computer that Also Contains 10g Release 2 (10.1.2) Instances
• 5.8.4 Deinstalling the OracleAS Identity Management Source Oracle Home

6 Additional OracleAS Identity Management Upgrade Procedures

• 6.1 Performing an Oracle Internet Directory Multi-Master Replication Upgrade
• 6.1.1 Preparing for an Oracle Internet Directory Multi-Master Replication Upgrade
• 6.1.2 Upgrading Oracle Internet Directory on One Replica
• 6.1.2.1 Upgrading the Oracle Internet Directory Replica
• 6.1.2.2 Completing the Upgrade of a 10g (9.0.4) Replica
• 6.1.2.3 Completing the Upgrade of a Release 2 (9.0.2) Replica
• 6.1.3 Upgrading Oracle Internet Directory on Multiple Replicas Simultaneously
• 6.1.3.1 Simultaneously Upgrading Multiple Oracle Internet Directory Replicas
• 6.1.3.2 Completing the Simultaneous Upgrade of 10g (9.0.4) Replicas
• 6.1.3.3 Completing the Simultaneous Upgrade of Release 2 (9.0.2) Replicas
• 6.2 Upgrading Oracle Internet Directory Version 9.2.0.x
• 6.2.1 Overview of Upgrading Oracle Internet Directory Version 9.2.0.x
• 6.2.2 Performing the Oracle Internet Directory Version 9.2.0.x Upgrade
• 6.2.3 Updating the Oracle Contexts in the 9.2.0.x Oracle Internet Directory
• 6.2.4 Setting Access Control Policies After Upgrading From Oracle Internet Directory Version 9.2.0.x
• 6.3 Using the Data Migration Method of Upgrading OracleAS Identity Management
• 6.3.1 Differences Between Data Migration and Typical OracleAS Identity Management Upgrade Procedures
• 6.3.2 Using the Data Migration Method of Upgrading OracleAS Identity Management

7 Upgrading the OracleAS Metadata Repository

• 7.1 Task 1: Upgrade the Database That Hosts the OracleAS Metadata Repository
• 7.1.1 Summary of the OracleAS Metadata Repository Database Requirements
• 7.1.2 Using OracleMetaLink to Obtain the Latest Oracle Application Server Software Requirements
• 7.1.3 Determining Your OracleAS Metadata Repository Database Upgrade Path
• 7.1.4 Upgrading a Seed Database with Oracle Universal Installer
• 7.1.4.1 Overview of Using Oracle Universal Installer to Upgrade a Seed Database
• 7.1.4.2 Upgrading a 10g (9.0.4) OracleAS Metadata Repository Seed Database in a Non-Colocated Infrastructure
• 7.1.5 Upgrading an OracleAS Metadata Repository Creation Assistant Database
• 7.1.5.1 If You Installed the OracleAS Metadata Repository in an Oracle9i Database
• 7.1.5.2 Special Instructions When Applying the Oracle9i Release 2 (9.2.0.6) Database Patchset
• 7.1.5.3 If You Installed the OracleAS Metadata Repository in an Oracle 10g Database
• 7.1.6 Relocating the Database Datafiles, Control Files, and Log Files
• 7.1.7 Configuring Oracle Enterprise Manager 10g Database Control
• 7.1.8 Database Upgrade Considerations When Using Oracle Ultra Search
• 7.1.8.1 Upgrading Oracle Ultra Search Middle Tiers Before Upgrading the OracleAS Metadata Repository Database
• 7.1.8.2 Configuring Oracle Ultra Search When Upgrading a Oracle9i Release 2 (9.2.0.4) Database
• 7.1.8.3 Repairing Oracle Ultra Search After Upgrading an Oracle9i Release 2 (9.2.0.x) Database
• 7.1.8.4 Upgrading the Oracle Ultra Search Schemas Immediately After Upgrading the OracleAS Metadata Repository Database
• 7.2 Task 2: Back Up the OracleAS Metadata Repository Before Upgrade
• 7.3 Task 3: Review Special Considerations for Specific Component Schemas
• 7.3.1 Special Instructions Before Upgrading the OracleAS Portal Schemas
• 7.3.1.1 Downloading and Installing the OracleAS Portal 10g (9.0.4) Repository Upgrade Software
• 7.3.1.2 Downloading and Installing the Oracle9iAS Single Sign-On 9.0.2.5 Patch
• 7.3.1.3 Converting External Application Identifiers After Applying the OracleAS Single Sign-On 9.0.2.5 Patch
• 7.3.2 About Upgrading the Oracle Business Intelligence Discoverer Schema
• 7.3.3 About Upgrading the OracleAS Wireless Schema
• 7.3.3.1 About Upgrading Release 2 (9.0.2) and 10g (9.0.4) Wireless Schemas
• 7.3.3.2 Upgrading OracleAS Wireless Device Definitions
• 7.3.4 Preparing to Upgrade the Oracle Ultra Search Component Schema
• 7.4 Task 4: Run the Metadata Repository Upgrade Assistant (MRUA)
• 7.4.1 Applying Required Release 2 (9.0.2) Patchsets
• 7.4.2 Verifying That the Oracle Internet Directory and Database Processes Are Running
• 7.4.3 Stopping All Middle Tier Instances That Use the OracleAS Metadata Repository
• 7.4.4 Checking for Invalid Database Objects
• 7.4.5 Running the Metadata Repository Upgrade Assistant (MRUA)
• 7.4.6 Example Execution Times for the Metadata Repository Upgrade Assistant
• 7.4.7 Reviewing the MRUA Log Files
• 7.4.7.1 Guidelines for Using the MRUA Log Files
• 7.4.7.2 Locating the MRUA Log Files
• 7.4.8 Reviewing the OracleAS Portal Repository Upgrade Log Files
• 7.4.9 Using a SQL Query to Verify the Success of the OracleAS Metadata Repository Upgrade
• 7.5 Task 5: Complete the OracleAS Metadata Repository Upgrade for OracleAS Portal and OracleAS Wireless
• 7.5.1 Completing the OracleAS Portal Schema Upgrade Process
• 7.5.1.1 Reconfiguring OracleAS Portal to Work with Oracle Internet Directory After Upgrading From Release 2 (9.0.2)
• 7.5.1.2 Starting all Middle Tiers That Use The Upgraded Portal Instance
• 7.5.1.3 Moving the Portlet Repository to the New Format (Optional)
• 7.5.1.4 Accessing the Upgraded OracleAS Portal
• 7.5.1.5 Impact of Shutting Down the OracleAS Metadata Repository Database on OracleAS Portal Oracle Text Indexes
• 7.5.1.6 Reconfiguring OracleAS Portal to Work with Delegated Administration Services
• 7.5.1.7 Updating Customized Login Portlets
• 7.5.1.8 Updating OracleAS Portal Performance Reporting
• 7.5.2 Completing the OracleAS Wireless Schema Upgrade Process
• 7.6 Task 6: Start the Middle Tiers That Use the OracleAS Metadata Repository

8 Upgrading Standalone and Separately Installed Components

• 8.1 Upgrading a Standalone OC4J Instance
• 8.2 Upgrading a Standalone OracleAS Web Cache Instance
• 8.3 Upgrading Oracle Application Server InterConnect
• 8.3.1 Reviewing Your Current Oracle Application Server InterConnect Installations
• 8.3.2 Installing and Upgrading Hub Components, Adapters, and Development Kit
• 8.3.3 Upgrading Metadata
• 8.3.4 Upgrading Management
• 8.4 About Upgrading Oracle Application Server ProcessConnect
• 8.5 Upgrading Schemas in a Customer Database
• 8.5.1 Upgrading the Oracle Business Intelligence Discoverer End User Layer Schema
• 8.5.2 Upgrading the OracleAS Portal Repository in a Customer Database
• 8.5.2.1 Preparing to Upgrade the OracleAS Portal Repository in a Customer Database
• 8.5.2.2 Running the OracleAS Portal Repository Upgrade in a Customer Database
• 8.5.2.3 Completing the OracleAS Portal Repository Upgrade in a Customer Database
• 8.5.3 Upgrading the Oracle Workflow Schema in a Customer Database
• 8.5.4 Upgrading a Standalone PL/SQL Web Toolkit Installations

9 Upgrading High Availability Configurations

• 9.1 Summary of High Availability Upgrade Options, Restrictions, and Prerequisites
• 9.2 Upgrading an OracleAS Cold Failover Cluster Infrastructure
• 9.2.1 Overview of the OracleAS Cold Failover Cluster Infrastructure Upgrade
• 9.2.2 Backing Up the 10g (9.0.4) OracleAS Cold Failover Cluster Infrastructure
• 9.2.3 Preparing to Upgrade to 10g Release 2 (10.1.2) From Node 1
• 9.2.4 Upgrading to 10g Release 2 (10.1.2) From Node 1
• 9.2.5 Cleaning Up the OracleAS Cold Failover Cluster Infrastructure on Node 1
• 9.2.6 Configuring the Windows Registry, Oracle Inventory, and Services on Node 2
• 9.2.7 Special Instructions for Updating Node 2 When Using Asymmetrical Configurations
• 9.2.8 Using MRUA to Upgrade the OracleAS Metadata Repository from Node 2
• 9.2.9 Creating a pfile for the Database
• 9.2.10 Performing Required Post-Upgrade Procedures for the OracleAS Cold Failover Cluster
• 9.2.11 Performing Typical OracleAS Identity Management Post-Upgrade Tasks
• 9.3 Transforming 10g (9.0.4) Rack-Mounted Identity Management to OracleAS Cluster (Identity Management)
• 9.3.1 About Rack-Mounted Identity Management and OracleAS Cluster (Identity Management)
• 9.3.2 OracleAS Cluster (Identity Management) Upgrade Requirements
• 9.3.2.1 OracleAS Identity Management Configuration Requirements
• 9.3.2.2 Requirements for Colocated Versus Distributed OracleAS Identity Management
• 9.3.2.3 OracleAS Metadata Repository Storage Requirements
• 9.3.2.4 OracleAS Cluster (Identity Management) Backup Requirements
• 9.3.3 Overview of the OracleAS Cluster (Identity Management) Transformation Process
• 9.3.4 Upgrading the Database That Hosts the OracleAS Metadata Repository
• 9.3.5 Upgrading the Middle Tiers
• 9.3.6 Upgrading the First OracleAS Identity Management Instance
• 9.3.7 Using Metadata Repository Upgrade Assistant to Upgrade the Component Schemas in the OracleAS Metadata Repository
• 9.3.8 Installing Subsequent OracleAS Cluster (Identity Management) Instances
• 9.3.9 About Upgrading a Distributed OracleAS Cluster (Identity Management) Environment

A Component Upgrade Process Reference

• A.1 Middle Tier Upgrade Processes
• A.1.1 The Oracle Process Manager and Notification Server (OPMN) Upgrade Process
• A.1.1.1 Oracle Process Manager and Notification Server (OPMN) Upgrade Items
• A.1.2 The Instance Configuration Data Upgrade Process
• A.1.2.1 Instance Configuration Upgrade Items
• A.1.3 The Oracle Application Server Containers for J2EE (OC4J) Upgrade Process
• A.1.3.1 OC4J Upgrade Items
• A.1.4 The Oracle HTTP Server Upgrade Process
• A.1.4.1 OHS Upgrade Items
• A.1.5 The Oracle Application Server Web Cache Upgrade Process
• A.1.5.1 Oracle Application Server Web Cache Upgrade Items
• A.1.6 The mod_plsql Upgrade Process
• A.1.6.1 mod_plsql Upgrade Items
• A.1.7 The Oracle Enterprise Manager 10g Upgrade Process
• A.1.7.1 Oracle Enterprise Manager 10g Upgrade Items
• A.1.8 The Oracle Application Server Web Services UDDI Registry Upgrade Process
• A.1.8.1 Oracle Application Server Web Services UDDI Registry Upgrade Items
• A.1.9 The Oracle Ultra Search Upgrade Process
• A.1.9.1 Oracle Ultra Search Upgrade Items
• A.1.10 The OracleAS Portal Middle Tier Upgrade Process
• A.1.10.1 OracleAS Portal Upgrade Items
• A.1.11 The Oracle Application Server Wireless Upgrade Process
• A.1.11.1 Oracle Application Server Wireless Upgrade Items (List A)
• A.1.11.2 Oracle Application Server Wireless Upgrade Items (List B)
• A.1.12 The Oracle Business Intelligence Discoverer Upgrade Process
• A.1.12.1 Oracle Business Intelligence Discoverer Upgrade Items
• A.1.13 The Oracle Application Server Forms Services Upgrade Process
• A.1.13.1 OracleAS Forms Services Upgrade Items (List A)
• A.1.13.2 OracleAS Forms Services Upgrade Items (List B)
• A.1.13.3 OracleAS Forms Services Upgrade Items (List C)
• A.1.13.4 OracleAS Forms Services Upgrade Items (List D)
• A.1.13.5 Parameters in the formsweb.cfg Files That Are Not Upgraded
• A.1.13.6 OracleAS Forms Services File Name, Directory Name, URL, and Variable Name Changes in 10g Release 2 (10.1.2.0.2)
• A.1.14 The Oracle Application Server Reports Services Upgrade Process
• A.1.14.1 Oracle Application Server Reports Services Upgrade Items
• A.2 Infrastructure Upgrade Processes
• A.2.1 The Identity Management Upgrade Process
• A.2.2 The Metadata Repository Container Schema Upgrade Process
• A.2.3 The Process Connect Upgrade Process
• A.2.4 The Oracle Application Server Certificate Authority Upgrade Process
• A.2.5 The Oracle Ultra Search Schema Upgrade Process
• A.2.5.1 Oracle Ultra Search Schema Upgrade Items
• A.2.6 The OracleAS Portal Schema Upgrade Process
• A.2.6.1 OracleAS Portal Schema Upgrade Items
• A.2.7 The Oracle Application Server Web Services UDDI Registry Schema Upgrade Process
• A.2.7.1 Oracle Application Server Web Services Schema Upgrade Items
• A.2.8 The Web Clipping Upgrade Process
• A.2.8.1 Web Clipping Schema Upgrade Items
• A.2.9 The Oracle Application Server Wireless Schema Upgrade Process

B Files Reference

• B.1 Upgraded Files Sorted By File Name
• B.2 Upgraded Files Sorted By Directory Path
• B.3 Descriptions of the Upgraded Files

C Upgrade and Compatibility Error Messages

• C.1 Error Messages Common to All Components
• C.2 Error Messages When Upgrading Instance Configuration Components
• C.3 Error Messages When Upgrading Oracle Application Server Containers for J2EE
• C.4 Error Messages When Upgrading Oracle HTTP Server
• C.5 Error Messages When Upgrading Oracle Application Server Web Services UDDI Registry
• C.5.1 UDDI Registry Middle Tier Upgrade Error Messages
• C.5.2 UDDI Registry OracleAS Metadata Repository Upgrade Error Messages
• C.6 Error Messages When Upgrading mod_plsql
• C.7 Error Messages When Upgrading Oracle Application Server Portal
• C.7.1 Middle-tier Upgrade Error Messages for OracleAS Portal
• C.7.2 Portal Repository Upgrade Messages
• C.7.2.1 Numbered Error Messages (WWU-00001 to WWU-24999)
• C.7.2.2 Numbered Warning Messages (WWU-25000 to WWU-49999)
• C.7.2.3 Unnumbered Error Messages
• C.7.2.4 Unnumbered Warning Messages
• C.8 Error Messages When Upgrading OracleAS Wireless
• C.9 Error Messages When Upgrading Oracle Ultra Search
• C.10 Error Messages Generated By the Metadata Repository Upgrade Assistant
• C.11 Error Messages When Upgrading OracleAS Forms Services

D Troubleshooting Upgrade

• D.1 General and Middle Tier Upgrade Problems and Solutions
• D.1.1 Cannot Expand an Installation Type During an Upgrade
• D.1.2 Problems Using Middle Tier with Upgraded Infrastructure
• D.1.3 Cannot Upgrade to a High Availability Environment During an Upgrade
• D.1.4 Installing a 10g Release 2 (10.1.2) Middle Tier Against a Release 2 (9.0.2) Infrastructure
• D.1.5 Locating the Upgrade Documentation for Your Platform
• D.1.6 Decommissioned Application Server Instances Still Visible on Farm Page in Application Server Control Console
• D.1.7 'Could not start process' Error When Starting Oracle Application Server Services
• D.1.8 Enterprise Manager Web Site Port is Changed After Upgrade From Release 2 (9.0.2)
• D.1.9 OracleAS Web Cache Fails to Start Due to XML Parsing Error After Configuring Upgraded Middle Tier for SSL
• D.2 OracleAS Identity Management Upgrade Problems and Solutions
• D.2.1 Problems Encountered When Running the Oracle Internet Directory Upgrade Assistant From Oracle Universal Installer
• D.2.2 Problem Stopping Processes in Source Oracle Home During OracleAS Identity Management Upgrade
• D.2.3 Database Listener Errors When Running Configuration Assistants During OracleAS Identity Management Upgrade
• D.2.4 Oracle Directory Integration and Provisioning Configuration Assistant Fails with Time Synchronization Error
• D.3 OracleAS Metadata Repository Upgrade Issues and Workarounds
• D.3.1 Deciding When to Upgrade an Infrastructure Database
• D.3.2 Verifying the Progress of the Database Upgrade Assistant During OracleAS Identity Management Upgrade
• D.3.3 Performance Issues When Using the Metadata Repository Upgrade Assistant (MRUA) to Upgrade the OracleAS Portal Schema
• D.3.4 Database Upgrade Assistant Failure During OracleAS Identity Management Upgrade
• D.3.5 Problem Upgrading Oracle Workflow and OracleAS Portal Schemas with MRUA
• D.4 Need More Help?

Index