Skip Headers
Oracle® Application Server Release Notes
10g Release 3 (10.1.3.2) for AIX

Part Number B32414-05
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

6 Oracle WebCenter Suite

This chapter describes issues associated with Oracle WebCenter Suite. It includes the following topics:

6.1 Oracle WebCenter Suite Issues and Workarounds

This section describes issues and workarounds related to Oracle WebCenter Suite. This section includes the following topic:

6.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.

6.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.

6.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.

6.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 (http://metalink.oracle.com).

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

6.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.

6.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.

6.1.7 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.

6.1.8 Issue with SES Securely Crawling Content in Oracle ContentDB

Currently, SES can crawl public content from Oracle ContentDB. However, there is an issue with crawling the secured content in Oracle ContentDB. Therefore, the search may not display files even when the user has the appropriate rights to view them.

6.1.9 Language Setting Issue with the Federated Portal Adapter

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

6.1.10 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.

6.1.11 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.

6.1.12 Use of Oracle WebCenter Adapters for Microsoft SharePoint, EMC Documentum, and IBM Lotus Domino Requires Patch Update

The Oracle WebCenter adapters for Microsoft SharePoint, EMC Documentum, and IBM Lotus Domino enable you to retrieve content from SharePoint, Documentum, and Domino repositories. To use the adapters you must ensure that you have applied the 10.1.3.3 patchset, or are using JDeveloper 10.1.3.3, and have applied patch 6447083. The patchset and patch are both available on Oracle Metalink (http://metalink.oracle.com). The patch 6447083 applies to both JDeveloper, Oracle Application Server, and Microsoft Windows (32bit) and Linux platforms. To locate this patch on Metalink, from the Quick Find dropdown, select Patch Number and then enter the patch number in the field next to it. Then click Go.

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

6.1.13 Using the Search Feature with Oracle WebCenter Adapters for Microsoft SharePoint, EMC Documentum, and IBM Lotus Domino

Keyword and namePattern search for the & (ampersand) symbol is not supported.

6.1.14 Reexecuting a Page that Uses Oracle WebCenter Adapters for Microsoft SharePoint, EMC Documentum, and IBM Lotus Domino

Reexecuting a page in JDeveloper that uses either the Oracle WebCenter adapter for Microsoft SharePoint, EMC Documentum, or IBM Lotus Domino throws an error.The workaround is to stop the OC4J before reexecuting the page.

6.1.15 Incorrect Query Execution in Oracle WebCenter Adapter for IBM Lotus Domino

The query /jcr:root/VIEWS/element(*, nt:base) will return all documents in the Lotus Domino database and not just the names of the views within the database. A query such as /jcr:root/views/MyView/element(*, nt:file) will return all documents visible through the view.

6.1.16 Supplying a Domain Name as Part of Administrator Credentials for Oracle WebCenter Adapter for EMC Documentum

For the Oracle WebCenter adapter for EMC Documentum, supplying a domain name as part of admininstrator credentials, for example EM\alison, may fail the repository connection.

The workaround is to omit the domain name, if the Documentum repository is configured such as to not require domain names.

6.1.17 Testing a JCR SharePoint Repository Connection

The Test button in the Create Data Control wizard does not work for the JCR SharePoint adapter.

6.1.18 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.

6.1.19 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.

6.1.20 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

6.2 Documentation Errors

This section describes known errors in Oracle WebCenter Suite documentation. It includes the following topics:

6.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.

6.2.2 Error in the Manually Creating and Editing the orion-application.xml File section of Oracle WebCenter Framework Developer's Guide

Steps 13 to 16 in the Manually Creating and Editing the orion-application.xml File section of the Deploying Your WebCenter Application chapter are required to be performed only if the program uses data-sources.xml or jazn-data.xml, that is, these files need to be created either manually or automatically by choosing to deploy to an OC4J platform in the deployment descriptor profile. If the program does not use data-sources.xml or jazn-data.xml files, then performing these steps (13 to 16) can cause errors.