Skip Headers
Oracle® Content Management SDK Release Notes
10g (9.0.4.2) for Microsoft Windows (64-bit) on Intel Itanium
B25609-02
 

 

Oracle® Content Management SDK

Release Notes

10g (9.0.4.2) for Microsoft Windows (64-bit) on Intel Itanium

B25609-02

November 2005

This document provides release note information for Oracle Content Management SDK 10g (9.0.4.2).

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://www.oracle.com/technology/index.html

It covers the following topics:

1 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. Accessibility standards will continue to evolve over time, and Oracle 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 more information, visit the Oracle Accessibility Program Web site at

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

Accessibility of Code Examples in Documentation

Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

TTY Access to Oracle Support Services

Oracle provides dedicated Text Telephone (TTY) access to Oracle Support Services within the United States of America 24 hours a day, seven days a week. For TTY support, call 800.446.2398.

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

3 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:

4 Certification and System Requirements

Use Oracle Database 10g as the database tier for Oracle CM SDK.

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.

4.1 Client Certifications

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

4.1.1 NTFS

  1. 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 6.0

  2. Microsoft Windows XP Professional Service Pack 1 and 2 with:

    • Microsoft Office 2003, including:

      • Microsoft Word 2003

      • Microsoft Excel 2003

      • Microsoft PowerPoint 2003

      • Microsoft FrontPage 2003

    • Microsoft Office XP Service Pack 2, including:

      • Microsoft Word 2002

      • Microsoft Excel 2002

      • Microsoft PowerPoint 2002

      • Microsoft FrontPage 2002

    • Microsoft Office 2000 Service Release 1, including:

      • Microsoft Word 2000

      • Microsoft Excel 2000

      • Microsoft PowerPoint 2000

      • Microsoft FrontPage 2000

    • Microsoft Visio 2000, 2002, 2003

    • Microsoft Project 2000, 2002, 2003

    • Adobe Acrobat 6.0

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

  1. Microsoft Windows

    • Mozilla 1.7 (and later)

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

  2. Macintosh

    • Microsoft Internet Explorer 5.2 for Mac OS X

  3. Linux

    • Mozilla 1.7 (and later)

  4. UNIX

    • Mozilla 1.7 (and later)

4.1.3 Web Browsers (for Web Starter Application)

  1. Microsoft Windows

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

4.1.4 FTP Clients

  1. Windows

    • OnNet FTP 4.0

    • Cute FTP XP 5.0

    • Hummingbird 7.1

  2. UNIX

    • Command line FTP Solaris 2.8, 2.9

  3. Macintosh OS X.2

    • Transmit 2.5.1

4.1.5 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

4.1.6 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

    • Linux Red Hat Advanced Server 3.0

4.1.7 WebDAV: Web Folders

  1. Windows XP Professional Service Pack 1 and 2

    • 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

    • Microsoft Office 2003, with Microsoft Internet Explorer 6.02 Service Pack 1 and MSDAIPP.DLL version 11.0.551.0 with:

      • Microsoft Word 2003

      • Microsoft Excel 2003

      • Microsoft PowerPoint 2003

      • Mircrosoft FrontPage 2003

      • Microsoft Visio 2003

      • Microsoft Project 2003

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

    • 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 6.0

4.1.8 WebDAV: Oracle FileSync Client

  1. Windows XP Professional Service Pack 1

  2. Windows 2000 Professional Service Pack 3

4.1.9 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

4.1.10 Command-Line Utility Client

  1. Microsoft Windows 2000, XP, 2003

  2. Solaris 2.8, Solaris 2.9, Linux

5 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 deprecations are described below.

5.1 Changes to AFP Support

AppleTalk Filing Protocol (AFP) will not be supported in future releases of Oracle CM SDK.

5.2 Deprecations to FTP Commands

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

  • QUOTE ACL

  • QUOTE NOACL

  • QUOTE ADMIN

  • QUOTE NOADMIN

5.3 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:

  • Construct the SearchSpecification each time as needed.

  • Save the search tree in a textual format, such as XML, and save the XML in a document. The application then uses the XML to reconstruct the search tree.

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

