Oracle® Internet File System

Release Notes

Release 9.0.1 for Sun SPARC Solaris

July 2001

Part No. A88815-02

Overview

These release notes accompany the Oracle Internet File System Release 9.0.1 (Oracle 9iFS) for Solaris.

This document contains these topics:

What's New

Administration, collaboration, and development features have been added.

Administration Features

New administrative framework.

The most extensive changes in Oracle 9iFS lie in its new administrative framework. Oracle 9iFS expands its administrative abilities by integrating with and taking advantage of new capabilities in Oracle9i Enterprise Manager.

New protocol and agent framework.

To use these new administrative features, Oracle 9iFS now has a significantly modified protocol server and agent infrastructure. In this new framework, you can monitor multiple instances of Oracle 9iFS, including protocol servers and agents, from a single Oracle9i Enterprise Manager Console. When you install and configure Oracle 9iFS, you define a domain controller and nodes within that domain, all of which you can then jointly administer from the Oracle9i Enterprise Manager Console. For a complete overview of this new framework, consult the Oracle Internet File System Setup and Administration Guide.

Dashboard interface.

In addition, the Oracle9i Enterprise Manager Console interface for Oracle 9iFS now includes several "dashboard" graphs to display system status for all nodes. For example, the dashboard displays the number of users connected via each protocol server.

Import/Export utility.

Another critical addition to the Oracle 9iFS administrative tools is the Import/Export utility, which lets you export all of the content and associated metadata from one portion of a Oracle 9iFS directory structure. You can then use the exported file to re-create the content and metadata on either the original Oracle 9iFS instance or a new instance.

Scalability, performance, and reliability.

Improvements in scalability make it easier to both expand the size of the document store as well as increase the number of concurrent and named users who can connect to Oracle 9iFS. The performance of content queries and folder-restricted queries has improved. Oracle 9iFS e-mail delivery performance has also improved, as has executing commands using the Oracle 9iFS IMAP server. You can now run multiple WCP instances as you would any Oracle 9iFS protocol server. Oracle 9iFS has been tested with 10,000 concurrent users.

Lower memory usage.

The memory usage of Oracle 9iFS for large numbers of concurrent users has been reduced. At fewer numbers of concurrent users, the memory overhead for running Oracle 9iFS protocol servers can be lowered by running multiple protocol servers in a single Java Virtual Machine (JVM). For more information, see the Oracle Internet File System Setup and Administration Guide.

Java Web Server no longer supported.

As of this release of Oracle 9iFS, Oracle HTTP Server powered by Apache has replaced Java Web Server (JWS) as the preferred web server. JWS is no longer supported.

Collaboration Features

NFS protocol server.

You can now access content in Oracle 9iFS through the NFS protocol server, generally used to access UNIX file servers.

File Sync utility.

Brand new in Oracle 9iFS is a utility that synchronizes files between your local Microsoft Windows drive and Oracle 9iFS. For anyone who regularly accesses and edits files on a Oracle 9iFS instance, the File Sync utility is an important tool. For information on installing the File Sync utility, see the Oracle Internet File System Installation Guide.

Arbitrary metadata (categories) for any file or folder.

Oracle 9iFS lets you define arbitrary metadata, called categories, that you can apply to any file or folder. Previously, extended attributes were based on the type of file: for example, you could add the ReadyForPublication property to all HTML files. Now, with categories, you can define one set of related attributes and then apply them to any file or folder. For example, you could define a category that describes all the information needed in a review process--NextReviewer, ReadyForPublication, and so forth--and then apply them to HTML, GIF, JPG, AVI, or any other files that form your web site.

For more information on how to use this feature as an end user, see the online help file accessed through any Oracle 9iFS Windows Utilities dialog. For more information on how to browse, create, and modify categories through the administration interfaces, consult the Oracle Internet File System Setup and Administration Guide.

Multimedia metadata extracted automatically.

One use of this new type of category information is extracting metadata encoded in multimedia files to populate new Oracle 9iFS file attributes. Using Oracle interMedia Annotator, Oracle 9iFS now automatically extracts color depth, play length, closed caption text, and other types of information encoded in audio, video, and image files, then makes this information into searchable and editable attributes of these files.

This feature requires the administrator to enable the Oracle Text option for Oracle 9iFS. For information on enabling Oracle interMedia on an Oracle 9iFS instance, consult the Oracle Internet File System Setup and Administration Guide. When upgrading to Oracle 9iFS, the audio, video, and image files created using release 1.x of Oracle Internet File System are not annotated. If annotation is desired, make sure the Oracle interMedia Annotator Agent is running and reload those files back into Oracle 9iFS.

Oracle 9iFS portlet.

Oracle 9iFS now comes with a portlet which you can register with your Oracle Portal. The portlet allows shortcuts to commonly used folders and files and simple searches.

Improvements to Oracle 9iFS Windows Utilities.

Significant improvements have been made to the Oracle 9iFS Windows Utilities.

The software now automatically detects whether the Oracle 9iFS server (to which the user is connected) has a newer version of the software, and assists the user in installing it.
Broader support for multi-select operations is now possible, such as the ability to apply an Access Control List to a group of files or to a folder and all its subfolders and files, and the ability to Check In, Check Out, Cancel Check Out, Lock, Unlock, and Create Link on multiple items. Users may also delete and rename versioned documents.
The Find on Oracle 9iFS is more usable and capable, with the ability to search on custom attributes of documents and their subclasses, categories (and their subclasses) which are associated with documents, the language of the document (specified by the user or defaulted by the server), and all versions of a document. The Find on Oracle 9iFS is faster now due to incremental retrieval of search results and faster server-side "folder-restricted" searching. The user can also stop a Find when it has only returned some of the results.
The Properties dialog has also been re-worked to be more usable. Users can now edit custom attributes, associate categories and category attributes with documents and folders, and more easily see all the linked locations of a particular document or folder. The Security tab has been reworked with a new Access Control List and Access Control Entry set of dialogs. Also, performance improvements have been made in the way the Utilities interact with the SMB protocol.

