5 Oracle Files

This chapter summarizes release note issues associated with Oracle Files.

The following sections are included in the chapter:

What's New
Certification and System Requirements
Deprecations
General Issues
Configuration Issues
Oracle Internet Directory Issues
Globalization Support Issues
Known Bugs

5.1 What's New

The following features are new for Oracle Files Release 2.

5.1.1 Workflow Configuration Enhancements

The Oracle Workflow configuration process for adding additional languages has been simplified.

This feature is available in Oracle Collaboration Suite Release 2 (9.0.4.1). If you have Oracle Collaboration Suite Release 2 (9.0.4.0), download and apply Oracle Collaboration Suite Release 2 Patch Set 1 (9.0.4.2.0) in order to obtain this feature.

5.1.2 Oracle Files Web UI and Oracle FileSync Client Available in Russian

In addition to the nine new languages supported by Oracle Collaboration Suite for Release 2, the Oracle Files Web user interface and the Oracle FileSync user interface have been translated into Russian.

5.1.3 Creating Custom Workflows

Oracle Files comes with a default workflow process. Additionally, with this release you can now define a custom workflow process in Oracle Workflow, then register it with Oracle Files. You can design and register any number of custom workflow processes.

Also new for this release, you can now define an action to be performed when a workflow process is approved, such as moving or copying files to a specified location, versioning the files, or deleting the files.

See Also:

Oracle Files Administrator's Guide for information on how to design and register custom workflows for use in Oracle Files

5.1.4 Branding the Oracle Files User Interface

Some organizations have "look and feel" standards, such as the requirement to use a particular company logo or color scheme. The Oracle Files Web interface can be customized to match those standards.

System Administrators can make the following customizations to the Oracle Files Web interface:

Oracle Files Web interface colors can be altered
Oracle Files Web interface fonts can be changed
Particular Oracle Files Web interface images (such as the Oracle Files logo) can be modified or replaced
The title bar for the Oracle Files Web interface can be altered

See Also:
Oracle Files Administrator's Guide for more information on custom branding

5.1.5 Improved Domain Controller Reliability After Computer Failure

The domain controller is an important component of the Oracle Files domain.

In Oracle Collaboration Suite Release 1, the domain could not be easily shut down, started, monitored, or configured in the following situations (although the domain would continue to run):

If the primary database listener in a RAC configuration failed.
If the computer on which the domain controller was running failed.

The first problem was due to the domain controller using a derived JDBC thin driver URL for communication between the domain controller and the database. To handle this problem, you can now specify a database URL in the registry.xml file. This can then be used to specify a JDBC thick driver URL, which supports Transparent Application Failover (TAF).

To handle the second problem, you can now migrate the domain controller to another middle-tier host.

See Also:

Oracle Files Administrator's Guide for more information on migrating the domain controller

5.1.6 Automatic User Provisioning

In Oracle Files Release 1, users created in Oracle Internet Directory were automatically provisioned in Oracle Files every 24 hours. Shortening this interval required a series of manual steps.

For the current release, the interval has been reduced to 15 minutes. Additionally, users created in Oracle Internet Directory are automatically provisioned in Oracle Files when they log in to Oracle Files for the first time through the Web interface.

5.1.7 Additional Oracle Files Features

The following new Oracle Files features are available if you download and apply Oracle Collaboration Suite Release 2 Patch Set 1 (9.0.4.2.0):

Enhancements to User Lookup
Enable/Disable Workspace Creation feature
Support for Oracle Database 10g Release 1
OmniPortlet support

For information about these features, refer to the Oracle Collaboration Suite Readme Release 2 Patch Set 1 (9.0.4.2.0).

5.2 Certification and System Requirements

Oracle Files requires one of the following Oracle database versions:

Oracle Collaboration Suite Release 2 Information Storage database, with 9.2.0.4 (or later) database patch set
External 9.2.0.4 (or later) version of the Oracle database

In addition, Oracle Files requires a 9.0.2.3 Oracle9iAS infrastructure.

5.2.1 Client Certifications

The following client software has been tested and certified for the various protocol servers offered by Oracle Files. Higher operating system and application service pack and minor version number releases are supported.

5.2.1.1 SMB

Microsoft Windows NT 4.0 Workstation Service Pack 6a with:

Microsoft Office 2000 Service Pack 3, including:
- Microsoft Word 2000
- Microsoft Excel 2000
- Microsoft PowerPoint 2000
- Microsoft FrontPage 2000
Microsoft Windows 2000 Professional Service Pack 3 with:
- Microsoft Office 2000 Service Pack 3, including:
  - Microsoft Word 2000
  - Microsoft Excel 2000
  - Microsoft PowerPoint 2000
  - Microsoft FrontPage 2000
- Microsoft Office XP Service Pack 2, including:
  - Microsoft Word 2002
  - Microsoft Excel 2002
  - Microsoft PowerPoint 2002
  - Microsoft FrontPage 2002
- Microsoft Visio 2000, 2002
- Microsoft Project 2000, 2002
- Adobe Acrobat 5.0
Microsoft Windows XP Professional Service Pack 1 with:
- Microsoft Office 2000 Service Release 1, including:
  - Microsoft Word 2000
  - Microsoft Excel 2000
  - Microsoft PowerPoint 2000
  - Microsoft FrontPage 2000
- Microsoft Office XP Service Pack 2, including:
  - Microsoft Word 2002
  - Microsoft Excel 2002
  - Microsoft PowerPoint 2002
  - Microsoft FrontPage 2002
- Microsoft Office 2003 Professional, including:
  - Microsoft Word 2003
  - Microsoft Excel 2003
  - Microsoft PowerPoint 2003
  - Microsoft FrontPage 2003