5.5 New Class: LockObject

The LockObject class is used to manage the following lock types available to a PublicObject:

  • unlock

  • hard lock

  • soft lock

  • user lock

  • timed lock

  • session lock

See the LockObject Javadoc for more information.

5.6 Parsing/Rendering in the Protocol Servers

Most Oracle CM SDK 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 was parsed automatically.

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. CUP can be turned on or off.

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

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

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

6.1 Oracle Internet Directory Default Port Numbers

The default port number for Oracle Internet Directory on Windows is 389.

The default SSL port number for Oracle Internet Directory on Windows is 686.

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

6.3 Using 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.

7 General Issues

This section describes general operations and administration issues.

7.1 Port Number Changes

Some Oracle Application Server ports have changed for this release.

The Oracle Application Server HTTP port defaults to port 7777 if port 80 is in use. For example, if the user is running a web server on a Windows host, then Oracle Application Server will use port 7777.

The following table lists the port number changes for Oracle Internet Directory, Oracle Internet Directory SSL, and OracleAS Web Cache:

Table 1 Port Numbers

Component Windows 2003 (64-bit)

Oracle Internet Directory


389

Oracle Internet Directory SSL

636

OracleAS Web Cache (if configured)

80


8 Documentation Issues

If you have difficulty viewing any of the Oracle Content Management SDK documentation in PDF format, either upgrade to a newer version of Adobe Acrobat or use the HTML version of the documentation.

9 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:

Table 2 Installation and Configuration Bugs

Bug # Description Action

3965463

Node for non upgraded schema displays

When you start the domain for upgraded schema that is on a different middle tier, the node for non upgraded schema may display.

None.

3438355, 3921691

Oracle Text does not set its own LD_LIBRARY_PATH

When installing Oracle CM SDK, the CMSDK Configuration Assistant performs a check on the database. The check fails and the following error message displays:

Oracle Text seems to be misconfigured

Perform the following steps on the database host:

  1. Set LD_LIBRARY_PATH to include $OH/lib32:$OH/ctx/lib

  2. Set PATH to include $OH/ctx/bin

  3. Restart the database, including listener.

3824312

The CMSDK$ID Account Locks Repeatedly

If you recreate schemas with the same name, the CMSDK$ID account will lock repeatedly.

Unlock the CMSDK$ID account.

2960519

Re-use of the Oracle CM SDK schema configured and set up with the same middle tier is not supported.

If you run the Oracle CM SDK Configuration Assistant twice in the same Oracle home, against the same Oracle CM SDK domain and schema, the Agents in the local node become deactivated if the following are true:

  • The middle tier already had a node (before you ran the Oracle CM SDK Configuration Assistant a second time), with all the Agents set to run in it.

  • While running the Oracle CM SDK Configuration Assistant the second time, you selected the Run Agents checkbox.

It is strongly recommended that the Oracle CM SDK Configuration Assistant not be run more than once per Oracle home, per Oracle CM SDK domain and schema.

If you have already run the Oracle CM SDK Configuration Assistant twice and your Agents have become deactivated, you can solve the problem by going to the Application Server Control and setting all the Agents to "Active" for the affected node.

3247505

WebStarterAppServer is not always set to active.

If you choose to have HTTP nodes when upgrading the CM SDK schema to 9.0.4, WebStarterAppServer may not be set to active.

Access the Oracle Application Server middle tier console.

  1. Select Content Management SDK (SchemaName).

  2. Select Node Configuration.

  3. Select WebStarterApp Node.

  4. Select WebStarterAppServer.

  5. Set WebStarterAppServer to active.

3163780

ifsshell script must have execute permission for the CUP client on Solaris.

The umask setting on Solaris modified the default permissions for the file when it was transferred via FTP.

If you cannot run the CUP client, use the following command to make the ifsshell script executable:

chmod +x ifsshell

The ifsshell script is located in the /ifs/clients/cmdline/unix directory.

2391425

NLS: IFSCONFIG fails in Japanese environment on AL32UTF8 database.

