37 Oracle Universal Content Management

This chapter describes issues associated with Oracle Universal Content Management (Oracle UCM). It includes the following topics:

37.1 General Issues and Workarounds

This section describes general issues and workarounds. It includes the following topics:

37.1.1 Folio Items With Content IDs Containing Multibyte Characters Do Not Display Correctly in Safari

If you use the Safari web browser to download content into a simple folio where one or more content IDs include multibyte characters, then these multibyte content IDs are displayed as '------'. To avoid this, you can either use Internet Explorer or Firefox, or avoid using multibyte characters in content IDs.

37.1.2 Site Studio Does Not Support Multibyte Characters in Site IDs, Directory Names, and Page Names

Oracle Site Studio does not support multibyte characters in any value that will be used in URLs, including site IDs, directory names, and page names.

37.1.3 Site Studio Publisher Does Not Support Multibyte Characters

Oracle Site Studio Publisher does not support multibyte characters.

37.1.4 Transferring Folder Archives Between Content Servers Fails If Server System Locales Do Not Match

If you transfer folder archives between two Oracle Content Server instances using the Archiver utility, then this will fail if these servers have different system locales. No folder will be created on the target server, and no items under that folder will be imported. To avoid this, make sure that the system locales of both content servers match.

37.1.5 Importing Folder Archives Fails If User Locale Did Not Match Server System Locale During Export

If you export a folder archive from the Folder Configuration page in Oracle Content Server and the user locale during export does not match the server system locale, then you will not be able to import that folder archive to the same or a different content server, even if the user and system locales on that server do match. To avoid this, make sure that the user and system locales match during the folder archive export.

37.1.6 New Folio Page Does Not Work in French and Italian Languages

If both the Folios and AppAdapterCore features are enabled, and the user language is set to either French or Italian, the New Folio page does not allow you to select a template and create a new folio.

37.1.7 UCM Servers and IPv6 Support

UCM servers are supported on IPv4/IPv6 dual-stack hosts, but not on"IPv6-only" hosts. The following topologies are supported:

  • Oracle Database on IPv4 hosts

  • Oracle UCM, Oracle URM, Oracle IBR on IPv4/IPv6 dual-stack hosts

  • Client (browser) on either IPv4 or IPv6 hosts

37.1.8 Large File Check-ins May Cause Timeouts

Large file check-ins often time out due to the amount of I/O that occurs. Database locks are held while the large file is written and this blocks subsequent check-ins. The IdcServerThreadQueryTimeout configuration setting can be used to lengthen the checkout time. The setting is expressed in seconds; to make the timeout 5 minutes, set IdcServerThreadQueryTimeout=300.

37.1.9 Content Categorizer Trace Log Settings Discontinued

The Content Categorizer-specific execution trace log settings are discontinued. Use the Content Server System Audit Information facility instead. To enable Content Categorizer execution trace, enter contentcategorizer in the Active Sections control of the Tracing Sections Information section of the Admin System Audit Information page.

37.1.10 Using Oracle UCM with OAM Server Under Single Sign-on

When Oracle UCM is used with Oracle Access Manager in a single sign-on environment, an entry to the config.cfg file must have the following lines added:

LogoutServerUrl=http://OAMserveraddress:port/ngam/server/logout?end_url=<$HttpBrowserFullWebRoot$>
RedirectHostsFilter=OAMserveraddress

37.1.11 Extra Lines Displayed Viewing Contribution Folders in Internet Explorer 8

When using Folders in Internet Explorer 8 with default settings, IE8 adds extra lines. This is solved by opening the Compatibility View Settings dialog and unselecting the Display intranet sites in Compatibility View checkbox.

37.1.12 WebDAV Connection Fails After Logout or Restart

In Windows 7 and Windows Vista clients, after logging out and logging back in or after restarting, the Network Place used to access UCM over WebDAV may no longer work. This is solved by deleting and recreating the connection.

