E Configuration Assistants

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

• Section E.1, "Troubleshooting Configuration Assistants"

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

E.1 Troubleshooting Configuration Assistants

This section contains the following topics:

• Section E.1.1, "General Tips"

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

E.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 F.1, "Log Files".

2. Review the log files for the failed configuration assistant. Configuration assistant log files are listed in Section E.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 D, "Deinstallation and Reinstallation".

   2. Correct the cause of the fatal error.

   3. Reinstall Oracle Application Server.

   Note:

   The tips in this section do not apply to the Oracle Content DB Configuration Assistant. If the Oracle Content DB Configuration Assistant is stopped or fails, follow the steps in Section D.3, "Additional Deinstallation Tasks for Oracle Content DB" before attempting to install again. Do not click Retry.

   You can find the Oracle Content DB Configuration Assistant log in the following location:

   ORACLE_HOME\content\log\ContentConfig.log
   

E.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 E-1) to the following log file:

C:\Program Files\Oracle\Inventory\logs\installActionstimestamp.log

Table E-1 Result Codes for Configuration Assistants

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

E.2 Description of Oracle Application Server Configuration Assistants

Table E-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 E-2 Oracle Application Server Configuration Assistants

Configuration Assistant	Description	Log File Location
Oracle Application Server Configuration Assistant	Configures Oracle Application Server.	ORACLE_HOME\cfgtoollogs\configtoolstimestamp.log
Oracle Content DB Configuration Assistant	Configures a new OC4J instance for Oracle WebCenter Framework.	ORACLE_HOME\content\log\ContentConfig.log
Oracle Process Management and Notification Configuration Assistant	Starts OPMN and OPMN-managed processes.	ORACLE_HOME\cfgtoollogs\configtoolstimestamp.log ORACLE_HOME\opmn\logs\ipm.log ORACLE_HOME\opmn\logs\ons.log
Oracle WebCenter Framework Configuration Assistant	Configures Oracle WebCenter Framework components and deploys sample portlets	ORACLE_HOME\cfgtoollogs\configtoolstimestamp.log C:\Program Files\Oracle\Inventory\logs\installActionstimestamp.log