- Microsoft Visio 2000, 2002, 2003
- Microsoft Project 2000, 2002, 2003
- Adobe Acrobat 5.0

5.2.1.2 Web Browsers (for Web User Interface and Enterprise Manager Web Site)

Microsoft Windows
- Netscape Communicator 7.x
- Microsoft Internet Explorer 5.5 Service Pack 2
- Microsoft Internet Explorer 6.02 Service Pack 1
- Mozilla 1.2.1, 1.1
Macintosh
- Mac OS 9.1
  - Microsoft Internet Explorer 5.1: Certified for English only. Not certified for other languages due to a published Microsoft Internet Explorer bug.
- Mac OS X version 10.3
  - Microsoft Internet Explorer 5.2: Certified for English only. Not certified for other languages due to a published Microsoft Internet Explorer bug.
  - Netscape Communicator 7.1
  - Mozilla 1.6
Linux
- Netscape Communicator 7.x
- Mozilla 1.2.1, 1.1
UNIX
- Mozilla 1.2.1, 1.1

5.2.1.3 FTP Clients

Microsoft Windows
- OnNet FTP 4.0
- WS_FTP Pro 7.6
- Cute FTP Pro 3.0
- Hummingbird 7.0
UNIX
- Command line ftp Solaris 2.8, 2.9
Macintosh OS X.2

Transmit 2.5.1

5.2.1.4 AFP

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

Microsoft Word for Mac OS X
Microsoft Excel for Mac OS X
Microsoft PowerPoint for Mac OS X

5.2.1.5 NFS Client Support

Microsoft Windows
- Hummingbird NFS Maestro 6.0 (Windows NT)
- Hummingbird NFS Maestro 7.0 (Windows NT/2000)
- OnNet 7.0 (Windows 2000 only)
UNIX
- Solaris 2.8 and 2.9
- Linux Advanced Server 2.1, Kernel 2.4.9-e.16
- Linux Red Hat 8.0

5.2.1.6 WebDAV: Web Folders

Microsoft Windows XP Professional Service Pack 1
- Microsoft Office XP Service Pack 2, with Microsoft Internet Explorer 6.02 Service Pack 1 and MSDAIPP.DLL version 10.145.3914.17 with:
  - Microsoft Word 2002
  - Microsoft Excel 2002
  - Microsoft PowerPoint 2002
  - Microsoft FrontPage 2002
  - Microsoft Visio 2002
  - Microsoft Project 2002
  - Adobe Acrobat 5.0
- Microsoft Office 2000 Service Release 1, with Microsoft Internet Explorer 6.02 Service Pack 1 and MSDAIPP.DLL version 8.103.5219.0 with:
  - Microsoft Word 2002
  - Microsoft Excel 2002
  - Microsoft PowerPoint 2002
  - Microsoft Visio 2002
  - Microsoft Project 2002
  - Adobe Acrobat 5.0
- Microsoft Office 2003 Professional, with Microsoft Internet Explorer 6.02 Service Pack 1 and MSDAIPP.DLL version 11.0.5510.0 with:
  - Microsoft Word 2003
  - Microsoft Excel 2003
  - Microsoft PowerPoint 2003
  - Microsoft Visio 2003
  - Microsoft Project 2003
Microsoft Windows 2000 Professional Service Pack 3
- Microsoft Office XP Service Pack 2, with Microsoft Internet Explorer 6.02 Service Pack 1 and MSDAIPP.DLL version 10.145.3914.17 with:
  - Microsoft Word 2002
  - Microsoft Excel 2002
  - Microsoft PowerPoint 2002
  - Microsoft FrontPage 2002
  - Microsoft Visio 2002
  - Microsoft Project 2002
  - Adobe Acrobat 5.0
- Microsoft Office 2000 Service Pack 3, with Microsoft Internet Explorer 5.5 Service pack 2 and MSDAIPP.DLL version 8.103.3521.0 with:
  - Microsoft Word 2002
  - Microsoft Excel 2002
  - Microsoft PowerPoint 2002
  - Microsoft Visio 2002
  - Microsoft Project 2002
  - Adobe Acrobat 5.0
Microsoft Windows NT 4.0 Workstation Service Pack 6a with:

Microsoft Office 2000 Service Pack 3, with Microsoft Internet Explorer 5.5 Service Pack 2 and MSDAIPP.DLL version 8.103.3521.0 with:
- Microsoft Word 2002
- Microsoft Excel 2002
- Microsoft PowerPoint 2002
- Microsoft FrontPage 2002

5.2.1.7 WebDAV: Oracle FileSync Client

Microsoft Windows XP Professional Service Pack 1
Microsoft Windows 2000 Professional Service Pack 3
Microsoft Windows NT Workstation Service Pack 6
Microsoft Windows 98

5.3 Deprecations

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

5.4 General Issues

This section describes general operations and administration issues you should be aware of before using Oracle Files. The bugs referred to are described in more detail in Section 5.8, "Known Bugs".

5.4.1 Logging Out From Portal Page Does Not Log Users Out of Oracle Files

Using Oracle9iAS Single Sign-On to log out from an application other than Oracle Files will leave users still logged in to Oracle Files. For example, if a user clicks the Return to Portal link in the Oracle Files Web interface, then logs out from the Oracle Collaboration Suite Portal page, the user will still be logged in to Oracle Files.

To ensure that they are logged out of Oracle Files, users should explicitly click Logout from the Oracle Files Web interface. Logging out from the Oracle Files Web interface will log the user out of both Oracle Files and any other SSO-enabled application.

5.4.2 Error Occurs on Creation of Workspaces

If a valid SMTP server is not specified during Oracle Files configuration, or a user has a null or invalid e-mail address, any Oracle Files operation that involves an e-mail notification will fail, including Workspace creation.

