Oracle Internet File System Release Notes Release 9.0.1 for Compaq Tru64 UNIX Part Number A90896-01 |
|
Copyright © 2001, Oracle Corporation
All Rights Reserved
Release Notes
Release 9.0.1 for Compaq Tru64 UNIX
August 2001
Part No. A90896-01
These release notes accompany Oracle Internet File System Release 9.0.1 (Oracle 9iFS) for Compaq Tru64 UNIX.
This document contains the following topics:
The following section describes the new administration, collaboration, and development features.
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.
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 the nodes within that domain, all of which you can administer from the Oracle9i Enterprise Manager Console.
For a complete overview of this new framework, refer to the Oracle Internet File System Setup and Administration Guide.
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.
The Import/Export utility lets you export all of the content and associated metadata from one portion of an 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.
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. Oracle 9iFS has been tested with 10,000 concurrent users. Oracle 9iFS e-mail delivery performance and executing commands using the Oracle 9iFS IMAP server have improved. You can now run multiple WCP instances as you would any Oracle 9iFS protocol server.
The performance of content queries and folder-restricted queries has improved.
The memory usage of Oracle 9iFS for large numbers of concurrent users has been reduced. The memory overhead for running Oracle 9iFS protocol servers can be lowered by running multiple protocol servers in a single Java Virtual Machine (JVM) when there are fewer concurrent users.
For more information, refer to the Oracle Internet File System Setup and Administration Guide.
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.
You can now access content in Oracle 9iFS through an NFS protocol server.
A new utility in Oracle 9iFS synchronizes files between your local Microsoft Windows drive and Oracle 9iFS. This utility will benefit users who regularly access and edit files on a Oracle 9iFS instance.
For information on installing the File Sync utility, refer to the Oracle Internet File System Installation Guide.
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, the ReadyForPublication property could be added 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 a user, refer to 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, refer to the Oracle Internet File System Setup and Administration Guide.
With 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, and then makes this information into searchable and editable attributes of these files. One use of this new type of category information is extracting metadata encoded in multimedia files to populate new Oracle 9iFS file attributes.
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.
This feature requires the administrator to enable the Oracle Text option for Oracle 9iFS. For more information on enabling Oracle interMedia on an Oracle 9iFS instance, refer to the Oracle Internet File System Setup and Administration Guide.
Oracle 9iFS includes a portlet which you can register with your Oracle Portal. The portlet allows shortcuts to commonly used folders, files and simple searches.
Significant improvements have been made to the Oracle 9iFS Windows Utilities.
The Find utility is now faster due to incremental retrieval of search results and faster server-side "folder-restricted" searching. Users can also stop a search when it has only returned some of the results.
The Oracle Internet File System Developer Reference has been completely rewritten. This reference contains new, expanded information covering all aspects of Oracle 9iFS development.
Oracle 9iFS includes a broad 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, refer to the Oracle Internet File System Developer Reference.
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.
A new type of arbitrary metadata, categories, is presented within the Oracle 9iFS Software Development Kit (SDK), to allow you to programmatically create, edit, apply, and search categories.
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. In addition, you can use the Java mail API instead of Oracle 9iFS-specific interfaces to generate and process e-mails.
The XML parser installed with Oracle 9iFS recognizes the Oracle 9iFS namespace you define within a document. This makes it possible for you to avoid conflicts in document definitions and attribute names between XML files used to configure Oracle 9iFS and an 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 when the Oracle 9iFS-specific files use the new namespace feature.
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 allows you to remove elements that appeared in the rendered XML file but were not in the original file such as Oracle 9iFS attributes added to the rendered XML content.
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 from the database to the browser. You can choose to either add other elements from its superclasses or omit those extended elements for rendering purposes.
The following client software versions have been tested and certified for use with Oracle 9iFS:
The following sections describe the minimum and recommended hardware configurations for Oracle 9iFS.
The following configuration numbers are for two-tier configuration and for running all protocol servers. This configuration will support approximately two users, accessing approximately two protocols concurrently.
If you plan to run the database and Oracle 9iFS on the same machine, then the following configuration will support approximately 50 users, accessing each protocol moderately. This does not include running the Oracle9i Enterprise Manager Console, which takes additional resources.
If you plan to have more than 50 users connecting to your Oracle 9iFS server, you should install the Oracle9i database and Oracle 9iFS on separate machines.
As the Oracle 9iFS Java API expands 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.
In this release, the Oracle 9iFS implementation of java.util.Collections has changed to improve scalability. Notable changes include the following:
The following illustration shows the relationship between the Collection interface and the classes:
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.
The error codes of the methods in Collection have been modified. If a 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")
As an example of this modification to the error codes in Collection, consider an error code such as this:
if (e.getErrorCode() == 12200)
For this release, the error code 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 ever change in the exception stack it occurs.
For more information these classes, refer to the Javadoc.
After you apply the 8.1.7.2.0 patchset on top of Oracle8i release 8.1.7, the database will still report version 8.1.7.1. The database reports the earlier version to the ifsconfig
executable, which generates a configuration error.
Workaround: Apply the 8.1.7.2.1 patchset.
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.
For more information about using Oracle Text to index Oracle 9iFS documents, refer to the Oracle Internet File System Setup and Administration Guide.
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, the IFS.SERVICE.SESSION.DefaultSearchTimeoutPeriod
parameter has the value of 60 seconds.
If a different default timeout period is desired, then the IFS.SERVICE.SESSION.DefaultSearchTimeoutPeriod
parameter can be changed.
For more information on the timeout parameter, refer to the Oracle Internet File System Setup and Administration Guide.
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. This script should be run 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 Compaq Tru64 UNIX, enter the following commands:
cd $ORACLE_HOME/9ifs/admin/sql
sqlplus ifssys/password
@analyze.sql ifssys
In the preceding command, ifssys is the Oracle 9iFS schema name.
Note that the script may take several minutes to complete, especially when there are a large number of documents in Oracle 9iFS. In general, the script should be run during periods of reduced load on the system.
For more information about the Cost-Based Optimizer, refer to the Oracle Performance Guide.
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.
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. An example of the URL would be as follows:
http://myserver.mycompany.com:7777/ifs/files
In the preceding example, myserver.mycompany.com is the server name, and 7777 is the port number.
This URL is required for the following:
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.
Tru64 does not currently support the public file handle lookup protocol (Internet RFC 2045 - WebNFS Client Specification). Therefore, to enable Tru64 5.0 clients to mount the directories exported by iFS, you must run the iFS Protocol Server for NFS using the default NFS port 2049.
The Oracle 9iFS NFS server has the following limitations:
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 available to a user.
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 because this would violate the caching algorithm used by NFS clients. 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.
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.
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 NLM.
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. In the following, the source file is the original file, and the target file is the resulting file.
Due to a bug with Internet Explorer running in multi-byte environments, upload using the drag-and-drop function will work only when the default character set for the Oracle 9iFS server matches the character set of the client machines.
Users may need to edit their web browser preferences to not use a proxy for FTP. Using a web proxy may cause problems when using the drag-and-drop function in the Web interface to upload files to the server.
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:
The following table describes the known installation bugs and provides workarounds when appropriate.
The following table describes the known Oracle 9iFS bugs and provides workarounds when appropriate.
The following table describes the known XML bug and provides a workaround for it.
The following table describes the known Windows and SMB bugs and provides workarounds when appropriate.
The following table describes the known Windows Utilities bugs and provides workarounds when appropriate.
The following table describes the known Web interface bugs and provides workarounds when appropriate.
The following table describes the known FTP bug and provides a workaround.
The following table describes the known e-mail bugs and provides workarounds when appropriate.
The following table describes the known HTTP bug and provides a workaround for it.
The following table describes the known Oracle 9iFS Manager bugs and provides workarounds when appropriate.
|
Copyright © 2001 Oracle Corporation. All Rights Reserved. |
|