37.1.13 LDAP Users Not Receiving Some Administrator Privileges

UCM inspects for the group "Administrators" on each user's login to grant UCM roles. If a user should have access to the UCM admin server, the UCM server requires that the user be a member in a group named "Administrators."

37.1.14 Detailed Oracle OpenOffice Configuration Settings

When configuring Inbound Refinery to convert content using Oracle OpenOffice, additional configuration details can be found in the Oracle 10g release of the PDF Converter Installation and Administration Guide. The complete guide is available for download in either PDF or HTML format from Oracle Technology Network at the following URL:

http://download.oracle.com/docs/cd/E10316_01/ouc.htm

Oracle OpenOffice configuration is detailed in the "OpenOffice" section of "Installing Third-Party Applications" in Chapter 4, "Installing PDF Converter" and can be accessed directly at the following URL:

http://download.oracle.com/docs/cd/E10316_01/refinery/refinery_doc_10/pdfconverter/wwhelp/wwhimpl/common/html/wwhelp.htm?context=install_admin_pdfc_10en&file=page_04_19.htm

Oracle OpenOffice configuration is detailed in the "OpenOffice" section of "Installing Third-Party Applications" in Chapter 4, "Installing PDF Converter" and can be accessed directly at the following URL:

http://download.oracle.com/docs/cd/E10316_01/refinery/refinery_doc_10/pdfconverter/wwhelp/wwhimpl/common/html/wwhelp.htm?context=install_admin_pdfc_10en&file=page_04_19.htm

37.1.15 Clarification When Setting Classpath to OpenOffice Class Files

In the Oracle Digital Asset Manager and Conversion Administration guide, chapter 2 "Managing Conversions" under the section "Configuring Content Server and Refinery Communication," step 2 asks you to enter:

JAVA_CLASSPATH_openoffice_jars=<OfficePath>/Basis/program/classes/unoil.jar:<OfficePath>/URE/java/ridl.jar:<OfficePath>/URE/java/jurt.jar:<OfficePath>/URE/java/juh.jar

Note that the true value for <OfficePath> is likely to include spaces and care must be taken when setting this in a Microsoft Windows environment.

Ensure that the paths are not enclosed in quotes, that slashes (/) are used for path separators and not backslashes (\), and that any space in the path is escaped using a backslash (\). For example, a properly formed classpath in a Windows environment could look like this:

JAVA_CLASSPATH_openoffice_jars=C:/Program\Files/OpenOffice.org\3/Basis/program/classes/unoil.jar:C:/Program\Files/OpenOffice.org\3/URE/java/ridl.jar:C:/Program\ Files/OpenOffice.org\3/URE/java/jurt.jar:C:/Program\ Files/OpenOffice.org\ 3/URE/java/juh.jar

37.1.16 Oracle Inbound Refinery PDF Conversion May Differ Visually from the Original Content

Oracle Inbound Refinery makes every effort to maintain the visual integrity and formatting of content being converted from its native format to PDF, but Oracle cannot guarantee that the resulting PDF will be an exact visual replication.

37.1.17 Mismatching User and Server Locales Prevent Access to Oracle E-Business Suite and PeopleSoft Managed Attachment Pages in Oracle UCM

For the Oracle E-Business Suite and PeopleSoft managed attachment function in Oracle UCM, users are not granted access to managed attachment pages if their user locale does not match the server locale, which means they cannot view these pages.

37.1.18 Connection Issues with Windows to WebDAV

Supported Windows operating systems may have difficulty connecting to a WebDAV server running over HTTP and using HTTP Basic authentication in some situations. To correct for this, you must edit the registry of the client computer to enable Basic authentication. For detailed information, see Microsoft Knowledge Base Article 841215 at http://support.microsoft.com/kb/841215.

37.1.19 Manual Addition of xdoruntime.ear Library for Records Management