Macintosh client certification.

Oracle 9iFS is certified with Thursby Software's DAVE, an SMB emulator for the Macintosh. Also, the Web interface is certified with Netscape Communicator on the Macintosh.

Development Features

Expanded and improved documentation.

The Oracle Internet File System Developer Reference has been completely rewritten. This manual contains new, expanded information covering all aspects of Oracle 9iFS development.

New sample code.

Oracle 9iFS includes a much broader range of sample code, both within the Oracle Internet File System Developer Reference and installed with the product. For a complete list of sample code, consult the Oracle Internet File System Developer Reference.

Perform SQL in Oracle 9iFS database transaction.

Developers can now access the same database transaction that Oracle 9iFS uses when committing changes to the relational data store. This feature is critical if you want to do any relational database work at the same time that a file system operation occurs. For example, if you want to perform a PL/SQL call in Oracle Portal when you insert new files in Oracle 9iFS, you can use the Oracle 9iFS transaction context for this combined operation.

New options for arbitrary metadata (categories).

A new type of arbitrary metadata, categories, is exposed within the Oracle 9iFS Software Development Kit (SDK), to allow you to programmatically create, edit, apply, and search for categories.

New e-mail object and API.

The Oracle 9iFS SDK component for e-mail has changed. Previously, an e-mail consisted of several separate objects that you needed to access and manipulate for any e-mail processing. Now, an e-mail is a single object, plus you can use the Java mail API instead of Oracle 9iFS-specific interfaces to generate and process e-mails.

XML namespace.

The XML parser installed with Oracle 9iFS now recognizes the Oracle 9iFS namespace you define within a document. This feature makes it possible for you to avoid conflicts in document definitions and attribute names between XML files used to configure Oracle 9iFS and any XML file that you might want to store. For example, the <CONTENT> tag used in many XML files no longer conflicts with Oracle 9iFS content objects, as long as Oracle 9iFS-specific files use the new namespace feature.

Round-trip XML.

Round-trip XML makes it possible to preserve all comments and unrecognized elements within an XML file. You can configure Oracle 9iFS to preserve unparsed contents that were previously discarded, making it possible to fully re-create an original XML file. This feature also lets you remove elements that appeared in the rendered XML file but were not in the original file (such as Oracle 9iFS attributes that were added to the rendered XML content).

Custom XML rendering.

It is now possible to select a subset of elements to be rendered. By default, only the extended elements specific to that Oracle 9iFS class will be rendered. You can choose to either add other elements from its superclasses or omit those extended elements for rendering purposes.

Client Certifications

The following client software versions have been tested and certified for Oracle 9iFS:

Microsoft Windows Web Browsers (for FTP, IMAP4, SMTP, HTTP, and the Web interface):
- Netscape Communicator 4.72 release and higher. Netscape 6.x is not supported in this release.
- Microsoft Internet Explorer 5.0 and above with Outlook Express
Windows Client Operating Systems (for access with SMB and the Windows Utilities, as well as the Web interface):
- Microsoft Windows NT 4.0 Workstation or Server, Service Pack 6, and higher
- Microsoft Windows 95, 98, and ME
- Microsoft Windows 2000 Professional and Server
Macintosh Web Browsers (for the Web interface):
- Netscape Communicator 4.73 release and higher. Netscape 6.x is not supported in this release.
Macintosh Client Operating Systems (for SMB access with Thursby Software's DAVE 2.5.1 support and the Web interface):
- Apple Macintosh PowerPC OS 9.0.4 and 9.1. Apple OS X is not yet certified.
NFS Access:
- Sun Solaris 2.7, 2.8 client
- Red Hat Linux 6.1 NFS client
- Hummingbird NFS Maestro 6.0 for Windows 95, 98, NT
- Hummingbird NFS Maestro 7.0 for Windows NT/2000
- OnNet 7.0
FTP Access:
- OnNet FTP 4.0
Eudora 4.3 for IMAP, SMTP
PINE 4.2 for IMAP, SMTP

Deprecations and Changes in the Oracle 9iFS Java API

As the Oracle 9iFS Java API grows to take advantage of new features and technology, certain classes, fields, and methods may be deprecated. Customers should expect that these deprecations will be deleted in the following major release. This allows our customers a full release cycle to modify their applications to use the supported classes, fields, 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.

Collections Improvements

In this release, the Oracle 9iFS implementation of java.util.Collections is changed to improve scalability. Notable changes include the following:

Not all items in a collection are cached.
Collection was modified from a class to an interface.
The methods of the new Collection interface have the same signatures as the methods of the old Collection class.

New implementation classes.

The following classes implement Collection:

oracle.ifs.common.Collection (interface)
|
+---oracle.ifs.common.CachedCollection (abstract)
| |
| +--- oracle.ifs.common.CachedSelectorCollection
| |
| +--- oracle.ifs.common.CachedResolverCollection
|
+---oracle.ifs.common.UncachedResolverCollection

The declared return values of the get*Collection() methods of LibrarySession and S_LibrarySession are changed to reflect the appropriate Collection subclass.

Changed error codes.

The error codes of the methods in Collection are also modified. If the specified name is invalid, the exception stack thrown by Collection.getItems(String)is as follows:

iFS 1.1:
IFS-12200 ("Invalid item name specified")
IFS-12214 ("Unable to get item in collection by name")
IFS-12200 ("Invalid item name specified")

Using Collection classes differently.

For an example of this modification to the error codes in Collections, consider error code such as this:

if (e.getErrorCode() == 12200)

For this release, it should be changed as follows:

if (e.containsErrorCode(12200))

In general, it is a better practice to use containsErrorCode() when expecting a specific error. In this manner, your code is protected should the error code, in a future release, ever change where in the exception stack it occurs. For more information these classes, consult the Javadoc.

General Issues

Monitoring Oracle Text Indexing of Oracle 9iFS Documents

Administrators may view which documents generated errors when they were indexed by Oracle Text by examining the example $ORACLE_HOME/9ifs/admin/sql/ViewContextErrors.sql.

If administrators want to monitor each document as it is indexed by Oracle Text, they can use the procedure ctx_output.add_event()prior to synchronizing the Oracle Text index. See the example $ORACLE_HOME/9ifs/admin/sql/SyncContextIndex.sql. For an example of viewing more information about the documents that have just been indexed by Oracle Text, see $ORACLE_HOME/9ifs/admin/sql/ViewDocumentByRowID.sql.

Refer to the Oracle Internet File System Setup and Administration Guide, Appendix E, for more information about using Oracle Text to index Oracle 9iFS documents.

New Search Timeout Parameter

A new service configuration parameter has been introduced that indicates the default timeout period for any executing search that has not yet returned results. In the default service configurations, this parameter (IFS.SERVICE.SESSION.DefaultSearchTimeoutPeriod) has the value of 60 seconds.

If a different default timeout period is desired, the IFS.SERVICE.SESSION.DefaultSearchTimeoutPeriod parameter can be changed. Please consult the Oracle Internet File System Setup and Administration Guide for more information.

Administrators Must Frequently Run 'analyze' Script on their Oracle Database

Because Oracle 9iFS uses advanced features of the Oracle database, Oracle 9iFS requires use of Oracle's Cost-Based Optimizer (CBO) to determine the most efficient way to execute SQL statements. For CBO to work properly, the administrator should run the 'analyze' script before using Oracle 9iFS, as well as regularly during use of Oracle 9iFS, especially after users have loaded a large number of files into Oracle 9iFS or have changed their data in other ways.

On Solaris, perform these steps (assuming ifssys is your Oracle 9iFS schema name):

cd $ORACLE_HOME/9ifs/admin/sql
sqlplus ifssys/<password> @analyze.sql ifssys

Note that the script may take many minutes to complete, especially when there are a large number of documents in Oracle 9iFS. In general, the command should be run during periods of reduced load on the system. For more information about the Cost-Based Optimizer, consult the Oracle Performance Guide.

Oracle 9iFS User Names May Not Contain Multi-byte Characters

Oracle 9iFS restricts the use of multi-byte user names. Access through WebDAV (Web Folders and Oracle 9iFS File Sync), HTTP (Oracle 9iFS Web interface or Web browsers), SMB (for Windows 95/98) and IMAP (e-mail) is not available for user names that contain multi-byte characters.

Protocol-specific Issues

Web Access

To access Oracle 9iFS through HTTP, use a URL in this format:

http://<server-name>:<port number>/ifs/files

By default, the port number is 7777, so the URL would be, for example,

http://myserver.mycompany.com:7777/ifs/files

This URL is required for the following:

Access through a web browser to the Web interface or to retrieve files directly through HTTP.
Access through WebDAV applications such as Web Folders.
Access to Oracle 9iFS using the File Sync feature.

NFS Protocol Support

Oracle 9iFS includes an NFS server. Consult the Oracle Internet File System Installation Guide for information on configuring the Oracle 9iFS NFS server, configuring NFS clients, and mapping UNIX users to Oracle 9iFS accounts.

Oracle 9iFS NFS Server Limitations.

The Oracle 9iFS NFS server has the following limitations.

Permission mode bits do not determine access (Issue 1750049)

The Oracle 9iFS NFS server returns the permission mode bits as read, write, and execute permissions for the document owner, the current user, and public access. Actual access to the document, however, is controlled by the Oracle 9iFS Access Control List (ACL). The mode bits returned by the Oracle 9iFS NFS server may not reflect the actual access allowed to the user.
You cannot change owner, group, or mode from UNIX. (Issues 1749621, 1749601)

The owner, group, and mode for a document in the Oracle 9iFS NFS server cannot be changed using the UNIX chown, chgrp, or chmod commands. These commands will appear to succeed, but will not actually modify the attributes of the document.
The Oracle 9iFS NFS server does not allow access to the checked-out version of a versioned document.

The Oracle 9iFS NFS server does not allow access to the checked-out version of a versioned document because this would violate the caching algorithm used by NFS clients to improve performance. This algorithm assumes that the contents of a file are the same for all users. Allowing access to the checked-out version of a document would violate this assumption because the user who checked out the document would see different document contents from other users.
A versioned document cannot be deleted, moved, or renamed.

Microsoft Office applications and other programs save files by first saving the data to a temporary file, deleting the original file, and then renaming the temporary file to the original name. In the case of versioned documents, this would result in the loss of all previous versions, so versioned documents are not allowed to be deleted, moved, or renamed.
Handles returned by the Oracle 9iFS NFS server are incompatible with the UNIX lock manager (NLM).

Programs that require the UNIX lock manager will not work with the Oracle 9iFS NFS server, because of an incompatibility between the Oracle 9iFS NFS server and the UNIX lock manager (NLM).
UNIX links (hard links and symbolic links) are not supported (Known Issue 1749778)

UNIX-style links are not compatible with Oracle 9iFS. Oracle 9iFS links may be used instead.

Oracle 9iFS File Sync Utility Limitations.

The File Sync utility is able to detect changes made by you on your local machine and by you or others on Oracle 9iFS and, generally, is able to resolve any conflict in these changes. However, certain types of changes may conflict and cannot currently be resolved by File Sync. In these cases, File Sync 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 9iFS folder are in sync, and a user creates a new file in the local folder, but the folder on Oracle 9iFS 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).

