5 Oracle WebCenter Suite

5.1.1 Installing Oracle WebCenter Suite 10g (10.1.3.2) on the Same Host as Oracle Database 10.1.x or 10.2.x Will Cause Performance Issues

If you install Oracle WebCenter Suite 10g (10.1.3.2) on the same host machine as an Oracle database, version 10.1.x or 10.2.x., Oracle Process Manager and Notification Server (OPMN) may consume a significant percentage of the machine's CPU time, and the OPMN log file will rapidly increase in size with messages, such as the following:

06/06/07 06:22:52 [ons-connect] Passive connection 127.0.0.1,6100 missing connect.

To prevent this issue from occurring, you can perform one of two actions:

• Install Oracle WebCenter Suite 10g (10.1.3.2) on a different machine than your Oracle database 10.1.x or 10.2.x, including the database you use for Oracle ContentDB, or

• Locate ORACLE_HOME/opmn/conf/ons.config in your database installation and change the port number to 6150 or higher.

5.1.2 Cloning the Oracle Home that Contains the OC4J_WebCenter Instance Does Not Clone the Java Object Cache Configuration

If you clone an Oracle Home that contains an OC4J_WebCenter instance, the Java Object Cache configuration for the instance, located in ORACLE_HOME/portal/conf/javacache.xml, is not automatically cloned. You must manually copy this file to the cloned Oracle Home.

5.1.3 Standalone OC4J Requires Configuration to Run Java Object Cache

When running WebCenter applications or WSRP producers on a standalone OC4J version 10.1.3.1.1 (specifically, the version that ships on the Companion CD with Oracle Application Server 10g Release 3 (10.1.3.2.0), Java Object Cache may not be correctly configured. In this situation, the WebCenter application or WSRP producer will run, but caching will be disabled and the application may run more slowly.

To determine whether this issue is occurring, check the log file in ORACLE_HOME/bin/javacache.log for the entry Òjava.lang.ArrayIndexOutOfBoundsException: -1."

To address this issue, create two directories: ORACLE_HOME/javacache/admin and ORACLE_HOME/javacache/persistence. Copy ORACLE_HOME/j2ee/home/config/javacache.xml to ORACLE_HOME/javacache/admin. Then, restart your standalone OC4J.

5.1.4 Use of Portal Adapter Requires Patch Update

The Oracle WebCenter Suite Portal Adapter enables you to view and search content in OracleAS Portal. To use the Portal Adapter, you must ensure that you are using OracleAS Portal Release 10g (10.1.4), then apply patchset 10.1.4.1 and patch 5697918. The patchset and patch are both available on Oracle Metalink (https://metalink.oracle.com).

For more information on installing the patch, refer to the patch install notes included with the patch ZIP file.

5.1.5 JAZN Migration Tool Incorrectly Prefixes ADFRolePrincipal

When executed with the destination type LDAP (-dt ldap), the JAZN Migration Tool incorrectly prefixes the ADFRolePrincipal in the LDIF file with the realm root determined from Oracle Internet Directory. An example of the incorrect prefix is "us/".

To fix this issue, after creating the LDIF file with the JAZN migration tool, remove the incorrect prefix, for example Òus/", from all occurrences of the grantee anyone, before uploading the entries of the LDIF file to the LDAP server.

5.1.6 Rich Text Portlet Customization Not Supported in Safari

When customizing the Rich Text portlet in a Safari browser, users can only perform basic HTML editing. To take advantage of rich text editing, users should customize the portlet in another browser.

5.1.7 Oracle SES Group ACL Synchronization Issue with Secure Crawl of Oracle ContentDB

When securely crawling the included Oracle ContentDB repository, Secure Enterprise Search (SES) indexes the crawled content, as well as the Access Control information for the crawled content. However, there is an issue where SES does not correctly gather Access Control information when the access rights in Oracle ContentDB are assigned through a group. Thus, the search may not display files even when the user has the appropriate rights to view them.

5.1.8 Oracle SES Group ACL Synchronization Issue with Secure Crawl of Oracle ContentDB

When using the Federated Portal Adapter, ensure the Oracle JDeveloper environment matches the available languages installed in the OracleAS Portal instance.

5.1.9 Using the Search Feature with the File System Adapter

When using the File System Adapter, multibyte keywords in a search operation only work with UTF-8 encoded files.

5.1.10 Using the Search Feature with the Federated Portal Adapter or Oracle ContentDB in Turkish

When using Oracle ContentDB or the Federated Portal Adapter, the search feature cannot distinguish among the four versions of the Turkish character I.

5.1.11 Running the Predeployment Tool in Scripts

If you run the Predeployment tool repeatedly in a script, you may experience intermittent failures of the tool. To avoid this problem, allow a minute or two to elapse between executions of the tool.

5.1.12 Rich Text Portlet Customization Not Supported in Safari

When customizing the Rich Text portlet in a Safari browser, users can only perform basic HTML editing. To take advantage of rich text editing, users should customize the portlet in another browser.

5.1.13 Portlets with ADF Data Binding on the Same Page Cannot Be Customized

When a JSF page contains both ADF data binding and portlets, the portlets cannot be customized. When you click Customize in the portlet, an error occurs.

The workaround for customizing the portlets is as follows:

1. Click the Back button of your browser.

2. Click Refresh.

3. The portlet switches to the customize mode in a shared screen and you can customize it.

5.1.14 Log Messages While Starting Preconfigured OC4J

When you start the Preconfigured OC4J in Oracle JDeveloper, the following may occur:

• You may see a notification as follows:

  Executing: C:\jdev_4044\jdk\jre/..\bin\java   Note the odd path containing forward slashes, backslashes, and "..".   
  

• You may see a warning message as follows:

  WARNING WARNING: No Repository Type selected,   deferring initialization   
  

You can safely ignore these log messages.

5.1.15 Error When Compiling JSP with PDK Struts Components

A JSP containing Portal Development Kit (PDK) struts components does not compile. It fails with the following error:

java.lang.NoClassDefFoundError: org/apache/struts/taglib/html/FormTag

This happens when using the Oracle PDK struts extension from JDeveloper 10.1.3.2.0. It happens only for the following components:

• FormTag

• ImgTag

• LinkTag

• RewriteTag

• TextTag

5.2.1 Help for WebCenter Application Metrics Incorrect in All Languages

In the Enterprise Manager Application Server Control Console, the HTTP-response code categories HTTP2xx, HTTP3xx, HTTP4xx, and HTTP5xx are used to present performance information for WebCenter applications. However, not all WebCenter application metrics relate to HTTP requests, so successful requests without an associated HTTP request are also logged as HTTP2xx, and unsuccessful requests without an associated HTTP request are logged HTTP5xx.

For example:

• Cache hits are logged as HTTP2xx

• Timeouts before an HTTP request started are logged HTTP5xx

• Timeouts after a cache hit are logged HTTP5xx

Accurate descriptions for all performance metrics are documented in the Oracle WebCenter Framework Developer's Guide, Chapter 10.3 "Interpreting the Information in Enterprise Manager". The online Help implies that all WebCenter application metrics relate to HTTP requests and this is no longer accurate.