|
Oracle® Application Server Upgrade and Compatibility Guide
10g Release 2 (10.1.2) for UNIX Part No. B14090-02 |
|
 Previous |
 Next |
|
Oracle® Application Server Upgrade and Compatibility Guide
10g Release 2 (10.1.2) for UNIX Part No. B14090-02 |
|
|
Previous |
Next |
This appendix describes common problems that you might encounter when upgrading to Oracle Application Server Release 2 (10.1.2) and explains how to solve them. It contains the following topics:
This section describes common problems and solutions. It contains the following topics:
Section D.1.1, "Upgrading the Database Version of the Infrastructure Database"
Section D.1.2, "Cannot Expand an Installation Type During an Upgrade"
Section D.1.3, "Cannot Upgrade to a High Availability Environment During an Upgrade"
Section D.1.4, "Problems Using Middle Tier with Upgraded Infrastructure"
Section D.1.5, "Installing a 10g (10.1.2) Middle Tier Against a Release 2 (9.0.2) Infrastructure"
Section D.1.6, "Insufficient Privileges Error When Upgrading Identity Management on UNIX Systems"
Section D.1.7, "Locating the Upgrade Documentation for Your Platform"
Section D.1.8, "Problems Encountered While Upgrading Oracle Internet Directory"
Section D.1.10, "Configuration Assistant Failure During OracleAS Identity Management Upgrade"
Section D.1.12, "Database Upgrade Assistant Failure During OracleAS Identity Management Upgrade"
Section D.1.15, "Can Users Upgrade OracleBI Discoverer 10g (9.0.4) 10g (10.1.2)?"
The Oracle Application Server Metadata Repository requires an Oracle database. Before you upgrade to Oracle Application Server 10g Release 2 (10.1.2), your OracleAS Metadata Repository database must be one of the database versions described in Section 6.1, "Upgrading the Database That Hosts the OracleAS Metadata Repository".
Problem
When a newer version of Oracle Database is announced, should I upgrade the OracleAS Metadata Repository database to the new database version?
Solution
In general, use caution when upgrading your Infrastructure database to a new database version. Check Oracle Metalink (http://metalink.oracle.com) for posted articles or announcements that confirm that the database version and upgrade has been tested and is supported for an existing OracleAS Metadata Repository database.
|
See Also: Section 6.1, "Upgrading the Database That Hosts the OracleAS Metadata Repository" for information about supported upgrade paths for the 10g (10.1.2) Metadata Repository database |
After installing a middle tier, you may decide that you need a component that is in a larger middle tier. For example, you installed a J2EE and Web Cache middle tier, and you realize you need OracleAS Portal.
Problem
You want to expand your installation type while upgrading the middle tier to Oracle Application Server 10g Release 2 (10.1.2).
Solution
Expanding the installation type and upgrading to 10g (10.1.2) are two separate steps. For example, to upgrade your 10g Release 2 (9.0.4) J2EE and Web Cache installation to a 10g (10.1.2) Portal and Wireless installation, do the following:
Upgrade the J2EE and Web Cache instance to Oracle Application Server 10g Release 2 (10.1.2).
Use Oracle Universal Installer and the 10g (10.1.2) installation procedure to expand the installation type to Portal and Wireless.
|
See Also: Oracle Application Server Installation Guide for more information about expanding a middle tier |
Oracle Application Server 10g Release 2 (10.1.2) provides documentation for configuring your Oracle Application Server environment for high availability.
Problem
How do I upgrade my Oracle Application Server to a high availability environment?
Solution
Implementing a high available environment for Oracle Application Server and upgrading to 10g (10.1.2) are two separate steps:
To upgrade your Oracle Application Server installation to Oracle Application Server 10g Release 2 (10.1.2), use the instructions in this guide.
To configure you environment for high availability, see the Oracle Application Server High Availability Guide.
The upgrade process is designed to allow you to upgrade one Oracle Application Server instance at a time. However, only certain configurations are supported and you must follow the documented guidelines for upgrading your installations in the proper order.
Problem
After upgrading an OracleAS Infrastructure, all the middle tiers generate errors when attempting to connect to the upgraded Infrastructure.
Solution
This problem occurs when you upgrade the OracleAS Metadata Repository before you upgrade the middle tiers that depend on the repository. To fix the problem, you must do one of the following:
Upgrade the middle tiers so they are the same version as the OracleAS Metadata Repository.
Revert the OracleAS Metadata Repository to its original version by restoring a backup of the OracleAS Metadata Repository; then, upgrade the middle tiers before upgrading the OracleAS Metadata Repository.
If you have a Release 2 (9.0.2) middle tier that uses a Release 2 (9.0.2) Infrastructure, you must upgrade the middle tier before you upgrade the Infrastructure. Upgrading the middle tier involves installing a new 10g (10.1.2) middle tier against the Release 2 (9.0.2) Infrastructure.
Problem
Is it possible to install a 10g (10.1.2) middle tier against a Release 2 (9.0.2) Infrastructure?
Solution
Yes, but before you install the 10g (10.1.2) middle tier, you must make a required change to the Release 2 (9.0.2) Oracle Internet Directory.
You upgrade OracleAS Identity Management using the Oracle Application Server 10g Release 2 (10.1.2) installation procedure, which is performed using the Oracle Universal Installer.
Problem
When you attempt to upgrade OracleAS Identity Management on a UNIX system, the upgrade fails. An "insufficient privileges" error appears in the following log file:
904_SOURCE_ORACLE_HOME/assistants/dbma/logs/trace.log
Specifically, the error appears as follows:
oracle.sysman.assistants.util.sqlEngine.SQLFatalErrorException: ORA-01031: insufficient privileges
Solution
Before you start Oracle Universal Installer to begin the installation procedure, be sure to log in as a user that is a member of the DBA group for the database.
The Oracle Application Server 10g Release 2 (10.1.2) documentation is available on the Oracle Technology Network (OTN), but it is divided into platform-specific and generic documentation libraries.
Problem
You cannot find the Upgrade documentation specific to your platform (for example, Sun Solaris, Linux, or Windows).
Solution
Carefully review the contents of the Oracle Application Server documentation page on OTN:
http://www.oracle.com/technology/documentation/appserver10g.html
Note that platform specific documentation is listed separately. For example, the Oracle Application Server documentation for the Sun Solaris platform is available in the Solaris platform-specific documentation library.
Do not attempt to use the Upgrade documentation for a different platform if the platform-specific information you are looking for is unavailable.
If the upgrade documentation for a particular platform is not available, it is likely that platform is not yet supported for the current Oracle Application Server release. You can obtain more information about supported releases on Oracle MetaLink, http://metalink.oracle.com.
The Oracle Internet Directory upgrade assistant is one of the assistants that run near the end of the 10g (10.1.2) installation procedure when you are upgrading an OracleAS Identity Management installation.
You can get information about the cause of Oracle Internet Directory upgrade assistant errors by looking at the following log file:
ORACLE_HOME/ldap/log/oidca.log
Problem 1
The upgrade assistant log file (oidca.log) reports the following:
OID processes are currently running
Solution
This is a result of some Oracle Internet Directory or Oracle Directory Integration and Provisioning processes not being shut down properly in the source Oracle Home.
Shut down the processes in the source Oracle Home before retrying the Oracle Internet Directory configuration assistant from the Oracle Universal Installer configuration assistants page.
|
See Also: The corresponding version of the Oracle Internet Directory documentation to stop the Oracle Internet Directory and Oracle Directory Integration and Provisioning processes in the source Oracle Home. |
Problem 2
The Oracle Internet Directory upgrade fails with "table or view does not exist" error.
Solution
This problem occurs when the Oracle Internet Directory upgrade assistant is run against a 9.2.0.x OracleAS Metadata Repository containing a 9.2.0.x Oracle Internet Directory.
The solution is to do the following:
Create table imcfgregistry in the 9.2.0.x Oracle Internet Directory database repository by running the following SQL statement as ODS schema:
CREATE TABLE imcfgregistry (Component VARCHAR2(255), instMode VARCHAR2(255), IASInstance VARCHAR2(255)) TABLESPACE OLTS_DEFAULT MONITORING;
Retry the Oracle Internet Directory upgrade assistant from the Oracle Universal Installer configuration assistants screen.
Problem 3
The Oracle Internet Directory configuration assistant fails during the Configuration Assistants phase of the OracleAS Identity Management upgrade with Oracle Universal Installer.
Solution
Check the contents of the following configuration file in the destination Oracle home and verify that the file contains the correct SERVICE_NAME entry for your Metadata Repository. If the value assigned to this entry is incorrect, enter the correct name, save the file, and retry the assistant.
DESTINATION_ORACLE_HOME/network/admin/tnsnames.ora
Problem
When you run the Oracle Universal Installer to upgrade OracleAS Identity Management, a popup dialog notifies you that the installer will shut down some processes in the source Oracle home.
After the installer performs the shutdown, it checks that Oracle Internet Directory is stopped. If Oracle Internet Directory is not stopped for some reason, installer will display another popup dialog notifying you of the problem.
Solution
Examine the following log file to determine the cause of the problem:
DESTINATION_ORACLE_HOME/cfgtoollogs/shutdownprocesses.log
Resolve the problem and then manually stop Oracle Internet Directory in the source Oracle home. Once Oracle Internet Directory is stopped, continue with the OracleAS Identity Management upgrade by clicking Continue in Oracle Universal Installer.
|
See Also: Chapter "Oracle Internet Directory Process Control–Best Practices" in the Oracle Internet Directory Administrator's Guide for information about stopping and starting Oracle Internet Directory |
Problem
Oracle Universal Installer invokes configuration assistants at the end of the OracleAS Identity Management upgrade. Some of the configuration assistants require an Oracle Database 10g database listener to connect to the database. If an Oracle Database 10g database listener is not available, those configuration assistants fail.
Solution
The installer normally starts an Oracle Database 10g database listener in the destination Oracle home. However, if an Oracle9i (9.0.1.3) database listener is already running, then the installer fails to start the Oracle Database 10g (10.1.0.2) database listener.
The most common cause of this problem is that you missed the instruction in a pop-up dialog during the installation. This pop-up message indicates during the interview phase of the installation that there is a running database listener running and that you should stop the listener manually before proceeding.
To correct the problem, stop the existing Oracle9i (9.0.1.3) listener, and then start the database listener in the destination Oracle home, as follows:
Set the ORACLE_HOME environment variable to point to the destination Oracle home of upgrade.
Change directory to bin directory of the destination Oracle home.
After the Oracle Database 10g database listener is running, continue with the OracleAS Identity Management upgrade by clicking Retry on the Configuration Assistants page in Oracle Universal Installer.
Problem
Oracle Universal Installer invokes Database Upgrade Assistant at the end of OracleAS Identity Management Upgrade. Database Upgrade Assistant may take a long time depending on the size and contents of the database. The installer shows progress of the Database Upgrade Assistant by displaying percentage numbers, but no details about the progress are shown on the Configuration Assistants screen in Oracle Universal Installer.
Solution
If you would like to obtain more detailed information about the progress of the Database Upgrade Assistant, examine the log files generated by the Database Upgrade Assistant. The log files reside in:
DESTINATION_ORACLE_HOME/admin/SID/upgrade/
In this example, replace SID with the system identifier of the database in the source Oracle home.
To obtain the timestamps of the different stages of the database upgrade, search for the string "COMP_TIME" in the log files. For example,
grep ^COMP_TIME *.log
The output of the command identifies each stage of the database upgrade, as well as a timestamp for each stage. For example:
Oracle_Server.log:COMP_TIMESTAMP DBUPG__BGN 2004-12-16 10:11:00 2453356 36660 Oracle_Server.log:COMP_TIMESTAMP UTLIP__END 2004-12-16 10:12:58 2453356 36778 Oracle_Server.log:COMP_TIMESTAMP CATALG_BGN 2004-12-16 10:27:44 2453356 37664 Oracle_Server.log:COMP_TIMESTAMP CATPROC 2004-12-16 11:18:45 Oracle_Server.log:COMP_TIMESTAMP RDBMS 2004-12-16 11:21:50 Oracle_Server.log:COMP_TIMESTAMP JAVAVM 2004-12-16 12:27:24 Oracle_Server.log:COMP_TIMESTAMP XML 2004-12-16 12:41:17 Oracle_Server.log:COMP_TIMESTAMP CATJAVA 2004-12-16 12:45:03 Oracle_Server.log:COMP_TIMESTAMP CONTEXT 2004-12-16 12:49:17 Oracle_Server.log:COMP_TIMESTAMP XDB 2004-12-16 12:56:32 Oracle_Server.log:COMP_TIMESTAMP OWM 2004-12-16 13:01:14 Oracle_Server.log:COMP_TIMESTAMP AMD 2004-12-16 13:11:04 Oracle_Server.log:COMP_TIMESTAMP ORDIM 2004-12-16 13:43:34 Oracle_Server.log:COMP_TIMESTAMP SDO 2004-12-16 13:52:30 Oracle_Server.log:COMP_TIMESTAMP WK 2004-12-16 13:56:24 Oracle_Server.log:COMP_TIMESTAMP DBUPG_END 2004-12-16 14:10:39 PostUpgrade.log:COMP_TIMESTAMP UTLRP_BGN 2004-12-16 14:12:32 PostUpgrade.log:COMP_TIMESTAMP UTLRP_END 2004-12-16 15:29:47
Oracle Universal Installer invokes Database Upgrade Assistant at the end of OracleAS Identity Management Upgrade. If the Database Upgrade Assistant fails, you can examine the log files generated by the Database Upgrade Assistant. The log files reside in:
DESTINATION_ORACLE_HOME/admin/SID/upgrade/
In this example, replace SID with the system identifier of the database in the source Oracle home.
Examine the log files and determine the cause of the failure. In most cases, it is not possible to retry the Database Upgrade Assistant. Instead, you will need to restore the source Oracle home and the database files to their state before the OracleAS Identity Management Upgrade. After the restoration, make sure that the problems which caused the Database Upgrade Assistant to fail are resolved. Then run OracleAS Identity Management Upgrade again.
Problem
When operating in a OracleAS Cold Failover Cluster environment, the OracleAS Metadata Repository database cannot be stopped or started using the Oracle Enterprise Manager Database Control Console.
Solution
On the active node, use the SQLNET utility to start or stop the database server processes and the lsnrctl utility to start or stop the database listener process.
Problem
Previous versions of Oracle Application Server included installation types that install and configure the OracleAS Reports Services and OracleAS Forms Services components.
However, the initial release of 10g (10.1.2) does not include these installation types.
Solution
You cannot upgrade OracleAS Reports Services or OracleAS Forms Services to 10g (10.1.2) at this time.
Problem
I am using OracleBI Discoverer 10g (9.0.4). Can I install the new Oracle Business Intelligence 10g (10.1.2) and upgrade OracleBI Discoverer to 10g (10.1.2)?
Solution
You can download and install Oracle Business Intelligence 10g (10.1.2), but you cannot upgrade OracleBI Discoverer 10g (9.0.4) to the initial version of 10g (10.1.2).
You can find more solutions on Oracle MetaLink, http://metalink.oracle.com. If you do not find a solution for your problem, log a service request.
|
See Also: Oracle Application Server Release Notes, available on the Oracle Technology Network:http://www.oracle.com/technology/documentation/ |
