Oracle® Internet File System
Release Notes
Release 9.0.2
for Sun SPARC Solaris
April 2002
Part No. A96000-01
Overview
This document is accurate to the best of our knowledge at the time of publication. Information that is discovered subsequent to publication will be available through regular support channels. You can access the latest information and additions to Release Notes on the Oracle Technology Network at:
http://otn.oracle.com/products/ifs/content.html
This document is specific to Oracle Internet File System Release 9.0.2 (Oracle 9iFS) for Sun SPARC Solaris. It includes information about:
Changes and New Features
This release provides several new features, including integration with Oracle9i Application Server, which includes support for Oracle Internet Directory and Oracle9iAS Containers for J2EE (OC4J). This release also supports AppleTalk Filing Protocol (AFP), enabling Macintosh users to connect to Oracle 9iFS just as they do to an AppleShare file server. See "Integration with Oracle9i Application Server" and "AppleTalk Filing Protocol (AFP) Support" for details.
Integration with Oracle9i Application Server
Oracle 9iFS is integrated with Oracle9i Application Server and is especially designed to integrate with Oracle Internet Directory and Oracle Enterprise Manager, specifically with the new Oracle Enterprise Manager Web site that enables Web-browser-based monitoring and administration.
Support for Oracle Internet Directory (LDAP Support)
Oracle Internet Directory is Oracle's LDAP (Lightweight Directory Access Protocol) v.3-compliant directory service implementation. Oracle Internet Directory can provide user authentication and other directory-service features to Oracle9i Application Server components, and to Oracle 9iFS. If you use Oracle Internet Directory with Oracle 9iFS, user management will be a very different process than in previous releases. Both system administrators and Oracle 9iFS may have to take different initial steps before using Oracle 9iFS.
For example, system administrators will need to create an Oracle Internet Directory Credential Manager (OidCredentialManager) if they want the Oracle 9iFS instance to authenticate Oracle 9iFS users. See the Oracle Internet File System Installation and Configuration Guide for information about configuring an Oracle Internet Directory credential manager.
Note that existing Oracle 9iFS user accounts can be migrated to Oracle Internet Directory by using the Migration Tool provided with Oracle 9iFS. See "Using the Oracle Internet Directory User Migration Tool" for additional information.
See "Running Oracle Internet Directory Replication Server to Purge Oracle Internet Directory Change Log" for additional caveats and workarounds specific to this release of Oracle 9iFS and integration with Oracle Internet Directory.
Support for Oracle9iAS Containers for J2EE (OC4J)
Oracle9i Application Server provides a J2EE-compliant application server with support for JavaServer Pages (JSP), Java Servlet, Enterprise JavaBeans, and many other APIs from the Java 2 Platform, Enterprise Edition (J2EE). Support for these APIs is provided in Oracle9i Application Server by the Oracle9iAS Containers for J2EE (OC4J) component.
OC4J replaces Apache JServ as the Java Servlet and Java Server Page runtime environment for Oracle 9iFS; Oracle 9iFS uses OC4J to support its servlets, specifically, the HTTP/DAV Servlet and the portlet servlet.
After installing and configuring Oracle 9iFS, you must deploy these servlets to OC4J using a command-line utility provided with Oracle 9iFS. See the Oracle Internet File System Installation and Configuration Guide, Chapter 4, Post-configuration, for information about deploying Oracle 9iFS servlets to OC4J.
OC4J is also used to support the new Web-based Oracle Enterprise Manager software (sometimes referred to as Enterprise Management Daemon, or EMD). See "Web-based Management" for more information.
Web-based Management
You can now use a browser to connect to all the nodes that comprise the Oracle 9iFS domain, on a host-by-host basis, using the EMD (Enterprise Management Daemon), a new component of Oracle9i Application Server. The software infrastructure that supports Web-based management (specifically, the Oracle9iAS Containers for J2EE (OC4J) component of Oracle9i Application Server) is configured for Oracle 9iFS automatically at the end of the Oracle 9iFS configuration process.
See Oracle9i Application Server Concepts for more information about Oracle9iAS Containers for J2EE and the role it plays in Oracle9i Application Server. See the Oracle9i Application Server Administrator's Guide for information about administering, managing, and monitoring Oracle9i Application Server.
AppleTalk Filing Protocol (AFP) Support
Oracle 9iFS includes an AFP 2.2-compliant AppleTalk Filing Protocol (AFP) server. MacOS 9 and MacOS X clients can use the Oracle 9iFS AFP Server just as if it were an AppleShare server. See the Oracle Internet File System Setup and Administration Guide for additional information about the new AFP protocol server support, including information about configuration parameters.
Long Filenames Truncated in AFP 2.2
Because AFP 2.2 does not support filenames with more than 31 characters, the Oracle 9iFS AFP Server will truncate long filenames. However, the AFP Server generates a unique name by appending a number at the end of the filename, as is standard practice with this protocol.
Certification and System Requirements
Several high priority bugs are fixed in the 9.0.1.3 release of Oracle9i Database Server. You should upgrade to this release of the database as soon as it is available.
Client Certifications
The following client software has been tested and certified for Oracle 9iFS:
Microsoft Windows
- Microsoft Windows Client Operating Systems (for access to an Oracle 9iFS server through SMB; Windows Utilities; and 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
- Web Browsers (for FTP, IMAP4, SMTP, HTTP, and the Web interface):
- Netscape Communicator 4.72 (and higher). Netscape 6.x is not supported in this release.
- Microsoft Internet Explorer 5.0 and 5.5, and Microsoft Outlook Express 5.0. Internet Explorer 6.0 is not yet certified.
- Email Clients:
- Eudora 4.3 for IMAP, SMTP
- PINE 4.33 for IMAP, SMTP
- FTP Clients:
- OnNet FTP 4.0
- Ipswitch WS_FTP32
- NFS Clients:
- Hummingbird NFS Maestro 6.0 (Windows 95, 98, NT)
- Hummingbird NFS Maestro 7.0 (Windows NT/2000)
- OnNet 7.0 (Windows 2000 only)
Apple Macintosh
- Mac OS 9.0.4, Mac OS 9.1, and Mac OS X.
- Netscape Communicator 4.73 release and higher (for the Web interface and email). Netscape 6.x is not supported in this release.
- Microsoft Outlook Express 5.0.
UNIX NFS Client Support
- Sun Solaris 2.6, Solaris 7, Solaris 8
- Red Hat Linux 6.2
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, attributes, and methods may be deprecated. You should expect these deprecated elements to be deleted in the following major release. This provides you with a full release cycle to modify your applications to use the supported classes, attributes, and methods.
To see what is deprecated in this release, go to the "Deprecated" link in the Javadoc. Each deprecation has a comment indicating the equivalent supported usage. You can also check if your application is using any deprecated classes, fields, or methods by compiling your Java application with the -deprecation flag.
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 9.0.2:
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 a test of an 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 better to use containsErrorCode() if you are expecting a specific error. In this manner, you code is protected if the error code, in a future release, ever changes its position in the exception stack. For more information about these classes, see the Javadoc.
Change in Delimiters for Service Configuration Properties
For better readability, Oracle 9iFS now accepts spaces in service configuration properties. For example, a property value can have the following value:
IFS.SERVICE.CREDENTIALMANAGER.Oid.Subscribers = DEFAULT SUBSCRIBER
Prior to this release, spaces were used to separate alternate values of a property. With this release, commas alone function as delimiters. If an existing property uses a space as a delimiter, you will need to change it to a comma.
interMedia Methods
The following methods now return an object, rather than an intrinsic value (int, long, or double). This change was made to support returning NULL if no attribute value was present. If you have used any of these methods in your custom applications, you must now modify your code to accept the correct return value.
interMediaAudio
int getAudioBitsPerSample()
int getAudioNumChannels()
int getAudioSampleRate()
interMediaAudioCDTrack
int getAudioCdTrackFrame()
int getAudioCdTrackLBA()
int getAudioCdTrackMinute()
int getAudioCdTrackSecond()
interMediaImage
int getImageBitsPerPixel()
int getImageCount()
long getImageHeight()
double getImageHorizontalRes()
double getImageVerticalRes()
long getImageWidth()
interMediaSource
long getMediaBitRate()
long getMediaSize()
interMediaVideo
int getVideoDepth()
long getVideoFrameRate()
long getVideoFrameSize()
int getVideoHorizontalRes()
long getVideoSrcHeight()
long getVideoSrcWidth()
int getVideoVerticalRes()
Configuration Issues
Here are some issues to be aware of before you attempt to install and configure Oracle 9iFS.
Oracle Internet Directory and Oracle 9iFS Issues
Before you attempt to install and configure this release of Oracle 9iFS, you should be aware of several issues with respect to Oracle Internet Directory and Oracle 9iFS. See specifically items 2282201, 2100615 and 2212389, 2286968 in the "Configuration Bugs" section. These bugs will be fixed by upgrading the database instance supporting Oracle Internet Directory to release 9.0.1.3 of the Oracle9i Database Server, which you should do as soon as it is available.
IfsDefault.properties Issues
Some additional manual steps are required to enable launching Oracle 9iFS Manager, Dashboard, and Credential Manager Configuration Assistant from the command line (ifsmgr, ifsdashboard, and ifsoidcm) on middle-tier machines. Briefly, if you configure an additional middle-tier node to an existing domain (by choosing the "Reuse existing schema" from the Oracle 9iFS Configuration Assistant) and you are using Oracle Internet Directory for credential management, you must run Credential Manager Configuration Assistant first, on the middle-tiers, before using Oracle 9iFS Manager and Dashboard. Running the Credential Manager Configuration Assistant synchronizes the IfsDefault.properties file with the existing credential managers (OidCredentialManagers) associated with the instance of Oracle 9iFS. Be sure to select the correct schema name when you run the Credential Manager Configuration Assistant. See item 2320341 in the "Configuration Bugs" section for details.
The Admin-only configuration of Oracle 9iFS requires manual modifications to the IfsDefault.properties file to support the command-line versions of ifsmgr, ifsdashboard, and ifsoidcm. See item 2320292 in the "Configuration Bugs" section for more information; also see the "Administration-only Configuration" instructions in Appendix B of the Oracle Internet File System Installation and Configuration Guide.
Oracle9i Application Server, Unified Messaging Install Type
If you use the Oracle9i Application Server, D. Unified Messaging install type with Oracle 9iFS, you should be aware of possible port conflicts for SMTP or IMAP servers.
Oracle9i Application Server, D. Unified Messaging provides both an IMAP server and an SMTP. Oracle 9iFS also provides an IMAP server, and, through the optional integration with Sendmail, provides mail transfer through an SMTP gateway.
If you want to use both the Oracle 9iFS IMAP and Oracle9iAS Unified Messaging IMAP servers on the same machine, you must change the port number on one of these servers, because by default, both of them use port 143. You can change the Oracle 9iFS IMAP server to a different port number during configuration. You can change the Oracle9iAS Unified Messaging IMAP server port through the Oracle9iAS Unified Messaging Email Server administration tool. Be aware that if you change the port number on either of these IMAP servers, the IMAP client application that you intend to use must be able to be configured for the specific port number you selected. If your IMAP client cannot be configured to this extent, you must install the Oracle9iAS Unified Messaging IMAP server and the Oracle 9iFS IMAP server on two different middle-tier machines, to avoid this port conflict.
By default, the Sendmail gateway used by Oracle 9iFS and the Oracle9iAS Unified Messaging SMTP servers both use port 25. You cannot modify this port number on the Oracle 9iFS, so you cannot run both Oracle9i Application Server SMTP server and Oracle 9iFS with Sendmail on the same middle-tier machine.
General Issues
Here are some general operations and adminstration issues.
Oracle 9iFS 'analyze.sql' Script Should be Run Frequently
Oracle 9iFS uses Oracle's Cost-Based Optimizer (CBO) to determine the most efficient way to execute SQL statements. For CBO to work properly, the Oracle 9iFS 'analyze.sql' script should be run as part of regular Oracle 9iFS operations, especially after large volume changes to the data, such as after users have loaded a large number of files into Oracle 9iFS.
Run the script during non-busy periods to avoid impeding performance for users.
Oracle strongly recommends that you export schema statistics before running analyze.sql, as follows:
cd $ORACLE_HOME/9ifs/admin/sql
sqlplus ifssys/<password>
SQL> call dbms_stats.create_stat_table
('ifssys', 'my_stat_backup_table', null);
SQL> call dbms_stats.export_schema_stats
('ifssys', 'my_stat_backup_table',
to_char(sysdate,'DD-MON-YY HH24:MI.SS'),'ifssys');
SQL> @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. For more information about the Cost-Based Optimizer, see the Oracle Performance Guide.
If for any reason you need to restore the old statistics, you can do so by executing the following statements:
SQL> select stat_id from my_stat_backup_table;
SQL> call dbms_stats.import_schema_stats
('ifssys', 'my_stat_backup_table', <name of stat id>,'ifssys');
Oracle 9iFS User Names Cannot Contain Multi-byte Characters
Although Oracle 9iFS supports multi-byte character sets, it does not effectively support user account names created using multi-byte characters. When you create user accounts for Oracle 9iFS, you should create the names using single-byte characters only. Users whose account names are created with multi-byte characters are unable to access content through many of the Oracle 9iFS protocol servers.
Oracle Internet Directory Issues
See the Oracle Internet Directory Release Notes for complete information on all known issues. This section covers only those issues specific to Oracle 9iFS. Note that several bugs listed later, in the "Configuration Bugs" section, will be fixed by upgrading the database instance supporting Oracle Internet Directory to release 9.0.1.3 of the Oracle9i Database Server as soon as it is available.
Use Oracle 9iFS-specific Passwords with Certain Protocol Servers
Many protocols, including AFP, CUP, FTP, and IMAP, transmit unencrypted passwords over the network. Other protocols, such as HTTP and SMB, also transmit user passwords in the clear (unencrypted, as cleartext) in some configurations.
From a security standpoint, transmitting unencrypted passwords becomes a concern when Oracle 9iFS uses Oracle Internet Directory to manage user passwords because the same password that provides access to Oracle 9iFS also provides access to all other applications using Oracle Internet Directory for authentication.
To address this issue, Oracle Internet Directory supports an alternate, application-specific password for each user. Oracle 9iFS supports this feature of Oracle Internet Directory. The alternate password for Oracle 9iFS is referred to as the "Oracle 9iFS-specific password." Thus, each Oracle 9iFS user can have two passwords: an Oracle Internet Directory common password, and an Oracle 9iFS-specific password.
You can configure Oracle 9iFS to use the Oracle Internet Directory common password or to use the Oracle 9iFS-specific password on a protocol-by-protocol basis. By default, AFP, CUP, FTP, and IMAP use the Oracle 9iFS-specific password; all other protocols use the Oracle Internet Directory common password. Consequently, users cannot access Oracle 9iFS using AFP, CUP, FTP, or IMAP protocols until they have set their Oracle 9iFS-specific password, using either Oracle 9iFS Manager or the Oracle 9iFS Web user interface. See the Oracle Internet File System Installation and Configuration Guide for additional information.
The default configuration may not be appropriate for all Oracle 9iFS deployments. You can change the configuration using the Oracle 9iFS Credential Manager Configuration Assistant. See Appendix B in the Oracle Internet File System Installation and Configuration Guide for additional information.
Using the Oracle Internet Directory User Migration Tool
Oracle Internet Directory is configured with default password policies, which can be changed by the Oracle Internet Directory administrator. Be sure to check with the Oracle Internet Directory administrator before migrating Oracle 9iFS to Oracle Internet Directory to ensure that the password policies in force during migration will support the passwords used by Oracle 9iFS users. For example, if the Oracle Internet Directory requires numeric values in passwords, the Oracle 9iFS 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 9iFS Credential Manager to the Oracle Internet Directory Credential Manager, it does not remove the migrated users' information from the Oracle 9iFS Credential Manager. If a migrated user is subsequently deleted and a new user with the same distinguished name is then created using the Oracle 9iFS Credential Manager, the following exception is thrown:
IFS-10154: Unable to create user (username)
IFS-10172: Distinguished name not unique
To workaround this, the Oracle 9iFS administrator must explicitly delete the Oracle 9iFS Credential Manager information for the deleted user by calling the DYNCredentialManagerDeleteUser method of oracle.ifs.server.S_LibrarySession.
Running Oracle Internet Directory Replication Server to Purge Oracle Internet Directory Change Log
Oracle 9iFS 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 may cause unavailability of the Oracle Internet Directory service. The need to start the replication server to purge the change-log is only a temporary restriction and will be removed in a future release.
For more information on starting and stopping the replication server, see Oracle Internet Directory Administrator's Guide.
Oracle Text Issues
Here are some issues relevant to Oracle Text and Oracle 9iFS. See the Oracle Internet File System Setup and Administration Guide, Appendix E, for more information about using Oracle Text with Oracle 9iFS.
Monitoring Oracle Text Indexing of Oracle 9iFS Documents
Administrators can see which documents generated errors during Oracle Text indexing by examining the example $ORACLE_HOME/9ifs/admin/sql/ViewContextErrors.sql.
To monitor each document as it is indexed by Oracle Text, 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 after Oracle Text indexing, see $ORACLE_HOME/9ifs/admin/sql/ViewDocumentByRowID.sql.
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.
Change the IFS.SERVICE.SESSION.DefaultSearchTimeoutPeriod parameter to select a different default timeout period. See the Oracle Internet File System Setup and Administration Guide for more information.
Client-specific Issues
Here are some issues that you should be aware of before using Oracle 9iFS.
Oracle 9iFS FileSync Utility Issues
The FileSync 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 FileSync. In these cases, FileSync only gives you the option to "skip" synchronizing these file changes.
The following types of conflicts are currently not resolvable ("source" means the original file; "target" means the resulting file):
- NEW/DELETE (when target of NEW conflicts with source of DELETE). For example, when a local folder and an Oracle 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 UI Issues
Here are some general Web UI issues.
Uploading via Drag-and-Drop Function in Multi-byte Locales
Due to a bug with Internet Explorer running in multi-byte environments, attempting to upload using the drag-and-drop function works 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 Function
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 the drag-and-drop function in the Web interface to upload files to the server.
Documentation Issues
In the HTML version of the Oracle Internet File System Installation and Configuration Guide, several tables display with extraneous space above them. This occurs only when viewed with the Netscape browser.
In Chapter 12, Web Interface Customization, of the Oracle Internet File System Developer Reference, the Servlet should be deployed to OC4J, not JServ. References to JServ should be replaced with references to OC4J.
In Chapter 5 and Chapter 10 of the Oracle Internet File System Setup and Administration Guide, replace references to JServ with OC4J.
Starting and Stopping the Oracle 9iFS Domains and Nodes from the Commandline
You can also start and stop domains and nodes from the Commandline. This is required when you do not have the OS root credentials.
Start the Domains and Nodes from the Commandline
On the machine where you want to run the Domain Controller:
- Launch the Domain Controller using the
ifslaunchdc script, located in $ORACLE_HOME/9ifs/bin. You can run this as the user that installed the Oracle 9i database or the root user.
- On the machines that you want to run the node, launch the node using the
ifslaunchnode script located in $ORACLE_HOME/9ifs/bin. You must be the root user to run this script.
- Start the Domain Controller using the
ifsstartdomain script located in $ORACLE_HOME/9ifs/bin. You should run this as the same user that ran ifslaunchdc.
See Chapter 2, "Administering an Oracle 9iFS Domain" in the Oracle 9iFS Setup and Administration Guide, for more information.
Stop the Oracle 9iFS Domain from the Commandline
Run the ifsstopdomain script located in $ORACLE_HOME/9ifs/bin. You should run this as the same user who ran ifsstartdomain.
Minimum Memory Requirement
Please note that the minimum memory requirement for the "Multiple Machine Deployment for Production Environment" is 1 GB, not 2 GB as indicated in table 2-1 on page 2-3 of the Oracle Internet File System Installation and Configuration Guide.
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:
Configuration Bugs
|
Bug 2282201, 2100615 |
Oracle 9iFS configuration may fail when attempting to configure an SSL-enabled Oracle Internet Directory for credential management. |
|
|
This is an intermittent bug that occurs only when attempting to configure Oracle 9iFS with an SSL-enabled Oracle Internet Directory for credential management. |
|
|
Upgrade the database instance supporting the Oracle Internet Directory to release 9.0.1.3 as soon as it becomes available. As a temporary workaround, in a non-production environment only, you can disable SSL (secure sockets layer) on the Oracle Internet Directory. This is a security violation. |
|
Bug 2212389, 2287968 |
Ifsconfig Fails with InvalidAttributeValueException or with an ORA-600 error. |
|
|
Occasionally, when configuring an Oracle Internet Directory (via the Oracle 9iFS Configuration Assistant), the Oracle 9iFS Configuration Assistant fails with an invalid attribute value exception. |
|
|
Set the optim_peak_user_binds=FALSE in the init<db>.ora file (or the SPFILE) and restart the database server where Oracle Internet Directory is running.
Note that this bug will be fixed by upgrading the Oracle Internet Directory database to 9.0.1.3. Once you upgrade, you should remove this workaround from the init<db>.ora file. |
|
Bug 2329188 |
Oracle 9iFS must be installed and configured in an Oracle9iAS Oracle home that has the active Enterprise Manager Web site running (EMD). |
|
|
If the host has more than one Oracle home based on Oracle9iAS Release 2, you must install and configure Oracle 9iFS in the Oracle home that is running the Enterprise Manager Web site, or you won't be able to manage the Oracle 9iFS instance. |
|
|
Ensure that Oracle 9iFS is installed and configured in the Oracle home that contains the active Enterprise Manager Web site instance and that Oracle 9iFS was configured from that Oracle home. |
|
Bug 2320292 |
Admin-only Oracle 9iFS configuration requires manual changes to IfsDefault.properties file before running Oracle 9iFS Manager, Dashboard, and Credential Manager Configuration Assistant. |
|
|
The Admin-only configuration of Oracle 9iFS requires manual modifications to the IfsDefault.properties file to support the command-line versions of ifsmgr, ifsdashboard, and ifsoidcm. |
|
|
Using a text processor, open the IfsDefault.properties file, located in the $ORACLE_HOME/9ifs/settings/oracle/ifs/server/properties directory and set the Oracle 9iFS schema name and service name in the file in these two lines:
IFS.SERVICE.JDBC.Schema=<SCHEMANAME>
IFS.SERVICE.JDBC.DatabaseURL=jdbc:oracle:oci8:@
<NETSERVICENAME>
where <schemaname> is the name of the Oracle 9iFS schema (ifssys is the default) and <netservicename> is the name of the Oracle database service on the database machine. See the "Administration-only Configuration" instructions in Appendix B of the Oracle Internet File System Installation and Configuration Guide for more information.
In addition, if you are using Oracle Internet Directory for credential management, you must synchronize the entries in the IfsDefault.properties file on this machine with the settings in the schema by running the Credential Manager. See Bug 2320341 for additional information. |
|
Bug 2320341 |
Cannot authenticate successfully through Oracle 9iFS Manager and Dashboard from a middle-tier machine (using Oracle Internet Directory for credential management). |
|
|
If you add a node to an existing domain (and so you use the "Reuse existing schema" option during Oracle 9iFS configuration), you must synchronize the settings in the IfsDefault.properties file with the entries in the Oracle 9iFS schema. If you don't, you will receive authentication errors when you attempt to login to ifsmgr or ifsdashboard from this machine. |
|
|
Run the Oracle 9iFS Credential Manager Configuration Assistant (oidcmca) on the middle-tier machine, entering the name of the Oracle 9iFS schema to which this node belongs. The IfsDefault.properties file will be updated with the correct information, and you can then launch ifsmgr or ifsdashboard. |
|
Bug 2205709 |
Font errors in Java-based clients in Japanese locale (font.properties.ja error). |
|
|
Error messages about missing fonts display on Japanese environments when launching Java-based GUI tools. |
|
|
You can edit the font.properties.ja to match the fonts on the system. See Sun's Java web site for information about editing font properties. However, the fonts do not affect functionality, so you do not need to do this. |
|
Bug 1865469 |
Oracle 9iFS domain information not discovered by Intelligent Agent. |
|
|
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. |
|
|
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 1860278 |
Oracle 9iFS Configuration Assistant may hang on "Verifying Oracle JServer". |
|
|
Under unusual circumstances, the Oracle 9iFS Configuration Assistant may hang during the "Verifying Oracle JServer" step. |
|
|
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. |
|
|
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. |
|
|
Stop the Oracle 9iFS JServ process using
ifsJservctl -stop
Restart the Oracle HTTP Server from the Services control panel (available from Administration Tools control panel in Windows 2000).
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. |
|
|
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. |
|
|
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. |
Administration Bugs
|
Bug 2339856 |
Help does not display in the correct language, even though the locale is correctly set. |
|
|
Oracle 9iFS Help is not shown in the correct language because of missing symbolic links to the help .jar file. |
|
|
- Create a symbolic link to the help system .jar file for the required language, as shown in the following single line command:
ln -s $ORACLE_HOME/9ifs/lib/ifs_help_<lang>.jar
$ORACLE_HOME/sysman/webapps/emd/online_
help/ifs/ifs_help_<lang>.jar
where <lang> is the abbreviation for the language you need, such as de, es, fr, ja, pt_BR, it, ko, zh_TW, zh_CN, and so on. The following single line shows an example of creating a symbolic link to the German language version of the help file:
ln -s $ORACLE_HOME/9ifs/lib/ifs_help_de.jar
$ORACLE_HOME/sysman/webapps/emd/online_
help/ifs/ifs_help_de.jar
- Restart the Oracle Enterprise Manager Web site.
|
|
Bug 2338372 |
Japanese Help does not show in Oracle Enterprise Manager Web page. |
|
|
In the Japanese environment, Oracle 9iFS Help does not show in Oracle Enterprise Manager (Web-based). |
|
|
Follow these steps:
- Follow the steps in the Oracle9i Application Server Release Notes Addendum (9.0.2; Part No A90337-01) to work around Bug 2333168 or 2326951.
- Create a symbolic link to the Help .jar file:
ln -s $ORACLE_HOME/9ifs/lib/ifs_help_ja.jar
$ORACLE_HOME/sysman/webapps/emd/online_
help/ifs/ifs_help_ja.jar
- Restart the Oracle Enterprise Manager Web site.
|
|
Bug 2276820 |
Traditional Chinese IME (input method) does not work with Oracle 9iFS Manager on Solaris 7 (Solaris 2.7). |
|
|
The Traditional Chinese IME does not work with Oracle 9iFS Manager when started from the command line on Solaris 7 (Solaris 2.7) if the language is set to zh_TW.BIG5. The Traditional Chinese IME works fine on Solaris 8 (Solaris 2.8) or when the language is set to zh_TW. |
|
|
Set the language to zh_TW (LANG=zh_TW; export LANG) before launching the Oracle 9iFS Manager. |
|
Bug 2183550 |
Chipped characters in Dashboard display (Japanese locale only). |
|
|
Japanese Locale only. The opening display of the Dashboard (the page that displays launch progress), the final characters in the first string don't display correctly; they appear to be chipped. |
|
|
None. |
|
Bug 2181034 |
Nodes don't display when sysadmin password fails to authenticate. |
|
|
Nodes don't display in the nodes table if the system administrator password in targets.xml file is not correct. |
|
|
Edit the targets.xml file using the Oracle Enterprise Manager administration web page:
- Connect to
http://<hostname>:1810/emd/console/admin. Enter the ias_admin and password when prompted.
- Select the Oracle 9iFS domain controller from the Agents Monitored table, and then click Next to display the Edit Target: Properties page.
- Edit the Oracle 9iFS system administrator password, and then click Finish to save the change.
- Restart the Oracle Enterprise Manager daemon by executing
emctl start at a command script.
See the Oracle Internet File System Setup and Administration Guide for more information. |
|
Bug 1753455 |
Changes to server not reflected until servers unloaded and reloaded. |
|
|
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. |
|
|
Unload and reload the servers after any changes. |
|
Bug 1847573 |
No error given when Oracle 9iFS Dashboard exits due to wrong preferred credentials. |
|
|
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. |
|
|
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. |
|
|
When invoking the Oracle 9iFS Dashboard from the command line (not from OEM), some messages are displayed on the terminal (standard output). |
|
|
None. These messages may be safely ignored. |
|
Bug 1867608 |
NLS: Oracle 9iFS Help does not appear in same content window as other OEM Help. |
|
|
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. |
|
|
None. |
|
Bug 1522235 |
NLS: Some English text may appear in translated product. |
|
|
When using Oracle 9iFS Manager in Spanish, Italian, Korean and Traditional Chinese, some menus, tool-tips and buttons may show up in English. |
|
|
None. |
|
Bug 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. |
|
Bug 1683035 |
Property Inspector: On Solaris, splitters do not resize when navigating via mouse. |
|
|
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. |
|
|
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. |
|
|
The ACLs of DirectoryUsers cannot be changed in the Oracle 9iFS Manager. |
|
|
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. |
|
|
ACLs or users cannot be renamed in Oracle 9iFS Manager. |
|
|
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. |
AFP Bugs
E-mail Bugs
Generic Oracle 9iFS Bugs
HTTP Bugs
Web Interface Bugs
|
Bug 1964796 |
NLS: Cannot search files using Japanese characters in Oracle 9iFS Portlet. |
|
|
The character set of the Portal database must be UTF-8, or searches from the Oracle 9iFS Portlet will not work. |
|
|
If the Portal character set is not UTF-8, have the user remove the search section from the Oracle 9iFS Portlet. |
|
Bug 2268254 |
Multi-byte filenames under multi-byte folders cannot be renamed. |
|
|
Cannot rename a file or folder that has a multi-byte name using Web Folders. The same issue causes limitations in the ability to copy files and folders with multi-byte names from one server to another through Web Folders.
This is caused by problems in the handling of multi-byte characters in the HTTP header. Although the HTTP specification does not support non-ASCII characters in the header, products like Web Folders send them. The issue is a Java 1.3.1 bug on Solaris 7 and Solaris 8. |
|
|
On Solaris 7 (Solaris 2.7) and Solaris 8 (Solaris 2.8), set the LANG and LC_ALL to en_US. On Solaris 2.6, set LANG and LC_ALL to C, before using opmnctl to start the processes. Be aware that you must have installed the en_US locale for this to work. Use the command locale -a to list all locales that have been installed on the machine. |
|
Bug 2289612 |
Quota section of an Oracle 9iFS Portlet displays as NULL. |
|
|
If users add the Quota section to their Portlets but their quotas have not been enabled by the administrator, the "Quota Used" value displays as NULL. |
|
|
Enable the user's quota, or have the user delete the Quota section from the Portlet. |
|
Bug 2276285 |
Cut-and-paste group members results in IFS-62017 error message. |
|
|
When moving users from one group to another using cut-and-paste, you get the error message "IFS-62017: No path could be found to the original item. Try copy instead." |
|
|
Rather than cut-and-paste, use copy-and-paste, and then delete the members from the original group. |
|
Bug 1831286 |
Uploading very large files with the Web interface fails without any feedback. |
|
|
Uploading very large documents (for example, over 100MB) via Browse in the Web interface can fail, possibly because of time-outs on the server. |
|
|
Use DAV (Web folders), use FTP directly, or another protocol. |
|
Bug 1859980 |
On resizing the browser window on Macintosh, right frame doesn't load. |
|
|
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. |
|
|
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. |
|
|
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. |
|
|
Choose a folder name that does not contain high ASCII characters. |
|
Bug 1831063 |
Ocasionally, cannot login even if username/password are correct. |
|
|
Stale data in the browser cache sometimes prevents users from logging into the Oracle 9iFS Web interface. |
|
|
Clear the browser's cache by pressing the Shift key and clicking Reload. |
|
Bug 1853303 |
Clicking does not always open the folder in the right frame. |
|
|
After opening a folder using the tree (left) frame, subsequent clicking on folders in the container (right) frame may fail to display their contents. |
|
|
Use the tree (left) frame to open folders and other container objects. |
|
Bug 1104090 |
In Netscape, uploading a folder using the drag-and-drop function fails. |
|
|
Using the drag-and-drop function in Netscape, uploading a folder and its contents will fail. This is a Netscape browser bug. |
|
|
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 the drag-and-drop function.
- Upload using browse rather than the drag-and-drop function.
- Use Internet Explorer 5.0 or above.
|
|
Bug 1244053 |
After entering username and password, pressing Enter causes login screen to beep. |
|
|
On the login.jsp, after entering the login and password, pressing the Enter key causes a beep. |
|
|
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. |
|
|
After resizing the window, the headings on the File List no longer appear, because the text is black on a black background. |
|
|
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. |
|
|
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. |
|
|
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. |
|
|
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. |
|
|
Select fewer than 100 items when you are applying ACLs. |
|
Bug 1370141 |
Using Netscape, upload and check-in/check-out menus overlap if the system uses small fonts. |
|
|
Using Netscape browsers, if the Windows display has been set to use small fonts, the menu options in the Upload and Check-In/Check-Out menus overlap one another. |
|
|
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 the drag-and-drop function fails. |
|
|
Using Internet Explorer 5.0 or 5.5 to upload a file with a non-ASCII file name via the drag-and-drop function 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. |
|
|
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. |
|
|
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. |
|
|
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. |
|
|
Using Netscape to upload (via browse) a document that has a non-ASCII filename, the upload fails. |
|
|
Use Internet Explorer or a different protocol to upload the file, such as FTP or SMB. |
|
Bug 1387938 |
Uploading via the drag-and-drop function may fail. |
|
|
Using the FTP drag-and-drop function from the Web interface, the upload fails if the path to the server is not fully qualified. |
|
|
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 the drag-and-drop function into a folder with a period in its name causes the file to open in Internet Explorer. |
|
|
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. |
|
|
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. |
|
|
If a folder name contains an apostrophe, you cannot open that folder in the Web interface. |
|
|
Remove the apostrophe from the folder name. |
|
Bug 1403302 |
Problems with theme searching. |
|
|
Using theme search in the Advanced Find window causes the web server to stop responding to requests. |
|
|
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. |
|
|
Users cannot create a link to individual versions of a versioned document. |
|
|
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. |
|
|
The tree frame gives unexpected results if a folder in the tree is renamed using a different protocol. |
|
|
Refresh the browser. |
|
Bug 1480275 |
Can't search for documents by language. |
|
|
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. |
|
|
Use the Windows Utilities instead. |
|
Bug 1524432 |
Changing default DAV renderer breaks Web interface. |
|
|
Changing the renderer implementation for the WebDAV renderer breaks the Web interface. |
|
|
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. |
|
|
Much of the user interface for the Web interface is generated by Javascript code. This is a known issue with some versions of Internet Explorer. |
|
|
Use only IE5.5 (5.50.4134.0600) with Simplified Chinese systems. |
|
Bug 1872138 |
Folder items are sorted uppercase first, then lowercase. |
|
|
When listing the items in a folder, the items are sorted case-sensitively, by name. |
|
|
None. |
Windows / SMB Bugs
Windows Utilities Bugs
XML Bugs
Oracle is a registered trademark, and Oracle9i, PL/SQL, and SQL*Plus are trademarks or registered trademarks of Oracle Corporation. Other names may be trademarks of their respective owners.
Copyright © 1999, 2002 Oracle Corporation.
All Rights Reserved.