Since the Subscriber Administrator's password is sent to the Subscriber Administrator by e-mail, the Subscriber Administrator will not be able to perform any administrative tasks if a valid SMTP server is not specified during configuration. For example, the Subscriber Administrator will not be able to manage users, quota, or categories, specify Subscriber settings, or restore files.

See bug 2520112 for more information about this issue.

5.4.3 Content From the Archive is Moved to BFILE Storage By Default

Content that has been deleted from Trash is moved to the Archive. By default, Oracle Files then moves all content from the Archive into BFILE storage.

Some administrators may want to temporarily disable BFILE storage while they formulate an archival strategy and arrange for adequate disk space. To disable BFILE storage, you must ensure that the following two agents are not initially started by the node:

FilesArchiveFileToBFileAgentConfiguration
FilesDelayedArchiveFileToBFileAgentConfiguration

To do this, use the Oracle Enterprise Manager Web site to update the node configuration that is used by the node that runs these agents.

See Also:

Oracle Files Administrator's Guide for more information about BFILEs and editing node configurations

5.4.4 Mapping Web Folders in Windows XP

When creating a Web Folders mapping in Windows XP, you must specify the port explicitly, even if you are using port 80. For example:

http://foo.acme.com:80/files/content

If you do not specify a port number, Windows XP may use the File System Redirector, which is not supported for use with the Oracle Files WebDAV server.

5.4.5 Saving HTML Files Using Internet Explorer

If you open an HTML file from the Oracle Files Web UI using Internet Explorer, and then choose File > Save As to download the content, the file will be saved as type Web Page, complete by default. If you save the file as this file type, any relative links in the HTML file will be re-written as absolute links due to the default behavior of Internet Explorer.

If you do not want to see this behavior, choose another file type (such as Web Page, HTML only) from the Save As dialog box before saving. Alternatively, if you right-click the file from the Browse Files page and choose Save Target As, you will not see this behavior.

5.4.6 Popup Blockers Can Cause Problems in the Oracle Files UI

If you have a popup blocker installed in your browser, such as the popup blocker in the Google toolbar, it may interfere with some features in the Oracle Files Web interface. For example, the Flashlight Lookup icon and the Calendar Lookup icon that allow you to choose criteria in the Advanced Search page may not function.

Because of this, you should disable popup blockers. For example, to disable the Google popup blocker, click Options on the toolbar, deselect Popup Blocker, and click OK.

5.4.7 Outlook Express Breaks Oracle Files URLs That Contain Multibyte Characters

Due to a known Microsoft bug, if you are using Outlooks Express 5.5 or 6.0, URLs that appear in e-mail notifications sent by Oracle Files are corrupted if the URL contains multibyte characters. To avoid this behavior, use a different e-mail client.

5.4.8 Standby Database Limitations

Because logical standby databases do not currently support all Oracle datatypes, Oracle Files does not support logical standby databases. If you need to use a standby database for disaster recovery, use a physical standby database.

5.5 Configuration Issues

This section describes issues related to configuring Oracle Files.

5.5.1 Workflow Issues

This section discusses configuration issues with Oracle Workflow.

5.5.1.1 Building Custom Workflows

In order to build custom workflows, you need to use Oracle Workflow Builder on a Windows NT, 2000, or XP system. You can download Oracle Workflow Builder from the Oracle Technology Network (OTN). To do this, follow these steps:

Point a Web browser at http://otn.oracle.com.
Navigate to the Oracle Collaboration Suite Downloads page.
Follow the instructions on this page to download Oracle Workflow Builder. The version you want is the Oracle Workflow Embedded Release 2.6.2 for Microsoft Windows 98/NT/2000/XP.

See Also:

Oracle Workflow Guide for information about building custom workflows
Oracle Files Administrator's Guide for information about Oracle Files-specific requirements for custom workflows

After you have created a custom workflow, you need to make it available to Oracle Files by loading the custom workflow into the Workflow schema. To do this, save the custom workflow as a .wft file, copy it to the middle-tier computer where the workflow schema resides, and load the .wft file using wfload:

$ORACLE_HOME/bin/wfload -u workflow_schema_name/workflow_schema_password@database_
URL workflow_file_location/workflow_file_name

For example:

$ORACLE_HOME/bin/wfload -u OWF_MGR/MY_PASSWORD@myhost.us.oracle.com/private
/oracle/MyCustomWorkflow.wft

See Also:

Oracle Files Administrator's Guide for information about registering a custom workflow with Oracle Files

5.5.1.2 LDAP Packages

If you are using an external Oracle 9.2.0.4 database, or if you have upgraded your Oracle Collaboration Suite information storage database, you need to confirm that the Catalog for the LDAP PL/SQL API has been loaded in this database.

To confirm the presence or absence of the Catalog, run the following SQL*Plus command as the SYS user on the database tier:

DESC DBMS_LDAP

If no such package exists, run the catldap.sql script that is present in $ORACLE_HOME/rdbms/admin as the SYS user on the database tier. This creates the catalog in the database.

Caution:

Make sure that you run catldap.sql in the Oracle home of the database; do not run the script from the middle tier or infrastructure Oracle homes.

5.5.1.3 Multiple Instances

You cannot use the same Oracle Workflow schema to support two different Oracle Files domains. If you have multiple Oracle Files domains being used by the same database instance, you must have different Oracle Workflow schemas (as is the case with Oracle Files schemas).

During configuration, you may want to choose an Oracle Workflow schema name different from the default value of OWF_MGR to ensure that you are not reusing an existing Oracle Workflow schema.

5.5.1.4 Provisioning Users Into Oracle Workflow

As new Oracle Files users are created in Oracle Internet Directory, run the following SQL*Plus commands to provision the new users into Oracle Workflow:

