Contents

Title and Copyright Information

Preface

• Audience
• What's New for Oracle Application Server 10g (10.1.4.0.1)
• Documentation Accessibility
• Related Documents
• Conventions

Part I Before You Begin

1 Overview of the Upgrade Process

• 1.1 Flow Chart of the Oracle Application Server Upgrade Process
• 1.2 Table Describing the Steps in the Upgrade Process Flow Chart

2 Oracle Application Server Upgrade Concepts

• 2.1 Reviewing Your Current Oracle Application Server Installations
  • 2.1.1 Identifying the Existing Oracle Homes to Upgrade
  • 2.1.2 About Upgrading Oracle Access Manager
  • 2.1.3 Reviewing Your Current OracleAS Infrastructure Configuration
  • 2.1.4 Determining Whether Your Database is a Seed Database or OracleAS RepCA Database
  • 2.1.5 Using Application Server Control to Review Your Oracle Application Server Environment
• 2.2 Introduction to the Upgrade Tools
• 2.3 Upgrade Rules to Follow
  • 2.3.1 Middle Tiers Must Be Upgraded Before OracleAS Metadata Repository
  • 2.3.2 Upgrade Cannot Be Performed Across Hosts or Platforms
• 2.4 Supported Upgrade Paths for Oracle Application Server 10g (10.1.4.0.1)
• 2.5 Verifying Support for Third-Party Products

3 Understanding Version Compatibility

• 3.1 Using the Release 3 (10.1.4.0.1) Compatibility Matrix
• 3.2 Release 3 (10.1.4.0.1) Identity Management Compatibility Issues
  • 3.2.1 Running 10g (10.1.4.0.1) Identity Management with a 10g (9.0.4) or 10g Release 2 (10.1.2) Metadata Repository
• 3.3 Release 3 (10.1.4.0.1) OracleAS Metadata Repository Compatibility Issues
  • 3.3.1 Running a Release 3 (10.1.4.0.1) OracleAS Metadata Repository with 10g (9.0.4) Middle Tiers
• 3.4 Release 3 (10.1.4.0.1) Database Version Compatibility Issues
• 3.5 List of the Release 3 (10.1.4.0.1) Compatibility Issues
  • 3.5.1 Problems Logging In to OracleAS Portal
  • 3.5.2 Cannot Install 10g (10.1.4.0.1) Identity Management Against a 10g (9.0.4) or 10g Release 2 (10.1.2) OracleAS Metadata Repository
  • 3.5.3 Release 3 (10.1.4.0.1) Identity Management General Compatibility Requirements
    • 3.5.3.1 OracleAS Identity Management Components Must Be the Same Version as Their Required Schemas
    • 3.5.3.2 OracleAS Identity Management Components Must Use an Oracle Internet Directory Of the Same Version

4 Backup Strategies and System Availability During an Upgrade

• 4.1 Backup Strategies Before Upgrade
  • 4.1.1 Backup Strategies for OracleAS Metadata Repository Upgrades
    • 4.1.1.1 Backing Up the Database Before Upgrading the Database Version
    • 4.1.1.2 Backing Up the Database Before Running MRUA
  • 4.1.2 Backup Strategies for Identity Management Upgrades
  • 4.1.3 Backup Strategies After Upgrading Your Oracle Application Server Instances
• 4.2 Planning for System Downtime
  • 4.2.1 Estimated Time Required to Upgrade
  • 4.2.2 Example Execution Times for the Metadata Repository Upgrade Assistant

Part II Performing the Upgrade

5 Upgrading 10g (9.0.4) Middle Tiers to 10g Release 2 (10.1.2)

• 5.1 Task 1: Determine Whether or Not to Upgrade Your 10g (9.0.4) Middle Tiers
• 5.2 Task 2: Locate Instructions for Upgrading Middle Tiers to 10g Release 2 (10.1.2)

6 Upgrading the Database That Hosts the OracleAS Metadata Repository

