Oracle^® Content Management Software Development Kit
(Oracle CM SDK)

Release Notes Release 9.0.3.1.0 for Windows NT/2000

November 2002

Part No. B10052-01

Overview

This document is accurate to the best of our knowledge at the time of publication. Information that is discovered subsequent to publication will be available through regular support channels. You can access the latest information and additions to Release Notes on the Oracle Technology Network at:

http://otn.oracle.com/products/ifs/content.html

This document is specific to Release 9.0.3.1.0 of the Oracle Content Management Software Development Kit (Oracle CM SDK), formerly Oracle Internet File System, for Windows NT/2000. It includes information about:

• The Oracle CM SDK Explained

• What's New in Oracle CM SDK 9.0.3.1.0

• Developing Against the Oracle CM SDK

• Certification and System Requirements

• Deprecations and Changes in the Oracle CM SDK Java API

• Installation and Configuration Issues

• General Issues

• Oracle Internet Directory Issues

• NLS Issues

• Client-specific Issues

• Documentation Issues

• Known Bugs

The Oracle CM SDK Explained

The Oracle Content Management SDK (abbreviated Oracle CM SDK) is the new name for the Oracle Internet File System (Oracle 9iFS), changed to better reflect its capabilities. For Oracle CM SDK, however, some components have been removed or modified, so you should read the warnings below for further details.

Oracle CM SDK now ships exclusively with the Oracle9i Application Server (9iAS). Both 9iAS and Oracle CM SDK are designed for the same audience: developers building middle-tier applications. Oracle CM SDK includes:

• A robust, Java-based API providing document life-cycle management.

• Extensive developer documentation, Javadoc, and examples.

• Integration with other Oracle content management technologies (for example, Workflow, Text).

• Scalability, reliability, security, and platform independence that the Oracle9i Database Server and Application Server both provide.

• Protocol servers (for example, HTTP/WebDAV, FTP) to provide native access to the Oracle CM SDK repository.

These features and capabilities are designed to help developers bring content management-based applications to market faster and better than with any other platform.

Warning

A significant difference between Oracle CM SDK 9.0.3.1.0 and earlier versions of the Oracle Internet File System is the unavailability of two components:

• the Web user interface;

• the desktop plug-in for Microsoft Explorer (also known as the Windows UI).