If the Records Management feature is installed in an Oracle Universal Content Management (UCM) product, xdoruntime.ear library needs to be added manually from the Oracle WebLogic administration console after a domain is created. A reference to the library must be added to the weblogic-application.xml file of the Oracle Universal Content Management EAR file before the managed server is started for the first time.

To add xdoruntime.ear to the WebLogic UCM domain, follow these steps:

  1. After a domain is created, start the Admin Server only. If a managed UCM server has already been started, then the administrator will have to perform additional steps to add reference to the deployed UCM server instance later.

  2. Open WebLogic console in browser. Click on Deployments in the left pane. Browse the pages to check if there is already a xdoruntime.ear file in the WebLogic administration console. If it is already present, then no more steps need to be performed.

  3. If no xdoruntime.ear file is present, click Install on the Deployments display. A file selection dialog opens. Browse the available file system and select xdoruntime.ear in the following path:

    /FMW_HOME/Oracle_ECM1/ucm/idc/components/ReportPublisher/lib/xdoruntime.ear
    
  4. Click Next. The option page to select the file as library opens. Select "Install this deployment as a library" and click Next.

  5. The Target Selection Screen opens. Select all targets and click Next.

  6. The Deployment Name screen opens. In the Security section, select "DD Only: Use only roles and policies that are defined in the deployment descriptors." In the Source accessibility section, select "Copy this application onto every target for me" and click Next.

  7. In the Additional Configuration section, select "Yes, Take me to the deployment's configuration screen" and click Finish. The library is now deployed in the environment.

To reference the deployed library from the UCM Enterprise Application library, follow these steps:

  1. Extract the cs.ear file from the following path:

    /FMW_HOME/Oracle_ECM1/ucm/idc/components/ServletPlugin/cs.ear
    
  2. In the extracted directory modify META-INF/weblogic-application.xml and add the following line for library reference:

    <library-ref>
        <library-name>oracle.xdo.runtime</library-name>
    </library-ref>
    
  3. Create an archive file named cs.ear from the extracted modified directory and replace the file by the same name in the path it was retrieved from. This change will take for all undeployed UCM server instances.

  4. Start the managed server.

If the managed server has been started at least once after the domain has been created, complete the following:

  • Locate the weblogic-application.xml of the Oracle Universal Content Management enterprise application in the deployed UCM domain at a path similar to the following example:

    /FMW_HOME/domain path/servers/UCM_server1/servers/UCM_server1/tmp/_WL_user/Oracle Universal Content Management - Content Server/k6ggd/META-INF/weblogic-application.xml
    

    Modify the META-INF/weblogic-application.xml and add the following line for library reference:

    <library-ref>
        <library-name>oracle.xdo.runtime</library-name>
    </library-ref>
    

    If the UCM_server1 is not available in /FMW_HOME/domain path/servers/, then this step is not needed, as the managed server has not been started, which would have deployed the UCM_server1 at this location.

37.1.20 Using HCSP Custom Elements with SSXA

When a new custom element form is created from scratch(rather than copying an existing form to build an element from), it may have issues lading properly in SSXA.

To use HCSP custom elements within SSXA, you must include the following in the SSXA application's web.xml file:

<mime-mapping>
    <extension>hcsp</extension>
    <mime-type>text/html</mime-type>
</mime-mapping>

This will allow the files related to the custom element to be executed rather than downloaded.

37.1.21 Using Link Wizard with FCKEditor and Chrome

If the defined editor for Site Studio Contributor is FCK Editor, in some cases the Link Wizard may not launch properly when using Contributor via Chrome 9.0.

This is an issue with the FCK editor. You should either use CK editor for Site Studio, or use one of the recommended browsers for Site Studio (IE, Firefox, Safari) when using Site Studio Contibutor.

37.1.22 Link Wizard Display Errors When Using Chrome

When making a link in the Link Wizard while using Chrome, in some cases JavaScript code is displayed rather than the link. The code continues to display even when looking at the web site outside of Contributor. This only happens when using Chrome, and not IE, Firefox, or Safari.