• 6.1 Task 1: Review the OracleAS Metadata Repository Database Requirements
  • 6.1.1 Summary of the Database Versions Supported by Oracle Identity Management 10g (10.1.4.0.1)
  • 6.1.2 Using OracleMetaLink to Obtain the Latest Oracle Application Server Software Requirements
• 6.2 Task 2: Determine Your Database Version and Upgrade Path
  • 6.2.1 Determining Your Current Database Version
  • 6.2.2 Seed Database Versus OracleAS Metadata Repository Database
  • 6.2.3 Flow Chart of the OracleAS Metadata Repository Database Upgrade Process
  • 6.2.4 Table Describing the Steps in the Database Upgrade Path Flow Chart
• 6.3 Task 3: Upgrade the Database
  • 6.3.1 Upgrading a Seed Database with Oracle Universal Installer
    • 6.3.1.1 Overview of Using Oracle Universal Installer to Upgrade a Seed Database
    • 6.3.1.2 Upgrading an OracleAS Metadata Repository Seed Database in a Non-Colocated Infrastructure
    • 6.3.1.3 Stopping the Database Listener When Prompted During the OracleAS Identity Management Upgrade
  • 6.3.2 Upgrading an OracleAS RepCA Database
    • 6.3.2.1 If You Installed the OracleAS Metadata Repository in an Oracle9i Database
    • 6.3.2.2 Special Instructions When Applying the Oracle9i Release 2 (9.2.0.7) Database Patchset
    • 6.3.2.3 If You Installed the OracleAS Metadata Repository in an Oracle 10g Database
• 6.4 Task 4: Relocate the Database Datafiles, Control Files, and Log Files
• 6.5 Task 5: Configure Oracle Enterprise Manager 10g Database Control

7 Using Oracle Universal Installer to Upgrade Oracle Identity Management

• 7.1 Overview of the OracleAS Identity Management Components
• 7.2 Task 1: Review Your OracleAS Identity Management Configuration
• 7.3 Task 2: Understand the OracleAS Identity Management Database Requirements
• 7.4 Task 3: Back Up the OracleAS Identity Management Installation
• 7.5 Task 4: Perform the OracleAS Identity Management Upgrade
  • 7.5.1 Upgrading OracleAS Identity Management in a Colocated Infrastructure
  • 7.5.2 Upgrading OracleAS Identity Management in a Non-Colocated Infrastructure
  • 7.5.3 Upgrading Distributed OracleAS Identity Management Configurations
    • 7.5.3.1 Upgrading a Distributed OracleAS Identity Management Configuration
    • 7.5.3.2 Verifying Whether OracleAS Identity Management Components are Enabled or Disabled

8 Using MRUA to Upgrade the OracleAS Metadata Repository

• 8.1 Task 1: Understand and Prepare for the OracleAS Metadata Repository Upgrade
  • 8.1.1 Why Upgrade the OracleAS Metadata Repository?
  • 8.1.2 Preparing to Upgrade the OracleAS Metadata Repository
• 8.2 Task 2: Run MRUA and Upgrade the OracleAS Metadata Repository Schemas
• 8.3 Task 3: Verify the Success of the OracleAS Metadata Repository Upgrade
  • 8.3.1 Using SQL to Verify the Status of Each Component Schema After Running MRUA
  • 8.3.2 About Component Schema Version Numbers After Upgrading to 10g (10.1.4.0.1)

9 Component-Specific Post-Upgrade Procedures

• 9.1 Task 1: Enable OracleAS SSL Support (SSL) for OracleAS Identity Management Components
  • 9.1.1 Enabling SSL for Oracle Internet Directory After Upgrade
  • 9.1.2 Enabling SSL for OracleAS Single Sign-On After Upgrade
    • 9.1.2.1 Enabling Monitoring of OracleAS Single Sign-On and Oracle Delegated Administration Services in Application Server Control
  • 9.1.3 Enabling SSL for Oracle Delegated Administration Services After Upgrade