Web Interface and Uploading via Drag & Drop in Multi-byte Locales

Due to a bug with Internet Explorer running in multi-byte environments, upload via drag/drop will work only when the default character set for the Oracle 9iFS server matches the character set of the client machines.

Web Proxies for FTP Drag and Drop

Users may need to edit their web browser preferences so that they do not use a proxy for FTP. Using a web proxy may cause problems when using drag and drop in the Web interface to upload files to the server.

Migrating Between the Open Source and Sendmail Pro 8.9.3 Versions of Sendmail

Oracle 9iFS uses Sendmail 8.9.3 as its Mail Transfer Agent. The open source version of Sendmail is shipped along with the core Oracle 9iFS product. Oracle 9iFS also allows you to use Sendmail Pro v 8.9.3 from Sendmail Inc. as your mail transfer agent. However, care must be taken when migrating from one to the other. If you are using Sendmail Pro and wish to migrate to the open source version, please make sure that you de-install Sendmail Pro before migrating to using the open source version.

To set up the Open Source version, run the script $ORACLE_ HOME/9ifs/bin/ifsemailsetup. If you want to use Sendmail Pro 8.9.3, please make sure that you re-install Sendmail Pro 8.9.3 and run the script $ORACLE_HOME/9ifs/bin/ifsemailsetup_pro893.

Known Bugs

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

Installation Bugs

Bug 1865469	Oracle 9iFS domain information not discovered by Intelligent Agent.
Description:	When you deinstall Oracle 9iFS software and then reinstall it in the same Oracle Home using the same Oracle 9iFS schema, the Intelligent Agent will be unable to discover the Oracle 9iFS domain controller and node that existed in the schema previously.
Action:	Before deinstalling, make a backup copy of <ORACLE_HOME>/network/agent/config/ ifs.ora. After reinstalling the Oracle 9iFS software, run the Oracle 9iFS Configuration Assistant, and choose to re-use the same schema. Then restore the backup copy of ifs.ora so that the Intelligent Agent will be able to discover the Oracle 9iFS domain controller and nodes.
Bug 1852624	Upgrade failure may prevent enabling of Oracle Text.
Description:	If a Oracle 9iFS Configuration Assistant schema upgrade fails, a subsequent upgrade of the same schema may not enable Oracle Text.
Action:	Manually enable Oracle Text using the scripts to create the Context index provided in <ORACLE_HOME>/9ifs/admin/sql.
Bug 1826074	NLS: Traditional Chinese window title garbled in Oracle 9iFS Configuration Assistant.
Description:	If the locale is set to zh_TW.BIG5, the Window title in the Oracle 9iFS Configuration Assistant may be garbled. This is caused by certain Solaris limitations.
Action:	None.
Bug 1860278	Oracle 9iFS Configuration Assistant may hang on "Verifying Oracle JServer".
Description:	Under unusual circumstances, the Oracle 9iFS Configuration Assistant may hang during the "Verifying Oracle JServer" step.
Action:	If the step does not complete within two minutes, kill the process and re-start the Oracle 9iFS Configuration Assistant.
Bug 1866051	"Checking available ports" may take several minutes if Apache or JServ is using the ports.
Description:	The step of "Checking available ports" when running the Oracle 9iFS Configuration Assistant may take several minutes if the Apache Web Server or the Oracle 9iFS JServ process is running.
Action:	Stop the Oracle 9iFS JServ process using ifsJservctl -stop Stop the Apache Web Server using apachectl stop Wait for a few minutes for the ports to clear, then rerun the Oracle 9iFS Configuration Assistant.
Bug 1529995	Custom policies that are placed in renderer's value domains are lost during upgrade.
Description:	When performing an upgrade from Oracle Internet File System release 1.x to Oracle 9iFS, the value domain used by Oracle 9iFS Manager to manage renderer policies is removed and recreated to accommodate new renderer policies added for WebDAV and e-mail. This does not affect any of the out-of-the-box renderer policies. However, any custom renderer policies created and added to this value domain will be lost. Note that the policy is not removed; rather, Oracle 9iFS Manager cannot see the policies.
Action:	Note the custom renderer policies added into the value domain. After you install Oracle 9iFS, add these entries back into the value domain, through, for example, the Oracle 9iFS Manager.

Generic Oracle 9iFS Bugs