37.1.23 Backing Up Site Studio Websites Using Chrome

When backing up a Site Studio website using Chrome, and manage the archive and download as a ZIP file, the name of the ZIP file might not be as expected.

The name of an archive downloaded as a ZIP file should be in this format: server_DDMMYYYY_HHMMSS.zip. But when using Chrome, the name may be idcplg.zip.

37.1.24 DAM Video Storyboard Errors With Chrome and Safari

The storyboard links on the Rendition Info page for a video item (which should make the video start playing at a specific spot) are not working in Chrome or Safari browsers with Windows Media or QuickTime player plugins. Nothing happens when you click on the links. They do work in Chrome and Safari with the flash player, and they work with all plugins in Firefox and IE.

37.1.25 Issues Applying Table Styles When Using FireFox and FCK Editor

When using FCK editor and FireFox with Site Studio Contributor, it is difficult to apply available table styles to a table. This is a functionality missing from FCK editor, and not a limitation of FireFox or Site Studio.

37.1.26 Content Information Server Is Not Supported for 11g

Oracle Content Information Server (CIS) is not supported for UCM 11g connections in any formats.

37.1.27 Window Size Using Trays with FireFox

When using the Trays view with Site Studio on the Content Server, some screens viewed in FireFox may not correctly fill the browser window.

37.1.28 Content Item Icon for Basket Item Appears Broken in Chrome

When using Chrome with Oracle UCM, the icon for content items in the user's active basket appears broken. This only happens when using the Chrome browser.

37.1.29 VB6 Component Dependency for Kofax 9

Kofax 9 does not install VB6 components required for many of the Export Connectors. Install and register the required VB6 components to use the Export Connectors.

37.2 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

37.2.1 Minimum JDBC Driver Version Required for Oracle Text Search Component

The Oracle Text Search component that is part of Oracle UCM 11gR1 requires a JDBC driver version of 10.2.0.4 or higher. The component will not work with older JDBC driver versions.

37.2.2 Setting Security Privileges for Modifying Folders

By default, users only need RW privileges to modify folders, where before the default was that RWD or owner was required unless collaboration was enabled.

Users explicitly relying on RWD privileges must set the environment variable to allow for this. WebCenter users and those with no upgrade issues are not affected.

For those who require RWD rather than RW, set the variable as:

FoldersModifyWithRW=false

37.2.3 Site Studio for External Applications (SSXA) Port Values for Oracle Content Server 10gR3

The JDeveloper Site Studio for External Applications connections dialog is pre-populated with a default web connection port value of 16200 for an Oracle Content Server 11g instance. Oracle Content Server 10gR3 web servers most often listen on port 80. As such, this value will likely have to be changed when connecting to an Oracle Content Server 10gR3 instance.

37.2.4 SSXA Required DC Version for Oracle Content Server 10gR3

To use dynamic conversion of native documents on your Site Studio web sites running off of Oracle Content Server 10gR3, you must install and configure Dynamic Converter build version 8.1.0.736 or greater.

37.2.5 Content Portlet Suite (SCPS) WebCenter as Producer Targeting Libraries

When creating a custom managed server, the following libraries need to be targeted to the newly created managed server (for example, CPS_Portlet). Note that the libraries for 11gR1 PS2 (11.1.1.3) are different from the libraries for 11gR1 PS3 (11.1.1.4) and 11gR1 PS4 (11.1.1.5) installation of WebCenter.

Libraries for 11gR1 PS2 (11.1.1.3) installation of WebCenter:

  • oracle-ridc-client-app-lib(10.3.2,10.3.2)

  • oracle-ucm-spi-app-lib(10.3.2,10.3.2)

  • p13n-app-lib-base(10.3.2,10.3.2)

  • vcr-app-lib(10.3.2,10.3.2)

  • oracle.webcenter.framework(11.1.1,11.1.1)

  • oracle.webcenter.spaces.fwk(11.1.1,11.1.1)