On Oracle9i databases, Oracle Text does not support Japanese lexer on AL32UTF8 databases. Because of this, Oracle CM SDK does not support AL32UTF8 databases for Asian languages on Oracle9i databases.

Use UTF8 for the database instead of AL32UTF8, or use the Oracle10g Database Server.

2677722

"OPMN timeout exceeded" error occurs during configuration.

The OPMN timeout value is too low.

Increase the OPMN timeout value. The default value is 30 minutes.

  1. Navigate to the $OH/opmn/conf directory:

  2. Open the opmn.xml file.

  3. Edit the following parameters:

    • start timeout

    • stop timeout

  4. Restart OPMN to make the changes take effect.

2851798

The Oracle CM SDK Configuration Assistant cannot be run against a load-balanced multi-node RAC DB.

The Oracle CM SDK Configuration Assistant will not work if you are using a multi-node RAC Database and are using a load-balanced port.

During RAC configuration, set up a database server port that is not load balanced. Then, run the Oracle CM SDK Configuration Assistant against this port.

You can switch back to a non-load balanced port after configuration.

2944440

Oracle Workflow cannot use SSL-enabled Oracle Internet Directory.

Although Oracle CM SDK can work with an SSL-enabled Oracle Internet Directory instance, Oracle Workflow will only work with the non-SSL port.

Irrespective of whether Oracle CM SDK is configured to work with the SSL-enabled Oracle Internet Directory port, Oracle Workflow must be configured to work with the non-SSL Oracle Internet Directory port.

2522186

During the Oracle CM SDK configuration, the Oracle CM SDK Configuration Assistan fails and produces the following error: "Invalid password for Oracle user SYS".

The Oracle CM SDK Configuration Assistant attempts to make a connection to a database as SYSDBA using the thin JDBC driver, which fails.

  1. On the database computer, verify whether an $ORACLE_HOME/dbs/orapwdSID file exits, where SID is your database instance name. If it does not exist, run the following command as a single line at the command line on the database machine (or on each database machine in a RAC environment):

    orapwd file=%ORACLE_HOME%/dbs/orapwSID password=password entries=5
    
    

    Where SID is your database instance name, and password is the value for the database user SYS password.

  2. Run the following commands as the ORACLE operating system user (or the user who installed the database) to reset the password of the SYS user in the database and in the orapwd file:

    sqlplus /nolog
    connect /as sysdba
    ALTER USER SYS IDENTIFIED BY password
    
    

    Where password is the value for the database user SYS password.

  3. If your database is configured to use a server parameter file (spfile), then issue this command in SQL*Plus:

    alter system set REMOTE_LOGIN_PASSWORDFILE=EXCLUSIVE scope = spfile
    
    

    If your database is configured to use an init.ora file, add the following line to the init.ora file:

    REMOTE_LOGIN_PASSWORDFILE=EXCLUSIVE
    
  4. Restart your database for the changes to take effect.

2960519

Re-use of the Oracle CM SDK schema configured and set up with the same middle tier is not supported.

If you run the Oracle CM SDK Configuration Assistant twice in the same Oracle home, against the same Oracle CM SDK domain and schema, the Agents in the local node become deactivated if the following are true:

  • The middle tier already had a node (before you ran the Oracle CM SDK Configuration Assistant a second time), with all the Agents set to run in it.

  • While running the Oracle CM SDK Configuration Assistant the second time, you selected the Run Agents checkbox.

It is strongly recommended that the Oracle CM SDK Configuration Assistant not be run more than once per Oracle home, per Oracle CM SDK domain and schema.

If you have already run the Oracle CM SDK Configuration Assistant twice and your Agents have become deactivated, you can solve the problem by going to the Application Server Control and setting all the Agents to "Active" for the affected node.

3195013

Running the Configuration Assistant and reusing an existing schema disables the Web Starter Application.

The Web Starter Application is automatically configured when you set up the HTTP node in an Oracle CM SDK instance. When you reuse a schema on a mid-tier and choose to run Agents on this new node, the Web Starter Application on the previous mid-tier gets deactivated.

