This appendix provides troubleshooting information, in these topics:
If you encounter an error during installation:
Read the Oracle Fusion Middleware Release Notes for Microsoft Windows (32-Bit) for the latest updates. The release notes are available with the platform-specific documentation. The most current version of the release notes is available from the Oracle Documentation page on Oracle Technology Network at
http://www.oracle.com/technology/documentation
Verify that your system meets the requirements specified in Section 3.1.1, "Meeting System Requirements".
If you are installing a middle tier, check that the OracleAS Infrastructure with which you want to associate the middle tier is running during installation.
If you entered incorrect information on one of the installation screens, return to that screen by clicking Back until you see the screen.
If an error occurred while the installer is copying or linking files:
Note the error and review the installation log files.
Remove the failed installation by following the steps in Chapter 11, "Deinstalling Oracle Enterprise Content Management Suite."
Correct the issue that caused the error.
Restart the installation.
This section contains solutions to common problems that you might encounter while installing and configuring Oracle Enterprise Content Management Suite.
If you are having problems with full-text search, Oracle IBR conversions, Dynamic Converter, Desktop Integration Suite, or Content Categorizer on a Windows operating system, first make sure you have downloaded correct the Visual C++ Redistributable Package, as described in Section 4.7.3, "Downloading Visual C++ Libraries for a Windows Operating System."
The Oracle Fusion Middleware installer and Fusion Middleware Configuration Wizard create their own sets of log files.
On a UNIX operating system, the installer writes the following log files:
oraInventory_location/logs/installActionstimestamp.log
oraInventory_location/logs/oraInstalltimestamp.err
oraInventory_location/logs/oraInstalltimestamp.out
ORACLE_HOME/install/make.log
On a Windows operating system, the installer writes the following log files:
inventory_location\logs\installActionstimestamp.log
inventory_location\logs\oraInstalltimestamp.err
inventory_location\logs\oraInstalltimestamp.out
The default inventory_location value follows:
%PROGRAMFILES%\Oracle\Inventory
Fusion Middleware Configuration Wizard writes log files in the cfgtoollogs directory in your Oracle home directory.
If you want to access the log files created by the installer, you need to exit it first. The log files are inaccessible if the installer is still in use.
If the Oracle Information Rights Management (Oracle IRM) key store has not been configured correctly, then issues will occur during creation of a context. If you cannot create a context, check the server log for one of the following errors.
Missing key store file
If the key store does not exist, you will see a FileNotFoundException message in the log:
java.io.FileNotFoundException: C:\IRM\oracle\middleware\user_projects \domains\base_domain\config\fmwconfig\irm.jceks (The system cannot find the file specified)
Missing key
If the key store exists, but the keys are missing, you will see an UnknownKeyException message in the log:
oracle.irm.engine.content.store.UnknownKeyException: The key oracle.irm.wrap does not exist in the key store C:\IRM\oracle\middleware\user_projects\domains\base_domain\config\fmwconfig\irm.jceks
Missing password
If the password is missing or incorrect you will see the following exception in the log:
java.security.UnrecoverableKeyException: Given final block not properly padded
When you attempt to connect Oracle I/PM to an Oracle UCM 11g repository, Oracle I/PM returns errors in these cases:
If Oracle UCM is installed in a domain that is later extended with Oracle I/PM and you have not restarted the Oracle I/PM Managed Server.
If the Oracle UCM and Oracle I/PM Managed Servers are configured to run on different machines and you have not performed the manual configuration.
For information about avoiding these errors, see Section 7.1.1.1, "Configuring Oracle Content Server 11g to Work with Oracle I/PM."
If you are having problems with Oracle IBR conversions on a Windows operating system, first make sure you have downloaded correct the Visual C++ Redistributable Package, as described in Section 4.7.3, "Downloading Visual C++ Libraries for a Windows Operating System".
This section provides troubleshooting information for the following Oracle IBR setup and run issues:
Oracle IBR will not run as either an application or a service. If you try to run Oracle IBR from a command line, you receive the following error message:
Error: Cannot read the config.cfg.
| Possible Causes | Solutions |
|---|---|
| Sun Java is not installed on the Oracle IBR machine. Sun Java must be installed on both the Oracle Content Server machine and the Oracle IBR machine. |
|
Oracle IBR will run as an application, but it will not run as a service. In some cases, you will receive the following error message when launching the service:
Error 1069: The service did not start due to a logon failure.
| Possible Causes | Solutions |
|---|---|
| If you receive Error 1069, the user linked to the Oracle IBR service has not been given the right to log on as a service. | Make sure user linked to the Oracle IBR service is valid and has the right to log on as a service. |
| There is a problem with the Oracle IBR service. |
|
The Oracle IBR service will run for a short period of time when started, but then the service fails and stops.
| Possible Causes | Solutions |
|---|---|
Java options settings in the intradoc.cfg file for the refinery. |
Change the Java options settings in the intradoc.cfg file for the Oracle IBR connection. For details, see "Setting Java Options in the intradoc.cfg File" in Oracle Fusion Middleware Administrator's Guide for Conversion. |
To set up Java options in the intradoc.cfg file:
Open the intradoc.cfg file located in the refinery_install_dir\bin directory in a text editor.
First, try the following setting:
JAVA_SERVICE_EXTRA_OPTIONS=-Xrs
Save your changes to the intradoc.cfg file and restart the Oracle IBR service.
If the first change is not successful, re-open the intradoc.cfg file and try the following setting:
JvmCommandLine=$JAVA_EXE $JAVA_SERVICE_EXTRA_OPTIONS $APPEND_CLASSPATH $CLASSPATH $STARTUPCLASS
Save your changes to the intradoc.cfg file and restart the Oracle IBR service.
When you attempt to log in to a refinery after installation, you get an error similar to the following one:
"Content Server Access Denied Access denied to Content Server managed resource. Error getting user credentials from proxied user cache. Unable to open file c:/ucm/cs1/data/users/proxied/ref1/userdb.txt. c:/ucm/cs1/data/users/proxied/ref1/userdb.txt contains an invalid path."
| Possible Causes | Solutions |
|---|---|
The refinery has been proxied to Oracle Content Server, but the InboundRefinerySupport component has not been installed and enabled on Oracle Content Server. |
Install and enable the InboundRefinerySupport component on Oracle Content Server.
For more information, see Section 1.4.3.2, "Enabling Components for Oracle IBR on Oracle Content Server." |
When Inbound Refinery is run on a Windows Server 2003 system, files intermittently get stuck in GenWWW. There are no conversion errors, and when resubmitted, the files are successfully converted.
| Possible Causes | Solutions |
|---|---|
| The problem is directly related to known file locking and deleting issues on a Windows Server 2003 system and typically occurs when Oracle Content Server runs on a UNIX operating system and Samba is used to connect to the Windows Server 2003 machine. However, the problem can also occur when you are using Oracle IBR on the Windows Server 2003 system and Oracle IBR resides on a separate physical machine from Oracle Content Server.
Please see the following knowledge base articles on the Microsoft web site to better understand these Windows Server 2003 issues:
|
In order to confirm you are experiencing the issues described in Microsoft's Knowledgebase entries, delete several files on your Windows Server 2003 machine using a remote client. If you witness a delay of up to 40 seconds in the file deletion it is likely that the Windows Server 2003 locking/deleting issue is the problem. Microsoft offers two solutions to this issue.
If you need specific information on how to disable opportunistic locking on the Windows Server 2003 server, please see the following Microsoft article: |
You are running Oracle IBR as a service, but it will not convert any documents, and the following error message is displayed in the Oracle IBR log:
Unable to convert, native application reported: 'Permission denied'
This error will usually occur when Samba is used, with Oracle Content Server on a UNIX operating system and Oracle IBR on a Windows operating system.
| Possible Causes | Solutions |
|---|---|
| You are using AutoExNT to map the UNIX volumes through a mapped network drive to Samba, and the DCOM permissions are not set properly for the user running the Oracle IBR service. | Change the DCOM permissions for the user running the Oracle IBR service. For details, see the following procedure for changing DCOM permissions. |
Launch dcmocnfg.exe to check user permissions for the user running the Oracle IBR service.
On the Default Security tab, make sure the domain user is added to Connect, Access, Launch, and Configuration.
Restart the Oracle IBR service.
If this appendix does not solve the problem you encountered, try these other sources:
Oracle Fusion Middleware Release Notes for Microsoft Windows (32-Bit), available through the Oracle Documentation page on Oracle Technology Network at
http://www.oracle.com/technology/documentation
My Oracle Support (formerly OracleMetaLink) web site at
http://support.oracle.com
If you do not find a solution for your problem, open a service request.