Libraries for 11gR1 PS3 (11.1.1.4) and 11gR1 PS4 (11.1.1.5) installation of WebCenter:

  • oracle.ucm.ridc.app-lib(11.1.1,11.1.1)

  • p13n-app-lib-base(10.3.2,10.3.2)

  • oracle.webcenter.framework(11.1.1,11.1.1)

  • oracle.webcenter.spaces.fwk(11.1.1,11.1.1)

  • oracle.webcenter.framework.core(11.1.1,11.1.1)

When consuming Oracle Content Portlet Suite 11gR1 PS3 (11.1.1.4) on Oracle WebCenter 11gR1 PS3 (11.1.1.4), users will see the exception "java.lang.IllegalArgumentException:IdcContext.setUser() method not valid, do not use this method."

Contact Oracle support for the options available to resolve this issue.

37.2.6 Logout URL for SSO Logout Integrating with Oracle Access Manager 11g

When integrating Oracle UCM with Oracle Access Manager 11g, add the following to the Logout URL setting for the WebGate:

/oamsso/logout.html

37.2.7 Using the Custom Truststore with the JPS Connection to ActiveDirectory

JpsUserProvider should be up for Oracle UCM to be able to fetch users' roles/groups from the LDAP server. The JPS layer does not automatically pick up the SSL truststore configuration from WLS. Since a custom truststore is being used in the WLS configuration, the problem is that the JPS connection to ActiveDirectory is not using this custom truststore.

Therefore, set the following Java properties when starting UCM_server1:

Djavax.net.ssl.trustStore=<location of custom truststore>
Djavax.net.ssl.trustStorePassword=<truststore password>

If you start the server from the command line using startManagedWeblogic.sh you can set the environment variable EXTRA_JAVA_PROPERTIES before invoking startManagedWeblogic.sh.

If you start the server using the NodeManager, these can be set using the WLS Admin console by setting the Arguments in the Server Start tab for the Configuration of UCM_server1.

37.3 Documentation Errata

This section describes documentation errata. It includes the following topics:

37.3.1 "Save As" Option Not Available in PowerPoint for Desktop Integration Suite

Sections A.10.1 and A.10.2 of the Oracle Fusion Middleware User's Guide for Desktop Integration Suite as well as the context-sensitive help pages for the Save dialog fail to mention that the Save As option is not available in Microsoft PowerPoint.

37.3.2 EnableOptimizedLatestReleaseQuerying No Longer Valid in Idoc Script

EnableOptimizedLatestReleaseQuerying is no longer a valid Idoc Script variable and should be disregarded.

37.3.3 Kofax Version Certification for Oracle UCM

Kofax versions 8.0 and 9.0 are both certified to work with Oracle UCM 11g.

37.3.4 Content Portlet Suite (CPS) WSRP URLs for WebCenter as Producer

After deploying the CPS EAR file to WebCenter as a producer, the WSDL URL for 11g PS2 (11.1.1.3) is different from the WSDL URL for PS3 (11.1.1.4) and PS4 (11.1.1.5). For more information, see the Deployment Guide for Content Portlet Suite, Section 3.1.4, Step 17.

WSRP URL for PS2 (11.1.1.3) installation of WebCenter:

http://Host_Name:Port/cps/portlets/wsrp1?wsdl

WSRP URL for PS3 (11.1.1.4) and PS4 (11.1.1.5) installations of WebCenter:

http://Host_Name:Port/cps/portlets/wsrp2?WSDL

37.3.5 Custom Installation Options for Desktop Integration Suite 11gR1

The custom installation options for Desktop Integration Suite 11gR1 were inadvertently left out of the 11gR1 documentation. The information in appendix A of the Desktop Integration Suite Installation Guide for 10gR3 also applies to 11gR1:

http://download.oracle.com/docs/cd/E17967_01/Desktop/Pdf/Desktop_Installation_Guide.pdf