Log into the Application Server Control and reactivate the Web Starter Application.

  1. Access the Oracle Application Server middle tier console.

  2. Select Content Management SDK (SchemaName).

  3. Select Node Configurations.

  4. Select WebStarterApp Node.

  5. Select WebStarterAppServer.

  6. Set WebStarterAppServer to active.

3163079

Product Languages button is not used during Oracle CM SDK installation.

There is no way to select languages when installing Oracle CM SDK.

You do not need to click the Product Languages button during installation since all supported languages are automatically installed with Oracle CM SDK.

1857689

If custom classes conflict with new out-of-the-box Oracle CM SDK classes, the upgrade fails.

If custom classes created with an earlier release of Oracle Internet File System or Oracle CM SDK conflict with any classes that are new in Oracle CM SDK, the upgrade to Oracle CM SDK fails.

Prior to upgrading, the conflicting custom classes must be deleted and re-created with new names that do not conflict. The new classes added in Oracle CM SDK are:

  • interMediaAudio

  • interMediaAudioCdTrack

  • interMediaImage

  • interMediaMovie

  • interMediaSource

  • interMediaVideo

  • Link

  • MediaTextBlob

  • NodeConfiguration

  • PortletUserProfile

  • Rfc822ContentObject

  • Rfc822Message

  • ServerConfiguration

  • ServiceConfiguration

3175218

After upgrading Oracle CM SDK, the protocol servers fail to come up if you are using Oracle Internet Directory for credential management.

This is caused by the fact that the Oracle CM SDK application entity needs to be added to some Oracle Internet Directory DAS groups.

Run the ifscmca tool to re-register the application entities with the Oracle Internet Directory instance. This is a required post-upgrade step for all upgrades to Oracle CM SDK 10g (9.0.4.2).

See the Oracle Content Management SDK Administrator's Guide for more information about ifscmca.

4718632

Oracle Text check fails during CMSDK installation

When the error message is displayed, click OK to create a schema that does not have Oracle Text enabled. Note that the Search functionality of CM SDK may not work.


Table 3 Administration Bugs

Bug # Description Action

1718014

Cannot add extended attributes that are named the same as SQL reserved words.

You cannot name an attribute with Oracle reserved words such as UNIQUE and SELECT.

Choose other names for the attribute. See the Oracle9i SQL Reference for a list of reserved words.

2746006

Cannot stop the Oracle CM SDK domain if the Oracle CM SDK schema password is changed.

The schema password for Oracle CM SDK is required in order to be able to start or stop a domain.

Do not change the schema password for a running Oracle CM SDK instance.

2573630

Windows network/domain user with admin privileges cannot start the domain controller or nodes on Oracle Enterprise Manager Web site.

Additional configuration is required.

No local user can have the same name as the domain user. If there is such a local user, you need to delete or rename the local user. If the Application Server Control is running as the domain user, you need to grant the following privileges to the domain user: "act as part of the operating system" (not needed on WinXP) "replace a process level token" "increase quotas" (called "adjust memory quotas for a process" on WinXP) In addition to the "logon as batch user" privilege which is always required (for both local user or domain user) to start the domain/node from EM.

3181920

Oracle Internet Directory group name changes are not synchronized into Oracle CM SDK.

If the group name is changed in Oracle Internet Directory, the changes do not get reflected in Oracle CM SDK. This is a limitation of Oracle Internet Directory for 10g for 10.1.2.

For this release, do not change the name of Oracle Internet Directory groups (cn/dn/rdn) using ldapmodify, after CM SDK has been configured to use it.

2216321

When using the Oracle Internet Directory User Migration tool, recreating a deleted user fails.

When the Oracle Internet Directory User Migration Tool migrates users from the IfsCredentialManager to the OidCredentialManager, it does not remove the migrated users' distinguished names and passwords from the IfsCredentialManager. If a migrated user is subsequently deleted and a new user with the same distinguished name is then created using the IfsCredentialManager, the following exceptions are thrown:

  • IFS-10154: Unable to create user (username)

  • IFS-10172: Distinguished name not unique

