Skip Headers
Oracle® Developer Suite Installation Guide
10g Release 2 (10.1.2) for Solaris, Windows and Linux x86
  Go To Documentation Library
Go To Product List
Go To Table Of Contents
Go To Index


F Troubleshooting

This appendix lists some methods for troubleshooting your Oracle Developer Suite installation. It includes the following topics:

F.1 Before You Begin

Oracle recommends that you review the following before you attempt to fix problems in your Oracle Developer Suite installation:

F.1.1 Verify Hardware and Preinstallation Requirements

First, review the Oracle Developer Suite hardware and software requirements and preinstallation tasks:

F.1.2 Read the Release Notes

Oracle recommends reading the Oracle Developer Suite 10g ( Release Notes for Windows and UNIX prior to installing. These document contain product-level and component-level release notes for Windows, Linux and Solaris platforms. This manual is available in the Oracle Developer Suite Documentation Library. To display the manual, see Section C.3.1, "Viewing the Release Notes from Disk". The manual is also available on Oracle Technology Network (

Your platform-specific documentation may include release notes for your platform. Platform-specific release notes are also available on Oracle Technology Network (

F.2 Troubleshooting the Installation

If you encounter an error while installing Oracle Developer Suite, follow these steps:

F.3 Troubleshooting Oracle Developer Suite Configuration Assistants

To troubleshoot an installation error that occurs when the configuration assistants are running:

F.3.1 Determining Configuration Assistant Execution Status

Oracle Developer Suite configuration assistant failures are noted at the bottom of the installation screen. The configuration assistant interface displays additional information, if applicable. The configuration assistant's execution status will be identified by the result. The result codes are listed in Table F-1:

Table F-1 Configuration Assistant Result Codes

Status Result Code

Configuration Assistant Succeeded


Configuration Assistant Failed


Configuration Assistant Cancelled


This result code is written to the following log file: oraInventory/logs/installActionstimestamp.log

F.3.2 Fixing Configuration Assistant Failures

During installation, configuration assistants run when the Configuration Assistants screen appears. If a configuration assistant fails, try the following procedure to correct the problem:

  1. Review the installation log files for this installation session.

  2. Review the log files for each configuration assistant located in the DevSuiteHome/cfgtoollogs directory. Default log file locations are described in Table F-2.

  3. Refer to the section describing the configuration assistants in Table F-2:

    1. If the failing configuration assistant has any dependencies, then run the dependencies again. You must do this even if the dependency completed successfully.

    2. If an optional configuration assistant fails, and it does not have any dependencies, run the remaining configuration assistants. Uncheck the cancelled optional configuration assistant, highlight and check the next listed configuration assistant, and click Retry.

    3. Run the failing configuration assistant again. If you are using the installer, select the configuration assistant and click Retry.


      If the description of a configuration assistant in Table F-2 includes an "Initial Tasks" section, you must perform these tasks before running the configuration assistant.

F.3.3 Handling Fatal Errors

Some configuration assistant failures are fatal errors. You cannot recover from a fatal error by correcting the problem and continuing. You must remove the current installation and reinstall Oracle Developer Suite. The following tasks describe the recovery procedure:

  1. Deinstall the failed installation using the procedure described in Section 4.1, "Deinstallation".

  2. Correct the cause of the fatal error.

  3. Reinstall Oracle Developer Suite.

  4. If the fatal error reoccurs, then you must remove all Oracle installations from your computer using the procedure in Section Section 4.1.1, "Deinstalling Using the Installer".

F.3.4 Oracle Developer Suite Configuration Assistant Descriptions

Table F-2 lists the configuration assistants that run during Oracle Developer Suite installation. Different installation types may use different configuration assistants.


Some configuration assistants run in silent mode, which means that their user interfaces are not visible.

Table F-2 Oracle Developer Suite Configuration Assistant Descriptions

Configuration Assistant Description Log File Location

Oracle Net Configuration Assistant

The Oracle Net Configuration Assistant configures the database listener and configures the mid-tier Oracle Application Server instances to use LDAP naming by default.

STDOUT/STDERR (all messages appear in the installer window)