Configuration Assistants

The Configuration Assistants screen shows the name, status, and tool type for tools recommended to be run before completing installation, along with optional configuration assistants that can be run at your discretion.

Note: Recommended tools must be run in order. If a recommended tool fails or is cancelled, you must correct the problem and successfully run that tool before proceeding to the next tool.

A tool may have one of the following states, as shown in the status column:

Succeeded: The tool ran successfully.
Failed: The tool ran, but failed.
Pending: The tool is waiting to run.
Cancelled: You cancelled the tool (by clicking Stop).
In Progress: The tool is currently running.
Skipped: A configuration assistant running before this tool was cancelled or failed. Tools that follow a failed or cancelled tool are skipped.

When you select a tool, its details are shown in the Details box. Details are displayed as the tool is running. If you want to stop a configuration assistant while it is running, click Stop.

If all tools succeed on the first try, OUI automatically proceeds to the next page. Otherwise, OUI remains on the Configuration Assistants page until all tools are successful. You can then click Next to proceed.

If one or more tools fail, OUI does not proceed to the next page. Instead, you can read the details of failed tools, fix the problems, and try running the configuration assistant again. You should also consult the installation document for the product being installed for instructions on what to do if a tool fails. For all failed or skipped tools, OUI generates a list of the tool names and the commands used to run them; you can copy/paste this information directly into a shell script or batch file to run these tools after installation is complete.

By default, all tools that failed or were skipped will be selected. To retry all checked configuration assistants, click Retry.

To continue without fixing the problem, click Next.

Note: The installation is considered successful, even if all configuration assistants failed, irrespective of their type (Recommended or Optional). However, failing to successfully run all recommended tools results in an improperly configured product that may not function.

Configuration Assistant Logs

A configuration assistants log file (configlog.xml) is created if the product you are installing uses a configuration assistant. Configuration assistants are usually run at the end of an installation and they prompt you to perform initial configuration changes to your application.

The XML log files are saved in the following locations:

oracle_home\inventory\Components21\product\version (Windows)

oracle_home/inventory/Components21/product/version (UNIX)

Other configuration Assistant log files are saved in the following directories:

oracle_home/cfgtoollogs (Windows)

oracle_home\cfgtoollogs (UNIX)

These directories contain the file configtoolstimestamp.log and other configuration assistant log files; for example, emca.log.