|Oracle® Fusion Middleware Release Notes
11g Release 1 (11.1.1) for Linux x86
Part Number E10133-05
This chapter describes issues associated with Oracle Fusion Middleware installation and configuration. It includes the following topics:
This section describes installation issue and workarounds. It includes the following topics:
If you are using a 64-bit JVM in your environment, ensure that all your Oracle Fusion Middleware components are using the 64-bit JVM. You cannot mix components using a 32-bit JVM with those using a 64-bit JVM.
Refer to the Oracle Fusion Middleware Certification matrix for information on the platforms that support a 64-bit JDK:
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 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, 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 instructed below:
./runInstaller -jreLoc JRE_LOCATION
The instuctions provided in the installation documentation regarding starting the installer for these products are applicable only for installing on 32-bit platforms with a 32-bit JDK.
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.
For Oracle Identity Management Installations that require Oracle WebLogic Server, you must perform the following steps after installing Oracle WebLogic Server and before installing Oracle Identity Management:
Verify the Oracle WebLogic Server Node Manager utility is stopped. If it is running, kill the process.
Note:The Oracle Fusion Middleware Installation Guide for Oracle Identity Management and the Oracle Fusion Middleware Quick Installation Guide for Oracle Identity Management both state that the Oracle WebLogic Server's Node Manager utility must be running when you install Oracle Identity Management. This is incorrect. If the Oracle WebLogic Server Node Manager utility is running, you must stop it before installing Oracle Identity Management.
Determine if the nodemanager.properties file is present in the WL_HOME/common/nodemanager/ directory.
If the nodemanager.properties file is not present, continue installing Oracle Identity Management.
If the nodemanager.properties file does exist, open it and verify that the
ListenPort parameter is included and that it is set. If the
ListenPort parameter is not included or set, edit the nodemanager.properties file so that it is similar to the following, where NODE_MANAGER_LISTEN_PORT represents the port the Node Manager listens on, such as 5556:
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.
The Oracle WebCenter installation gives you the option of installing Oracle Universal Content Management (UCM). If you choose not to install Oracle UCM during the Oracle WebCenter installation, you can install Oracle UCM separately in stand-alone mode. Installation instructions are available at the following location:
These installation instructions are missing some important information, which is covered below. The following topics are covered:
The last question is during the installation procedure is:
Select components to install. 1. ContentFolios: Collect related items in folios 2. Folders_g: Organize content into hierarchical folders 3. LinkManager8: Hypertext link management support 4. OracleTextSearch: External Oracle 11g database as search indexer support 5. ThreadedDiscussions: Threaded discussion management Enter numbers separated by commas to toggle, 0 to unselect all, F to finish:
Malke sure you DO NOT include number 2 (
Folders_g) for this answer; you should not install
Folders_g using the installation script.
Folders_g will be installed when the
wc_contentserverconfig.sh script is run.
Instead of installing an new Content Server to use with Oracle WebCenter, you have the option of using an existing Content Server. Any existing Content Server used with Oracle WebCenter should have the Trash disabled. Trash will only be in the Content Server if you have installed a foldering component.
To see if Trash is enabled in the Content Server:
Go to Administration.
Go to Folder Configuration.
Go to System Folder Configuration.
The colour of the dot next to the Trash folder indicates whether or not the Trash is enabled:
Green = enabled
Gray = disabled
To disable the Trash:
Ensure you can edit marked folders:
/custom/Folders_g/folders_environment.cfg (on UNIX) or
\custom\Folders_g\folders_environment.cfg (on Windows) file.
Verify that the
CollectionReadOnlyMarkedFolders value is set to
Restart the Content Server if you changed the
Log in to the Content Server Home Page as a user with Administrator privileges.
Go to Administration.
Go to Folder Configuration.
Go to System Folder Configuration.
Click on the green dot next to Trash. This will disable the Trash folder and will turn the dot grey.
Restore the value of
CollectionReadOnlyMarkedFolders if you had changed it and restart the Content Server.
For Oracle Fusion Middleware 11g Release 1 (11.1.1), each product requires its own Oracle Home directory. Currently, there is no provision for ensuring that port conflicts do not occur across multiple Oracle Home directories.
The best way to work around this problem is to use the
staticports.ini file, so that you will have a record of all the ports that are in use.
If you are creating multiple domains inside a single Middleware Home, there is no provision for checking port conflicts with the Administration Server in each domain. You must manually ensure that the Administration Server in each domain uses a unique port number.
You can configure custom port numbers for your Administration Server as follows:
Start the Configuration Wizard from the
Navigate to the Select Optional Configuration screen, and select Administration Server.
On the Configure Administration Server screen, specify a unique port number for this Administration Server.
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
password with the actual password for the SYS user.
Alternatively, you can check the values by querying the
prompt> sqlplus "sys/password as sysdba"SQL> select name,value from v$parameter;
In the event that an installation fials, 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
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
This procedure will enable you to reinstall the software to the same location, using the same managed server names.
If you want to remove an Oracle instance which is registered with a WebLogic domain, make sure to launch the deinstaller from Oracle Home directory that is associated with the Oracle instance you are removing.
The deinstaller will list all instances associated with same WebLogic domain; make sure you choose to remove the instances that are associated with the Oracle Home from where you launched the deinstaller only.
During the Oracle Identity Management installation, on the "Select Domain" screen, if you enter "weblogic" as the domain password, you will receive an error message telling you that you have used invalid characters in the password, and that only alphanumeric characters are allowed.
The actual problem is that the password must contain at least one number. For example, "weblogic1" would be a valid password.
This section describes configuration issues and their workarounds. It includes the following topics:
For the Oracle Identity Management, Oracle Web Tier, and Oracle Portal, Forms, Reports and Discoverer installations, Oracle Process Manager and Notification Server (OPMN) will not start if the
LD_ASSUME_KERNEL environment variable is set. Make sure that this environment variable is not set.
If you run the Oracle Fusion Middleware Configuration Wizard on an AIX 64-bit system, the Graphics Manager on that system will cause some text to be truncated on the "Server Start Mode and JDK Configuration" screen.
There is no work around for this issue.
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 machine.
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.
After running the Oracle Fusion Middleware Configuration Wizard to expand a cluster, the
EMD_URL parameter in the
/EMAGENT/EMAGENT/sysman/config/emd.properties (on UNIX) or
\EMAGENT\EMAGENT\sysman\config\emd.properties (on Windows) file contains the values shown below:
You must edit this parameter and replace
localdomain with the actual host and domain information of your environment. For example, using
5160 as the port number:
After upgrading Oracle Identity Management from Release 10g (10.1.4.3) to 11g Release 1 (11.1.1), the Oracle Directory Service schemas (
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.
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:22.214.171.124.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.
Oracle SOA Suite, Oracle WebCenter, and Application Developer all contain the
unpack.sh (on UNIX systems) or
unpack.cmd (on Window systems) commands in their respective
/common/bin (on UNIX systems) or
\common\bin (on Windows systems) directories.
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.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 machine.
unpack.cmd commands will fail if any installed products are missing from the machine where you are running the
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
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 Browser when the initial request comes from Oracle HTTP Server.
The work arounds are to either use the Internet Explorer browser, or manually modify the
/config/OHS/instance_name/httpd.conf file and change the
ServerName entry to include the port number. For example:
should be changed to:
port with the actual port number.
This section describes documentation errata. It includes the following topics:
The Oracle Fusion Middleware quick installation guides contain the following documentation errata:
In the PDF versions of the quick installation guides, the links to the system requirements and certification documents are hyphenated due to the limitations of the page size. This causes the links to be formed incorrectly.
The correct link to the Oracle Fusion Middleware System Requirements document is:
The correct link to the Oracle Fusion Middleware Certification document is:
The quick installation guides in the Oracle Fusion Middleware documentation set contain the following database requirement:
Oracle Database 10g (10.2.0.4 or later for non-XE database) using the AL32UTF8 character set.
The AL32UTF8 is strongly recommended but is not a requirement. For the latest RCU database requirements, refer to the system requirements document on Oracle Technology Network (OTN):
The Oracle Fusion Middleware Installation Guide for Oracle Identity Management contains the following documentation errata:
Both the Oracle Fusion Middleware Installation Guide for Oracle Identity Management and the Oracle Fusion Middleware Quick Installation Guide for Oracle Identity Management documents do not include information about installing and configuring Java Access Bridge for Section 508 Accessibility.
If you are installing Oracle Identity Management on a Windows system, you have the option of installing and configuring Java Access Bridge for Section 508 Accessibility. This is only necessary if you require Section 508 Accessibility features:
Download Java Access Bridge from the following URL:
Install Java Access Bridge.
jaccess-1_4.jar from your installation location to the
JAWTAccessBridge.dll files from your installation location to the
Copy the accessibility.properties file to the
In Chapter 10, "Installing Oracle Single Sign-On and Oracle Delegated Administration Services Against Oracle Internet Directory," of the Oracle Fusion Middleware Installation Guide for Oracle Identity Management, the description for the
CONNECT_STRING option is incorrect. The document refers to the option as
DB_CONNECT_STRING, however, it should be described as follows:
CONNECT_STRING: Represents the directory database connect string. If you already have a
tnsnames.ora file configured, then this is the net service name specified in that file, which is located by default in the
/config (on UNIX) or
\config (on Windows) directory.
The Oracle Fusion Middleware Installation Guide for Application Developer contains the following documentation errata:
The Oracle Fusion Middleware Installation Guide for Application Developer incorrectly states that schema creation is necessary for installation and configuration. Disregard all references to schema creation in this document.
In Section 1.1.3, "Install Oracle WebLogic Server and Create the Middleware Home," the following note appears:
Note:In order to be configured properly, Oracle SOA Suite requires that Configuration Wizard and Upgrade Framework is selected.
The reference to Oracle SOA Suite is an error; the note should read as follows:
Note:In order to be configured properly, Application Developer requires that Configuration Wizard and Upgrade Framework is selected.
The following sections in Chapter 3, "Deinstalling Application Developer" are not applicable and should be skipped when deinstalling Application Developer:
Section 3.1.1, "Stopping Oracle Fusion Middleware"
Section 3.1.2, "Removing the Application Developer Schemas"
The Oracle WebCenter installation gives you the option of installing Oracle Universal Content Management (UCM). If you choose to install Oracle UCM, you will be asked to provide connection details to your Oracle database.
Section A.7, "Specify UCM Database Details Screen" in Oracle Fusion Middleware Installation Guide for Oracle WebCenter contains incorrect information suggesting that an Oracle Real Applications Cluster (RAC) database may be specified at the time of installation. Support for Oracle RAC databases is not available out-of-the-box. You must configure your Oracle RAC database after Oracle UCM is installed.
Refer to "Reconfiguring the Content Server to Support RAC" in Oracle Fusion Middleware Enterprise Deployment Guide for Oracle WebCenter for more information.
The Oracle Fusion Middleware Installation Planning Guide contains the following text in Section 1.3.7, "Oracle Metadata Repository:"
Although a metadata repository can be database-based or file-based, it is recommended that database-based repositories be used in a production environment. If you initially configured your environment with a file-based repository, you can change it to a database-based repository.
This is incorrect because only database-based repositories are supported for Oracle Fusion Middleware 11g Release 1 (11.1.1).