set serveroutput on size 1000000
declare
  ret_code boolean;
begin
  ret_code := wf_ldap.synch_changes();
  if (ret_code) then
    dbms_output.put_line('WF_LDAP.Synch_Changes successful');
  else
    dbms_output.put_line('WF_LDAP.Synch_Changes failed. Please try again');
  end if;
exception
  when others then
    dbms_output.put_line('Exception encountered : ' || sqlerrm);
end;
/

Note:

It is recommended that you create a DBMS_JOB that will automatically run wf_ldap.synch_changes() at regular intervals.

5.5.2 Oracle Text Issues

After upgrading an existing Oracle Files domain, you must manually sync the existing IFS_TEXT index.

See Also:

Appendix A, Oracle Text Reference in the Oracle Files Administrator's Guide for more information

5.5.3 Caching Issues

Using Oracle9iAS Web Cache to cache any content located under /files/content is prevented due to a variety of security issues.

5.6 Oracle Internet Directory Issues

This section covers Oracle Internet Directory issues specific to Oracle Files.

See Also:

Oracle Internet Directory Release Notes at http://otn.oracle.com/documentation, for complete information on all known issues.

5.6.1 User Provisioning Failure

Sometimes, users created in Oracle Internet Directory fail to be provisioned in Oracle Files, or you may be unable to add newly provisioned users to Oracle Files Workspaces.

If these problems occur, they are likely due to a failure to set required user attributes in Oracle Internet Directory. The following Oracle Internet Directory user attributes must be non-null for all users:

sn
givenName
mail
username

The username attribute is specified by the orclCommonNicknameAttribute in the Subscriber's OracleContext.

See Also:

Oracle Internet Directory Administrator's Guide for more information on viewing the orclCommonNicknameAttribute

5.7 Globalization Support Issues

Here are some issues relevant to Oracle Files Globalization Support, formerly known as National Language Support (NLS).

5.7.1 Error When Saving Documents with Multibyte Filenames in Internet Explorer

When using the Save As command in Internet Explorer to save documents with multibyte filenames, the filename in the Save As dialog appears corrupted.

To fix this, enable the Always send URLs as UTF-8 option in Internet Explorer:

Select Tools > Internet Options.
Select the Advanced tab.
Check the Always send URLs as UTF-8 option.
Click OK.

5.7.2 Jagged Bold/Italic Fonts

When running in Japanese, Simplified Chinese, Traditional Chinese, and Korean environments, bold or italicized fonts in the Configuration Assistants appear jagged, and are difficult to read.

This issue is caused by problems in the 1.3.1_02b version of the JDK, and can be resolved by moving to JDK 1.3.1_04. This problem will be fixed in future releases of Oracle Files.

See bug 2377003 and base bug 2220343 for more information.

5.7.3 Character Set Limitations

Oracle Files does not support AL32UTF-8 databases for Asian languages, because Oracle Text does not support Chinese, Japanese, and Korean lexers on AL32UTF-8 databases. On such databases, Chinese, Japanese, and Korean documents will not be indexed or searchable. UTF-8 is the recommended character set for Unicode-based file systems. See also bug 2391425.

5.8 Known Bugs

The following bugs are known to exist in this Oracle Files release. Workarounds are given when appropriate. The known bugs are grouped in tables by the following processes or components:

Table 5-1, "Configuration Bugs"
Table 5-2, "Administration Bugs"
Table 5-3, "Generic Oracle Files Bugs"
Table 5-4, "HTTP/WebDAV Bugs"
Table 5-5, "NFS Bugs"
Table 5-6, "AFP Bugs"
Table 5-7, "Windows / SMB / Print Services Bugs"
Table 5-8, "Oracle FileSync Bugs"

Table 5-1 Configuration Bugs

