Oracle® Content Management SDK

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

Oracle Text seems to be misconfigured

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

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

3. Restart the database, including listener.

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

The OPMN timeout value is too low.

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

2. Open the opmn.xml file.

3. Edit the following parameters:

   • start timeout

   • stop timeout

4. Restart OPMN to make the changes take effect.

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

1. Select Content Management SDK (SchemaName).

2. Select Node Configuration.

3. Select WebStarterApp Node.

4. Select WebStarterAppServer.

5. Set WebStarterAppServer to active.

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

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

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

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

The database is missing the ctxhx executable that is required to enable Oracle Text on the schema.

• Create a schema without Oracle Text enabled.

• Build your own ctxhx executable. For information, see OTN at http://otn.oracle.com/products/text/htdocs/FilterServer.htm

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

chmod +x ifsshell

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

When trying to configure against a 9.2.0.3 or 9.2.0.4 database, the following error occurs in the log when trying to create Advanced Queues:

java.sql.SQLException: No more data to read from socket

The problem is that some of the stored procedures are still at the 9.2.0.1 level, yet the software was upgraded to 9.2.0.3 or 9.2.0.4.

1. Shut down the database.

2. Start up the database in migrate mode.

3. Run catpatch.sql from the $ORACLE_HOME/rdbms/admin directory.

4. Run the Oracle CM SDK Configuration Assistant.

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

1. Access the Oracle Application Server middle tier console.

2. Select Content Management SDK (SchemaName).

3. Select Node Configurations.

4. Select WebStarterApp Node.

5. Select WebStarterAppServer.

6. Set WebStarterAppServer to active.

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

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

• interMedia Audio

• interMedia AudioCdTrack

• interMedia Image

• interMedia Movie

• interMedia Source

• interMedia Video

• Link

• MediaTextBlob

• NodeConfiguration

• PortletUserProfile

• Rfc822ContentObject

• Rfc822Message

• ServerConfiguration

• ServiceConfiguration

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   alter system set REMOTE_LOGIN_PASSWORDFILE=EXCLUSIVE scope = spfile
   
   

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

   REMOTE_LOGIN_PASSWORDFILE=EXCLUSIVE
   

4. Restart your database for the changes to take effect.

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

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.

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

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

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

• IFS-10172: Distinguished name not unique

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

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

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

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

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

ERROR at line 1:
ORA-00604: error occurred at recursive SQL level 1
ORA-24005: must use DBMS_AQADM.DROP_QUEUE_TABLE to drop queue tables

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

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

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

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

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

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

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

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

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

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

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.

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

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

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

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

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

Editing a link to a deleted document generates an error.

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

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

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

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

Alternatively, you can restart the Windows client machine.

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

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

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

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

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

2. Set the following Dav ServerConfiguration property to TRUE:

   IFS.SERVER.PROTOCOL.DAV. IfsServer.Auth.CearText. Accept
   

3. Restart OC4J_iFS_cmsdk and reload the DAV server on each middle-tier host.

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

URLs that have these characters embedded will cause problems.

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

Certain versions of Windows create multiple print jobs in Oracle CM SDK when the user requests to print a single document. These extra print jobs have no content, and do not result in paper use. They do, however, show up in the queue for a short period of time. The correct document is still be printed.

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

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

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

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

When connecting to a printer from Windows NT/2000, the user is not prompted for a username and password. If the share is restricted by a username and password, then the user is not able to print.

1. Before mounting the printer, map a network drive to a file share on the same server. When the user is prompted for his username and password, enter the same username and password that are to be subsequently used to access the printer.

2. Before mounting the printer, open a DOS prompt and enter:

   > net use \\<server-name>\<printer-name>   <password> /USER:<username>
   

   Then mount the printer, using the same name for the printer share.

An error indicates that the user name is invalid.

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.

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

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

When a user adds a printer through the Add Printer Wizard from Windows clients, they may get the error "Printer cannot be found."

In the window that appears, double-click on the printer you wish to add.

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

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.

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

Using drag and drop to move mail from Outlook 2000 to a drive mapped to Oracle CM SDK results in an error message stating that the file cannot be dropped to this location, and a zero length file is created on the mapped drive. This error occurs when using Outlook 2000 on Windows NT. The error does not occur on Windows 2000 or when using Outlook Express.

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

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

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