Bug 1857689	If version 1.x custom classes conflict with new out-of- the-box Oracle 9iFS classes, the upgrade will fail.
Description:	If custom classes created with release 1.x of Oracle Internet File system conflict with any classes that are new in Oracle 9iFS, the upgrade to Oracle 9iFS will fail.
Action:	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 9iFS are: InterMediaAudio InterMediaAudioCdTrack InterMediaImage InterMediaMovie InterMediaSource InterMediaVideo MediaTextBlob NodeConfiguration PortletUserProfile Rfc822ContentObject Rfc822Message ServerConfiguration ServiceConfiguration
Bugs 1837169, 1840606	Content indexing of PDF documents is slower in Oracle 8.1.7.2 and Oracle9i database than in Oracle 8.1.7.0.0 database.
Description:	Content indexing of PDF documents through Oracle Text is slower in the Oracle 8.1.7.2 and Oracle9i database, Release 1 than it was in Oracle 8.1.7.0.0 database.
Action:	Ensure that sufficient CPU capacity is available on the machine running the Oracle database. Two CPUs or more is recommended.
Bug 1736391	Oracle interMedia Annotator fails to parse JPEG files and throws exceptions.
Description:	The Oracle interMedia Annotator will attempt to parse IPTC (International Press Telecommunications Council) metadata in JPEG files when none is actually present. This results in generating an exception in the log files. Since Oracle 9iFS does not take advantage of IPTC information even when it's present, you may want to disable IPTC parsing.
Action:	Stop the InterMediaAnnotator agent. Edit $ORACLE_HOME/ord/Annotator/lib/ descriptors/parsers/JpgParser.xml and change the line: <ParameterValue> true </ParameterValue> to <ParameterValue> false </ParameterValue> Restart the InterMediaAnnotator agent. Any JPG files that previously failed to be annotated due to this issue will be reparsed.
Bug 1724775	Content-based searches "OR-ed" with criteria that should also return non-indexed files will only return indexed files.
Description:	A content-based search, such as "all files containing 'Oracle' " OR-ed with an attribute search that should return non-indexed files, fails to return the non-indexed files in the search result.
Action:	Break the search into two searches, the content search and the attribute search.
Bug 1833065	Node log file may have stack traces with exceptions IFS-45371 and IFS-46402.
Description:	Each time the InterMedia Annotator fails to annotate a file, these two exceptions are logged, and the stack trace is dumped to the log.
Action:	None.
Bug 1855983	Uploading multimedia files containing multi-byte data may result in invalid characters in annotations.
Description:	In a multi-byte Oracle Text-enabled installation, multi-media files (audio, video and images) are automatically annotated by the InterMedia Annotator agent. For some installations, the InterMedia Annotator incorrectly puts invalid characters in as the category metadata.
Action:	Change the environment variable LANG to match the native language (e.g., for Korean, set LANG=ko), and restart Oracle 9iFS.

XML Bugs

Bug 1600470	Creating a user via XML with a multi-byte login fails.
Description:	By default, creating a user through XML will create the e-mail address by concatenating the <Username> and the <EmailAddressSuffix>. If the username contains multi-byte characters, then the user creation fails because an e-mail address cannot contain multi-byte characters.
Action:	Explicitly set the e-mail address without multi-byte characters using the <EmailAddress> tag.

Windows / SMB Bugs

Bug 1791830	On Windows NT / 2000, double clicking on a Microsoft Office file with a high ASCII character in the name fails.
Description:	Double-clicking on a Microsoft Office file (.DOC, .XLS, etc.) with a high ASCII character in the filename (characters which are not 7-bit USASCII) causes the error "The file could not be found".
Action:	Launch the Microsoft Office application and then use "File/Open" to open the file.
Bug 809516	Cannot list files in DOS command shell under Windows 95 and Windows 98.
Description:	When using the DOS command shell under Windows 95 and Windows 98, file names are not displayed for files on the Oracle 9iFS server.
Action:	Use the Windows Explorer and Desktop for all file operations in Windows 95 and Windows 98.
Bug 1113581	Cannot delete or rename versioned files in SMB.
Description:	Attempts to delete or rename a versioned file in SMB result in a failure message indicating that all or part of the file may 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 9iFS, the Oracle 9iFS SMB server does not allow deletion or renaming of versioned files.
Action:	Through Windows Explorer, right click on the versioned document and use the "Delete Versioned Document" capability of Oracle 9iFS Windows Utilities or use the Web interface.
Bug 1115154	Saving versioned document gives "file is locked" error.
Description:	Attempts to save a versioned document result in an error message indicating that all or part of the file may be locked.
Action:	This error appears for one of two reasons: Files associated with certain applications, such as Microsoft Word and Microsoft Excel, cannot be edited in-place in Oracle 9iFS. These applications delete previous versions of the document as part of the save process. Solution: When working with files that produce such errors, try saving the file to a local directory and then copying it on top of the Oracle 9iFS versioned file. A versioned file cannot be edited before first being checked out by the user. Solution: To edit a versioned file, check it out.
Bug 1243158	Cannot set read-only attribute for folders through SMB.
Description:	Locking a folder in Oracle 9iFS will prevent all users from renaming and deleting a folder. Locking a folder will also prevent items from being added or removed from that folder. Because this extra functionality is not designed into Windows and current Windows applications, locking an Oracle 9iFS folder through setting the Windows read-only attribute is not permitted.
Action:	To prevent users from changing the contents of a folder, lock it through another interface, such as the Web interface. This will prevent Windows users from adding or removing files from the folder; however, this technique will not prevent the users from modifying the files in the folder unless those files are also locked.
Bug 1254675	Changes delayed when saving through SMB.
Description:	After saving a file through SMB there is sometimes a delay of up to a minute before those changes are visible to other users and in other protocols. This is caused by local caching by the Windows operating system which benefits Windows performance.
Action:	The changes are shown immediately if the user refreshes the directory listing from the Windows Explorer. Press F5 to refresh the current view in Windows Explorer.
Bug 1364155	Saving a Word 95 file fails on some Win95 clients.
Description:	Saving a Microsoft Word 95 file on some Windows 95 client machines sometimes results in an error that the file is in use.
Action:	Take the following steps: Use the "Save As" command to save the file with a different name. Open the locked file and replace the old contents with the new contents using cut and paste. Save the original file with the new contents.
Bug 1374563	*Misleading error when opening versioned Excel files (.xls) via SMB.**
Description:	Attempting to open a versioned Excel file that is not checked out causes an Excel error message indicating that the document is being modified by another user. The file can be opened in read-only mode.
Action:	The document is not being modified by another user, but since the document is not checked out it is locked and cannot be written to. Confirm opening the file in read-only mode or check it out.
Bug 1401439	"Too Many Files" Error after Extracting WinZip files.
Description:	After extracting a large number of files using WinZip, the user may be unable to read or write any more files from the mapped drive. The user may get an error similar to "Too many files are currently in use. Quit one or more programs, and then try again." The user may get other less specific errors to the effect that a file could not be opened.
Action:	The user can unmap and re-map the network drive. The administrator can also increase the default maximum number of open files per mountpoint for the SMB server using the following parameters: MaxOpenFiles = 30 MaxAllOpenFiles = 100 Increase them as necessary until the problem is resolved.
Bug 1622123	As a system administrator, loading a folder hierarchy into Oracle 9iFS using SMB results in folders that cannot be accessed.
Description:	All system administrators have the Private ACL as their default ACL. This means when an administrator populates Oracle 9iFS using drag and drop in SMB, all folders and files will have the Private ACL. No other users, except system administrators, will be able to access the folders or files.
Action:	Load the files as a non-system administrator. These users have Published as their default ACL.