Bug No.	Description	Action
2944440	Oracle Workflow does not use SSL-enabled Oracle Internet Directory. Although Oracle Files can work with an SSL-enabled Oracle Internet Directory instance, Oracle Workflow will only work with the non-SSL port.	Irrespective of whether Oracle Files is configured to work with the SSL-enabled Oracle Internet Directory port, Oracle Workflow must be configured to work with the non-SSL Oracle Internet Directory port.
2961091	Arabic is not available in Oracle Workflow. In this version, Oracle Workflow does not package Arabic in the Workflow product. This is an Oracle Workflow limitation.	None.
2851941	The Oracle Files Configuration Assistant cannot be run against a load-balanced multi-node RAC DB. The Oracle Files Configuration Assistant will not work if you are using a multi-node RAC Database and are using a load-balanced port.	During RAC configuration, set up a database server port that is not load balanced. Then, run the Oracle Files Configuration Assistant against this port.
2960519	Re-use of the Oracle Files schema configured and set up with the same middle tier will cause problems with Agents. If you run the Oracle Files Configuration Assistant more than once in the same Oracle home, against the same Oracle Files domain and schema, the Agents in the local node will become deactivated if the following are true: The middle tier already had a node (before you ran the Oracle Files Configuration Assistant a second time), with all the Agents set to run in it. While running the Oracle Files Configuration Assistant the second time, you selected the Run Agents checkbox.	You may see this problem if you need to run the Oracle Files Configuration Assistant a second time due to failures during the post-upgrade process. You can avoid this behavior by not selecting the Run Agents checkbox in the Node Configuration screen of the Oracle Files Configuration Assistant. Alternatively, if you have already run the Oracle Files Configuration Assistant more than once and your Agents have become deactivated, you can solve the problem by going to the Oracle Enterprise Manager Web site and setting all the Agents to "Active" for the affected node. You must activate each Agent individually.
2520112	Error occurs on creation of Workspaces when there is a problem in a user's e-mail address. If a valid SMTP server is not specified, or a user has a null or invalid e-mail address, any Oracle Files operation that involves an e-mail notification will fail.	Ensure a valid SMTP server is specified in the `FilesBaseServerConfiguration` parameter: IFS.SERVER.APPLICATION.UIX.SmtpServer Ensure that users have valid non-null e-mail addresses.
2391425	NLS: IFSCONFIG fails in Japanese environment on AL32UTF8 database. Oracle Text does not support Japanese lexer on AL32UTF8 databases; hence Oracle Files does not support AL32UTF8 databases for Asian languages.	Use UTF8 for the database instead of AL32UTF8. Alternatively, you can upgrade your database to Oracle Database 10g. You must download and apply Oracle Collaboration Suite Release 2 Patch Set 1 (9.0.4.2.0) to enable Oracle Database 10g support in Oracle Files.
3124801	Oracle Files Release 2 installs an extra documentation directory. Oracle Files shipped with the following outdated directory: $ORACLE_HOME/ifs/files/doc/ The information in this directory is old and is not meant to be used.	Do not refer to the documents under this directory. Instead, refer to the documents on the Oracle Collaboration Suite Documentation CD, or on the Oracle Technology Network (OTN) at `http://otn.oracle.com`.
3214142	Java Command for regular nodes needs to be changed. The current Java Command for Oracle Files regular nodes includes the following argument: -XX:+OverrideDefaultLibthread This argument should be removed. Retaining this argument can cause problems.	Download and apply Oracle Collaboration Suite Release 2 Patch Set 1 (9.0.4.2.0) to stop this argument appearing by default in new node configurations. To remove this argument from existing node configurations, perform the following steps: Log into the Oracle Enterprise Manager Web site on any middle-tier computer and navigate to the Node Configurations page. For each regular node configuration, remove `-XX:+OverrideDefaultLibthread` from the Java Command property and click OK. Restart each regular node. See Also: Oracle Files Administrator's Guide for more information about changing node configurations and restarting regular nodes.
3114881	Help not translated for Russian. Even though the Oracle Files Web interface has been translated into Russian, translated help files are not displayed.	Download and apply Oracle Collaboration Suite Release 2 Patch Set 1 (9.0.4.2.0).
3016906	Oracle Files configuration against Windows 64-bit Oracle9i Database Server 9.2 database fails. The database is missing the `ctxhx` executable that is required to enable Oracle Text on the schema.	There are two possible solutions: If you get an error message during Oracle Files configuration saying "Oracle Text Verification Failed," click OK to create a schema without Oracle Text enabled. Build your own `ctxhx` executable. For more information, see OTN at `http://otn. oracle.com/products/text/htdocs/FilterServer.htm`
3313333	Oracle Workflow help is not configured by default. For Oracle Workflow Release 2.6.2 and earlier, the help must be manually configured.	First, unzip the help files: Navigate to `$ORACLE_HOME/wf`. Unzip `wfdoc262.zip` to the `$ORACLE_HOME/wf` directory. Help files will be extracted to the `/doc/us` directory. Next, configure the `OA_DOC` virtual directory: Navigate to `$ORACLE_HOME/apache/apache/conf`. Open `httpd.conf` for editing. In the Alias section, add the following line: Alias /OA_DOC/ "$ORACLE_HOME/wf/doc/" Note: Substitute an absolute path for `$ORACLE_HOME`. Restart the Oracle HTTP Server. See the Oracle Files Administrator's Guide for information about how to do this.
3130775	Post upgrade, clicking on the Oracle Files domain renders a blank page. A blank page appears after clicking the upgraded Oracle Files domain name link.	Download and apply Oracle Collaboration Suite Release 2 Patch Set 1 (9.0.4.2.0). Alternatively, you can follow these steps: Copy the `files.jar` file (located in `$ORACLE_HOME/ifs/files/lib`) to the following directory: $ORACLE_HOME/sysman/webapps/emd/WEB-INF/lib Copy the file `jewt4.jar` (located in `$ORACLE_HOME/jlib/`) to the following directory: $ORACLE_HOME/sysman/webapps/emd/WEB-INF/lib/ Rename the file from `jewt4.jar` to `jewt.jar`.
2960325, 2615650	Set up a workaround to use the Oracle9iAS Web Cache port instead of the http or https port for Netscape or Mozilla. Users may get the following error when trying to access a page in Oracle Files using Netscape or Mozilla: "Oracle SSO Warning - Unable to process request. Either the requested URL was not specified in terms of a fully-qualified hostname or OHS single sign-on is incorrectly configured. Please notify your administrator." This error is caused by the browser being unable to determine the port number for Web Cache. This error does not appear for Microsoft Internet Explorer users.	If you encounter this problem, explicitly set the Web Cache URLs in the list of Partner applications: Using a Web browser, go to: http://infra_host:port/pls/orasso/ orasso.home Log in as the `orcladmin` user. Click SSO Server Administration. Click Administer Partner Applications. Click the pencil icon next to the Oracle Files middle tier. Specify the following for Home URL, Success URL, and Logout URL: Home URL: http://mid_tier_host:web_cache_port Success URL: http://mid_tier_host:web_cache_port/ osso_login_success Logout URL: http://mid_tier_host:web_cache_port/ osso_logout_success Note: If you are using SSL, specify the Web Cache SSL port and substitute https for http. Click Apply and then Ok to save the changes.

Table 5-2 Administration Bugs

