D Configuration Assistants

This appendix lists the configuration assistants and the location of their log files.

• Section D.1, "Troubleshooting Configuration Assistants"

• Section D.2, "Description of Oracle Application Server Configuration Assistants"

D.1 Troubleshooting Configuration Assistants

Contents:

• Section D.1.1, "General Tips"

• Section D.1.2, "Configuration Assistant Result Codes"

D.1.1 General Tips

If a configuration assistant fails, try the following steps to correct the problem:

1. Review the installation log files listed in Section E.1, "Log Files".

2. Review the log files for the failed configuration assistant. Configuration assistant log files are listed in Section D.2, "Description of Oracle Application Server Configuration Assistants". Try to fix the issue that caused the error.

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

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

5. If configuration assistant failure occurs when running configuration assistant execution commands on the command line, then re-run the configuration assistant execution command again.

   You can use the generated script file named configtoolcmds.pl located in the ORACLE_HOME/bin directory to execute the failed configuration assistant again. The configtoolcmds.pl script is generated after you exit the installer. During silent or non-interactive installation, the configtoolcmds.pl script is generated immediately after configuration assistant failure.

6. If you see a "Fatal Error. Reinstall" message, find the cause of the problem by analyzing the log files. You cannot recover from a fatal error by correcting the problem and continuing. You must remove the current installation and reinstall Oracle Application Server. The following tasks describe the recovery procedure:

   1. Deinstall the failed installation using the procedure described in Appendix C, "Deinstallation and Reinstallation".

   2. Correct the cause of the fatal error.

   3. Reinstall Oracle Application Server.

   4. If the fatal error reoccurs, then you must remove all Oracle installations from your computer.

D.1.2 Configuration Assistant Result Codes

If a configuration assistant fails, the bottom half of the installation screen displays the error message, and the configuration assistant writes its result code (Table D-1) to the following log file:

oraInventory/logs/installActionstimestamp.log

Table D-1 Result Codes for Configuration Assistants

Result Code	Description
0	Configuration assistant succeeded
1	Configuration assistant failed
-1	Configuration assistant cancelled

D.2 Description of Oracle Application Server Configuration Assistants

Table D-2 lists the Oracle Application Server configuration assistants in alphabetical order. Different installations use different configuration assistants depending on installation type and configuration options you selected.

Table D-2 Oracle Application Server Configuration Assistants

Configuration Assistant	Description	Log File Location
ADF Configuration Assistant	Integrates Oracle Application Development Framework Runtime Libraries with Oracle Enterprise Manager 10g Application Server Control. This configuration assistant requires the ORACLE_HOME/jlib/emConfigInstall.jar file.	ORACLE_HOME/cfgtoollogs/configtoolstimestamp.log ORACLE_HOME/oraInventory/logs/installActionstimestamp.log
OPMN Configuration Assistant	Starts OPMN and OPMN-managed processes.	ORACLE_HOME/cfgtoollogs/configtoolstimestamp.log ORACLE_HOME/cfgtoollogs/ipm.log ORACLE_HOME/cfgtoollogs/ons.log