Replacements for both components are currently planned. However, based on customer feedback and other factors, plans may change. Check with your Oracle representative or on the Oracle Technology Network Web site (http://otn.oracle.com) for more details.

Installation Warning

Before you upgrade from earlier versions of Oracle 9iFS to Oracle CM SDK 9.0.3.1.0, be aware that if you are depending on features unavailable in 9.0.3.1.0 (such as the Web UI or the Windows UI), you should not upgrade. Once you have upgraded the schema to Oracle CM SDK 9.0.3.1.0 (the first step in the installation process), you will not be able to run components certified against 9iFS versions 9.0.2 and earlier.

The current 9iAS CD Pack includes CDs for both Oracle Internet File System Release 9.0.2 and Oracle CM SDK Release 9.0.3.1.0. Please note the following recommendations:

• Do not upgrade to Oracle CM SDK 9.0.3.1.0 if you require 9.0.2 components unavailable in this release.

• Do not install both versions of the product in the same Oracle home or on the same machine.

• If you install both versions of the product on different machines, they cannot point to the same schema.

Introducing Oracle Files

Simultaneous with the release of Oracle CM SDK 9.0.3.1.0, Oracle is also releasing a new application, Oracle Files 9.0.3.2.0. Built using the Oracle CM SDK, Oracle Files is designed to be a packaged solution, not a bundle of APIs for development. Oracle Files is designed as an enterprise file server replacement, with added content management features (for example, versioning) that enable users to collaborate more productively.

Oracle Files includes:

• Support for the file-sharing and collaboration protocols provided in Oracle CM SDK.

• A new Web UI, designed for large-scale deployments.

• Workspace-based collaboration.

• Content management features like extensible metadata, versioning, and content-based searching.

• Workflow integration for approval and routing.

• User and administrator options for single file recovery.

• The same scalability, reliability, security, and platform independence provided by Oracle CM SDK.

These features and capabilities are designed to help IT managers lower costs through file server consolidation while simultaneously making employees more productive.

Oracle Files ships and is licensed with Oracle's new, fourth business, the Oracle Collaboration Suite.

What's New in Oracle CM SDK 9.0.3.1.0

New features in Oracle Content Management SDK 9.0.3.1.0 include:

• Queue Framework. Oracle CM SDK now provides a messaging based integration point. Queue framework is built on Oracle Advanced Queues (AQ) technology, a feature of the Oracle database. Queue framework can be used to integrate external applications with applications using Oracle CM SDK.

• Offline storage of content. Oracle CM SDK now includes an agent that can move content not accessed for a specified period to offline storage. This content is still accessible, but stored externally to reduce the operational load on the database.

• Print services. Customers running the SMB protocol can now use Oracle CM SDK to provide print services.

• Expanded samples. The sample code provided on the Oracle CM SDK CD have been updated and expanded.

• New parser framework. The parser framework in Oracle CM SDK has changed from previous versions. Consult the Oracle Content Management Software Development Kit Developer Reference for more details.

• Improvements in scalability. NTFS, AFP and NFS protocol servers can now support many more simultaneous users. Performance with a large number of ACLs is also now greatly improved.

Developing Against the Oracle CM SDK

Oracle CM SDK provides a platform for building custom applications. To remain compatible with future releases of Oracle CM SDK, the following guidelines must be followed:

• Use published classes and methods. Use only the classes and methods that are published in the Javadoc. There are many other classes and methods which Oracle CM SDK uses internally, but are not part of the published Javadoc. Oracle reserves the right to modify or delete unpublished classes and methods with no notice. Using these unpublished classes or methods may result in breaking your application or in undesired application behavior.

• Establish an application namespace. To avoid conflict among your own custom classes and Oracle CM SDK future class enhancements, prefix your subclasses, attributes, and database tables with a unique identifier. For example, someone working for the ACME company creates a REPORT subclass with an attribute name PRIORITY. The subclass should be named ACME_REPORT, with an attribute ACME_PRIORITY.

Also see Known Bug 1857689.

• Do not modify the Oracle CM SDK schema directly. The Oracle CM SDK schema must never be modified directly. All operations to the schema must be done through the published API.

Certification and System Requirements

Several high priority bugs are fixed in the 9.0.1.3 release of Oracle9i Database Server. You should upgrade to this release of the database as soon as it is available.

Client Certifications

The following client software has been tested and certified for Oracle CM SDK:

Microsoft Windows

• Microsoft Windows Client Operating Systems (for access to an Oracle CM SDK server through NTFS):
  • Microsoft Windows NT 4.0 Workstation or Server (Service Pack 6 and higher)

  • Microsoft Windows 95 and 98

  • Microsoft Windows 2000 Professional and Server

• Web Browsers (for FTP, IMAP4, SMTP, and HTTP):
  • Netscape Communicator 4.72 (and higher). Netscape 6.x is not supported in this release.

  • Microsoft Internet Explorer 5.0, 5.5, and 6.0; Microsoft Outlook Express 5.0.

• Email Clients:
  • Eudora 4.3 for IMAP, SMTP

  • PINE 4.33 for IMAP, SMTP

  • Outlook Express 5.0 (and higher) for IMAP, SMTP

  • Outlook 2000 for IMAP, SMTP

  • Netscape Communicator 4.7.2 and higher. Netscape 6.x is not supported in this release.

• FTP Clients:
  • OnNet FTP 4.0

  • Ipswitch WS_FTP32

• NFS Clients:
  • Hummingbird NFS Maestro 6.0 (Windows 95, 98, NT)

  • Hummingbird NFS Maestro 7.0 (Windows NT/2000)

  • OnNet 7.0 (Windows 2000 only)

Apple Macintosh

• Mac OS 9.2 and X.1 (AFP and email):
  • Netscape Communicator 4.73 release and higher (for email). Netscape 6.x is not supported in this release.

  • Microsoft Outlook Express 5.0 (email only).

UNIX NFS Client Support

• Sun Solaris 7, Solaris 8

• Red Hat Linux 6.2

Commandline Utility Client

• MS Windows NT

• MS Windows 2000

• Sun Solaris 2.6, Solaris 7, Solaris 8

Deprecations and Changes in the Oracle CM SDK Java API

As the Oracle CM SDK Java API grows to take advantage of new features and technology, certain classes, attributes, and methods may be deprecated. You should expect these deprecated elements to be deleted in the following major release. This provides you with a full release cycle to modify your applications to use the supported classes, attributes, and methods.

To see what is deprecated in this release, go to the "Deprecated" link in the Javadoc. Each deprecation has a comment indicating the equivalent supported usage. You can also check if your application is using any deprecated classes, fields, or methods by compiling your Java application with the -deprecation flag.

Some of the significant deprecations are described below.

Parsing/Rendering in the Protocol Servers

Most 9iFS protocol servers (FTP, NTFS, etc.) no longer perform parsing and rendering as a side effect of transferring files. In previous releases, an XML document uploaded through the protocols would be automatically parsed. Starting with the 9.0.3.1.0 release, this will no longer be the case.

An exception to this deprecation is the Commandline Utility Protocol (CUP) Server. To continue parsing and rendering XML files, you can use the CUP server. To create 9iFS objects through XML files, upload your XML file using CUP. CUP also continues to render out objects in XML.

Parsing/Rendering Framework in the Oracle CM SDK

The purpose of the parsing/rendering framework in the Oracle CM SDK was to allow application developers to inject behavior changes into the protocol servers when they were transferring files. Since the protocol servers no longer support this feature, the following deprecations apply for this release.

Interfaces

oracle.ifs.beans.parsers.Parser 
oracle.ifs.beans.parsers.ParserCallback 
oracle.ifs.beans.parsers.XmlParserInterface 
oracle.ifs.server.renderers.Renderer 

Classes

oracle.ifs.beans.parsers.IfsSimpleXmlParser      
oracle.ifs.beans.parsers.IfsXmlParser 
oracle.ifs.beans.parsers.LiteralDocumentParser 
oracle.ifs.beans.parsers.ParserInputStream 
oracle.ifs.server.renderers.BaseRenderer 
oracle.ifs.server.renderers.SimpleXmlRenderer 
oracle.ifs.server.renderers.XmlRenderer 

Application developers who need to modify the contents of files as they are stored and/or retrieved can still by directly modifying the input stream as the document is being uploaded or downloaded.

PendingPublicObject attribute on the VersionSeries class

This attribute has been deprecated. It was designed to allow for a "working copy" of a versioned document to be maintained inside 9iFS while a versioned document was checked out. All protocol servers have been enhanced to recognize the existence of this object, but not to create them. If you have a custom application that makes use of this attribute, you are encouraged to develop an alternative implementation before upgrading to the next major release of Oracle CM SDK.

Change in Delimiters for Service Configuration Properties

For better readability, Oracle CM SDK now accepts spaces in service configuration properties. For example, a property value can have the following value:

IFS.SERVICE.CREDENTIALMANAGER.Oid.Subscribers = DEFAULT SUBSCRIBER

Prior to this release, spaces were used to separate alternate values of a property. With this release, commas alone function as delimiters. If an existing property uses a space as a delimiter, you will need to change it to a comma.

Installation and Configuration Issues

Here are some issues to be aware of before you attempt to install and configure Oracle CM SDK.

Oracle Internet Directory and Oracle CM SDK Issues

Before you attempt to install and configure Oracle CM SDK, you should be aware of several issues with respect to Oracle Internet Directory and Oracle CM SDK. See specifically Known Bugs 2282201, 2100615 and 2212389, 2286968 in the "Installation and Configuration Bugs" section. These bugs will be fixed by upgrading the database instance supporting Oracle Internet Directory to release 9.0.1.3 of the Oracle9i Database Server, which you should do as soon as it is available.

General Issues

Here are some general operations and administration issues to be aware of before using Oracle CM SDK.

Oracle CM SDK User Names Cannot Contain Multi-byte Characters

Although Oracle CM SDK supports multi-byte character sets, it does not effectively support user account names created using multi-byte characters. When you create user accounts for Oracle CM SDK, you should create the names using single-byte characters only. Users whose account names are created with multi-byte characters are unable to access content through many of the Oracle CM SDK protocol servers.

Oracle Internet Directory Issues

See the Oracle Internet Directory Release Notes for complete information on all known issues. This section covers only those issues specific to Oracle CM SDK. Note that several bugs listed later, in the "Installation and Configuration Bugs" section, will be fixed by upgrading the database instance supporting Oracle Internet Directory to release 9.0.1.3 of the Oracle9i Database Server as soon as it is available.

Use Oracle CM SDK-specific Passwords with Certain Protocol Servers

Many protocols, including AFP, CUP, FTP, and IMAP, transmit unencrypted passwords over the network. Other protocols, such as HTTP and SMB, also transmit user passwords in the clear (unencrypted, as cleartext) in some configurations.

From a security standpoint, transmitting unencrypted passwords becomes a concern when Oracle CM SDK uses Oracle Internet Directory to manage user passwords because the same password that provides access to Oracle CM SDK also provides access to all other applications using Oracle Internet Directory for authentication.

To address this issue, Oracle Internet Directory supports an alternate, application-specific password for each user. Oracle CM SDK supports this feature of Oracle Internet Directory. The alternate password for Oracle CM SDK is referred to as the "Oracle CM SDK-specific password." Thus, each Oracle CM SDK user can have two passwords: an Oracle Internet Directory common password, and an Oracle CM SDK-specific password.

You can configure Oracle CM SDK to use the Oracle Internet Directory common password or to use the Oracle CM SDK-specific password on a protocol-by-protocol basis. By default, AFP, CUP, FTP, and IMAP use the Oracle CM SDK-specific password; all other protocols use the Oracle Internet Directory common password. Consequently, users cannot access Oracle CM SDK using AFP, CUP, FTP, or IMAP protocols until they have set their Oracle CM SDK-specific password, using the Oracle CM SDK Manager. See the Oracle Content Managment SDK Installation Guide for additional information.

The default Oracle Internet Directory configuration may not be appropriate for all Oracle CM SDK deployments. You can change the configuration using the Oracle CM SDK Credential Manager Configuration Assistant. See Appendix B in the Oracle Content Managment SDK Installation Guide for additional information.

Using the Oracle Internet Directory User Migration Tool

Oracle Internet Directory is configured with default password policies, which can be changed by the Oracle Internet Directory administrator. Be sure to check with the Oracle Internet Directory administrator before migrating Oracle CM SDK to Oracle Internet Directory to ensure that the password policies in force during migration will support the passwords used by Oracle CM SDK users. For example, if the Oracle Internet Directory requires numeric values in passwords, the Oracle CM SDK user passwords must also have numeric values. Or, alternatively, the password policies in Oracle Internet Directory must be modified or disabled during migration.

In addition, when the Oracle Internet Directory User Migration Tool migrates users from the Oracle CM SDK Credential Manager to the Oracle Internet Directory Credential Manager, it does not remove the migrated users' information from the Oracle CM SDK Credential Manager. If a migrated user is subsequently deleted and a new user with the same distinguished name is then created using the Oracle CM SDK Credential Manager, the following exception is thrown:

 IFS-10154: Unable to create user (username) 
 IFS-10172: Distinguished name not unique 

To work around this, the Oracle CM SDK administrator must explicitly delete the Oracle CM SDK Credential Manager information for the deleted user by calling the DYNCredentialManagerDeleteUser method of oracle.ifs.server.S_LibrarySession.

For specific instructions on how to migrate users from the Oracle CM SDK Credential Manager to the Oracle Internet Directory Credential Manager, see Chapter 6 of the Oracle Content Management SDK Administration Guide.

Running Oracle Internet Directory Replication Server to Purge Oracle Internet Directory Change Log

Oracle CM SDK relies on the Provisioning Integration Service provided by the Directory Integration Platform to be notified of user and group changes in Oracle Internet Directory. These changes are stored in the Oracle Internet Directory change log and are appropriately filtered by the Provisioning Integration Service before being delivered as change events to this application. Even if you are not deploying the Oracle Internet Directory server in replication mode, make sure that the directory administrator starts up the replication server in order to periodically purge unnecessary change-log entries.

This can be done by starting the replication server using the following command:

prompt>oidctl connect=net_service_name server=oidrepld instance=1 
flags="-p ldapserver_port_number" start 

Without this periodic cleanup, the Oracle Internet Directory change-log can potentially grow to occupy the entire file system, which may cause unavailability of the Oracle Internet Directory service. The need to start the replication server to purge the change-log is only a temporary restriction and will be removed in a future release.

For more information on starting and stopping the replication server, see Oracle Internet Directory Administrator's Guide.

NLS Issues

Here are some issues relevant to Oracle CM SDK and National Language Support (NLS).

Jagged Bold/Italic Fonts

When running in Japanese, Simplified Chinese, Traditional Chinese, and Korean environments, bold or italicized fonts in the Java applications appear jagged, and are difficult to read. This problem is visible for all Java applications, including Configuration Assistants, Oracle FileSync, and the Admin browser.

This issue is caused by problems in the 1.3.1_02b version of the JDK, and can be resolved by moving to JDK 1.3.1_04. This problem will be fixed in future releases of the product.

See also known bugs 2377003, 2293628, and Base Oracle bug 2220343.

Character Set Limitations

Oracle CM SDK does not support AL32UTF-8 databases for Asian languages. Oracle Text does not support Chinese, Japanese, and Korean lexers on AL32UTF-8 databases. On such databases, Chinese, Japanese, and Korean documents will not be indexed or searchable. UTF-8 is the recommended character set for Unicode-based file systems. See also known bugs 2391425 and 1926886.

If you are developing in an NLS environment, you may need to modify your CLASSPATH to include nls_charset12.zip. The Oracle JDBC class file classes12.zip only provides support for the following commonly used character sets:

• US7ASCII

• WE8DEC

• ISO-LATIN-1

• UTF-8

This file, nls_charset12.zip, provides support for all Oracle character sets. If you are using a character set other than the ones listed above, modify your CLASSPATH to include nls_charset12.zip.

Client-specific Issues

Here are some client-specific issues that you should be aware of before using Oracle CM SDK.

Oracle FileSync Utility Issues

The Oracle FileSync utility is able to detect changes made by you on your local machine and by you or others on Oracle CM SDK and, generally, is able to resolve any conflict in these changes. However, certain types of changes may conflict and cannot currently be resolved by Oracle FileSync. In these cases, Oracle FileSync only gives you the option to "skip" synchronizing these file changes.

The following types of conflicts are currently not resolvable ("source" means the original file; "target" means the resulting file):

• NEW/DELETE (when target of NEW conflicts with source of DELETE). For example, when a local folder and an Oracle CM SDK folder are in sync, and a user creates a new file in the local folder, but the folder on Oracle CM SDK is deleted. This conflict is not currently resolvable.

• NEW/COPY (when target of NEW conflicts with source or target of COPY).

• NEW/EDIT (when target of NEW conflicts with target of EDIT).

• NEW/MOVE (when target of NEW conflicts with source or target of MOVE).

• MOVE/EDIT (when target of EDIT conflicts with source or target of MOVE).

• MOVE/DELETE (when source of DELETE conflicts with source or target of MOVE).

• MOVE/MOVE (when both source and target of both MOVEs cause possible conflict).

• COPY/COPY (when both source and target of both COPYs cause possible conflict).

• COPY/DELETE (when source of DELETE conflicts with source or target of COPY).

• COPY/EDIT (when target of EDIT conflicts with source or target of COPY).

• COPY/MOVE (when both source and target of COPY and MOVE cause possible conflict).

Documentation Issues

Some graphics, diagrams, and text in Oracle CM SDK documentation and online help may still feature the Oracle Internet File System name. This material will be updated with the next release.

Known Bugs

The following bugs are known to exist in this Oracle CM SDK release. Workarounds are given when appropriate. The known bugs are grouped by process or component:

• Installation and Configuration Bugs

• Administration Bugs

• AFP Bugs

• NFS Bugs

• E-mail Bugs

• Generic Oracle CM SDK Bugs

• HTTP Bugs

• Windows / NTFS Bugs

• Oracle FileSync Bugs

• XML Bugs

Installation and Configuration Bugs

<linkFactory class = 
"oracle.ifs.clients.webadmin.WebAdminLinkFactory" 

parentName="allTargets"/> 

<targetDisplayBase type="oracle_ifs" 

pageName="ias/oracle_ifs/ifsdc" 

defaultEvent="doLoad"/> 

<targetDisplayBase type="oracle_ifsnode" 

pageName="ias/oracle_ifs/ifsnode_st" 

defaultEvent="doLoad"/> 

jewt.jar
repos.jar
utils.jar
webadmin.jar in

prompt>emctl stop

ORACLE_HOME\ifs\cmsdk\bin\ifsca.bat

prompt>emctl start

Administration Bugs

emd_oracle_home\assistants\repca

ORACLE_HOME\ifs\bfile\ifs_schema\media 

AFP Bugs

NFS Bugs

Bug 1749601	Unable to chgrp in iFS NFS.
Description:	A chgrp does not have any effect on mode for a file.
Action:	None. The security model is different and this has no impact.
Bug 1749621	Unable to chmod in iFS NFS.
Description:	A chmod does not have any effect on mode for a file.
Action:	None. The security model is different and this has no impact.
Bug 1750049	Mode attributes cannot be set.
Description:	Cannot change the permission mode bits through iFS NFS.
Action:	None. The security model is different and this has no impact.
Bug 1749778	Links cannot be created using iFS NFS.
Description:	No links (symbolic, soft, or hard) can be create in iFS NFS.
Action:	None. This problem is due to the nature of the underlying infrastructure.
Bug 2333774	Cannot copy files or folders where non-standard ASCII character is the first character in the name.
Description:	Folders and files that have non standard ASCII characters as the first character cannot be copied using NFS Maestro.
Action:	Use other NFS clients; this problem appears to be a Maestro limitation.

E-mail Bugs

Generic Oracle CM SDK Bugs

ERROR at line 1: 
ORA-00604: error occurred at recursive SQL 
level 1 
ORA-24005: must use DBMS_AQADM.DROP_QUEUE_TABLE 
to drop queue tables 

ORACLE_HOME\jdbc\lib\nls_charset12.jar 

HTTP Bugs

Bug 2337719	URLS with semi-colons return a 404 error.
Description:	URLs that have ';' embedded in them will cause problems.
Action:	None. This bug stems from a problem in the underlying OC4J layer of the software.
Bug 2386806	URLS with '%' in them do not work.
Description:	URLS that have '%' embedded will cause problems.
Action:	None. This bug stems from a problem in the underlying OC4J layer of the software.
Bug 2461169	Uninformative errors when over quota.
Description:	Incorrect errors are reported when an attempt is made to save a new document, if user is over quota.
Action:	None. This bug stems from a problem in the underlying OC4J layer of the software.

Windows / NTFS Bugs

Oracle FileSync Bugs

XML Bugs

Oracle is a registered trademark, and Oracle9i, PL/SQL, and SQL*Plus are trademarks or registered trademarks of Oracle Corporation. Other names may be trademarks of their respective owners.

Copyright © 1999, 2002 Oracle Corporation.

All Rights Reserved.

All Rights Reserved.