Skip Headers
Oracle® Collaboration Suite Release Notes
10g Release 1 (10.1.1) for Linux

Part Number B19091-07
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Master Index
Master Index
Go to Feedback page
Contact Us

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

5 Oracle Content Services Release Notes

This chapter summarizes release note issues associated with Oracle Content Services. This chapter contains the following sections:

Note:

This document was updated on October 7, 2005.

5.1 New in Oracle Content Services

Oracle Content Services is the new name for the product formerly known as Oracle Files. In addition to having a new name, this version of the product ships with many additional key features that support the following benefits to your organization:

The following sections provide an overview of the new features in Oracle Content Services 10g:

5.1.1 Web Services

Oracle Content Services ships with Web services that:

  • Support integration, automation, and functional extension

  • Are J2EE and .Net compatible

  • Provide support for file management, records management, searching, versioning, workflow, session management, virus scanning, and other functions

The Oracle Content Services Web services provide programmatic access to the following functionality:

See Oracle Content Services Application Developer's Guide for more information about the Oracle Content Services Web services.

5.1.2 File and Document Management

Oracle Content Services provides the following new features for file and document management:

  • Folder and file-level security

  • Fine-grained permissions

  • Role-based access control

  • Group access management

  • Multiple Sites per Oracle Content Services instance

  • File check-in/check-out

  • Policy-based versioning with a folder-by-folder policy, automatic or manual application, maximum version cutoff, and selectable version naming

  • Policy-based Category management (extended metadata) with a folder-by-folder policy, automatic or manual application, hierarchical categories, and default and/or enforced attributes

  • Integrated antivirus protection (partner solution required)

  • Ability to create and store links to files and folders

5.1.3 Business Process Automation

Oracle Content Services provides features that allow workflows to be associated with specific folders. These workflows:

  • Can be automatically triggered when events such as document check-in or deletion occur

  • Can be used to drive review and approval cycles

  • Can notify someone that a new document version has been checked in

  • Can prevent the deletion of a document from a folder without a manager's permission

Oracle Content Services also supports custom workflows through Oracle BPEL Process Manager, an Oracle product that provides a framework for easily designing, deploying, monitoring, and administering processes based on Business Process Execution Language (BPEL) standards. These custom workflows:

  • Can be used to automate a wide range of business processes

  • Can be registered with Oracle Content Services so that users can define workflow-based folder policies

  • Can invoke the Oracle Content Services Web services to perform an extensive set of actions

See "Managing Workflows in Oracle Content Services" in Chapter 3 of Oracle Content Services Administrator's Guide for information about workflow features in Oracle Content Services. See Oracle BPEL Process Manager Developer's Guide for information about creating custom BPEL workflows.

5.1.4 Records Management

Records management features provide the ability to specify that a document is to be retained for a certain period of time, prevent or control changes to the document during the retention period, and dispose of the document in a prescribed way once the retention period has expired. Oracle Content Services ships with an optional product, Oracle Records Management, to support these records management capabilities.

The following features are provided:

  • File plan-based record organization

  • Record search

  • Flexible classification and retention policy management

  • Records declaration that can be:

    • Applied manually by users

    • Policy-based, applied on a per-folder basis

See Oracle Records Management Administrator's Guide for information about how to use the records management features in both Oracle Records Management and Oracle Content Services.

5.1.5 New Administration Features

The following new administrative features are provided in Oracle Content Services:

  • Integration with OPMN

  • Simplified installation and configuration

  • Simplified RAC configuration

  • BFILE aging

  • Enhanced logging

  • Multiple Applications tiers on a single host

  • Option to configure and unconfigure Oracle Content Services from the Oracle Collaboration Suite Control

  • LYKE index to improve performance on filename searches (such as *minutes*)

  • Ability to manage SQL metric configuration

  • Automatic integration with Oracle Workflow

  • Easier mechanism to change the Oracle Content Services schema password

  • Additional default formats

For detailed information about changes and improvements to Oracle Content Services administration, see "What's New in Oracle Content Services Administration" in Oracle Content Services Administrator's Guide.

5.2 Known Limitations and Workarounds in Oracle Content Services

The following sections describe known limitations and workarounds for Oracle Content Services:

5.2.1 Some Oracle Content Services Features Only Available for Preview

The Oracle Content Services engine is being released as part of Oracle Collaboration Suite 10g. This engine provides a comprehensive set of Web services APIs that enable content management functionality in the new Oracle Workspaces application, and that can be used to content-enable a wide range of customer business and knowledge worker applications.