Bug No.	Description	Action
2867479	User authentication occasionally fails when accessing Oracle Files. This error message occurs in configurations that use a load balancer for multiple Oracle Internet Directory servers. The error occurs when a user tries to log in to the domain after a certain period (equal to the connection timeout period on the load balancer) of inactivity on the middle tier against the Oracle Internet Directory server. The problem is more likely to happen if there are very few users on the system. The greater the number of active users, the less likely the problem will occur, because the level of interaction between the middle tiers and Oracle Internet Directory automatically increases, which ensures that the connection between the middle tier and Oracle Internet Directory does not time out.	The user can retry the operation, which should generally work. Alternatively, increase the connection timeout period on the load balancer that is used to connect to the Oracle Internet Directory servers.
2408925	Oracle Enterprise Manager allows illegal characters for service name. Service Configuration objects that have ';' embedded in their names will cause problems.	Do not use ';' in service names.
2746006	Cannot stop the Oracle Files domain if the Oracle Files schema password is changed. The schema password for Oracle Files is required in order to be able to start or stop a domain.	Do not change the schema password for a running Oracle Files instance.
2852809	Need to restart the Oracle Files domain any time the default Subscriber is changed on the LDAP server. If the default Subscriber is changed in Oracle Internet Directory after the Oracle Files domain has been started, users in the new default Subscriber will be created with user names of the format `username``@``subscribername`.	Restart the domain, and delete the old default subscriber from Oracle Files after changing the default Subscriber in Oracle Internet Directory.
2629614	User's first name is not getting synchronized from Oracle Internet Directory into Oracle Files. The user's first name is not synchronized when the user is auto-provisioned, or by the OID Synchronization Agent.	Download and apply Oracle Collaboration Suite Release 2 Patch Set 1 (9.0.4.2.0).

Table 5-3 Generic Oracle Files Bugs

Bug No.	Description	Action
2414889	Searches don't exclude AFP resource forks. It is possible for Oracle Files Advanced Searches to include AFP resource forks in search results. Any actions performed on these files will result in an error.	Ignore these files in the search results.
3200325	Oracle Collaboration Suite Search only supports exact matches on User Name for Oracle Files content. Oracle Collaboration Suite Search for Oracle Files ignores the content of the User Name field if the value provided does not match a valid Oracle Files user.	Provide an exact match in the Oracle Collaboration Suite Search User Name field when searching Oracle Files content. Do not use wildcards.
2518871	Files with multibyte file names that were zipped with the Oracle Files Zip feature must be unzipped with a utility that supports UTF8. If you use the Zip feature in the Oracle Files Web user interface to zip a file or set of files that have multibyte file names, you cannot use WinZip to unzip the file because WinZip does not support UTF8.	Unzip the file using either the Unzip feature in the Oracle Files Web user interface, or use the JAR utility to unzip the file locally.
3078486	Users with punctuation in their passwords may have problems. If Oracle Files users have punctuation in their passwords (for example, ';' '%' '#'), these users may not be able to enable protocol access in Oracle Files. In addition, these users may be unable to change their SSO passwords using the Oracle Files Web UI.	To solve this problem, choose one of the following options: Option 1 Ensure that the following service configuration property is set to `FALSE` in the service configuration that you are using: `IFS.SERVICE.CaseSensitive Authentication` See Also: Oracle Files Administrator's Guide for more information about viewing and setting service configuration parameters If any of the affected users existed in Oracle Internet Directory before Oracle Files was installed, reset their passwords using Oracle Internet Directory tools. You can reset the password to the same value, or you can choose a different value. Option 2 If you want to use case-sensitive authentication, you should not permit users to include punctuation in their passwords. Use Oracle Internet Directory tools to change the passwords of existing users that have punctuation in their passwords.
2988862	Users whose names begin with a number get an error when clicking the My Public Files tab in the Oracle Files Web interface. If a user's name begins with a number, such as 123user, that user cannot access their public files through the My Public Files tab in the Oracle Files Web interface.	Users whose names begin with a number can access their public files through another protocol, such as WebDAV, or by navigating to their public folder from the All Public Files tab in the Oracle Files Web interface. To access public files through the All Public Files tab, follow these steps: Click All Public Files. Click Users. Click the Users folder that corresponds to the number at the start of the user name (for example, Users-1). Click the user's public folder (for example, 123user-Public).

Table 5-4 HTTP/WebDAV Bugs