Explicitly delete the Ifs CredentialManager entry for the previously deleted user. This can be done by calling the DYNCredentialManager DeleteUser() method of oracle.ifs.server. S_LibrarySession.

3164833

BFILE path tip text in Oracle CM SDK Manager has a typo.

The tip under BFILE Base Path on the Advanced > System > LOB Storage page contains a typo.

The text should be:

"A path can be an absolute path which starts with '/' on UNIX, or a drive letter on Windows. It can also be relative to the database's Oracle Home, by starting with './'."

2988355

Existing Oracle CM SDK users are not authenticated against Oracle Internet Directory for Oracle Collaboration Suite Releases 1-2 and Oracle Application Server 9.0.2.3.

New users that are created after Oracle CM SDK has been configured against these versions of Oracle Internet Directory will be able to authenticate. Existing users in that Oracle Internet Directory instance, however, will not be able to authenticate.

The users' password verifiers must be regenerated before they can be authenticated. Existing users must reset their passwords using oiddas.


Table 4 Generic Oracle CM SDK Bugs

Bug # Description Action

2460867, 1924737

Dropping the schema before dropping the Advanced Queues (AQ) might fail.

Dropping the schema before dropping the AQ can result in the following error:

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

If you want to drop the schema, always drop the AQ first using DropQueues.sql before dropping the schema.

Once you see this error, you cannot drop the schema. You must create a new schema.

3495915

Popup Blockers Can Cause Problems in Oracle CM SDK Manager

If you have a popup blocker installed in your browser, such as the popup blocker in the Google toolbar, it may interfere with some features in Oracle CM SDK Manager. For example, the Flashlight Lookup icon that allows you to add users to an ACL may not function.Because of this, you should disable popup blockers. For example, to disable the Google popup blocker, click Options on the toolbar, deselect Popup Blocker, and click OK.

Disable popup blocker.

2414889

Searches don't exclude AFP resource forks.

It is possible for Oracle CM SDK Advanced Searches to include AFP resource forks in search results. Any actions performed on these files will result in an error.

Ignore these files in the search results.

1724775

Content-based searches "OR-ed" with criteria that should also return non-indexed files only return indexed files.

A content-based search, such as "all files containing 'Bob'" OR-ed with an attribute search that should return non-indexed files, fails to return the non-indexed files in the search result.

Break the search into two searches, the content search and the attribute search.

1369729, 1389141