Oracle has also developed a set of applications for Oracle Content Services, including a rich Web client providing a familiar, desktop-like collaborative content management experience, and a Windows integration client (known as Oracle Drive) that offers seamless access to Oracle Content Services from Windows desktop applications. To ensure a high level of quality and ease-of-use, these clients, as well as additional functionality such as WebDAV access for Macintosh clients, are still undergoing additional testing and development and are only available for preview through the Oracle Sales organization.

The full list of Oracle Content Services features that are only available for preview include:

  • Oracle Content Services Rich Web User Interface

    This user interface provides dynamic tree and list views, right-click menus, keyboard shortcuts, Group, Reports, and Search views, and Advanced Properties dialogs for Sharing, Versioning, Categories, Workflow, and Records Management.

  • Oracle Content Services Accessibility Web UI

    This user interface is BLAF-based for ADA compliance and provides full screen reader support and keyboard navigation.

  • Oracle Drive Windows Desktop Integration Tool

    This client is a "file system redirector" for the Windows desktop that provides:

    • Mounted drive functionality through WebDAV

    • A cache-based facility for transparent offline file and folder management

    • Right-click access to Advanced Properties dialogs from Windows Explorer providing viewing and editing of Advanced Properties

  • Oracle Content Services Records Management Web UI

    This user interface provides File Plan, Record Series, Record Category, and Records Management capabilities, as well as dynamic tree and list views, right-click menus, and keyboard shortcuts.

  • Cookieless WebDAV facility for Macintosh

    This feature provides WebDAV access for Macintosh clients.

Contact your Oracle sales representative for information about previewing these features.

5.2.2 Upgrade from Oracle Files 9.0.x to Oracle Content Services 10g Not Supported

For the Oracle Collaboration Suite 10g (10.1.1) release, upgrading from Oracle Files 9.0.x to Oracle Content Services 10g (10.1.1) is not supported.

This limitation only applies to Applications tier upgrades for Oracle Collaboration Suite installations that have Oracle Files configured on any Applications tier. Upgrading your Oracle Internet Directory and Oracle Database instances is a supported production feature, as long as you do not upgrade any Applications tiers.

See Oracle Collaboration Suite Upgrade Guide for more information.

5.3 Known Issues in Oracle Content Services

The following table lists known issues for Oracle Content Services.

Table 5-1 Known Issues in Oracle Content Services

Description Action Bug Number

You must meet Oracle Internet Directory user requirements for configuring Oracle Content Services through the Oracle Collaboration Suite Control.

An Oracle Internet Directory user must have additional privileges to be able to use the Oracle Collaboration Suite Control to configure Oracle Content Services.

The Oracle Internet Directory user must have the following privileges:

  • Owner of the group IAS Admins

  • Member of the group IAS Admins

  • Member of the group IAS and User Mgmt Application Admins

  • Member of the group Repository Mid-tier Administrators

Use the same Oracle Internet Directory user to configure all Oracle Content Services Applications tiers.

4466973

File not found errors appear in install log file after silent installation.

The log file generated during the silent installation process displays "File not found" errors.

The error message can be safely ignored.

4456690

NodeManager throws NumberFormatException during initial deployment of OC4J.

After deploying Oracle Content Services, the NodeManager services generates a NumberFormatException.

None. Oracle Content Services restarts the OC4J instance automatically and corrects the problem.

4226180

Uninstalling Oracle Content Services does not remove the service registry entries for the product.

Because of this, subsequent attempts to configure Oracle Content Services will fail.

Remove the service registry entry using the following ldap command:

ldapdelete -h oid_host_name -p oid_port -D
 user_name -w user_password -v "cn=
domain_display_name,cn=VirtualServices,
cn=Files,cn=Services,cn=OracleContext"

4464135

Users cannot sign on to a new Oracle Content Services instance that is using an upgraded Oracle Internet Directory.

This problem occurs because of insufficient access rights set in the upgraded Oracle Internet Directory instance.

Grant Browse access to Everyone on the user search base and group search base containers for each realm in Oracle Internet Directory. This needs to be done only for orclentrylevelaci.

Follow these steps to grant Browse access:

  1. As the orcladmin user, connect to Oracle Internet Directory using Oracle Directory Manager.

  2. For each realm, browse to the user search base and group search base containers.

    The following examples show user search base and group search base containers for a realm named "us" and a realm search base "dc=oracle,dc=com":

    cn=Users,dc=us,dc=oracle,dc=com
    cn=Groups,dc=us,dc=oracle,dc=com
    
  3. For each container, click the Local Access tab, then grant Browse access to Everyone in the Structural Access Items box by selecting Everyone and clicking Edit for the existing ACI.

