Skip Headers
Oracle® Application Server Upgrade and Compatibility Guide
10
g
(10.1.4.0.1) for UNIX
Part Number B28188-01
Home
Book List
Index
Master Index
Contact Us
Next
View PDF
Contents
Title and Copyright Information
Preface
Audience
What's New for Oracle Application Server 10
g
(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 10
g
(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 10
g
(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 10
g
(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 10
g
(10.1.4.0.1)
6.1.2
Using Oracle
MetaLink
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 Oracle9
i
Database
6.3.2.2
Special Instructions When Applying the Oracle9
i
Release 2 (9.2.0.7) Database Patchset
6.3.2.3
If You Installed the OracleAS Metadata Repository in an Oracle 10
g
Database
6.4
Task 4: Relocate the Database Datafiles, Control Files, and Log Files
6.5
Task 5: Configure Oracle Enterprise Manager 10
g
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 10
g
(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 10
g
(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