Cannot see an object to which the user has been granted access. (When a user tries to access the attribute of an object to which the user's access has been revoked, an IfsException occurs.)

If the ACL of an object is changed by one user so that the object becomes discoverable by a different user, the object might not be discoverable until the user disconnects from Oracle CM SDK and reconnects. For example, if user A changes the ACL of an item in a folder from "Private" to "Public," user B might not see that item in the folder until user B disconnects and reconnects to Oracle CM SDK.

Conversely, if user B has discovered an object whose ACL is subsequently changed by user A, causing that object to no longer be discoverable by user B, user B might continue to see that object until disconnecting and reconnecting to Oracle CM SDK. However, if user B performs an operation on that object (such as getting its name), that operation might fail and throw an IfsException, indicating the user does not have permission to perform that operation.

Disconnect and reconnect your session.

1600470

E-mail address cannot contain multibyte characters.

By default, creating a user through XML creates an e-mail address by concatenating the <Username> and the <EmailAddressSuffix> tags. If the username contains multibyte characters, then user creation fails because an e-mail address cannot contain multibyte characters.

Explicitly set the e-mail address without multibyte characters using the <EmailAdress> tag.


Table 5 AFP Bugs

Bug # Description Action

2380571

Size of Mac file does not take into account size of resource fork.

The resource fork is not being included in size computations. Because of this, the size of the document might not be accurate.

None.

1990453

File > Encrypt fails when using Mac OS Finder to encrypt files on Oracle CM SDK (mounted as AFP volume).

The Mac OS File > Encrypt utility creates temporary files containing an asterisk character (*) in their names. Because Oracle CM SDK does not allow filenames to contain an asterisk, this command fails for any Oracle CM SDK file accessed via a mounted AFP volume.

Do not encrypt a file in Oracle CM SDK from a Mac. Instead, encrypt the file locally, on the Mac, and then copy the encrypted file to the Oracle CM SDK through AFP.

2719007

The default protocol character set logic is applied globally.

The AFP server protocol (or, "command") encoding is a constant value that is applied globally for the server. Every user session that connects to the AFP server uses the same encoding; there is no way to override this encoding on a per-user or per-session basis. If there are AFP clients (Macintosh clients) that need to connect to the AFP server with a different encoding, they will not be able to do so unless the AFP server encoding is changed accordingly.

To allow multiple clients with differing encodings to use the AFP server together, you must run multiple AFP servers. To do this, use multiple middle-tier machines, each running an AFP server with the desired encoding. The AFP server encoding is specified in the property IFS.SERVER.PROTOCOL.AFP. Encoding.

2847678

AFP does not support Links.

You cannot use AFP with the new Oracle CM SDK link feature.

You will have to make copies of the files.

2995643

Microsoft PowerPoint files with long names cannot be saved directly.

PowerPoint files with file names longer than 31 characters appear truncated when you try to save using AFP. For example:

long_long_long_long_lo?5A0B.ppt

The user will be able to open the PowerPoint file and copy it to the local hard disk, just like any other file. Once opened in PowerPoint, however, if the user makes changes to the file and issues a "Save" command, an error will be displayed: "Error accessing file filename." The changes will not be saved and the original file that was opened will be deleted (moved to the Trash and renamed "PowerPoint Temp 0" or similar).

If you want to save changes and keep the file, issue a "Save As" command, either by choosing the command from the menu or toolbar, or by clicking "Yes" in the dialog box that is displayed when the file is closed. Choose a different name for the saved file. Once you do so, the new file will be saved correctly.

2463376

Finder does not refresh folder listing.

When the contents of a folder is updated by adding, removing, or modifying files, the AFP finder does not refresh the folder listing.

Log out and log back in to work around this problem.


Table 6 NFS Bugs

Bug # Description Action

3480228

File updates through Linux NFS clients overwrite the creation date.

When updating a file using standard NFS clients on Linux, the modification date is reflected as the creation date. This occurs because the file metadata is not retained.

None. This is client specific behavior.

1749601

Unable to chgrp in Oracle CM SDK NFS.

The chgrp command does not have any effect on mode for a file.

None. The security model is different and this has no impact.

1749621

Unable to chmod in Oracle CM SDK NFS.

The chmod command does not have any effect on mode for a file.

None. The security model is different and this has no impact.

1750049

Cannot set mode attributes.

Cannot change the permission mode bits through Oracle CM SDK NFS.

None. The security model is different and this has no impact.

2730990

Cannot edit links to deleted files.

Editing a link to a deleted document generates an error.

Remove links to deleted files.

1749778

Links cannot be created using Oracle CM SDK NFS.

No links (symbolic, soft, or hard) can be created in Oracle CM SDK NFS.

None. The security model is different and this has no impact.

2333774

Cannot copy files or folders where a non-standard ASCII character is the first character in the name.

Folders and files that have non-standard ASCII characters as the first character cannot be copied using NFS Maestro.

Use other NFS clients; this problem appears to be a Maestro limitation.


Table 7 HTTP / WebDAV Bugs

Bug # Description Action

2393968

URLs with '#,' '%,' or ';' in them do not work.

URLs that have these characters embedded will cause problems.

Do not use '#,' '%,' or ';' in URLs.

3006494

Cannot create multiple Web Folder mappings that use different user credentials on the same client computer.

Because of a Web Folders limitation, Oracle CM SDK does not support logging in to Web Folders as different users from the same Windows client. Web Folders caches user credentials, so if you first create a Web Folders mapping as user1, and then create a second mapping as user2, after user1's connection is disconnected, user2 is able to access user1's content.

Do not create Web Folder mappings that use different user accounts from the same client computer.

Alternatively, you can restart the Windows client machine.

2955251

Cannot connect to Oracle CM SDK through Macintosh and other WebDAV cookie-less clients.

If multiple Oracle CM SDK middle tiers are fronted by a load balancer that relies on cookies to load balance requests, WebDAV clients that do not store cookies will not be able to access that Oracle CM SDK instance via the load balancer. This may be particularly noticeable on Macintosh client machines.

Configure the load balancer to use IP addresses instead of cookies for load balancing.

2697262

WebDAV drag-and-drop download can result in 0-byte file.

Dragging a file from a Web Folder on Oracle CM SDK to the local PC file system can result in a 0-byte file if the file is locked by another user on Oracle CM SDK. This appears to be caused by MSDAIPP.DLL version 8.103.2402.

Upgrade Internet Explorer to the latest Service Pack.

Ensure the client environment conforms to the supported configuration listed in Client Certifications for WebDAV: Web Folders.

3225450

Cannot authenticate through WebDAV if Oracle CM SDK is configured to run using https.

If you have set up Oracle CM SDK to run using https, Web Folders cannot be used due to authentication problems. This is caused by a default security check that prevents the ability to authenticate using basic authentication.

  1. Log in to the Application Server Control and navigate to the Server Configurations page.

  2. Set the following Dav ServerConfiguration property to TRUE:

    IFS.SERVER.PROTOCOL.DAV. IfsServer.Auth.ClearText. Accept
    
  3. Restart OC4J_iFS_cmsdk and reload the DAV server on each middle-tier host.

For more information about setting server configuration parameters, reloading servers, and restarting the OC4J instance, see the Oracle Content Management SDK Administrator's Guide.


Table 8 NTFS Bugs

Bug # Description Action

1113581

Cannot delete or rename versioned files in NTFS.

Attempts to delete or rename a versioned file in NTFS result in a failure message indicating that all or part of the file might be locked. Certain applications, such as Microsoft Word and Microsoft Excel, save their work by deleting old versions of the document. Because this would cause a loss of data attributes and compromise the versioning features of Oracle CM SDK, the Oracle CM SDK NTFS server does not allow deletion or renaming of versioned files.

Make sure the document is not versioned before attempting to delete using NTFS.

1846693

Cannot start NTFS protocol server from terminal services client session.

Attempting to start NTFS protocol server from a terminal services session results in the following error message:

OracleIfsd driver failed to start. If an Oracle iFS installation has just been completed then a system restart may be needed to complete the installation of the OracleIfsd driver.

The NTFS protocol server cannot be started from within a Windows terminal services client session.

Start Oracle CM SDK from the Windows server console rather than trying to start it from a terminal services client session. Windows terminal services client sessions can only access devices that are already defined at the time the terminal session starts.

1289569

Delete appears to work on some files that a user should not be able to delete.

No error messages are given when a user tries to delete a document that the user does not have permission to delete, or when a user tries to delete special objects, such as the inbox folder, which cannot be deleted.

Although no error message appears, the document or folder is not deleted. Selecting Refresh in the Windows Explorer will cause the Windows Explorer to refresh the display and the document or folder will reappear.

1412048

In Windows NT with Service Pack 6, some .txt documents cannot be modified and saved in Wordpad.

When editing a document with the Read Only attribute with Wordpad on NT 4.0 with Service Pack 6, you will not be able to save the document to a different name using the Save As dialog box. When trying to save the document under a different name you will receive an error stating that the document cannot be accessed because it is in use by another application.

Remove the Read Only attribute before editing the document with Wordpad, or use another editor, such as Notepad.

3020371

Cannot list NTFS mountpoints with Hummingbird NFS client.

When a machine has the Hummingbird NFS client installed, the machine will attempt to use NFS when told to connect to a server that supports both NFS and NTFS. When a user clicks Start > Run and types \\servername, the Hummingbird NFS client will display the NFS mountpoints in the window that comes up. NTFS mountpoints and printers will not be displayed.

There are many possible workarounds for this issue:

  1. Mount the NTFS mountpoints and printers directly, using the Map Network Drive dialog or the Add Printer Wizard.

  2. Disable the NFS server on the machine that is running the NTFS server.

  3. Uninstall the Hummingbird NFS client on the machines that need to list NTFS mountpoints on a server.

2699323

Cannot connect through NTFS from a Windows NT client as a user with more than 20 characters in the user name.

An error indicates that the user name is invalid.

The Windows NT operating system does not allow user names longer than 20 characters. Use a different user name to connect to NTFS from a Windows NT client.

3027080

Programs that use DOS 8.3 file names will not work with long file names.

Programs that use DOS 8.3 file names will not work against the NTFS server because the NTFS server does not support translating long file names into the short DOS 8.3 format file names. Examples of such programs are DOS edit, the Windows image accessory, and the Windows Paint accessory. These programs require file names in DOS 8.3 format. They also require each directory in the path to be an 8.3 directory name.

Rename the file to the DOS 8.3 format for filenames. If necessary, move the file to another directory so that the path does not contain any directories with long filenames.

2890902

Files lose metadata when they are copied between folders using NTFS.

Copying a file from one folder to another folder using the Oracle CM SDK NTFS server will only copy the contents of the file. Oracle CM SDK metadata, such as categories, will not be copied. This is a limitation of the Windows operating system. The Windows operating system does not handle Oracle CM SDK metadata, and therefore does not copy this metadata when copying a file.

Under some circumstances, a file cut and paste operation in Windows Explorer will result in a file move rather than a file copy. Oracle CM SDK metadata is maintained when a file move is performed.

Use the Web Starter Application, or your own custom application, to copy files that have metadata.

3027564

When editing a PowerPoint file, the modified date may not get updated on NT.

When editing a Microsoft PowerPoint file on Windows NT, the modified date for the file may not get updated when the file is saved.

Make sure that the current Windows NT service pack has been installed. If the problem persists, save the file to the local drive and copy the file to the NTFS mapped drive.

3108043

The LogAllCommands server configuration parameter must be manually added and set to True in order to see complete NTFS log information.

The NTFS server has a configuration parameter which allows additional information to be logged in the log file. This information, which consists of the NTFS server commands that are being executed, can be used to debug problems in the NTFS server.

Using the Application Server Control, add the IFS.SERVER. PROTOCOL.NTFS.LogAll Commands parameter to the NTFSServerConfiguration. Set the value to TRUE in order to see the NTFS commands in the log file.

See the Oracle Content Management SDK Administrator's Guide for more information about adding server configuration parameters.


Table 9 E-mail Bugs

Bug # Description Action

1859056

Binary document attachments are not indexed.

Binary documents are not content indexed and hence are not located in a search.

None. This feature is planned for a later release.


Table 10 Oracle FileSync Bugs

Bug # Description Action

3037418, 3436884

There is no Arabic or Romanian selection available in the list of installation languages for Oracle FileSync.

Oracle FileSync can be installed on an Arabic or Romanian computer and will function in Arabic or Romanian. However, the installation process will not display Arabic or Romanian.

Install Oracle FileSync in another language, then switch the locale to Arabic or Romanian.

2853182

In the Oracle FileSync Exclusions tab, toggling the Type column does not save the setting.

In a mapping, exclude by extension and perform a sync. Excluding an item through the Extensions tab that was earlier included through the Log File screen does not save the change.

Use the Log File screen to include and exclude files.



Content Management SDK Installation Guide, 10g (9.0.4.2) for Microsoft Windows (64-bit) on Intel Itanium

B25609-02

Copyright © 2002, 2005, Oracle. All rights reserved.

The Programs (which include both the software and documentation) contain proprietary information; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited.

The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. This document is not warranted to be error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose.

If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the United States Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, Commercial Computer Software—Restricted Rights (June 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065

The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and we disclaim liability for any damages caused by such use of the Programs.

Oracle, JD Edwards, PeopleSoft, and Retek are registered trademarks of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

The Programs may provide links to Web sites and access to content, products, and services from third parties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites. You bear all risks associated with the use of such content. If you choose to purchase any products or services from a third party, the relationship is directly between you and the third party. Oracle is not responsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warranty obligations related to purchased products or services. Oracle is not responsible for any loss or damage of any sort that you may incur from dealing with any third party.