4499315

On-demand provisioning through WebDAV/FTP fails for non-default realms.

Users should be automatically provisioned into Oracle Content Services when they first sign on. Users who are members of non-default realms, however, are not getting provisioned when they sign on through FTP or WebDAV.

Because the Oracle Internet Directory Credential Manager Agent provisions new users at pre-specified intervals (the default is every 15 minutes), users who are members of non-default realms should wait until this time period has elapsed before attempting to sign on over FTP or WebDAV.

4495338

Error occurs when pressing Enter for some fields in the Oracle Collaboration Suite Control.

If you are using Internet Explorer, you may encounter an error if you press Enter after entering text in the Search fields for the Formats, Sites, Domain Properties, and Server Configurations pages in the Oracle Collaboration Suite Control.

Use the Go button with the Search field rather than pressing Enter on these pages.

4492847

The Oracle Content Services Configuration Assistant fails when running against Oracle 10.2 database server.

The Oracle Content Services Configuration Assistant fails when running against Oracle 10.2 database server because of syntax changes from Oracle 9i database server

Edit the file $ORACLE_HOME/content/admin/sql/analyze.sql. Replace the line:

exec dbms_stats.export_schema_stats
 upper('&1'), 'IFS_BACKUP_STATS',
 to_char(sysdate, 'DD-MON-YY HH24:
MI.SS'), upper('&1') );

With the following:

exec dbms_stats.export_schema_stats(
 upper('&1'), 'IFS_BACKUP_STATS',
to_char(sysdate, 'MON_DD_YYHH24_MI_SS'),
 upper('&1') );

4524137

The Oracle Internet Directory Credential Manager Agent consumes 100% CPU when more than 10,000 users are first provisioned.

This problem occurs because a database query against the odmz_oidcredentialmanagerevnt table takes more than ten minutes to return. If you are experiencing this problem, you will see the following entry in the node log:

[oracle.ifs.management.servers.Oid CredentialManagerAgent] WARNING: IFS-45370: Unable to handle requests

If you encounter this problem, perform the following steps:

  1. Verify that the odmz_oidcredential managerevnt database table has a large number of rows in it.

  2. Stop the node that runs the OidCredential ManagerAgent, killing the node process if necessary.

  3. Using the Oracle Collaboration Suite Control, increase the value for IFS.SERVICE. SessionOperationTimeoutPeriod to 3000 seconds by modifying the service configuration used by the node.

  4. Increase the value for IFS.SERVICE.Orphan SessionTimeoutPeriod to 6000 seconds.

  5. Disable the OidCredentialManagerAgent by deselecting Initially Started for this agent in the node configuration.

  6. Start the node.

  7. Wait until very few users are using the system so that they will not be impacted by the following actions.

  8. On the Node page, start the OidCredentialManagerAgent.

  9. Wait until the odmz_oidcredential managerevnt database table has less than a thousand rows in it.

  10. Decrease the value of IFS.SERVICE.SessionOperation TimeoutPeriod to 300 seconds.

  11. Decrease the value of IFS.SERVICE.OrphanSessionTimeout Period to 600 seconds.

  12. Enable the OidCredentialManagerAgent by selecting Initially Started for this agent in the node configuration.

  13. Restart the node.

This problem only occurs when large numbers of users are first provisioned. You should not need to perform these steps more than once.


Configuration of Oracle Content Services fails when Oracle Internet Directory is in SSL-only mode.

This problem occurs because registration of the database fails.

Ensure that Oracle Internet Directory is in non-SSL mode before configuring Oracle Content Services. You can change Oracle Internet Directory back to SSL mode after Oracle Content Services configuration is complete.

4477176

Turning on BFILE aging causes the Content Agent to log exceptions.

Turning on BFILE aging results in the Content Agent to log the following exception: IFS-21011: Unable to dynamically invoke method DYNMoveContentToBfile on oracle.ifs.server.S_TieMediaBlob.

The file is not moved to BFILE, but remains stored as a LOB.

None

4515866

Turning on EMC Retention Storage does not move the content of the record to the EMC storage device.

Configuring the system to use the EMC storage device for Oracle Records Management leaves the contents of the record stored in the database as a LOB. The content is not moved to EMC.

None

4500317


5.4 Globalization Issues in Oracle Content Services

The following table lists Oracle Content Services globalization issues.

Table 5-2 Globalization Issues in Oracle Content Services

Description Action Bug Number

Users with multibyte or high-ASCII characters in their user names may not be able to sign on to Oracle Content Services using service-to-service authentication.

This affects logins though the Content Searchlet and Web services, both of which use service-to-service authentication.

Set the default character set on the calling system to UTF-8 or to a character set that can properly encode the characters in the username. This will ensure that the username is properly encoded when being passed from the calling system to the called system for service-to-service authentication.

4467233

Cannot use FTP or WebDAV with multibyte user names.

Users with multibyte user names cannot sign on to Oracle Content Services using FTP or WebDAV.

Do not create user names that contain multibyte characters.

4340204


5.5 Documentation Issues in Oracle Content Services

The following sections describe documentation issues for Oracle Content Services:

5.5.1 Documentation Contains References to Features Available Only for Preview

In some cases, Oracle Content Services documentation, including Oracle Content Services manuals, Oracle Content Services online help, and Oracle Content Services information in Oracle Collaboration Suite manuals, contains references to features that are only available for preview through the Oracle Sales organization. For example, Oracle Content Services Administrator's Guide contains references to OC4J_RM, an OC4J instance that supports the Oracle Records Management Web interface, and Oracle Collaboration Suite Concepts Guide contains references to Oracle Drive.

5.5.2 Using Protocols with Required Categories

The following additional information has become available and will be added to the Oracle Content Services documentation at the first available opportunity:

If you define a policy on a folder or Library that requires users to enter data associated with uploaded content, users will not be able to place content in that folder or Library using FTP or WebDAV. This limitation is due to the fact that the FTP and WebDAV protocols do not provide a facility to enter metadata.

5.5.3 Configuring Oracle Content Services Through the Oracle Collaboration Suite Control

The following additional information has become available and will be added to the Oracle Content Services documentation at the first available opportunity:

After you configure Oracle Content Services using the Oracle Collaboration Suite Control, you must restart the Oracle HTTP Server in order to access Oracle Content Services through Web services or WebDAV.

5.5.4 Configuring Oracle Workflow After Applications Tier Deinstallation

The following additional information has become available and will be added to the Oracle Content Services documentation at the first available opportunity:

If you choose to deinstall an Oracle Content Services Applications tier on which Oracle Workflow has been configured, Oracle Workflow is also deinstalled from that Applications tier.

If you had only one Applications tier, and you choose to reinstall and reconfigure Oracle Content Services, Oracle Workflow will be automatically reconfigured.

If you have multiple Oracle Content Services Applications tiers, Oracle Workflow will not be configured automatically, even if you reinstall and reconfigure Oracle Content Services on a new Applications tier. Instead, you must manually configure Oracle Workflow by running the Oracle Workflow Configuration Assistant on one of the Oracle Content Services Applications tiers. Note the following:

  • Be sure to choose the Mid-tier Only option in the Oracle Workflow Configuration Assistant when you perform this task.

  • If you were previously using the Oracle Workflow notification mailer, you must reconfigure the notification mailer. See Oracle Content Services Administrator's Guide for more information about how to perform this task.

5.5.5 Considerations Related to Applications Tier Deinstallation

The following additional information has become available and will be added to the Oracle Content Services documentation at the first available opportunity:

When you first configure Oracle Content Services, the first Applications tier that you configure contains important configuration settings that are not stored in subsequent Applications tiers. Because of this, if you choose to deinstall the first Oracle Content Services Applications tier, you must ensure these configuration settings are restored on another Applications Tier. The following list summarizes these configuration settings:

  • The Oracle Internet Directory Service Registry may contain Oracle Content Services Web application URLs that point to the Applications tier you deinstalled. If this is the case, you must change these URLs to point to another Oracle Content Services Applications tier. For more information about how to change URLs in the Oracle Internet Directory Service Registry, see Oracle Collaboration Suite Administrator's Guide.

  • The IFS.DOMAIN.APPLICATION.ApplicationHost domain property may point to the Applications tier you deinstalled. If this is the case, you must update this domain property to point to another Oracle Content Services Applications tier.

  • If you were running some or all of the Oracle Content Services agents on the Applications tier you deinstalled, you must configure these agents to run elsewhere. To do this, modify the node configuration of a node running on another Oracle Content Services Applications tier.

  • If you collected domain and repository metrics on the Applications tier you deinstalled, you must configure these metrics on another Oracle Content Services Applications tier.

  • If you were running Oracle Mail on the Applications tier you deinstalled, you must update the IFS.DOMAIN.EMAIL.SmtpHost and IFS.DOMAIN.EMAIL.SmtpPort domain properties to point to another SMTP server.