Windows Utilities Bugs

Bug 1873831	Find on Oracle 9iFS may run out of memory.
Description:	When using Find on Oracle 9iFS to find large numbers of documents over many queries, your client machine may run out of memory.
Action:	Close the Find on Oracle 9iFS application and start it again.
Bug 1845460	Find on Oracle 9iFS: Control characters in file attributes may throw IFS-1003 exception.
Description:	If you see the exception IFS-1003 when the Windows Utilities is attempting to display the results of a Find, it may be because there is a control character in the file attributes.
Action:	Isolate the problem file and remove control characters from the attributes of that file.
Bug 1807421	User Profile: Alt+O and Alt+N do not work if any error message received.
Description:	In the Oracle 9iFS User Profile dialog, the keyboard shortcuts stops working for the fields "Old Password" (alt+o) and "New Password" (alt+n) if there is has been any password authentication errors.
Action:	Use tab key or the mouse to navigate to these fields.
Bug 1728051	Oracle 9iFS Find using Category: May return duplicate results.
Description:	If a document is associated with more than one Category, those Categories have a subclass/superclass relationship, and the user requests a search on the superclass, then each document will be duplicated in the result set.
Action:	Ignore the duplicate documents.
Bug 1416975	Missing some Oracle 9iFS operations for file with name longer than 256 characters.
Description:	In Windows NT, if you drag and drop a file that has a file name longer than 256 characters, some of the Windows Utilities will not work.
Action:	This is a Microsoft Windows limitation.

Web interface Bugs