• 9.2 Task 2: Perform Oracle Internet Directory Post-Upgrade Steps
  • 9.2.1 Running the Certificate Upgrade Tool (upgradecert.pl)
  • 9.2.2 Modifying Access Policies After Oracle Internet Directory Upgrade
  • 9.2.3 Resetting the Replication Wallet Password
  • 9.2.4 Completing the Upgrade for the Oracle Directory Integration Platform
  • 9.2.5 Running the oidstats.sql Script After Upgrading Oracle Internet Directory from 10g (9.0.4)
  • 9.2.6 Modifying DSA Configuration Entries After Upgrade
  • 9.2.7 Recreating Oracle Internet Directory Indexes After Upgrade
  • 9.2.8 About the New Account Used for Accessing Server Manageability Information
• 9.3 Task 3: Perform OracleAS Single Sign-On Post-Upgrade Steps
  • 9.3.1 Re-configuring the OracleAS Single Sign-On Middle Tier
  • 9.3.2 Configuring Third-party Authentication
  • 9.3.3 Installing Customized Pages in the Upgraded Server
  • 9.3.4 Setting Up OracleAS Single Sign-On Replication
  • 9.3.5 Upgrading the OracleAS Single Sign-On Server with a Customized Middle Tier
  • 9.3.6 Troubleshooting Wireless Voice Authentication
  • 9.3.7 Installing Languages in the OracleAS Single Sign-On Server
  • 9.3.8 Removing Obsolete OracleAS Single Sign-On Partner Applications
• 9.4 Task 4: Perform OracleAS Portal Post-Upgrade Steps
  • 9.4.1 Starting all Middle Tiers That Use The Upgraded Portal Instance
  • 9.4.2 Moving the Portlet Repository to the New Format (Optional)
  • 9.4.3 Accessing the Upgraded OracleAS Portal
  • 9.4.4 Impact of Shutting Down the OracleAS Metadata Repository Database on OracleAS Portal Oracle Text Indexes
  • 9.4.5 Reconfiguring OracleAS Portal to Work with Delegated Administration Services
  • 9.4.6 Updating Customized Login Portlets
  • 9.4.7 Updating OracleAS Portal Performance Reporting
• 9.5 Task 5: Perform OracleAS Wireless Post-Upgrade Steps
  • 9.5.1 Adding Unique Constraint on the orclWirelessAccountNumber Attribute in Oracle Internet Directory
  • 9.5.2 Assigning Change Password Privilege to OracleAS Wireless
  • 9.5.3 Specifying URL Query Parameters for Wireless Services That Use the HTTP Adapter

10 Verifying the Upgrade and Decommissioning the Source Oracle Homes

• 10.1 Task 1: Verify the Oracle Identity Management Upgrade
• 10.2 Task 2: Decommission the OracleAS Identity Management Source Oracle Home

Part III Appendices for Specialized Environments and Troubleshooting

A Performing an Oracle Identity Management Multimaster and Fan-Out Replication Upgrade

• A.1 Task 1: Review the Terminology, Prerequisites, and Key Concepts For Upgrading a Replication Environment
  • A.1.1 Terminology Conventions for This Chapter
  • A.1.2 Valid Starting Points When Upgrading a Replication Environment
  • A.1.3 Understanding the Proper Order of Upgrades in a Replication Environment
  • A.1.4 Oracle Recommendations When Upgrading a Replication Environment
• A.2 Task 2: Prepare for the Oracle Identity Management Multimaster or Fan-Out Replication Upgrade
• A.3 Task 3: Perform the Oracle Internet Directory Replica Upgrade
  • A.3.1 Selecting a Replica Upgrade Method
  • A.3.2 Upgrading One Replica at a Time
  • A.3.3 Upgrading Oracle Internet Directory on Multiple Replicas Simultaneously
