Skip Headers

Oracle Content Management SDK Release Notes
10g (9.0.4)
Part Number B10691-01

Oracle® Content Management SDK

Release Notes

10g (9.0.4) for Solaris Operating System (SPARC 32-bit and SPARC 64-bit)

November 2003

Part No. B10691-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/

This document is specific to Oracle Content Management SDK 10g (9.0.4) for Solaris Operating System (SPARC 32-bit and SPARC 64-bit). It covers the following topics:

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Standards will continue to evolve over time, and Oracle Corporation is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For additional information, visit the Oracle Accessibility Program Web site at:

http://www.oracle.com/accessibility/

About Oracle Content Management SDK

Oracle Content Management SDK (Oracle CM SDK) is a robust development platform for building content management applications. It provides a set of Java APIs for versioning, check-in/check-out, security, searching, extensible metadata and other standard content management operations. Oracle CM SDK provides:

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

Prior to version 9.0.3, Oracle CM SDK was known as Oracle Internet File System (Oracle 9iFS).

Warning

A significant difference between Oracle CM SDK 10g (9.0.4) and earlier versions of the Oracle Internet File System (9.0.2 and before) is that the default Web user interface has been replaced with the Web Starter Application. For more information, see the ReadMe file included with the Web Starter Application sample code.

In addition, the Windows UI is not available in this release.

Installation Warning

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

Please note the following recommendations:

See the Oracle Content Management SDK Installation and Configuration Guide for detailed upgrade information.

What's New in Oracle Content Management SDK 10g (9.0.4)

Oracle Content Management SDK 10g (9.0.4) provides the following new features:

Developing Against Oracle Content Management SDK

Oracle CM SDK provides a platform for building custom applications. To remain compatible with future releases of Oracle CM SDK, follow these guidelines:

Certification and System Requirements

Use Oracle9i Database Server release 9.0.1.4 or 9.2.0.3 (or later) as the database tier for Oracle CM SDK. Oracle CM SDK is certified with Oracle Workflow 2.6.2 and 2.6.3.

To find out which versions of Oracle Application Server, Infrastructure are certified, see the latest Oracle Application Server 10g certification information on OracleMetaLink at http://metalink.oracle.com.

Client Certifications

The following client software has been tested and certified for Oracle CM SDK. Higher operating system and application service pack and minor version number releases are supported.

SMB

  1. Microsoft Windows NT 4.0 Workstation Service Pack 6a with:

    • Microsoft Office 2000 Service Pack 3, including:

      • Microsoft Word 2000

      • Microsoft Excel 2000

      • Microsoft PowerPoint 2000

      • Microsoft FrontPage 2000

  2. Microsoft Windows 2000 Professional Service Pack 3 with:

    • Microsoft Office 2000 Service Pack 3, including:

      • Microsoft Word 2000

      • Microsoft Excel 2000

      • Microsoft PowerPoint 2000

      • Microsoft FrontPage 2000

    • Microsoft Office XP Service Pack 2, including:

      • Microsoft Word 2002

      • Microsoft Excel 2002

      • Microsoft PowerPoint 2002

      • Microsoft FrontPage 2002

    • Microsoft Visio 2000, 2002

    • Microsoft Project 2000, 2002

    • Adobe Acrobat 5.0

  3. Microsoft Windows XP Professional Service Pack 1 with:

    • Microsoft Office 2000 Service Release 1, including:

      • Microsoft Word 2000

      • Microsoft Excel 2000

      • Microsoft PowerPoint 2000

      • Microsoft FrontPage 2000

    • Microsoft Office XP Service Pack 2, including:

      • Microsoft Word 2002

      • Microsoft Excel 2002

      • Microsoft PowerPoint 2002

      • Microsoft FrontPage 2002

    • Microsoft Visio 2000, 2002

    • Microsoft Project 2000, 2002

    • Adobe Acrobat 5.0