Bug No.	Description	Action
2393968, 2386806, 2337719	URLS with '#,' '%,' or ';' in them do not work. URLs that have these characters embedded will cause problems.	Do not use '#,' '%,' or ';' in URLs.
2955251	Cannot connect to Oracle Files through WebDAV cookie-less client. If multiple Oracle Files middle tiers are fronted by a load balancer that relies on cookies to load balance requests, WebDAV clients that do not store cookies will not be able to access that Oracle Files instance via the load balancer.	Configure the load balancer to use IP addresses instead of cookies for load balancing.
2614217	Uploading a document via Netscape returns an Oracle SSO warning error. When the Oracle Collaboration Suite middle tier is configured, it registers with the Single Sign-On server using the Oracle HTTP Server port. It is incorrect to register the HTTP Server port if Oracle9iAS Web Cache is configured.	For `mod_osso` to work correctly, the Single Sign-On registration for this middle tier must be corrected manually. See Also: Oracle9i Application Server Administrator's Guide for detailed information on how changes in hostname and port affect Oracle9iAS, and specifically how `mod_osso` and Oracle9iAS Single Sign-On Server may be affected
2697262	WebDAV drag-and-drop download can result in 0-byte file. Dragging a file from a Web Folder on Oracle Files to the local PC file system can result in a 0-byte file if the file is locked by another user on Oracle Files. This appears to be caused by `MSDAIPP.DLL` version 8.103.2402.	Upgrade Internet Explorer to the latest Service Pack. Ensure the client environment conforms to the supported configuration listed in Client Certifications for WebDAV: Web Folders.
3006494	Cannot create multiple Web Folder mappings that use different user credentials on the same client computer. Because of a Web Folders limitation, Oracle Files does not support logging in to Web Folders as different users from the same Windows client. Web Folders caches user credentials, so if you first create a Web Folders mapping as user1, and then create a second mapping as user2, after user1's connection is disconnected, user2 will be able to access user1's content.	Do not create Web Folder mappings that use different user accounts from the same client computer. Alternatively, you can restart the Windows client.
3225450	Cannot authenticate through WebDAV if Oracle Files is configured to run using https. If you have set up Oracle Files to run using https, Web Folders cannot be used due to authentication problems. This is caused by a default security check that prevents the ability to authenticate using basic authentication.	Download and apply Oracle Collaboration Suite Release 2 Patch Set 1 (9.0.4.2.0). Alternatively, you can follow these steps: Log in to the Oracle Enterprise Manager Web site and navigate to the Server Configurations page. Set the following `DavServer Configuration` property to TRUE: `IFS.SERVER.PROTOCOL.DAV.IfsServer.Auth.CearText.Accept` Restart `OC4J_iFS_files` and reload the DAV server on each middle-tier host. See Also: Oracle Files Administrator's Guide for more information about setting server configuration parameters, reloading servers, and restarting the OC4J instance
3103878	In the Oracle Files Web interface, right-clicking a > 30 character multibyte filename and choosing "Save Target As" corrupts the filename. This is a known issue with the Microsoft operating system. Oracle is currently working on a resolution. Please contact Oracle Support for an update on the resolution to this issue.	Use shorter filenames, manually type in the correct filename, or use Web Folders.

Table 5-5 NFS Bugs

Bug No.	Description	Action
1749601	Unable to `chgrp` in Oracle Files NFS. A `chgrp` does not have any effect on mode for a file.	None. The security model is different and this has no impact.
1749621	Unable to `chmod` in Oracle Files NFS. A `chmod` does not have any effect on mode for a file.	None. The security model is different and this has no impact.
1750049	Mode attributes cannot be set. Cannot change the permission mode bits through Oracle Files NFS.	None. The security model is different and this has no impact.
1749778	Links cannot be created using Oracle Files NFS. No links (symbolic, soft, or hard) can be created in Oracle Files NFS.	None. The security model is different and this has no impact.
2333774	Cannot copy files or folders where a non-standard ASCII character is the first character in the name. Folders and files that have non-standard ASCII characters as the first character cannot be copied using NFS Maestro.	Use other NFS clients; this problem appears to be a Maestro limitation.

Table 5-6 AFP Bugs

Bug No.	Description	Action
1990453	File Encrypt fails when using Mac OS Finder to encrypt files on Oracle Files (mounted as AFP volume). The Mac OS File > Encrypt utility creates temporary files containing * in their names. However, Oracle Files does not allow filenames to contain an asterisk.	Do not try to encrypt a file from a Mac. Instead, encrypt the file locally, on the Mac, and then copy the encrypted file to Oracle Files through AFP.
2380571	Size of Mac file does not take into account size of resource fork. The resource fork is not being included in size computations; thus, the size of the document may not be accurate.	None.
2994830	Making a file non-versioned in the Oracle Files Web interface can cause the file to vanish. Documents in the Oracle Files application can be versioned using the Web interface. If a Macintosh user is logged in using AFP and viewing a folder with a versioned file, the file is visible but read-only. If a user logs in to the Web interface and changes this file so that it is now NOT versioned (by deleting all saved versions), the file viewed by the AFP user may vanish from the Macintosh client folder listing.	The workaround is for the Macintosh user to log out and log back in to AFP. This will refresh the folder listing.
2719007	The default protocol character set logic is applied globally. The AFP server protocol (or, "command") encoding is a constant value that is applied globally for the server. Every user session that connects to the AFP server uses the same encoding; there is no way to override this encoding on a per-user or per-session basis. If there are AFP clients (Macintosh clients) that need to connect to the AFP server with a different encoding, they will not be able to do so unless the AFP server encoding is changed accordingly.	The workaround so that multiple clients with differing encodings can use the AFP server together is to run multiple AFP servers. To do this, use multiple middle-tier computers, each running an AFP server with the desired encoding. The AFP server encoding is specified in the property `IFS.SERVER.PROTOCOL.AFP.Encoding`.
2994813	Cannot open documents under or upload into AllPublic/Users/... The AFP server for the Oracle Files application allows Macintosh clients to mount either the "user's home directory" or the "AllPublic" directory as network volumes. The AllPublic volume has a limitation where files under the "Users" folder inside the AllPublic volume cannot be opened reliably, and new files cannot be uploaded into the "Users" folder. Files and folders can be listed, however, and files can be copied to the local disk.	To open files, copy them to the local disk first, then open them. To upload files, use the "user's home directory" mountpoint (volume) instead of the AllPublic volume.
2995643	Microsoft PowerPoint files with long names cannot be saved directly. PowerPoint files with file names longer than 31 characters appear truncated when you try to save using AFP. For example: long_long_long_long_lo?5A0B.ppt The user will be able to open the PowerPoint file and copy it to the local hard disk, just like any other file. Once opened in PowerPoint, however, if the user makes changes to the file and issues a "Save" command, an error will be displayed: "Error accessing file filename." The changes will not be saved and the original file that was opened will be deleted (moved to the Trash and renamed "PowerPoint Temp 0" or similar).	If you want to save changes and keep the file, issue a "Save As" command, either by choosing the command from the menu or toolbar, or by clicking "Yes" in the dialog box that is displayed when the file is closed. Choose a different name for the saved file. Once you do so, the new file will be saved correctly.
2463376	Finder does not refresh folder listing. When the contents of a folder is updated by adding, removing, or modifying files, the AFP finder does not refresh the folder listing.	Log out and log back in to work around this problem.