• A.4 Task 4: Completing the Upgrade of Each Replica
  • A.4.1 Changing the Replication DN Password in the Oracle Internet Directory Wallet for Each Replica
    • A.4.1.1 Changing the Replication DN Password
    • A.4.1.2 Resetting the Replication DN Password
  • A.4.2 Setting the orclreplicationid Attribute in the Upgraded 10g (10.1.4.0.1) Directory
• A.5 Task 5: Upgrading OracleAS Single Sign-On and Oracle Delegated Administration Services in a Replicated Environment

B Upgrading High Availability Configurations

• B.1 Summary of High Availability Upgrade Options, Restrictions, and Prerequisites
• B.2 Upgrading an OracleAS Cold Failover Cluster Infrastructure
• B.3 Transforming 10g (9.0.4) Rack-Mounted Identity Management
  • B.3.1 About Rack-Mounted Identity Management and OracleAS Cluster (Identity Management)
  • B.3.2 Task 1: Review the Requirements for Transforming the 10g (9.0.4) Rackmounted Identity Management
    • B.3.2.1 OracleAS Identity Management Configuration Requirements
    • B.3.2.2 Requirements for Colocated Versus Distributed OracleAS Identity Management
    • B.3.2.3 OracleAS Metadata Repository Storage Requirements
    • B.3.2.4 OracleAS Cluster (Identity Management) Backup Requirements
  • B.3.3 Task 2: Upgrade the Database That Hosts the OracleAS Metadata Repository
  • B.3.4 Task 3: If Necessary, Upgrade Any Middle Tiers That Use the OracleAS Metadata Repository
  • B.3.5 Task 4: Upgrade the First OracleAS Identity Management Instance
  • B.3.6 Task 5: Use the Metadata Repository Upgrade Assistant to Upgrade the Component Schemas in the OracleAS Metadata Repository
  • B.3.7 Task 6: Install Subsequent OracleAS Cluster (Identity Management) Instances
  • B.3.8 Task 7: Verify the Upgrade and Decommission the 10g (9.0.4) Oracle Homes
• B.4 Transforming a Distributed 10g (9.0.4) Rack-Mounted Identity Management Environment
• B.5 Upgrading an OracleAS Cluster (Identity Management) 10g Release 2 (10.1.2) Colocated Configuration
  • B.5.1 Task 1: Review the OracleAS Cluster (Identity Management) Upgrade Requirements
    • B.5.1.1 OracleAS Identity Management Configuration Requirements
    • B.5.1.2 Requirements for Upgrading a Colocated OracleAS Cluster (Identity Management) Configuration
    • B.5.1.3 OracleAS Cluster (Identity Management) Backup Requirements
  • B.5.2 Task 2: Upgrade the Database That Hosts the OracleAS Metadata Repository
  • B.5.3 Task 3: If Necessary, Upgrade any 10g (9.0.4) Middle Tiers to 10g Release 2 (10.1.2.0.2)
  • B.5.4 Task 4: Upgrade the First OracleAS Identity Management Instance
    • B.5.4.1 Task 4a: Prepare For and Perform the Upgrade
    • B.5.4.2 Task 4b: Reconfigure the DCM Cluster
    • B.5.4.3 Task 4c: Configure Oracle HTTP Server and OracleAS Single Sign-On
    • B.5.4.4 Task 4d: Finish the Upgrade of the First OracleAS Identity Management Instance
  • B.5.5 Task 5: Using Metadata Repository Upgrade Assistant to Upgrade the Component Schemas in the OracleAS Metadata Repository
  • B.5.6 Task 6: Installing Subsequent OracleAS Cluster (Identity Management) Instances
  • B.5.7 Task 7: Verify the Upgrade and Decommission the 10g Release 2 (10.1.2) Oracle Homes