Web Browsers (for Oracle CM SDK Manager and Application Server Control)

  1. Microsoft Windows

    • Netscape Communicator 7.0x

    • Mozilla 1.4

    • Microsoft Internet Explorer 5.5 Service Pack 2 (and later)

  2. Macintosh

    • Microsoft Internet Explorer 5.2

  3. Linux

    • Netscape Communicator 7.0x

    • Mozilla 1.4

  4. UNIX

    • Mozilla 1.4

Web Browsers (for Web Starter Application)

  1. Microsoft Windows

    • Microsoft Internet Explorer 5.5 Service Pack 2 (and later)

FTP Clients

  1. Windows

    • OnNet FTP 4.0

    • WS_FTP Pro 7.6

    • Cute FTP XP 5.0

    • Hummingbird 7.0

  2. UNIX

    • Command line ftp Solaris 2.8, 2.9

  3. Macintosh OS X.2

    • Transmit 2.5.1

AFP

  1. Mac OS X.2 with Microsoft Office Mac X, including:

    • Microsoft Word for Mac OS X

    • Microsoft Excel for Mac OS X

    • Microsoft PowerPoint for Mac OS X

NFS Client Support

  1. Microsoft Windows

    • Hummingbird NFS Maestro 6.0 (Windows 98, NT)

    • Hummingbird NFS Maestro 7.0 (Windows NT/2000)

    • OnNet 7.0 (Windows 2000 only)

  2. UNIX

    • Solaris 2.8 and 2.9

    • Linux Advanced Server 2.1, Kernel 2.4.9-e.16

    • Linux Red Hat 8.0

WebDAV: Web Folders

  1. Windows XP Professional Service Pack 1

    • Microsoft Office XP Service Pack 2, with Microsoft Internet Explorer 6.02 Service Pack 1 and MSDAIPP.DLL version 10.145.3914.17 with:

      • Microsoft Word 2002

      • Microsoft Excel 2002

      • Microsoft PowerPoint 2002

      • Microsoft FrontPage 2002

      • Microsoft Visio 2002

      • Microsoft Project 2002

      • Adobe Acrobat 5.0

    • Microsoft Office 2000 Service Release 1, with Microsoft Internet Explorer 6.02 Service Pack 1 and MSDAIPP.DLL version 8.103.5219.0

      • Microsoft Word 2000

      • Microsoft Excel 2000

      • Microsoft PowerPoint 2000

      • Microsoft Visio 2000

      • Microsoft Project 2000

      • Adobe Acrobat 5.0

  2. Microsoft Windows 2000 Professional Service Pack 3

    • Microsoft Office XP Service Pack 2, with Microsoft Internet Explorer 6.02 Service Pack 1 and MSDAIPP.DLL version 10.145.3914.17 with:

      • Microsoft Word 2002

      • Microsoft Excel 2002

      • Microsoft PowerPoint 2002

      • Microsoft FrontPage 2002

      • Microsoft Visio 2002

      • Microsoft Project 2002

      • Adobe Acrobat 5.0

    • Microsoft Office 2000 Service Pack 3, with Microsoft Internet Explorer 5.5 Service pack 2 and MSDAIPP.DLL version 8.103.3521.0 with:

      • Microsoft Word 2000

      • Microsoft Excel 2000

      • Microsoft PowerPoint 2000

      • Microsoft Visio 2000

      • Microsoft Project 2000

      • Adobe Acrobat 5.0

  3. Microsoft Windows NT 4.0 Workstation Service Pack 6a with:

    • Microsoft Office 2000 Service Pack 3, with Microsoft Internet Explorer 5.5 Service pack 2 and MSDAIPP.DLL version 8.103.3521.0 with:

      • Microsoft Word 2000

      • Microsoft Excel 2000

      • Microsoft PowerPoint 2000

      • Microsoft FrontPage 2000

WebDAV: Oracle FileSync Client

  1. Windows XP Professional Service Pack 1

  2. Windows 2000 Professional Service Pack 3

  3. Windows NT Workstation Service Pack 6

  4. Windows 98

Email Clients:

  1. Eudora 4.3 for IMAP, SMTP

  2. PINE 4.33 for IMAP, SMTP

  3. Outlook Express 6.0 (and later) for IMAP, SMTP

  4. Outlook 2000 for IMAP, SMTP

  5. Netscape Communicator 7.0 (and later)