Table 5-7 Windows / SMB / Print Services Bugs

Bug No.	Description	Action
1113581	Cannot delete or rename versioned files in SMB. 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 Files, the Oracle Files SMB server does not allow deletion or renaming of versioned files.	Use the Web interface to delete the file.
2472522	Windows generates multiple print jobs. Certain versions of Windows create multiple print jobs in Oracle Files when the user requests to print a single document. These extra print jobs have no content, and will not result in paper use. They will, however, show up in the queue for a short period of time. The correct document will still be printed.	None.
2344972	Cannot print to printer that is restricted by username and password. When connecting to a printer from Windows NT/2000, the user is not prompted for a user name and password. If the share is restricted by a user name and password, then the user will not be able to print.	There are two courses of action: Before mounting the printer, map a network drive to a file share on the same server. When the user is prompted for the user name and password, enter the same user name and password that will subsequently be used for accessing the printer. Before mounting the printer, open a DOS prompt and enter: > net use \\server_name\printer_name password /USER:user_name Then mount the printer, using the exact same name for the printer share.
2424896	Server property for enabling printing does not appear in SMB Server Configuration. In order to enable printing via SMB, the Oracle Files administrator must set a property to specifically enable the sharing of printers. This property will not be listed automatically as one of the SMB server configuration properties.	The Oracle Files administrator must manually add the `IFS.SERVER.PROTOCOL.SMB. EnablePrinting` property and set its value to `TRUE`.
2890902	Files lose metadata when they are copied between folders using SMB. Copying a file from Windows using a network drive mapped to the Oracle Files SMB server will only copy the contents of the file. Oracle Files metadata, such as categories, will not be copied. This is a limitation of the Windows operating system. The Windows operating system does not handle Oracle Files metadata, and therefore does not copy this metadata when copying a file. Under some circumstances, a file cut and paste operation in Windows Explorer will result in a file move rather than a file copy. Oracle Files metadata is maintained when a file move is performed.	The Oracle Files Web interface should be used to copy files that have metadata. Copying a file using the Oracle Files Web interface will maintain the file's metadata.
2995548	Users may need to manually cancel blank jobs after printing. Some Windows clients may add blank print jobs ahead of the actual print job when a user prints to Oracle Files Print Services. These jobs may get "stuck" in the queue.	Users must double click on the printer icon and manually cancel the blank print jobs if their document is not getting printed.
3020371	Cannot list SMB mountpoints with Hummingbird NFS client. When a computer has the Hummingbird NFS client installed, the computer will attempt to use NFS when told to connect to a server that supports both NFS and SMB. When a user clicks Start > Run and types `\\``server_name`, the Hummingbird NFS client will display the NFS mountpoints in the window that comes up. SMB mountpoints and printers will not be displayed.	There are many possible workarounds for this issue: Mount the SMB mountpoints and printers directly, using the Map Network Drive dialog or the Add Printer Wizard. Disable the NFS server on the computer that is running the SMB server. Uninstall the Hummingbird NFS client on the computers that need to list SMB mountpoints on a server.
3008391	Users may not be able to add printers through the Add Printer Wizard. When a user adds a printer through the Add Printer Wizard from Windows clients, they may get the error "Printer cannot be found."	Do not use the Add Printer Wizard to add a printer. Instead, click Start > Run. Then, type `\\``server_name` and press Enter. In the window that appears, double-click the printer you wish to add.
3027080	Programs that use DOS 8.3 file names will not work with long file names. Programs that use DOS 8.3 file names will not work against the SMB server because the SMB server does not support translating long file names into the short DOS 8.3 format file names. Examples of such programs are DOS edit, the Windows image accessory, and the Windows Paint accessory. These programs require file names in DOS 8.3 format. They also require each directory in the path to be an 8.3 directory name.	Rename the file to the DOS 8.3 format for filenames. If necessary, move the file to another directory so that the path does not contain any directories with long filenames.
3027564	When editing a PowerPoint file, the modified date may not get updated on NT. When editing a Microsoft PowerPoint file on Windows NT, the modified date for the file may not get updated when the file is saved.	Make sure that the current Windows NT service pack has been installed. If the problem persists, save the file to the local drive and copy the file to the SMB mapped drive.
3108043	The LogAllCommands server configuration parameter must be manually added and set to True in order to see complete SMB log information. The SMB server has a configuration parameter which allows additional information to be logged in the log file. This information, which consists of the SMB server commands that are being executed, can be used to debug problems in the SMB server.	Using the Oracle Enterprise Manager Web Site, add the `IFS.SERVER.PROTOCOL.SMB. LogAllCommands` parameter to the `SmbServerConfiguration`. Set the value to `TRUE` in order to see the SMB commands in the log file. See Also: Oracle Files Administrator's Guide for more information about adding server configuration parameters

Table 5-8 Oracle FileSync Bugs

Bug No.	Description	Action
2374879	Server-side folders with the percent (%) character in their names are not synchronized. Folders and files that have '%' embedded in their names will not be synchronized during the sync process.	Do not use '%' in folder names if you want to use Oracle FileSync for file synchronization.
3037418, 3436884	There is no Arabic or Romanian selection available in the list of installation languages for Oracle FileSync. Oracle FileSync can be installed on an Arabic or Romanian computer and will function in Arabic and Romanian. However, the installation process will not display Arabic or Romanian.	Install Oracle FileSync in another language, then switch the locale to Arabic or Romanian. Note: The Romanian language is not available for Oracle FileSync unless you have downloaded and applied Oracle Collaboration Suite Release 2 Patch Set 1 (9.0.4.2.0).