• B.6 Upgrading an OracleAS Cluster (Identity Management) 10g Release 2 (10.1.2) Distributed Configuration
  • B.6.1 Task 1: Review the Distributed OracleAS Cluster (Identity Management) Upgrade Requirements
    • B.6.1.1 OracleAS Identity Management Configuration Requirements
    • B.6.1.2 Requirements for Upgrading a Distributed OracleAS Cluster (Identity Management) Configuration
    • B.6.1.3 OracleAS Metadata Repository Storage Requirements
    • B.6.1.4 OracleAS Cluster (Identity Management) Backup Requirements
  • B.6.2 Task 2: Upgrade the Database That Hosts the OracleAS Metadata Repository for the Distributed Environment
  • B.6.3 Task 3: If Necessary, Upgrade Any 10g (9.0.4) Middle Tiers to 10g Release 2 (10.1.2.0.2) in the Distributed Environment
  • B.6.4 Task 4: Upgrade the First Oracle Internet Directory Oracle Home in the Distributed Environment
  • B.6.5 Task 5: Upgrade the First OracleAS Single Sign-On Oracle Home
  • B.6.6 Task 6: Using Metadata Repository Upgrade Assistant to Upgrade the Component Schemas in the OracleAS Metadata Repository
  • B.6.7 Task 7: Installing Subsequent Oracle Internet Directory Instances
  • B.6.8 Task 8: Installing Subsequent OracleAS Single Sign-On Instances
  • B.6.9 Task 9: Verify the Upgrade and Decommission the 10g Release 2 (10.1.2) Oracle Homes

C Using the Data Migration Method of Upgrading OracleAS Identity Management

• C.1 Differences Between Data Migration and Typical OracleAS Identity Management Upgrade Procedures
• C.2 Using the Data Migration Method of Upgrading OracleAS Identity Management

D Reviewing the Upgrade Log Files

• D.1 Reviewing the Oracle Universal Installer Log Files
• D.2 Reviewing the MRUA Log Files
  • D.2.1 Guidelines for Using the MRUA Log Files
  • D.2.2 Locating the MRUA Log Files
• D.3 Reviewing the OracleAS Portal Repository Upgrade Log Files

E OracleAS Metadata Repository Upgrade Error Messages

• E.1 Error Messages Generated By the Metadata Repository Upgrade Assistant
• E.2 UDDI Registry OracleAS Metadata Repository Upgrade Error Messages
• E.3 Portal Repository Upgrade Messages
  • E.3.1 Numbered Error Messages (WWU-00001 to WWU-24999)
  • E.3.2 Numbered Warning Messages (WWU-25000 to WWU-49999)
  • E.3.3 Unnumbered Error Messages
  • E.3.4 Unnumbered Warning Messages

F Common Issues and Workarounds

• F.1 OracleAS Identity Management Upgrade Problems and Solutions
  • F.1.1 Insufficient Privileges Error When Upgrading Identity Management on UNIX Systems
  • F.1.2 Problems Encountered When Running the Oracle Internet Directory Upgrade Assistant From Oracle Universal Installer
  • F.1.3 Problem Stopping Processes in Source Oracle Home During OracleAS Identity Management Upgrade
  • F.1.4 Database Listener Errors When Running Configuration Assistants During OracleAS Identity Management Upgrade
  • F.1.5 Oracle Directory Integration Platform Configuration Assistant Fails with Time Synchronization Error
  • F.1.6 Errors While Running OracleAS Portal Patch Configuration Assistant During OracleAS Identity Management Upgrade
• F.2 OracleAS Metadata Repository Upgrade Issues and Workarounds
  • F.2.1 Deciding When to Upgrade an Infrastructure Database
  • F.2.2 Verifying the Progress of the Database Upgrade Assistant During OracleAS Identity Management Upgrade
  • F.2.3 Performance Issues When Using the Metadata Repository Upgrade Assistant (MRUA) to Upgrade the OracleAS Portal Schema
  • F.2.4 Database Upgrade Assistant Failure During OracleAS Identity Management Upgrade
  • F.2.5 Problem Upgrading OracleAS Portal Schemas with MRUA
  • F.2.6 Error About "DIP" User in Database Upgrade Log Files
  • F.2.7 MRUA Error While Upgrading the Portal Schema

Index