Command-Line Utility Client

  1. MS Windows NT

  2. MS Windows 2000, XP, 2003

  3. Solaris 2.8, Solaris 2.9, Linux Advanced Server 2.1

Javadoc Links

In some versions of the Internet Explorer browser or Windows 2000 operating system, the links in the Oracle CM SDK Javadoc do not work. To avoid this problem, do not use the following browsers:

To view the Javadoc, Oracle recommends that you use one of the following:

Deprecations and Changes in Oracle Content Management SDK

As the Oracle CM SDK Java API grows to take advantage of new features and technology, certain classes, attributes, and methods might 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 changes and deprecations are described below.

Changes to AFP Support

AppleTalk Filing Protocol (AFP) will not be supported in future releases of Oracle CM SDK. In future releases, Mac users will be able use SMB or WebDAV.

Deprecations to FTP Commands

The following FTP QUOTE commands are deprecated in this release, and will be deleted in a future release:

Deprecated Class: SearchObject

The SearchObject class and its related classes have been deprecated. Due to the restriction that a SearchObject is only guaranteed to work within the same version of Oracle CM SDK and is not upwardly compatible, its benefits are limited, and the classes will be deleted in a future release.

If your application uses SearchObject, your options are to modify your application to either:

Future Changes in the Usage of Definition Classes

The next major release of Oracle CM SDK will include changes to the use of Definition classes. Definition classes are the subclasses of oracle.ifs.beans.LibraryObjectDefinition that are used to create new and to modify existing Oracle CM SDK instances. In previous versions of Oracle CM SDK, these Definition classes had an unpublished zero argument constructor defined. This meant that a statement such as the following would compile and (in most cases) execute successfully: 

DocumentDefinition def = new DocumentDefinition();

This has never been a legal or recommended variant of construction, but in most circumstances it would yield reasonable results. In some circumstances, using definition instances constructed in this manner could result in obscure exceptions.

The correct method of constructing definition objects is to use the published constructor variant that takes a single LibrarySession argument.

In the next major version of Oracle CM SDK, these zero argument variants will be removed, and any code that attempts to use them will result in compilation errors.

Additionally, in the next major version of Oracle CM SDK, the published constructor variant will be changed from taking a oracle.ifs.beans.LibrarySesssion argument to a oracle.ifs.common.LibrarySessionInterface argument. Since LibrarySession implements the LibrarySessionInterface, no code changes are necessary. However, this change will require a re-compilation of any code written against Oracle CM SDK that constructs definition instances.

New Class: LockObject

A new class, LockObject, was introduced with the 9.0.3 release. This class is used to manage the following lock types available to a PublicObject:

See the LockObject Javadoc for more information.

Parsing/Rendering in the Protocol Servers

Most Oracle CM SDK protocol servers (FTP, SMB, etc.) no longer perform parsing and rendering as a side effect of transferring files. In previous releases, an XML document uploaded through the protocols was parsed automatically. Starting with the 9.0.3 release, this is no longer the case.

An exception to this deprecation is the Command-Line Utilities Protocol (CUP) server. To continue parsing and rendering XML files, you can use the CUP server. To create Oracle CM SDK objects through XML files, upload your XML file using CUP. CUP also continues to render out objects in XML.

Parsing/Rendering Framework in Oracle CM SDK

The purpose of the parsing/rendering framework in 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 do so 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 Oracle CM SDK 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.

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 in Table 1, " Installation and Configuration Bugs" can be fixed by upgrading the database instance supporting Oracle Internet Directory to release 9.0.1.4 of the Oracle9i Database Server.

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: 

$ 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 can 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 the Oracle Internet Directory Administrator's Guide.

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:

Oracle is a registered trademark, and Oracle9i and OracleMetaLink are trademarks or registered trademarks of Oracle Corporation. Other names may be trademarks of their respective owners.

Copyright © 1999, 2003 Oracle Corporation.

All Rights Reserved.

Oracle
Copyright © 1999, 2003 Oracle Corporation.
All Rights Reserved.