This chapter describes issues associated with Oracle Fusion Middleware installation, patching, and configuration. It includes the following topics:
Note:
This chapter contains issues you might encounter while installing, patching, or configuring any of the Oracle Fusion Middleware products.Be sure to review the product-specific release note chapters elsewhere in this document for any additional issues specific to the products you are using.
This section describes installation issue and workarounds. It includes the following topics:
Section 2.1.2, "Oracle Portal, Forms, Reports and Discoverer Installation Issues"
Section 2.1.10, "Installing Oracle Service Registry in the Same Domain as Oracle SOA Suite"
Section 2.1.11, "Problems Installing in Thai and Turkish Locales"
Section 2.1.12, "Enterprise Manager Configuration Fails with Timezone Error Message"
This section contains installation issues pertaining to Oracle SOA Suite:
If you install Oracle SOA Suite on a dual stack host and the SOA front end URL is only set to IPv4, Oracle BPM Worklist or asynchronous callbacks from IPv6-only clients may have problems resolving IPv4 callback URLs (and vice-versa).
The work around is to use either a split Domain Name System (DNS) or another forward proxy configuration. This enables the IPv6-only client to connect to a dual stack box through its IPv6 interface.
If you are installing Oracle SOA Suite Release 11.1.1.3.0 in a Turkish environment, there will be some functionality loss for Oracle Enterprise Manager Fusion Middleware Control.
There is no work around for this issue. Oracle recommends that you avoid installing in a Turkish environment and install in an English environment instead.
This section contains installation issues pertaining to Oracle Portal, Reports, Forms and Discoverer:
Section 2.1.2.1, "Installing Oracle Portal, Forms, Reports and Discoverer on Windows with IPv6"
Section 2.1.2.3, "Prerequisite Warnings During Installation"
If you are installing Oracle Portal, Forms, Reports and Discoverer on a Windows operating system that supports IPv6 (for example, Windows Vista or Windows 7), the components in the installation will not start if IPv6 is enabled.
Make sure that IPv6 is disabled on your Windows operating system before you install these components.
During the installation of Oracle Portal, Forms, Reports and Discoverer on any Windows operating system, if you choose to extend your domain or expand a cluster and specify a domain name other than the default "ClassicDomain," you will see a "Missing Shortcut" error when you try to start and stop the Managed Servers.
The work around for this issue is as follows:
From the Start menu, right-click on the shortcut that generated the error message.
In the shortcut tab, go to the target node.
Change the domain name to the correct domain name.
Click Apply.
Vendor release updates cummulative patches and/or packages that may superseed our listed Oracle Fusion Middleware 11g Release 1 prerequisites for platforms. As long as vendor approved patches and/or packages are installed, the prerequisite warnings could be ignored and the installation completed.
Another option is to use -ignoreSysPreReqs command line additional argument to the runInstaller as:
$ Mount_Point/runInstaller -ignoreSysPreReqs other required install options
This section contains installation issues pertaining to Oracle Web Tier:
Section 2.1.3.1, "Oracle Web Tier Installation on Windows Requires User Account Control Enabled"
Section 2.1.3.4, "Oracle Web Tier Silent Install Requires Oracle Web Cache Component Name"
Section 2.1.3.5, "Oracle Web Tier Sample Response File is Missing the MIDDLEWARE_HOME Entry"
If you are installing and configuring Oracle Web Cache on a Microsoft Windows operating system, you must have User Acount Control enabled on your system.
Refer to your Microsoft Windows documentation for details and instructions.
To ensure that the oracle_common/soa/modules/commons-cli-1.1.jar (on UNIX operating systems) or oracle_common\soa\modules\commons-cli-1.1.jar (on Windows operating systems) file is installed properly, if you plan to associate Oracle Web Tier with an existing domain, you must install Oracle Web Tier after all other products are installed.
During the installation of Oracle Web Tier on Microsoft Windows operating systems, if you accidentally specified an installation directory using double backslash (\\) characters, you will encounter problems when you try to start Oracle Web Cache.
The work around is to re-install Oracle Web Cache without using double backslash characters in the installation location.
If you are performing a silent Oracle Web Tier installation for Oracle HTTP Server, an Oracle Web Cache component name (WEBCACHE_COMPONENT_NAME parameter) must also be mentioned in the response file, even though Oracle Web Cache is not required for Oracle HTTP Server installation. Even though both component names are provided, as long as CONFIGURE_WEBCACHE is set to false then only Oracle HTTP Server will be installed and configured.
There is no work around for this issue.
When installing Oracle Web Tier, the sample response files that are provided in the Disk1/stage/Response (on UNIX operating systems) or Disk1\stage\Response (on Windows operating systems) directories are missing an entry for specifying the Middleware home directory.
If you plan on using these response files for silent installation, you must add the MIDDLEWARE_HOME entry to the file. For example:
MIDDLEWARE_HOME=/home/Oracle/Middleware
This section contains installation issues pertaining to Oracle Identity Management:
Section 2.1.4.5, "Do Not Install Patch 9824531 During the Setup of OIM and OAM Integration"
Section 2.1.4.7, "Welcome Screen of Oracle Entitlements Server Installer Not Translated"
Included per bug 9104511.
If you install the Oracle Home directory to a File Allocation Table 32 (FAT32) file system during Oracle Identity Management installation, a pop-up dialog box containing the following text appears on the Specify Installation Location screen:
null null null
The following is the dialog box text that is hidden by the erroneous "null null null" message:
The Windows FAT file system allows any user to create, modify and delete all files on the file system. Oracle recommends use of NTFS on windows operating systems because it preserves permission restrictions on files. Do you want to Continue?
To work around this issue, click Yes on the dialog box to continue the installation, or click No to cancel the installation.
Included per bug 9051784.
When you install Oracle Identity Management, you have several options for choosing how the Oracle Identity Management components are installed in relation to an Oracle WebLogic Server administration domain. If you select the Extend Existing Domain option on the installer's Select Domain screen, Oracle Identity Management components are installed in an existing Oracle WebLogic Server administration domain.
To install Oracle Identity Management components in an existing administration domain using the Extend Existing Domain option, the Oracle WebLogic Administration Server instance must be running.
Included per bug 9116464
While starting the installation of Classic, Oracle Identity Management (IDM), or WebTier shiphomes, the following syntax error may be seen:
Please wait ..../runInstaller: syntax error at line 299: `count1=$' unexpected
This syntax error message can be safely ignored as this issue is seen on a few Solaris systems and the installation completes with no functionality impact.
The Oracle Access Manager 11g WebGates require operating system-specific GCC libraries on Linux and Solaris platforms. During the installation process of the 11g Webgates, the installer will verify the required GCC library versions. To verify that you have the correct GCC library versions before installation, run the following commands on your respective operating system. The output of each command should be greater than zero. If the output of any command is zero, install the correct GCC libraries as outlined in Oracle Fusion Middleware Installation Guide for Oracle Identity Management (Chapter 23 Installing and Configuring Oracle HTTP Server 11g Webgate for OAM).
In Linux32/i386 environments:
strings -a libgcc_s.so.1 | grep -c "GCC_3.0"
strings -a libgcc_s.so.1 | grep -v "GCC_3.3.1" | grep -c "GCC_3.3"
file libgcc_s.so.1 | grep "32-bit" | grep -c "80386"
file libstdc++.so.5 | grep "32-bit" | grep -c "80386"
In Linux64/x86-64 environments:
strings -a libgcc_s.so.1 | grep -c "GCC_3.0"
strings -a libgcc_s.so.1 | grep -v "GCC_3.3.1" | grep -c "GCC_3.3"
strings -a libgcc_s.so.1 | grep -c "GCC_4.2.0"
file libgcc_s.so.1 | grep "64-bit" | grep -c "x86-64"
file libstdc++.so.6 | grep "64-bit" | grep -c "x86-64"
In Solaris64/SPARC environments:
strings -a libgcc_s.so.1 | grep -c "GCC_3.0"
strings -a libgcc_s.so.1 | grep -v "GCC_3.3.1" | grep -c "GCC_3.3"
file libgcc_s.so.1 | grep "64-bit" | grep -c "SPARC"
file libgcc_s.so.1 | grep "64-bit" | grep -c "x86-64"
file libstdc++.so.5 | grep "64-bit" | grep -c "SPARC"
In the Oracle Fusion Middleware Installation Guide for Oracle Identity Management, Step 10 in the section titled "Setting Up Integration Between OIM and OAM Using the Domain Agent" instructs users about installing Patch 9824531.
Do not install this patch.
Note that you must download and install the following patches instead of Patch 9824531:
Patch 9674375
Patch 9817469
Patch 9882205
You can download these patches from My Oracle Support.
Included per bug 11074455
In 11.1.1.2 release, while installing WebTier or IDM on Linux x86-64, AIX and HP-UX platforms, JDK gets installed in both ORACLE_HOME and ORACLE_COMMON. JDK version installed in ORACLE_COMMON is lower in version than that of ORACLE_HOME. Hence should not be used. PS3 patching fails to resolve the JDK issue. However, this issue does not affect the successful installation of Webtier or IDM.
To work around this issue, use the JDK in ORACLE_HOME and avoid using the JDK installed in ORACLE_COMMON.
Bug 12387240 - note entered by Peter LaQuerre for 11.1.1.5.0
When you are installing Oracle Entitlements Server in a non-English environment, the text on the Welcome screen does not appear in the selected language. This is a known problem that will be addressed in a future release.
Email thread from writer, Michael Teger; dev contact is Sirish Vepa.
The section, "Using the Java Security Module" in the Oracle Fusion Middleware Installation Guide for Oracle Identity Management, describes how to configure and use a Java security module with Oracle Entitlements Server.
In addition to the information provided in the installation guide, consider the following additional information when configuring the security module:
When a Security Module is configured as a proxy client, set the authentic.identity.cache.enabled system property to true. The configuration is based on the type of Security Module being used and is done for the JVM in which the Web Services or RMI Security Module remote proxy is executing.
Specifically:
If the Security Module is a WebLogic Server Security Module, the system property -Dauthentic.identity.cache.enabled=true should be appended to the JAVA_OPTIONS environment variable in the setDomainEnv.sh script on Unix or the setDomainEnv.cmd script on Windows.
If the Security Module is a Java Security Module, the system property -Dauthentic.identity.cache.enabled=true should be added to the program being protected by the Java Security Module.
This section contains installation issues pertaining to JDKs and JREs during installation:
Section 2.1.5.1, "Specifying the JRE Location if Installing with Automatic Updates"
Section 2.1.5.2, "Upgrading Sun JDK in the Oracle Home Directory"
Section 2.1.5.3, "Installation Fails on 64-bit Operating Systems with 32-bit JDKs"
If you are installing one of the following Oracle Fusion Middleware products:
Oracle SOA Suite
Oracle WebCenter
Oracle Service Bus
Oracle Enterprise Content Management Suite
Oracle Data Integrator
Oracle Identity and Access Management
And you will choose to configure automatic updates on the Install Software Updates screen by selecting Download and install updates from My Oracle Support you must specify the location of a JRE on your system by using the -jreLoc parameter from the command line when you start the installer.
If you do not use the -jreLoc parameter and instead wait for the installer to prompt you for a JRE location, an exception will be seen during the installation.
Certain installations, including Oracle Identity Management, Oracle Portal, Forms, Reports and Discoverer, and Oracle Web Tier will install Sun JDK version 1.6.0_07 in the Oracle home directory. This version of the Sun JDK may be lower in version than what is specified in the Oracle Fusion Middleware Certification Document:
http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html
This JDK is used internally and should not be used to deploy Oracle SOA, Oracle WebCenter, or any custom J2EE applications.
If you want a single JDK version deployed for all types of applications, you can upgrade Sun JDK 1.6.0_07 to Sun JDK 1.6.0_11 or higher as specified in the Oracle Fusion Middleware Certification document using the following steps:
Shut down all processes.
Back up your existing JDK (for example, Sun JDK 1.6.0_07).
Install the new JDK (for example, Sun JDK 1.6.0_11) in the same location as your existing JDK.
Restart all processes.
If you are installing Oracle SOA Suite, Oracle WebCenter, or Application Developer on a 64-bit platform with a 32-bit JDK, you must run the installer by specifying the JRE location at the command line, as shown below:
On UNIX operating systems:
> ./runInstaller -jreLoc JRE_LOCATION
On Windows operating systems:
D:\ setup.exe -jreLoc JRE_LOCATION
Note:
Specify the absolute path to yourJRE_LOCATION; relative paths are not supported.To work around this issue:
Append -jreLoc and the 32-bit JDK path to the install command.
In UNIX/Linux environments:
INSTALL_PATH/runInstaller -jreLoc 32BIT_JAVA_HOME
In Windows environments:
INSTALL_PATH\setup.exe -jreLoc 32BIT_JAVA_HOME
This section contains installation issues pertaining to the product installers:
If you have downloaded the setup.exe installer in the C:\Document and Settings directory, and there is also the C:\Documents directory already present on your system, the installer will not start as it will attempt to locate files in C:\Documents.
The work around is to either remove or rename the C:\Documents directory.
This section contains installation issues pertaining to databases and schemas:
Section 2.1.7.1, "Problems with the Oracle Home Directory Being Overwritten on Windows"
Section 2.1.7.2, "Setting the nls_length_semantics Parameter in your Database"
Section 2.1.7.3, "Installing the SOAINFRA Schema with DBA Permissions"
If you are installing Oracle Fusion Middleware on a Windows system, and that system already contains an Oracle database, then you may encounter issues where the ORACLE_HOME global environment variable used by the database is overwritten by the Oracle Fusion Middleware product installation.
To view the global environment variable, select System Properties > Advanced > Environment variables > System Variables and check the value of ORACLE_HOME. From here, you can set the value of ORACLE_HOME to the location of the desired product.
Oracle Fusion Middleware only supports schemas in a byte-mode database. The nls_length_semantics initialization parameter on the database where the schemas reside must be set to BYTE; setting this parameter to CHAR is not supported.
To check the values of this parameter using SQL*Plus, you can use the show parameters command:
prompt> sqlplus "sys/password as sysdba"SQL> show parameters nls_length_semantics
Replace password with the actual password for the SYS user.
Alternatively, you can check the values by querying the V$PARAMETER view:
prompt> sqlplus "sys/password as sysdba"SQL> select name,value from v$parameter;
If you need to install the SOAINFRA schema and you are using a user with only DBA permissions, run the following commands on your database prior to running RCU:
GRANT ALL ON dbms_aqadm TO user WITH GRANT OPTION; GRANT ALL ON dbms_aq TO user WITH GRANT OPTION;
Replace user in the command with the name of your database user.
If the installation of Oracle Internet Directory fails due to timeout or connection failure when connecting to a database for schema creation, you can try to reset the timeout parameter in the rcu.properties file. This file is located in the IDM_Home/rcu/config directory on UNIX operating systems. On Windows operating systems, this file is located in the IDM_Home\rcu\config directory.
Open the rcu.properties file in a text editor, search for the property JDBC_LOGIN_TIMEOUT, and set its value to 30.
On Windows operating systems, the command used to drop tablespaces and data files does not drop data files from the file system.
This is a known problem specific to Oracle databases running on Windows operating systems.
This section contains installation issues pertaining to error messages and exceptions seen during installation:
After extending an Oracle Identity Management domain, you may see exception messages related to JRF Startup Class in the managed server log files. For example:
Failed to invoke startup class "JRF Startup Class", oracle.jrf.PortabilityLayerException: Fail to retrieve the property for the Common Components Home. oracle.jrf.PortabilityLayerException: Fail to retrieve the property for the Common Components Home.
You can safely ignore these exception messages—there is no loss in functionality.
Upon completing of an Oracle Web Tier, Oracle Identity Management, or Oracle Portal, Forms, Reports and Discoverer installation, the following errors may be seen in the installtime_and_date.log file:
[2009-11-04T21:15:13.959-06:00] [OUI] [NOTIFICATION] [] [OUI] [tid: 16] [ecid: 0000IJ2LeAeFs1ALJa5Eif1Aw^9l000007,0] OUI-10080:The pre-requisite for the component Sun JDK 1.6.0.14.08 has failed. [2009-11-04T21:15:13.960-06:00] [OUI] [NOTIFICATION] [] [OUI] [tid: 16] [ecid: 0000IJ2LeAeFs1ALJa5Eif1Aw^9l000007,0] OUI-10080:The pre-requisite for the component Oracle Configuration Manager 10.3.1.2.0 has failed.
These messages occur because the Sun JDK and Oracle Configuration Manager are not installed in the oracle_common directory. You can safely ignore these messages.
This section contains issues pertaining to product deinstallation:
Section 2.1.9.1, "Proper Deinstallation for Reinstallation in the Event of a Failed Installation"
Section 2.1.9.3, "Deinstallation Does Not Remove WebLogic Domains"
In the event that an installation fails, and you want to deinstall the failed installation and then reinstall the software to the same location, you must do the following:
Make sure that all the managed servers in the failed installation are shut down. You must verify this in the Administration Console; the word "SHUTDOWN" must appear next to the managed server name.
Deinstall the binaries in the Oracle home directory using the deinstaller in the ORACLE_HOME\oui\bin directory.
Delete all the managed servers from the failed installation in the config.xml file by using the Administration Console or WLST.
Delete all directories in the DOMAIN_HOME\servers directory:
This procedure will enable you to reinstall the software to the same location, using the same managed server names.
Before starting Classic Application Server installation, any reference to Program Files (x86) must be removed from the PATH environment variable. On echoing PATH on the command prompt, Program Files (x86) should not be present.
There may be certain scenarios where you will need to remove WebLogic Domains that you have created. The Oracle Universal Installer is used to remove Oracle Instances and Oracle home directories only; it does not remove WebLogic Domains.
If you need to remove a WebLogic Domain, you must do so manually. Please refer to your Oracle WebLogic Server documentation for more information.
When installing Oracle Service Registry 11g in the same Weblogic Domain as Oracle SOA Suite 11g Release 11.1.1.2.0 or Release 11.1.1.3.0, you may see the following error message on the WebLogic Server console when Oracle Service Registry is starting up:
java.lang.LinkageError: loader constraint violation in interface itable initialization:....
To work around this issue:
Make sure Oracle Service Registry is installed on a different Managed Server from Oracle SOA Suite.
Download patch 9499508 and follow the instructions in the README file included with the patch:
Go to My Oracle Support.
http://support.oracle.com
Click on the Patches & Updates tab.
In the Patch Search area, search for patch 9499508.
Download the patch.
Edit the setDomainEnv.sh file and, for Oracle Service Registry Server, remove fabric.jar from classpath:
if [ "${SERVER_NAME}" != "osr_server1" ] ; then
POST_CLASSPATH="${SOA_ORACLE_HOME}/soa/modules/oracle.soa.fabric_11.1.1/oracle.soa.fabric.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.adapter_11.1.1/oracle.soa.adapter.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.b2b_11.1.1/oracle.soa.b2b.jar
${CLASSPATHSEP}${POST_CLASSPATH}"
else
POST_CLASSPATH="${SOA_ORACLE_HOME}/soa/modules/oracle.soa.adapter_11.1.1/oracle.soa.adapter.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.b2b_11.1.1/oracle.soa.b2b.jar
${CLASSPATHSEP}${POST_CLASSPATH}"
fi
When installing Oracle Service Registry 11g in the same Weblogic Domain as Oracle SOA Suite 11g Release 11.1.1.3.0, you may see the following error message when accessing the Oracle Service Registry console:
ClassCastException java.lang.ClassCastException:org.systinet.uddi.client.serialization.UDDIFaultSerializer
To work around this error, edit the setDomainEnv.sh file and remove oracle.soa.fabric.jar from the classpath when running the Oracle Service Registry Managed Server. To do this:
Make a backup of the MW_HOME/user_projects/domains/soa_domain_name/bin/setDomainEnv.sh file.
Edit the setDomainEnv.sh file and replace the following line:
POST_CLASSPATH="${SOA_ORACLE_HOME}/soa/modules/oracle.soa.fabric_11.1.1/oracle.soa.fabric.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.adapter_11.1.1/oracle.soa.adapter.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.b2b_11.1.1/oracle.soa.b2b.jar
${CLASSPATHSEP}${POST_CLASSPATH}"
with the following:
if [ "${SERVER_NAME}" != "<your_osr_server_name>" ] ;
then
POST_CLASSPATH="${SOA_ORACLE_HOME}/soa/modules/oracle.soa.fabric_11.1.1/oracle.soa.fabric.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.adapter_11.1.1/oracle.soa.adapter.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.b2b_11.1.1/oracle.soa.b2b.jar
${CLASSPATHSEP}${POST_CLASSPATH}"
else
POST_CLASSPATH="${SOA_ORACLE_HOME}/soa/modules/oracle.soa.adapter_11.1.1/oracle.soa.adapter.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.b2b_11.1.1/oracle.soa.b2b.jar
${CLASSPATHSEP}${POST_CLASSPATH}"
fi
Restart the Oracle Service Registry Managed Server.
If you have multiple Oracle Service Registry Managed Servers in the domain, each Managed Server must be added to the condition. For example, if you have two Oracle Service Registry Managed Servers named WLS_OSR1 and WLS_OSR2:
case "$SERVER_NAME" in
.
'WLS_OSR1')
.
echo "Setting WLS_OSR1 CLASSPATH..."
POST_CLASSPATH="${SOA_ORACLE_HOME}/soa/modules/oracle.soa.adapter_11.1.1/oracle.soa.adapter.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.b2b_11.1.1/oracle.soa.b2b.jar
${CLASSPATHSEP}${POST_CLASSPATH}"
exit;;
.
'WLS_OSR2')
.
echo "Setting WLS_OSR2 CLASSPATH..."
POST_CLASSPATH="${SOA_ORACLE_HOME}/soa/modules/oracle.soa.adapter_11.1.1/oracle.soa.adapter.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.b2b_11.1.1/oracle.soa.b2b.jar
${CLASSPATHSEP}${POST_CLASSPATH}"
exit;;
.
*)
.
echo "Setting default SOA CLASSPATH..."
POST_CLASSPATH="${SOA_ORACLE_HOME}/soa/modules/oracle.soa.fabric_11.1.1/oracle.soa.fabric.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.adapter_11.1.1/oracle.soa.adapter.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.b2b_11.1.1/oracle.soa.b2b.jar
${CLASSPATHSEP}${POST_CLASSPATH}"
exit;;
.
esac
Turkish and Thai users are recommended to install and run Oracle Fusion Middleware using the English locale. Oracle Fusion Middleware does support Turkish and Thai locales as clients.
There is a problem with the timezone detection algorithm on some versions of Windows. When the database is installed on some systems that have a fresh installation of Windows, the configuration of Enterprise Manager fails with a message that indicates that an "America/Rio_Branco" timezone has been detected.
The work around is to reset the timezone to the desired value, then re-install your Oracle Fusion Middleware product.
This section describes patching issues and their workarounds. It includes the following topics:
Section 2.2.6, "Oracle BI Components Show Incorrect Version Number After Patching"
Section 2.2.8, ""Patch Already Installed" Warning Message in Log File"
Section 2.2.9, "Manual Step for ODI-BAM Users After Installing 11.1.1.4.0 Patch Set"
This section contains patching issues pertaining to Oracle SOA Suite products:
The following intermittent exception may be seen in cases where you have upgraded your Oracle SOA Suite software to release 11.1.1.3.0 with the Patch Set Installer, and are extending your existing domain to include Oracle Business Process Management Suite:
javax.ejb.EJBTransactionRolledbackException: EJB Exception: ; nested exception
is: javax.persistence.PersistenceException: Exception
[EclipseLink-4002] (Eclipse Persistence Services - 2.0.2.v20100323-r6872):
org.eclipse.persistence.exceptions.DatabaseException
Internal Exception: java.sql.SQLIntegrityConstraintViolationException:
ORA-02292: integrity constraint (DB9128_SOAINFRA.BPM_CUBE_ROLE_FK1) violated -
child record found.
Error Code: 2292
Call: DELETE FROM BPM_CUBE_PROCESS WHERE (PROCESSID = ?)
bind => [247]
Query: DeleteObjectQuery(CubeProcess(domain:default, composite:counter_extended,
revision:1.0, name:Process, hasNametab:true));
nested exception is: javax.persistence.PersistenceException: Exception
[EclipseLink-4002] (Eclipse Persistence Services - 2.0.2.v20100323-r6872):
org.eclipse.persistence.exceptions.DatabaseException
Internal Exception: java.sql.SQLIntegrityConstraintViolationException:
ORA-02292: integrity constraint (DB9128_SOAINFRA.BPM_CUBE_ROLE_FK1) violated -
child record found
This is a harmless exception. To avoid seeing this exception, do the following:
Connect to your databsae as the SOA schema user.
Drop the BPM_CUBE_ROLE_FK1 constraint by executing the following:
ALTER TABLE BPM_CUBE_ROLE DROP CONSTRAINT BPM_CUBE_ROLE_FK1;
Recreate the BPM_CUBE_ROLE_FK1 constraint by executing the following:
ALTER TABLE BPM_CUBE_ROLE ADD CONSTRAINT BPM_CUBE_ROLE_FK1 FOREIGN KEY @ (ProcessId) REFERENCES BPM_CUBE_PROCESS(ProcessId) ON DELETE CASCADE;
Restart the Oracle SOA Managed Server.
The following intermittent exception may be seen in cases where you have upgraded your Oracle SOA Suite software to release 11.1.1.3.0 with the Patch Set Installer, and have undeployed SOA composites that have range-based dimension business indicators:
javax.ejb.EJBTransactionRolledbackException: EJB Exception: ; nested
exception is: javax.persistence.PersistenceException: Exception
[EclipseLink-4002] (Eclipse Persistence Services - 2.0.2.v20100323-r6872):
org.eclipse.persistence.exceptions.DatabaseException
Internal Exception: java.sql.SQLIntegrityConstraintViolationException:
ORA-02292: integrity constraint (DB9967_SOAINFRA.BPM_CUBE_NAMETAB_RANGE_FK1)
violated - child record found
Error Code: 2292
Call: DELETE FROM BPM_CUBE_NAMETAB WHERE ((EXTENSIONID = ?) AND (NAMETABID =
?))
bind => [0, 603]
Query:
DeleteObjectQuery(oracle.bpm.analytics.cube.persistence.model.CubeNametab@b7b8
2a); nested exception is: javax.persistence.PersistenceException: Exception
[EclipseLink-4002] (Eclipse Persistence Services - 2.0.2.v20100323-r6872):
org.eclipse.persistence.exceptions.DatabaseException
Internal Exception: java.sql.SQLIntegrityConstraintViolationException:
ORA-02292: integrity constraint (DB9967_SOAINFRA.BPM_CUBE_NAMETAB_RANGE_FK1)
violated - child record found
This exception is harmless and can be safely ignored. To avoid seeing this exception, do the following:
Connect to your databsae as the SOA schema user.
Drop the BPM_CUBE_NAMETAB_RANGE_FK1 constraint by executing the following:
ALTER TABLE BPM_CUBE_NAMETAB_RANGE DROP CONSTRAINT BPM_CUBE_NAMETAB_RANGE_FK1;
Recreate the BPM_CUBE_NAMETAB_RANGE_FK1 constraint by executing the following:
ALTER TABLE BPM_CUBE_NAMETAB_RANGE ADD CONSTRAINT BPM_CUBE_NAMETAB_RANGE_FK1 FOREIGN KEY @ (ProcessId, NametabId, ExtensionId) REFERENCES BPM_CUBE_NAMETAB (ProcessId, NametabId, ExtensionId) ON DELETE CASCADE;
Restart the Oracle SOA Managed Server.
If you have patched your existing Oracle SOA Suite installation with the Patch Set Installer to include Oracle Business Process Management Suite and you are using a Microsoft SQL Server 2008 database, the following procedure is required after you have patched your software:
Login to the Administration Console.
In the "Connection Pools" tab, add the following property in the "Properties" section for the mds-owsm and mds-soa data sources:
ReportDateTimeTypes=false
After you update your Release 11.1.1.2.0 software to Release 11.1.1.3.0, and login to the Oracle Enterprise Manager Console and navigate to the b2b Properties screen, the b2b.r1ps1 property (used to enable Release 11.1.1.2.0 features such as DocProvisioning and TransportCallout) is still visible. This property is removed for Release 11.1.1.3.0.
To remove this property, use the MBean browser remove property operation in Fusion Middleware Control. For more information, see "Configuring B2B Operations" in Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle BPM Suite.
If you migrate your database schemas from Release 11.1.1.1.0 to Release 11.1.1.2.0 with the BAM Alone option:
ant master-patch-schema -DpatchMaster.Componentlist=BAM
The Oracle BAM server will not start and you will receive UMS and MDS exceptions. After executing above command, if no errors are seen in the log files and if the version in schema_version_registry is changed to 11.1.1.2.0 for Oracle BAM, then the following commands must be executed to manually migrate Oracle UMS and MDS:
ant master-patch-schema -DpatchMaster.Componentlist=MDS ant master-patch-schema -DpatchMaster.Componentlist=UMS
Then, start the Oracle BAM server after running these commands.
If you deployed BPEL processes that are instrumented with monitors, then Oracle BAM might generate warning messages in the SOA diagnotic log file after you apply the 11g Release 1 (11.1.1.4.0) patch set.
This is because a new business indicator data object field ("LATEST") was added for Oracle Fusion Middleware 11g Release 1 (11.1.1.4.0).
To avoid the warning message and to take advantage of the new data object field, redeploy the BPEL process after you apply the 11g Release 1 (11.1.1.4.0) patch set.
For more information about the LATEST data object field, see "Understanding Business Indicator Data Objects" in the Oracle Fusion Middleware Developer's Guide for Oracle SOA Suite.
This section contains patching issues pertaining to Oracle WebCenter products:
Section 2.2.2.1, "Deploying WebCenterWorklistDetailApp.ear for WebCenter Spaces Workflows"
Section 2.2.2.2, "Some WebCenter Applications Show Old Version Number"
Section 2.2.2.4, "Errors When Updating Oracle WebCenter Using WLST Commands"
If you are patching from Oracle Fusion Middleware 11.1.1.2.0, then after running the Patch Set Installer, you must redeploy WebCenterWorklistDetailApp.ear. This file is located at the following path in your Oracle SOA Suite 11.1.1.2.0 installation path: SOA_ORACLE_HOME/webcenter/applications/WebCenterWorklistDetailApp.ear.
After applying the patch for Oracle WebCenter, some applications still show the version number from previous releases.
There is no work around for this issue.
If you extended WebCenter Spaces 11g Release 1 (11.1.1.2.0) or Release 1 (11.1.1.3.0) with your own customizations, then before you upgrade, you must ensure that the customization shared library uses .jspx pages and not .jsp pages.
After you upgrade to WebCenter Spaces 11.1.1.4.0, custom site templates will not render if they use .jsp pages.
Note that if you followed the white paper Customizing Site Templates in WebCenter Spaces to develop your custom site templates, then your pages should already be .jspx pages.
If you are updating Oracle WebCenter using WLST commands, you may see some error messages as described in this section. These errors can be safely ignored provided that when the command completes there is some text indicating the successful completion of the command.
When running the upgradeWebCenterDomain WLST command, you may see the following error message:
Error: addTemplate() failed. Do dumpStack() to see details.
When running the upgradeWebCenterPermissions command, you may see the following error message:
Command FAILED, Reason: JPS-04204: Cannot revoke permissions.
This section contains patching issues pertaining to Oracle Identity Management products:
Section 2.2.3.1, "Uploading Third Party JAR Files to the Database"
Section 2.2.3.2, "Updating Oracle Identity Management with LDAP Sync Enabled Generates XML Errors"
Section 2.2.3.3, "Access Policy With Approval Does Not Work After Patch"
Section 2.2.3.9, "Exception Seen When Starting Oracle Identity Management Server"
During the update of Oracle Identity and Access Management to Release 11.1.1.5.0, third party JAR files (for example, ldapbp.jar which is required for connector functionality) that are present in the file system are not uploaded to database by the upgrade process. You must manually upload these JAR files to the database using the UploadJars.sh (on UNIX operating systems) or UploadJars.bat (on Windows operating systems) utility.
For more information, see the "Upload JAR and Resource Bundle Utilities" chapter in Oracle Fusion Middleware Developer's Guide for Oracle Identity Manager.
During the update of Oracle Identity Manager to from Release 11.1.1.3.0 to Release 11.1.1.5.0, the following XML error is generated if LDAP Sync is enabled on Windows operating systems:
XML-22110: (Fatal Error) Invalid StreamResult set in TransformerHandler. oracle.iam.oimupgrade.exceptions.OIMUpgradeException: Error in writing document EventHandlers.xml
To work around this issue:
Edit the ORACLE_OIM_HOME\server\bin\dwps1upgrade.properties file and set the oim.ps1.seedoespolicies property to false:
oim.ps1.seedoespolicies.patch=false;
All other properties should be set to true.
Create a log directory (for example, logDir) in ORACLE_OIM_HOME\server\bin.
Go to the IAM_11.1.1.5.0_Home\server\bin directory and run the DW2PS1Upgrade.bat script.
For the following command line prompt:
##Enter your Log location directory
Specify the relative path of the log directory created in Step 2 (for example, logDir). Do not specify the absolute path to the log directory.
Edit the ORACLE_OIM_HOME\server\bin\dwps1upgrade.properties file again, but this time set the oim.ps1.seedoespolicies property to true and all other properties to false:
oim.ps1.seedoespolicies.patch=true;
This will allow you to upgrade the policies for Oracle Entitlements Server only.
Go to the IAM_11.1.1.5.0_Home\server\bin directory and run the DW2PS1Upgrade.bat script again.
For the following command line prompt:
##Enter your Log location directory
Specify the absolute path of the log directory created in Step 2 (for example, logDir) if you are using the same directory, or you can create a new directory and specify the absolute path to the new directory.
In Release 11.1.1.5.0, the following new policies are introduced for Oracle Entitlements Server (OES):
SelfServiceUserManagementPolicies.xml
UserManagementPolicies.xml
Because of this change, a request for approval is not generated when a new policy with approval is added.
To work around this issue, add the "Request Administrator" role to the "Access Policy Based Provisioning" request template:
Login to "Advance Console."
Go to Request Templates on the Configuration tab.
Search for and and open the "Access Policy Based Provisioning" request template.
Go to the Template User Roles tab on the Template Details page.
From the left pane in "Available Roles," search for and assign the "Request Administrators" role.
The assigned role will appear in the right pane under "Selected Roles."
Save the request template.
If you are patching Oracle Internet Directory (OID) or Oracle Virtual Directory (OVD) from Releases 11.1.1.2.0 or 11.1.1.3.0 to Release 11.1.1.4.0 or later, your saved connection in Releases 11.1.1.2.0 or 11.1.1.3.0 will not be available after the patch.
If you are patching from Release 11.1.1.3.0 or later, then your saved connections in OID and OVD will be available.
There is no work around for this issue.
During the upgrade of Oracle Identity Manager 11.1.1.3.0 to 11.1.1.5.0, you are asked to run the upgradeOpss WLST (online) command to update Oracle Platform Security Services (OPSS).
The following message will be visible on the console when you run the upgradeOpss command:
WLS ManagedService is not up running. Fall back to use system properties for configuration.
date_and_time oracle.security.jps.internal.tools.utility.destination.apibased.JpsDstPolicy <init>
WARNING: No identity store associate with policy store found.
Upgrade of jps configuration and security stores is done.
This message is harmless and can be safely ignored.
After patching and configuring Oracle Identtiy Management to Release 11.1.1.4.0, the following errors are seen in the wls_oif1-diagnostics.log file when Single Sign-On is used for Oracle Identity Federation:
[2010-08-05T13:05:30.754-07:00] [wls_oif1] [INCIDENT_ERROR] [FED-10174] [oracle.security.fed.model.config.Configuration] [tid: [ACTIVE].ExecuteThread: '2' for queue: 'weblogic.kernel.Default (self-tuning)'] [userId: <anonymous>] [ecid: 42ef6c66fe18f3ad:291f353a:12a43da27c1:-8000-0000000000000021,0] [APP: OIF#11.1.1.2.0] [arg: certvalidationtimeout] Property was not found: certvalidationtimeout. . [2010-08-05T13:05:37.174-07:00] [wls_oif1] [INCIDENT_ERROR] [FED-10174] [oracle.security.fed.model.config.Configuration] [tid: [ACTIVE].ExecuteThread: '2' for queue: 'weblogic.kernel.Default (self-tuning)'] [userId: <anonymous>] [ecid: 42ef6c66fe18f3ad:291f353a:12a43da27c1:-8000-0000000000000021,0] [APP: OIF#11.1.1.2.0] [arg: schemavalidationenabled] Property was not found: schemavalidationenabled [2010-08-06T17:09:23.861-07:00] [wls_oif1] [INCIDENT_ERROR] [FED-10174] [oracle.security.fed.model.config.Configuration] [tid: [ACTIVE].ExecuteThread: '3' for queue: 'weblogic.kernel.Default (self-tuning)'] [userId: <anonymous>] [ecid: f6d9b81289e40cee:42d4f595:12a49b7af7a:-8000-000000000000086f,0] [APP: OIF#11.1.1.2.0] [arg: certpathvalidationenabled] Property was not found: certpathvalidationenabled. [2010-08-06T17:11:27.173-07:00] [wls_oif1] [INCIDENT_ERROR] [FED-10174] [oracle.security.fed.model.config.Configuration] [tid: [ACTIVE].ExecuteThread: '3' for queue: 'weblogic.kernel.Default (self-tuning)'] [userId: <anonymous>] [ecid: f6d9b81289e40cee:42d4f595:12a49b7af7a:-8000-00000000000009a0,0] [APP: OIF#11.1.1.2.0] [arg: httpheaderattrcollector] Property was not found: httpheaderattrcollector.
There errors are harmless and can be safely ignored.
To avoid seeing these errors, run the oif-upgrade-11.1.1.2.0-11.1.1.4.0.py script after you have patched your software to 11.1.1.4.0 as described in "Updating Configuration Properties in Oracle Identity Federation" in the Oracle Fusion Middleware Patching Guide.
When you are using the Patch Assistant migration scripts to migrate Oracle Identity Federation from Release 11.1.1.1.0 to Release 11.1.1.2.0, you may see the following error message:
WLSTException: Error occured while performing addHelpCommandGroup : Error getting resource bundle: : Can't find bundle for base name oifWLSTResourceBundle, locale en_US
This message is harmless and can be safely ignored.
You may see some benign error messages in installation log files, such as the following, after you patch an Oracle Identity Management 11.1.1.2.0 installation to 11.1.1.3.0:
External name..INVALID_ORACLE_DIRECTORY_MSG_STRING
In doFinish method checking for inventory lock...InstallProgressPage
Next page is a progress page and the inventory lock is false
/bin/chmod: changing permissions of /scratch/aime1/Oracle/Middleware/oracle_ps2/install/root.log': Operation not permitted
/bin/chmod: changing permissions of /scratch/aime1/Oracle/Middleware/oracle_ps2/bin/nmb': Operation not permitted
/bin/chmod: changing permissions of /scratch/aime1/Oracle/Middleware/oracle_ps2/bin/nmhs': Operation not permitted
/bin/chmod: changing permissions of /scratch/aime1/Oracle/Middleware/oracle_ps2/bin/nmo': Operation not permitted
inventoryLocation: /scratch/aime1/oraInventory
Mode:init
Such messages can be ignored.
After updating Oracle Identity Management to Release 11.1.1.5.0, the following exception may be seen when starting Oracle Identity Management Server:
java.lang.ClassNotFoundException: ADP ClassLoader failed to load:com.thortech.xl.schedule.tasks.tcTskScheduledProvision
This error is harmless and can be safely ignored.
This section contains patching issues pertaining to Oracle Fusion Middleware system components:
After you have patched your system component software (Oracle Portal, Forms, Reports and Discoverer, Oracle Identity Management, or Oracle Web Tier) and started all services, you must manually redeploy your system components if you are extending your existing domain. To do so, follow the instructions in "Redeploying System Components for Extend Domain Scenarios" in the Oracle Fusion Middleware Patching Guide.
If you do not redeploy your system components, you will encounter problems when you attempt to remove them.
If you are running Fusion Middleware products that use the Metadata Services schema (MDS) and your Fusion Middleware products are older than Release 11.1.1.4.0, the schema version number for the MDS schema in Enterprise Manager will be the previous release number, even if you have updated the MDS schema to Release 11.1.1.4.0.
In order for the MDS schema version number to appear correctly, both the schema and the Fusion Middleware product software must be up to date with the most recent version.
After you patch your existing Oracle Business Intelligence (BI) software to Release 11.1.1.4.0, some Oracle BI components (for example, Oracle BI Publisher or Oracle RTD) will still show the version number from your previous release when viewed using Oracle Enterprise Manager.
There is no work around for this issue.
When running the upgradeOpss() WLST command to upgrade configurations and stores to Release 11.1.1.4.0, the following error messages may be seen:
oracle.security.jps.internal.tools.utility.destination.apibased.JpsDstPolicy migrateData WARNING: cannot migrate a global grant. Reason oracle.security.jps.service.policystore.PolicyStoreException: Found 2 permissions in the store matching: ([PermissionEntry:class=java.util.PropertyPermission target=weblogic.Name resourceType=null actions=read,PERMISSION, name=null, uniqueName=null, guid=null] [jaznGranteeDn=orclguid=AC171BF0E72711DEBF9CCF0B93FB22A1,cn=Grantees, cn=JAASPolicy,cn=systempolicy,cn=webcenter,cn=JPSContext,cn=jpsroot_webcenter_IR14_prod}), [PermissionEntry: class=java.util.PropertyPermission target=weblogic.Name resourceType=null actions=read,PERMISSION, name=8228FD8036F711DEAF24DB7D80B2D07C, uniqueName=orclguid=8228FD8036F711DEAF24DB7D80B2D07C,cn=Permissions,cn=JAASPolicy, cn=systempolicy,cn=webcenter,cn=JPSContext,cn=jpsroot_webcenter_IR14_prod, guid=8228FD8036F711DEAF24DB7D80B2D07C] [jaznGranteeDn=orclguid=822505e036f711deaf24db7d80b2d07c,cn=grantees,cn=jaas policy,cn=systempolicy,cn=webcenter,cn=jpscontext,cn=jpsroot_webcenter_ir14_prod}1 [PermissionEntry: class=java.util.PropertyPermission target=weblogic.Name resourceType=null actions=read,PERMISSION, name=8228FD8036F711DEAF24DB7D80B2D07C, uniqueName=orclguid=8228FD8036F711DEAF24DB7D80B2D07C,cn=Permissions,cn=JAASPolicy, cn=systempolicy,cn=webcenter,cn=JPSContext,cn=jpsroot_webcenter_IR14_prod, guid=8228FD8036F711DEAF24DB7D80B2D07C] [jaznGranteeDn=orclguid=822505e036f711deaf24db7d80b2d07c,cn=grantees,cn=jaaspolicy ,cn=systempolicy,cn=webcenter,cn=jpscontext,cn=jpsroot_webcenter_ir14_prod} [PermissionEntry: class=java.util.PropertyPermission target=weblogic.Name resourceType=null actions=read,PERMISSION, name=AC198CF0E72711DEBF9CCF0B93FB22A1, uniqueName=orclguid=AC198CF0E72711DEBF9CCF0B93FB22A1,cn=Permissions,cn=JAASPolicy, cn=systempolicy,cn=webcenter,cn=JPSContext,cn=jpsroot_webcenter_IR14_prod, guid=AC198CF0E72711DEBF9CCF0B93FB22A1] [jaznGranteeDn=orclguid=822505e036f711deaf24db7d80b2d07c,cn=grantees,cn=jaaspolicy ,cn=systempolicy,cn=webcenter,cn=jpscontext,cn=jpsroot_webcenter_ir14_prod} [jaznGranteeDn=orclguid=ac171bf0e72711debf9ccf0b93fb22a1,cn=grantees,cn=jaaspolicy ,cn=systempolicy,cn=webcenter,cn=jpscontext,cn=jpsroot_webcenter_ir14_prod}2 [PermissionEntry: class=java.util.PropertyPermission target=weblogic.Name resourceType=null actions=read,PERMISSION, name=AC198CF0E72711DEBF9CCF0B93FB22A1, uniqueName=orclguid=AC198CF0E72711DEBF9CCF0B93FB22A1,cn=Permissions,cn=JAASPolicy, cn=systempolicy,cn=webcenter,cn=JPSContext,cn=jpsroot_webcenter_IR14_prod, guid=AC198CF0E72711DEBF9CCF0B93FB22A1] [jaznGranteeDn=orclguid=822505e036f711deaf24db7d80b2d07c,cn=grantees,cn=jaaspolicy ,cn=systempolicy,cn=webcenter,cn=jpscontext,cn=jpsroot_webcenter_ir14_ prod}[jaznGranteeDn=orclguid=ac171bf0e72711debf9ccf0b93fb22a1,cn=grantees,cn=jaas policy,cn=systempolicy,cn=webcenter,cn=jpscontext,cn=jpsroot_webcenter_ir14_prod}
These messages are harmless and can be safely ignored.
In a scenario where you have a product that is already patched to version 11.1.1.3.0 in a Middleware home, and then you attempt to patch a second product to the same version in the same Middleware home, a warning message similar to the following will appear in the installtimestamp.out file:
Attempting to install 1 patches Mar 3, 2010 1:00:07 PM [THREAD: Thread-1] com.bea.cie.paf.internal.attach.PatchManagerImpl install WARNING: Warning: Patch already installed: PBY8 Patch installation success Patch installation success Success.. [SOARootService.getRootActions] autoPortsDetect =null [SOARootService.getRootActions] privilegedPorts =null
This warning message can be safely ignored.
If you are integrating Oracle Data Integrator (ODI) with Oracle Business Activity Monitoring, you should import a new version of the following knowledge module after you install the Oracle Fusion Middleware 11g Release 1 (11.1.1.4.0) patch set:
BAM_ORACLE_HOME/bam/ODI/knowledge modules/KM_RKM Oracle BAM.xml
For more information, see "Importing and Replacing Knowledge Modules" in the Oracle Fusion Middleware Developer's Guide for Oracle Data Integrator.
This new module includes bugs fixes and improvements made for the Oracle Fusion Middleware 11g Release 1 (11.1.1.4.0) .
If any of the applications you deployed on Oracle Fusion Middleware 11g Release 1 (11.1.1.2.0) or Release 1 (11.1.1.3.0) include EclipseLink-JAXB classes that have no-arg constructors missing, then after you install Release 1 (11.1.1.4.0), the application might generate the following exceptions during runtime:
javax.xml.bind.JAXBException
To avoid this error:
Modify the classes and add default no-arg constructors where necessary.
Compile and redeploy your project to the newly patched Oracle Fusion Middleware 11g Release 1 (11.1.1.4.0) domain.
Example 2-1 shows an example of typical no-arg constructor.
This section describes configuration issues and their workarounds. It includes the following topics:
Section 2.3.2, "Oracle Identity Management Configuration Issues"
Section 2.3.7, "Administrator Privilege Requirements for Windows 2008 and Windows Vista"
Section 2.3.8, "FileNotFoundException When Cloning on Windows"
Section 2.3.9, "Setting the PATH Environment Variable for Oracle Configuration Manager"
Section 2.3.10, "Specifying the Windows Short Name for the C:\Program Files in PATH"
Section 2.3.11, "Changing the Listen Address of a Managed Server"
Section 2.3.12, "Domain Extension Overwrites JDBC Data Source Name"
Section 2.3.13, "Rerouting to Original URL After SSO Authentication in Firefox and Safari Browsers"
Section 2.3.15, "WebLogic Administration Server Fails to Start Due to Memory Issues"
This section contains information pertaining to Oracle SOA Suite configuration:
When running Oracle SOA Suite on IBM WebSphere application server, the following exception is seen after logging in to Fusion Middleware Control, expanding Application Deployments on the left side and then clicking on any of the applications under it:
[date_and_time] 0000003f OHWHelpProvid E unable to create global configuration [date_and_time] 00000044 OHWHelpProvid E critical error in OHW configuration oracle.help.web.config.parser.ConfigParseException: error finding configuration file at: at oracle.help.web.config.parser.OHWParser._openConnection(Unknown Source) at oracle.help.web.config.parser.OHWParser.getGlobalConfiguration(Unknown Source) at oracle.help.web.rich.helpProvider.OHWHelpProvider.getHelpTopic(Unknown Source) . . .
This exception is harmless and can be safely ignored.
This section contains information pertaining to Oracle Identity Management configuration:
Section 2.3.2.3, "Configuring Oracle Identity Management When WebLogic Node Manager is Running"
Section 2.3.2.5, "OIDMON Does Not Start After Configuring Oracle Internet Directory on Windows"
Section 2.3.2.6, "Password Requirements for Oracle Internet Directory Administrator"
Section 2.3.2.7, "Error Message When Configuring Oracle Identity Federation"
When extending a 11.1.1.3.0 (patched) domain on a remote system, you may see a Null Pointer exception message, such as the following, in the Managed Server log files after installation:
0000IW5hUxgDc_Y5HrDCif1Bm1sl000000,0] [APP: DMS Application#11.1.1.1.0]
initialization error[[java.lang.NullPointerException
at java.io.File.<init>(File.java:222)
at oracle.dms.impl.util.AdmlLocator.<init>(AdmlLocator.java:59)
at oracle.dms.app.DmsSpy.init(DmsSpy.java:86)
at weblogic.servlet.internal.StubSecurityHelper$ServletInitAction.run(StubSecurityHelper.java:283)
To work around this issue, do the following:
Stop the instance running on the second system.
Stop the Managed Server on the second system.
Stop the instance running on the first system.
Stop Managed Servers on the first system.
Stop the Administration Server on the first system.
Start the instance, the Administration Server, and then Managed Servers on the first system manually from the command line.
Start the instance and then Managed Servers on the second system manually from the command line.
For information about starting and stopping Oracle Fusion Middleware, see the "Starting and Stopping Oracle Fusion Middleware" chapter in the Oracle Fusion Middleware Administrator's Guide.
During the creation of the Oracle Identity Management (OIM) schema, some log messages will appear in the RCU console window. These log messages are specific to Quartz, which is used by Oracle Identity Management, and can be safely ignored.
If there are any errors encoutered during the loading of this Quartz-specific data, the errors will be written to the RCU log files. Refer to Oracle Fusion Middleware Repository Creation Utility User's Guide for more informaiton about the RCU log files.
To configure Oracle Identity Management, using either the Install and Configure option or the Configuration Wizard, when the WebLogic Node Manager utility is running from the same Middleware home directory where Oracle Identity Management is installed, the StartScriptEnabled parameter in the nodemanager.properties file must be set to true. For example: StartScriptEnabled=true
To configure Oracle Identity Management when the StartScriptEnabled parameter is set to false, you must:
Set the StartScriptEnabled parameter to true.
Stop, then restart the Node Manager utility.
Configure Oracle Identity Management using either the Install and Configure option or the Configuration Wizard.
Note:
The nodemanager.properties file is located in the WL_HOME/common/nodemanager/ directory.If you choose to configure Oracle Internet Directory (OID) with Oracle Data Vault:
Apply patch 8897382 (see the README file in the patch for instructions).
In the ORACLE_HOME/ldap/datasecurity/dbv_oid_command_rules.sql (on UNIX operating systems) or ORACLE_HOME\ldap\datasecurity\dbv_oid_command_rules.sql (on Windows operating systems) file, find the following code:
/declare . begin . dvsys.dbms_macadm.CREATE_COMMAND_RULE( command => 'CONNECT' ,rule_set_name => 'OID App Access' ,object_owner => 'ODS' ,object_name => '%' ,enabled => 'Y'); . commit; . end;/
Change the following line:
,object_owner => 'ODS'
to:
,object_owner => '%'
On Windows platforms, when configuring Oracle Internet Directory using either the installer's Install and Configure option or the Configuration Wizard, OIDMON will not start if the total length of all environment variables, such as ORACLE_HOME, JAVA_HOME, PATH, and so on, exceeds 4,000 characters.
If you see an oidmon.exe application error message while configuring Oracle Internet Directory, or if the installer's log files indicate that OIDMON could not start, you may have encountered this issue.
To work around this issue, reduce the length of environment variables so that the total length of all variables is less than 4,000 characters and then attempt to configure Oracle Internet Directory again.
When configuring Oracle Internet Directory, using either the installer's Install and Configure option or the Configuration Wizard, you must enter and confirm the Administrator Password.
The following is a list of the requirements for the Oracle Internet Directory Administrator Password. The password must contain:
At least 5 characters
No more than 30 characters
At least one number
Only alpha-numeric characters, underscore ( _ ), dollar sign ( $ ), and pound/hash ( # )
Note:
If the password you enter does not satisfy these requirements, the following error message appears:INST-07037: Administrator Password field value contains one or more invalid characters or the value is not in proper format.
During the configuration of Oracle Identity Federation (OIF), the following error message regarding key store and password may be seen in the configuration log file:
[app:OIF module:/fed path:/fed spec-version:2.5 version:11.1.1.1.0]: Failed while destroying servlet: usermanager. java.lang.RuntimeException: The server could not initialize properly: oracle.security.fed.sec.util.KeySourceException: Invalid/unsupported key store or incorrect password. Please verify that the password is correct and the store is a valid PKCS#12 PFX wallet or Java KeyStore file.
This error message can be safely ignored if OIF is running properly.
This section contains issues pertaining to the Oracle Fusion Middleware Configuration Wizard:
Section 2.3.3.1, "Starting the Configuration Wizard From a New Window"
Section 2.3.3.2, "Specify Security Updates Screen Does Not Appear in the Configuration Wizard"
When you start the Configuration Wizard from a terminal window, make sure that it is a new terminal window to ensure that there are no environment variables set to incorrect locations from a previous configuration or installation session.
If you use silent installation (response file) to configure Oracle Identity Management, security updates (through Oracle Configuration Manager) are not configured. However, the ocm.rsp file is created in the Oracle home directory. If you run the Configuration Wizard GUI from the Oracle home, you will not see the Specify Security Updates Screen because of the presence of the ocm.rsp file.
To work around this issue, delete the ocm.rsp file from the Oracle home and run the Configuration Wizard to see the Specify Security Updates screen.
This section contains issues pertaining to Repository Creation Utility:
After upgrading Oracle Identity Management from Release 10g (10.1.4.3) to 11g Release 1 (11.1.1), the Oracle Directory Service schemas (ODS and ODSSM) are not visible in the Repository Creation Utility (RCU).
The reason for this is because RCU is not used during the upgrade process, and RCU only recognizes schemas that are created by RCU. Refer to Oracle Fusion Middleware Repository Creation Utility User's Guide for more information.
If you are dropping the Identity Management schemas and you select both Oracle Internet Directory (ODS) and Oracle Identity Federation (OIF) to be dropped, the RCU summary screen may not be displayed and an exception may be thrown in the console.
To work around this issue, select and drop one component at a time instead of selecting them both and dropping them together.
When other components are selected for a drop schema operation, the summary screen may display inaccurate information. However, the selected schemas will be successfully dropped from the database in spite of the erroneous information on the summary screen.
To work around this issue, select and drop only one component at a time.
This section contains issues pertaining to packing and unpacking a domain:
Section 2.3.5.1, "Ensure There Are No Missing Products When Using unpack.sh or unpack.cmd"
Section 2.3.5.2, "Running unpack.sh or unpack.cmd on a Different Host"
Section 2.3.5.3, "Starting Managed Servers on Remote System After Packing and Unpacking Domain"
Oracle SOA Suite, Oracle WebCenter, and Application Developer all contain the pack.sh and unpack.sh (on UNIX systems) or pack.cmd and unpack.cmd (on Window systems) commands in their respective ORACLE_HOME/common/bin (on UNIX systems) or ORACLE_HOME\common\bin (on Windows systems) directories.
The pack.sh and pack.cmd scripts are used to create a template archive (.jar) file that contains a snapshot of either an entire domain or a subset of a domain. The unpack.sh and unpack.cmd scripts are used to create a full domain or a subset of a domain used for a Managed Server domain directory on a remote system.
The unpack.sh and unpack.cmd commands will fail if any installed products are missing from the system where you are running the unpack.sh or unpack.cmd command.
If you are running the unpack.sh (on UNIX) or unpack.cmd (on Windows) command to unpack a domain on a remote host, the Oracle home location and the Middleware home location on the remote host should match the locations on the host where the pack was performed.
Below is a valid example:
Host 1: MW_HOME = /user/home/Middleware ORACLE_HOME =/user/home/Middleware/Oracle_SOA1 @ Host 2: MW_HOME = /user/home/Middleware ORACLE_HOME =/user/home/Middleware/Oracle_SOA1
The example below is NOT valid because the Oracle homes do not match:
Host 1: MW_HOME = /user/home/Middleware ORACLE_HOME =/user/home/Middleware/Oracle_SOA1 @ Host 2: MW_HOME = /user/home/Middleware ORACLE_HOME =/user/home/Middleware/SOA_Home
The example below is NOT valid because the Middleware homes do not match:
Host 1: MW_HOME = /user/home/Middleware ORACLE_HOME =/user/home/Middleware/Oracle_SOA1 @ Host 2: MW_HOME = /user/home/MWHome ORACLE_HOME =/user/home/Middleware/Oracle_SOA1
Host 1: MW_HOME = C:\Oracle\Middleware ORACLE_HOME = C:\Oracle\Middleware\Oracle_SOA1 @ Host 2: MW_HOME = C:\Oracle\Middleware ORACLE_HOME = C:\Oracle\Middleware\Oracle_SOA1
The example below is NOT valid because the Oracle homes do not match:
Host 1: MW_HOME = C:\Oracle\Middleware ORACLE_HOME = C:\Oracle\Middleware\Oracle_SOA1 @ Host 2: MW_HOME = C:\Oracle\Middleware ORACLE_HOME = C:\Oracle\Middleware\SOA_Home
The example below is NOT valid because the Middleware homes do not match:
Host 1: MW_HOME = C:\Oracle\Middleware ORACLE_HOME = C:\Oracle\Middleware\Oracle_SOA1 @ Host 2: MW_HOME = C:\Oracle\MWHome ORACLE_HOME = C:\Oracle\Middleware\Oracle_SOA1
After you unpack a domain on a remote system using the unpack command, complete the following steps:
Start Node Manager on the remote system. This action creates a nodemanager.properties file on your system in the MW_HOME/wlserver_10.3/common/nodemanager directory (on UNIX). On Windows, this file is created in the MW_HOME\wlserver_10.3\common\nodemanager directory.
Stop Node Manager.
Open the nodemanager.properties file in a text editor and set the StartScriptEnabled property to true.
Start the Node Manager on the remote system before starting the Managed Server on the remote system through the Oracle WebLogic Administration Console.
This section contains issues pertaining to clusters and your WebLogic Server domain:
Section 2.3.6.1, "Extend Domain and Expand Cluster Scenarios with Remote Systems"
Section 2.3.6.3, "Expand Cluster Requires Changes to the emd.properties File"
In scenarios where you are using the Fusion Middleware Configuration Wizard to extend a domain or expand a cluster with remote systems, you must make sure that both the source and destination Middleware home and Oracle home directories are identical.
Selecting only Oracle Directory Integration Platform without cluster in a session followed by creating cluster and extending domain on the same system fails.
In this domain configuration scenario, ensure that you install and configure Oracle Directory Services Manager on the same system where you extending the domain to configure Oracle Directory Integration Platform.
After running the Oracle Fusion Middleware Configuration Wizard to expand a cluster, the EMD_URL parameter in the INSTANCE_HOME/EMAGENT/EMAGENT/sysman/config/emd.properties (on UNIX) or INSTANCE_HOME\EMAGENT\EMAGENT\sysman\config\emd.properties (on Windows) file contains the values shown below:
EMD_URL=http://localhost.localdomain:port/emd/main
You must edit this parameter and replace localhost and localdomain with the actual host and domain information of your environment. For example, using 5160 as the port number:
EMD_URL=http://examplehost.exampledomain.com:5160/emd/main
By default, after your Fusion Middleware product is installed in a Middleware Home (using a local administrator account), the permission for the Oracle home is set for SYSTEM and the Administrators group.
However, in Windows 2008 and Windows vista, even when a user with administrator privileges logs in to the machine, for default tasks the administrative role is not granted. In order to access the Oracle home files and folders, the user needs to launch the command prompt or Windows Explorer as administrator explicitly, even if the user is logged in as the administrator.
To do so, go to the Start menu or find the desktop icon for either the Command Prompt or Windows Explorer, right-click on the menu item or icon, and select Run as administrator.
From the resulting Command Prompt or Windows Explorer, access the Oracle home and run the Configuration Wizard.
When you run the applyClone command on Windows operating systems, a java.io.FileNotFoundException is thrown to the console.
This exception can be safely ignored and the applyClone operation will be successfully completed.
In order for Oracle Configuration Manager to work properly on Windows operating systems, make sure the PATH environment variable is set to C:\windows\system32.
If your PATH environment variable contains the C:\Program Files directory, you must convert this directory to the Windows short name as specified below:
For C:\Program Files, use the Windows short name C:\PROGRA~1 in your PATH environment variable.
For C:\Program Files (x86), use the Windows short name C:\PROGRA~2 in your PATH environment variable.
In addition, if your PATH environment variable includes another environment variable that uses either C:\Program Files or C:\Program Files (x86) in its definition, then you must also change C:\Program Files or C:\Program Files (x86) to its respective Windows short name in that environment variable's definition.
When you run the Configuration Wizard after installing Oracle Identity Management or Oracle Portal, Forms, Reports and Discoverer, the listen address for WebLogic Managed Servers is left blank by default (to listen to all network interfaces). If you change the listen address to the actual host name, the Managed Server stops listening from outside the system.
It is recommended that you either leave the listen address blank, or specify the IP address of the host rather than using the host name.
When a WebLogic Domain with JDBC resources is extended to either Oracle SOA Suite or Oracle WebCenter, the JDBC data source name will be changed. This behavior is commonly observed in cases where WebLogic Server version lower than 9.x is upgraded to a version higher than 9.x and then extended to Oracle SOA Suite or Oracle WebCenter.
To work around this issue, you must manually edit the JDBC data source names.
When configuring Oracle Portal, Forms, Reports and Discoverer, when both Oracle HTTP Server and Oracle Web Cache are selected for configuration, re-routing (back to the original URL) after Single Sign-On (SSO) authentication does not work in Firefox and Safari browsers when the initial request comes from Oracle HTTP Server.
The work arounds are to either use the Internet Explorer browser, or manually modify the INSTANCE_HOME\config\OHS\instance_name\httpd.conf file and change the ServerName entry to include the port number. For example:
ServerName examplehost.exampledomain.com
should be changed to:
ServerName examplehost.exampledomain.com:port
Replace port with the actual port number.
Make sure you clear your browser cache files; otherwise, the objects on your screen (for example, in Oracle Enterprise Manager) may not be refreshed to the latest version, or if you added a new object then it may not appear.
On Windows 32-bit operating systems, the WebLogic Administration Server may fail to start, as it cannot allocate sufficient memory despite the availability of free memory.
As a workaround, complete the following steps:
Open the setSOADomainEnv.cmd file, located in your <Domain_Home>\bin directory, in a text editor.
Update the PORT_MEM_ARGS entry as follows:
set PORT_MEM_ARGS=-Xms512m -Xmx1024m
Save the file and close.
This section describes known issues. It includes the following topics:
Forms and Reports Builder is not suported on Linux x86-64, Solaris Operating System (SPARC 64-Bit), AIX Based Systems (64-Bit), HP-UX PA-RISC (64-Bit), HP-UX Itanium, and Microsoft Windows x64 (64-Bit) platforms. It is supported on Linux x86 and Microsoft Windows (32-Bit) platforms only.
This section describes documentation errata. It includes the following topics:
Step 4 in the Section 22.8 "Optional: Updating Oracle Identity Manager Configuration" in the chapter "Migrating from Domain Agent to Oracle HTTP Server 10g Webgate for OAM" requires you to update the OIM Configuration when the OAM URL or agent profile changes. This section is in the Oracle Fusion Middleware Installation Guide for Oracle Identity Management.
To update Oracle Identity Manager configuration, complete the following steps:
Export the oim-config.xml file from metadata by running <IDM_Home>/server/bin/weblogicExportMetadata.sh (on UNIX), and export the file - /db/oim-config.xml. On Windows operating systems, you can use the weblogicExportMetadata.bat file located in the same directory.
Update the file to use Oracle HTTP Server 10g Webgate by updating following element under the <ssoConfig> tag:
<webgateType>javaWebgate</webgateType> to <webgateType>ohsWebgate10g</webgateType>
Import oim-config.xml back to metadata by running <IDM_Home>/server/bin/weblogicImportMetadata.sh on UNIX. On Windows, use the weblogicImportMetadata.bat located in the same directory.
Log in to Oracle Enterprise Manager using your WebLogic Server administrator credentials.
Click Identity and access > oim > oim(version). Right-click and select System MBean Browser. The System MBean Browser page is displayed.
Under Application Defined MBeans, select oracle.iam > Server:oim_server1 > Application: oim > XMLConfig > config.
Replace the front-end URL with the URL of Oracle HTTP Server. This should be the same Oracle HTTP Server that was used before installing Oracle HTTP Server 10g Webgate for Oracle Access Manager. Complete the following steps:
Under XMLConfig MBean, move to XMLConfig.DiscoveryConfig.
Update OimFrontEndURL with the URL of Oracle HTTP Server.
Click Apply.
Restart the OIM server.
Steps to perform logout configuration after updating the OIM Server Configuration are missing from the Oracle Fusion Middleware Installation Guide for Oracle Identity Management.
You must perform logout configuration after updating the OIM Server configuration, as described in the Section 22.6 "Updating OIM Server Configuration" in the chapter "Migrating from Domain Agent to Oracle HTTP Server 10g Webgate for OAM".
Note:
Ensure that you have set up integration between Oracle Identity Manager and Oracle Access Manager, as described in the topic "Integration Between OIM and OAM" in the Oracle Fusion Middleware Installation Guide for Oracle Identity Management.After updating OIM Server configuration, you must perform logout configuration as follows:
Copy the logout.html file from the <IDM_HOME>/oam/server/oamsso directory to the <10gWebgateInstallation>/access/oamsso directory.
Edit the SERVER_LOGOUTURL variable in the logout.html file to point to the host and port of the Oracle Access Manager Server. Follow the instructions in the logout.html file.
If the http.conf file of the web server includes the following entries, remove the entries from the http.conf file:
<LocationMatch "/oamsso/*">
Satisfy any
</LocationMatch>