Bug 1831286	Uploading very large files with the Web interface fails without any feedback.
Description:	Uploading very large documents (for example, over 100MB) via Browse in the Web interface can fail.
Action:	Use Drag and Drop upload, use FTP directly, or another protocol.
Bug 1859980	On resizing the browser window on Macintosh, right frame doesn't load.
Description:	When you grow or shrink the browser window on the Macintosh, you may notice that the tree (left) and container (right) frames do not reload.
Action:	After resizing the window, press the reload button. Note: The tree (left frame) will not retain its current state.
Bug 1860905	Cannot create a document/folder location in portlet for a folder created using high ASCII characters.
Description:	If you create a folder with high ASCII characters (8-bit characters), you cannot create a link to that folder in the Oracle 9iFS portlet.
Action:	Choose a folder name that does not contain high ASCII characters.
Bug 1831063	Cannot login even if username/password are correct.
Description:	Occasionally stale data in the browser cache will prevent you from logging into the Oracle 9iFS Web interface.
Action:	Clear the browser's cache by pressing the Shift key and clicking Reload.
Bug 1842888	In Netscape, squares sometimes appear instead of multi-byte characters
Description:	The font names specified in the Oracle 9iFS Web interface are not recognized by the browser.
Action:	Change settings in Netscape to "Use my default fonts and override document specified fonts".
Bug 1853303	Clicking does not always open the folder in the right frame.
Description:	After opening a folder using the tree (left) frame, subsequent clicking on folders in the container (right) frame may fail to display their contents.
Action:	Use the tree (left) frame to open folders and other container objects.
Bug 1104090	In Netscape, uploading a folder using drag and drop fails.
Description:	Using drag and drop in Netscape, uploading a folder and its contents will fail. This is a Netscape browser bug.
Action:	You have several options: If the folder's contents are not other folders, first create the folder in Oracle 9iFS, then upload the folder's contents using drag and drop. Upload using browse rather than drag and drop. Use Internet Explorer.
Bug 1235607	If quota is exceeded, attempting to upload over an existing file will fail.
Description:	If quotas are being used, and you are currently near or over your quota, you may not be able to upload any files, even if you are attempting to replace an existing file.
Action:	Delete the file you are replacing before attempting the upload.
Bug 1244053	After entering username and password, pressing Enter causes login screen to beep.
Description:	On the login.jsp, after entering the login and password, pressing the Enter key causes a beep.
Action:	Press the Tab key to select the Login button before pressing Enter.
Bug 1248003	The text in the column heading disappears after the window is resized.
Description:	After resizing the window, the headings on the File List no longer appear, because the text is black on a black background.
Action:	This is a style sheet and browser issue. Reload the File List by clicking the current folder in the Directory Tree.
Bugs 1252587, 1106093, 1263638	Library Session times out during long uploads.
Description:	When executing tasks that require a long time to complete, such as complex searches, searches over a very large data set, or deleting a large folder tree, the connection times out and fails.
Action:	Shut down the service and increase the SessionTimeoutPeriod parameter in the properties file. The default value is 10 minutes. Restart the service.
Bug 1258791	Cannot apply ACLs to more than 100 items in the Web interface at one time.
Description:	A design issue in the Web interface limits the number of items you can have selected when you choose Apply ACL from the Edit menu.
Action:	Select fewer than 100 items when you are applying ACLs.
Bug 1370141	Upload and check-in/check-out menus overlap if the system uses small fonts.
Description:	If you set the Windows NT display parameters to use small fonts, the menu options in the Upload and Check-In/Check-Out menus overlap one another. This problem only occurs in Netscape browsers.
Action:	Change the font settings in the Display section of the Windows control panel to use medium or large fonts.
Bug 1372615	Using Internet Explorer, uploading a document with non-ASCII document name via drag and drop fails.
Description:	Using Internet Explorer 5.0 or 5.5 to upload a file with a non-ASCII file name via drag and drop results in an error message that the file already exists. Choosing to overwrite the non-existent file causes the filename to be truncated when the file is stored in Oracle 9iFS .
Action:	This is a known NLS bug with the FTP window in Internet Explorer 5.0 or 5.5. Either use upload via browse, or use a different protocol server to upload the file.
Bug 1374498	Non-ASCII file name is displayed as squares while viewing its parents.
Description:	For a file with a non-ASCII name, if you open the View Parents window to see all the folders in which a file appears, the file name appears as a series of rectangles.
Action:	Set your browser to ignore typefaces. For example, in Netscape, select Edit -> Preferences -> Appearance and set Fonts option to "Use My Default Fonts."
Bug 1384904, 1379837, 1374374	Using Netscape, cannot upload a file with non-ASCII characters in filename.
Description:	Using Netscape to upload (via browse) a document that has a non-ASCII filename, the upload fails.
Action:	Use Internet Explorer or a different protocol to upload the file, such as FTP or SMB.
Bug 1387938	Drag and drop upload may fail.
Description:	Using FTP to drag and drop from the Web interface, the upload fails if the path to the server is not fully qualified.
Action:	Either fully qualify the path to the server (for example, http://myserver.mycompany.com:2100) or use a different protocol server to upload the file.
Bug 1399626	Uploading a file via drag & drop into a folder with a period in its name causes the file to open in Internet Explorer.
Description:	Attempting to upload a document into a folder with a period in its name causes the upload to fail. Instead of being uploaded, the file displays in Internet Explorer.
Action:	Navigating one level up from the folder (the folder with a period in its name), then back down into the folder will enable the upload to work.
Bug 1399646	Folder name with apostrophe cannot be opened.
Description:	If a folder name contains an apostrophe, you cannot open that folder in the Web interface.
Action:	Remove the apostrophe from the folder name.
Bug 1403302	Problems with theme searching.
Description:	Using theme search in the Advanced Find window causes the web server to stop responding to requests.
Action:	Do not use theme searches. (Theme indexing is turned off by default in Oracle 9iFS .)
Bug 1408308	Cannot link to specific versions of a document.
Description:	Users cannot create a link to individual versions of a versioned document.
Action:	If you want to reference a particular version of a document, you can paste and create a copy, but you cannot have a reference.
Bug 1416997	Tree frame operates incorrectly.
Description:	The tree frame gives unexpected results if a folder in the tree is renamed using a different protocol.
Action:	Refresh the browser.
Bug 1480275	Can't search for documents by language.
Description:	The File Contents criterion of the Advanced Find window allows you to specify a particular string to search on and its language. Some users may think they're specifying a language attribute to search on.
Action:	Use the Windows Utilities instead.
Bug 1524432	Changing default DAV renderer breaks Web interface.
Description:	Changing the renderer implementation for the WebDAV renderer breaks the Web interface.
Action:	Do not subclass Renderer and create a custom renderer.set.
Bug 1604545	Using UTF-8 encoded .js files causes web page error in IE for Simplified Chinese.
Description:	Much of the user interface for the Web interface is generated by Javascript code. There is a known issue with some versions of Microsoft's Internet Explorer.
Action:	Use only IE5.5 (5.50.4134.0600) with Simplified Chinese systems.
Bug 1872138	Folder items are sorted uppercase first, then lowercase.
Description:	When listing the items in a folder, the items are sorted case-sensitively, by name.
Action:	None.

FTP Bugs

Bug 1832626	Occasionally the browser will hang when using Netscape as the FTP client.
Description:	Netscape will periodically hang when trying to upload a file into Oracle 9iFS. This occurs when using Netscape as an FTP client and during upload via drag/drop through the Web interface.
Action:	Try again or use Internet Explorer as the FTP client.

E-mail Bugs

Bug 1859056	Binary e-mail attachments are not content indexed.
Description:	Content searches will not return matches on binary attachments in e-mails.
Action:	None. Currently only text and HTML e-mail content and attachments are indexed.
Bug 1197079	Deleting and expunging multiple messages in Netscape Messenger 4.7 may cause the client to fail.
Description:	Occasionally, trying to delete several messages and expunge them all at once using Netscape Messenger 4.7 causes the client to fail.
Action:	Retry the same operation. If the error recurs, restart the client and delete messages in smaller groups.
Bug 1248657	Mail sent from a machine that uses XFN instead of DNS does not always work.
Description:	XFN is a federated naming service used instead of DNS. Oracle 9iFS e-mail only supports DNS.
Action:	DNS is required for Oracle 9iFS.
Bug 1379886	Cannot delete non-ASCII folder name with EUDORA 4.3.2.
Description:	It is not possible to remove folders named with non-ASCII characters using EUDORA 4.3.2.
Action:	Use any other e-mail client, SMB, or the Web interface to remove the folder.
Bug 1380015	Unable to login into an IMAP account with a non-ASCII character in the name.
Description:	If user name has non-ASCII characters, logging into the IMAP server may fail. This happens if the server character set is not set correctly.
Action:	Set the Oracle 9iFS server default character set to ISO8859-1 or the appropriate multibyte character set.
Bug 1387952	E-mails sent from PINE cannot be opened in the Web interface.
Description:	An e-mail that originated from a PINE client is not viewable in the Oracle 9iFS Web interface. The body of the e-mail will not be displayed. Instead, a "404 Document not found" error is reported.
Action:	The e-mail can be viewed using any standard e-mail client suitably configured, and through Windows Explorer using Oracle 9iFS SMB.

HTTP Bugs

Bug 1393110	Folder names in top-level Oracle 9iFS directory are restricted.
Description:	In an Apache environment, servlet names exactly matching one or more of the first characters of the name of a top-level directory will cause the Web interface to fail. For example, if the name of the servlet is files, the presence of a folder called files will cause the Web interface to fail.
Action:	Do not create any top-level folder on Oracle 9iFS with the same first set of characters as the servlet name (by default, files).

Oracle 9iFS Manager Bugs

Bug 1822898	In OEM, launching main node fails if incorrect host credentials.
Description:	Using OEM on Solaris, if you do not provide the host credentials for the "root" user when you start or refresh the domain (or in the OEM preferred credentials), OEM may list only the HTTP node and its related servers, even though you selected other servers to run. In addition, the OEM job to launch the Oracle 9iFS main node may fail with the following output: "`<ORACLE_HOME>/9ifs/bin/ifslaunchnode` must be run as root. "
Action:	Provide the Solaris "root" user credentials when launching the main node through OEM or in the OEM preferred credentials.
Bug 1753455	Changes to server not reflected until servers unloaded and reloaded.
Description:	When you use Oracle 9iFS Manager to make a change in the protocol or server configuration, you will need to unload and reload the servers (not just stop and start the servers) before the change will take effect.
Action:	Unload and reload the servers after any changes.
Bug 1847573	No error given when Oracle 9iFS Dashboard exits due to wrong preferred credentials.
Description:	If you launch the Oracle 9iFS Dashboard from within OEM and have incorrect credentials in the OEM preferred credentials, the Dashboard will exit without any error message.
Action:	Set the preferred credentials to be the Oracle 9iFS schema name and password. Check the dashboard.log in the `<ORACLE_HOME>/9ifs/log` directory for more information.
Bug 1857080	Oracle 9iFS Dashboard startup from command line outputs log to stdout.
Description:	When invoking the Oracle 9iFS Dashboard from the command line (not from OEM), some messages are displayed on the terminal (standard output).
Action:	None. These messages may be safely ignored.
Bug 1867608	NLS: Oracle 9iFS Help does not appear in same content window as other OEM Help.
Description:	In the Oracle9i OEM Console, Oracle 9iFS related online help shows up with its own 'Contents', 'Index', and 'Find' tabs, separated from the rest of the OEM online help.
Action:	None.
Bug 1522235	NLS: Some English text may appear in translated product.
Description:	When using Oracle 9iFS Manager in Spanish, Italian, Korean and Traditional Chinese, some menus, tool-tips and buttons may show up in English.
Action:	None.
Bug 1718014	Cannot add extended attributes that are named the same as SQL reserved words.
Description:	You cannot name an attribute with Oracle Reserved words such as UNIQUE and SELECT.
Action:	Choose other names for the attribute. See the Oracle9i SQL Reference for a list of reserved words.
Bug 1683035	Property Inspector: On Solaris, splitters do not resize when navigating via mouse.
Description:	On Solaris, the Property Inspector does not correctly re-size the "Categories" or "Relationships" pull-down splitter when using the mouse. As a result, categories and relationships can't be seen until the user manually clicks and pulls down the splitter.
Action:	Before navigating the "Properties", "Categories", or "Relationships" tabs, click (with the mouse) the "Properties" tab twice, after which all splitters will be re-sized correctly. This step must be done only once.
Bug 1167418	Cannot change ACL of a User Object itself.
Description:	The ACLs of DirectoryUsers cannot be changed in the Oracle 9iFS Manager.
Action:	Go to the Web interface and select the user in the Users list. Click Edit->Apply ACL to update the ACL.
Bug 1388097	Cannot rename an ACL or User.
Description:	ACLs or users cannot be renamed in Oracle 9iFS Manager.
Action:	To rename an ACL, go to the Web interface, select the ACL in the ACL list and click Edit->Rename. Renaming a DirectoryUser requires a Java utility that can update the NAME attribute of the DirectoryUser.

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