F Configuration Assistants

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

Section F.1, "Troubleshooting Configuration Assistants"
Section F.2, "Description of Oracle Application Server Configuration Assistants"

F.1 Troubleshooting Configuration Assistants

Contents:

Section F.1.1, "General Tips"
Section F.1.2, "Configuration Assistant Result Codes"

F.1.1 General Tips

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

Review the log files for the failed configuration assistant. Configuration assistant log files are listed in Section F.2, "Description of Oracle Application Server Configuration Assistants". Try to fix the issue that caused the error.
If the failed configuration assistant has any dependencies, then run the dependencies again. You must do this even if the dependency completed successfully.

Run the failed configuration assistant again by selecting the configuration assistant in the installer and clicking Retry.

If the configuration assistant fails again after you click Retry, remove the /tmp/EM_CONFIG_INSTALL.lk file and re-run the configuration assistant again.

If the configuration assistant fails again after you click Retry, remove the component entry from the ORACLE_HOME/sysman/emd/targets.xml file. For example, the following lines show the OracleAS Web Cache entry in the targets.xml file:

<Target TYPE="oracle_webcache" NAME="instance2.domain.com_Web Cache" DISPLAY_NAME="Web Cache">
   <Property NAME="HTTPPort" VALUE="7777" />
   <Property NAME="logFileName" VALUE="webcache.log" />
   <Property NAME="authrealm" VALUE="Oracle Web Cache Administrator" />
   <Property NAME="AdminPort" VALUE="4000" />
   <Property NAME="HTTPProtocol" VALUE="http" />
   <Property NAME="logFileDir" VALUE="/sysman/log" />
   <Property NAME="HTTPMachine" VALUE="domain.com" />
   <Property NAME="HTTPQuery" VALUE="" />
   <Property NAME="controlFile" VALUE="/ORACLE_HOME/webcache/bin/webcachectl" />
   <Property NAME="MonitorPort" VALUE="4002" />
   <Property NAME="HTTPPath" VALUE="/" />
   <Property NAME="authpwd" VALUE="administrator" />
   <Property NAME="authuser" VALUE="administrator" />
   <CompositeMembership>
      <MemberOf TYPE="oracle_ias" NAME="domain.com" ASSOCIATION="null" />
   </CompositeMembership>
</Target>

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.
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 run 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.
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 E, "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.

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

oraInventory/logs/installActionstimestamp.log

Table F-1 Result Codes for Configuration Assistants

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

F.2 Description of Oracle Application Server Configuration Assistants

Table F-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.

Note that the following paths use "/" as the directory delimiter. You might need to change it for your system.

Table F-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/oraInventory/logs/installActionstimestamp.log
Application Server Control Configuration Assistant	Starts the Oracle Management Agent and the Application Server Control to deploy applications through the Oracle Enterprise Manager 10g Application Server Control.	ORACLE_HOME/cfgtoollogs/configtoolstimestamp.log
Database Configuration Assistant	Configures the OracleAS Metadata Repository for OracleAS Infrastructure.	ORACLE_HOME/cfgtoollogs/configtoolstimestamp.log
Database Migration Assistant	Migrates an older version of the infrastructure database to the current version of the infrastructure database. Before running this migration assistant, make sure the database is up and running.	ORACLE_HOME/assistants/dbma/logs
Database- managed OracleAS Cluster Assistant	Enables cluster configuration for selected databases.	ORACLE_HOME/config/infratool_dcm_repository.log ORACLE_HOME/cfgtoollogs/infratool_dcm_repository.log
DCM Repository Backup Assistant	Enables you to back up your DCM repository.	ORACLE_HOME/dcm/logs
Delegated Administration Service Configuration Assistant	Sets up the Oracle Delegated Administration Services URL in Oracle Internet Directory and adds the necessary access control privileges to the DAS entity. Before running this configuration assistant, make sure the Infrastructure Instance Configuration Assistant was run successfully.	ORACLE_HOME/cfgtoollogs/dasca.log
Directory Integration Platform Configuration Assistant	Registers and starts the directory integration server when configured with Oracle Internet Directory. Before running this configuration assistant, make sure Oracle Internet Directory is properly configured.	ORACLE_HOME/cfgtoollogs/dipca.log
Discoverer Configuration Assistant	Performs the following tasks: reads the contents of the `discoconfig5.properties` file adds entries to the `targets.xml` file adds a provider with a few parameters adds an entry to `opmn.xml` reloads OPMN registers the Discoverer session	ORACLE_HOME/oraInventory/logs/installActionstimestamp.log ORACLE_HOME/cfgtoollogs/configtoolstimestamp.log
File-Based Farm Repository Configuration Assistant	Configures a file-based repository for Oracle Application Server components.	ORACLE_HOME/config/infratool_filebased_repository.log ORACLE_HOME/cfgtoollogs/infratool_filebased_repository.log
Forms Configuration Assistant	Configures the OracleAS Forms Services server and integrates OracleAS Forms Services with Oracle Enterprise Manager 10g Application Server Control. It adds an entry to `targets.xml` file. Before running this configuration assistant, make sure that OracleAS Infrastructure is up and running.	ORACLE_HOME/forms90/config/formsConfig.log
HTTP Server Configuration Assistant	Configures Oracle HTTP Server, registers it with Oracle Enterprise Manager 10g Application Server Control, and adds an entry to the `ORACLE_HOME/sysman/emd/targets.xml` file.	ORACLE_HOME/Apache/Apache/logs ORACLE_HOME/Apache/Apache/httpd.log ORACLE_HOME/cfgtoollogs/configtoolstimestamp.log
Infrastructure Database Registration Assistant	Registers the OracleAS Metadata Repository with Oracle Internet Directory.	ORACLE_HOME/cfgtoollogs/infratool_ldaporacfg.log
Infrastructure Instance Configuration Assistant	Updates the `ORACLE_HOME/config/ias.properties` file, registers the instance with Oracle Internet Directory, and creates the `ldap.ora` file with Oracle Internet Directory credentials in the `ORACLE_HOME/network/admin` file. Before running this configuration assistant, check that the `SHLIB_PATH` environment variable includes `ORACLE_HOME/lib32` and `ORACLE_HOME/network/lib`:	ORACLE_HOME/config/infratool_instance_jazn.log ORACLE_HOME/cfgtoollogs/infratool_instance_jazn.log
Infrastructure mod_osso Configuration Assistant.	Registers mod_osso, plugs mod_osso into Oracle HTTP Server, and provides integration with OracleAS Single Sign-On to authenticate users.The registration enables Oracle HTTP Server installed with OracleAS Infrastructure to act as a partner application to OracleAS Single Sign-On. Applications that run under Oracle HTTP Server can register and protect their URL with mod_osso. When the URL is requested, mod_osso authenticates the user with OracleAS Single Sign-On to allow access to the URL.	ORACLE_HOME/config/infratool_mod_osso.log ORACLE_HOME/cfgtoollogs/ infratool_mod_osso.log
Infrastructure Schema Configuration Assistant	Registers the Infrastructure schemas with Oracle Internet Directory. Before running this configuration assistant, check that: the `SHLIB_PATH` environment variable includes `ORACLE_HOME/lib32` and `ORACLE_HOME/network/lib` the Internet Directory Configuration Assistant and the Database Configuration Assistant were run successfully	ORACLE_HOME/config/schemaload.log ORACLE_HOME/cfgtoollogs/schemaload.log
Infrastructure Upgrade Instance Configuration Assistant	Removes ACL entries on the `SSO` schema. Before running this configuration assistant, check that the `SHLIB_PATH` environment variable includes `ORACLE_HOME/lib32` and `ORACLE_HOME/network/lib`:	ORACLE_HOME/config/infratool_infra_upgrade.log
Internet Directory Configuration Assistant	Starts up Oracle Internet Directory, loads the LDAP schemas, and sets up the Oracle Identity Management realm. Before running this configuration assistant, check that the database was created successfully, the listener is up and running, and the `tnsnames.ora` file is configured.	ORACLE_HOME/cfgtoollogs/oidca.log
Java Security Configuration Assistant	Changes the default password, and sets or reassigns new passwords for JAAS security.	ORACLE_HOME/cfgtoollogs/jaznca.log
OC4J Configuration Assistant	Integrates OC4J with Application Server Control. It performs the following steps: Add entries to the `targets.xml` file. Add entries to the `iasadmin.properties` file. This configuration assistant requires the `deploy.ini` file.	ORACLE_HOME/cfgtoollogs/configtoolstimestamp.log
OC4J Instance Configuration Assistant	Configures OC4J instances for deployed Oracle Application Server applications.	ORACLE_HOME/cfgtoollogs/configtoolstimestamp.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
OPMN Configuration Assistant - start DAS instance	Starts Oracle Delegated Administration Services instance through OPMN.	ORACLE_HOME/cfgtoollogs/configtoolstimestamp.log ORACLE_HOME/cfgtoollogs/ipm.log ORACLE_HOME/cfgtoollogs/ons.log
OPMN Configuration Assistant - start OCA	Starts OCA through OPMN.	ORACLE_HOME/cfgtoollogs/configtoolstimestamp.log ORACLE_HOME/cfgtoollogs/ipm.log ORACLE_HOME/cfgtoollogs/ons.log
OPMN Configuration Assistant - start Oracle HTTP Server	Starts Oracle HTTP Server through OPMN.	ORACLE_HOME/cfgtoollogs/configtoolstimestamp.log ORACLE_HOME/cfgtoollogs/HTTP_Server~1
OCA Configuration Assistant	Configures a self-signed certificate authority, integrated with OracleAS Single Sign-On for authentication. Before running this configuration assistant, check that Oracle Internet Directory, OracleAS Metadata Repository, OracleAS Single Sign-On, and the Repository API are configured.	ORACLE_HOME/cfgtoollogs/oca_install.log
OracleAS File-Based Farm Repository Configuration Assistant	Configures a file-based farm repository.	ORACLE_HOME/config/infratool_filebased_repository.log ORACLE_HOME/cfgtoollogs/infratool_filebased_repository.log
OracleAS Instance Configuration Assistant	Adds an entry for the instance to the `ORACLE_HOME/config/target2add.xml` file.	ORACLE_HOME/cfgtoollogs/configtoolstimestamp.log
OracleAS Randomize Password Configuration Assistant	Changes the default password of all schemas.	None
Oracle mod_osso Configuration Assistant	Registers mod_osso during installation, plugs mod_osso into Oracle HTTP Server, and provides integration with OracleAS Single Sign-On to authenticate users. The registration enables Oracle HTTP Server installed with the Oracle Application Server middle tier to act as a partner application to OracleAS Single Sign-On.Applications running under Oracle HTTP Server can register and protect their URL with mod_osso. When the URL is requested, mod_osso authenticates the user with OracleAS Single Sign-On to allow access to the URL.	ORACLE_HOME/config/j2ee_mod_osso.log ORACLE_HOME/cfgtoollogs/j2ee_mod_osso.log
Oracle Net Configuration Assistant	Configures the database listener and the middle tiers to use LDAP naming by default.	ORACLE_HOME/cfgtoollogs/installActionstimestamp.log
Personalization Configuration Assistant	Configures OracleAS Personalization.	ORACLE_HOME/oraInventory/logs/installActionstimestamp.log
Portal Configuration Assistant	Configures OracleAS Portal. Before running this configuration assistant, check that the OracleAS Infrastructure is up and running.	ORACLE_HOME/cfgtoollogs/install.log
Register DCM Plug-Ins With Oracle Enterprise Manager 10g Configuration Assistant	Registers DCM plug-ins with Oracle Enterprise Manager 10g.	ORACLE_HOME/cfgtoollogs/configtoolstimestamp.log ORACLE_HOME/dcm/logs/dcmctl_logs
Replication Configuration Assistant	For ASR replica installations, it writes the new Oracle Internet Directory metadata to the master Oracle Internet Directory. For LDAP replica installations, it configures LDAP-based replication between the master Oracle Internet Directory and the new Oracle Internet Directory replica with default configuration. It then starts the Oracle Internet Directory replication server and helps configure Oracle Internet Directory replication. Before running this configuration assistant, check that the Oracle Internet Directory servers for the master and the new replica are up and running.	ORACLE_HOME/ldap/log/remtool.log
Reports Configuration Assistant	Configures the OracleAS Reports Services server and integrates OracleAS Reports Services with Oracle Enterprise Manager 10g Application Server Control. Before running this configuration assistant, check that OracleAS Infrastructure is up and running.	ORACLE_HOME/cfgtoollogs/reportsConfig.log
Single Sign-On Configuration Assistant	Configures OracleAS Single Sign-On. Before running this configuration assistant, check that Oracle Internet Directory, OracleAS Metadata Repository, and the Repository API are configured.	ORACLE_HOME/sso/log/ssoca.log ORACLE_HOME/sso/log/ssoreg.log
Ultra Search Configuration Assistant	Performs the following tasks: Deploys and configures Oracle Ultra Search within the Oracle Application Server middle tier. Creates Oracle Ultra Search back-end application entities and Oracle Ultra Search administration privilege groups. Creates application entities for the Oracle Ultra Search middle tier. Upgrades and cleans up Oracle Ultra Search metadata in the OracleAS Metadata Repository.	ORACLE_HOME/cfgtoollogs/ultrasearch_config.log
Unlock Metadata Repository Schemas Configuration Assistant	Unlocks the schemas in the OracleAS Metadata Repository. This configuration assistant is run for Oracle Identity Management installations.	ORACLE_HOME/config/infratool_unlock_schema.log
Use Infrastructure Configuration Assistant	Updates the `ORACLE_HOME/config/ias.properties` file, registers the instance with Oracle Internet Directory, and creates the `ldap.ora` file with Oracle Internet Directory credentials in the `ORACLE_HOME/network/admin` directory. Before running this configuration assistant, check that the PATH environment variable includes the `ORACLE_HOME/lib` and ORACLE_HOME directories.	ORACLE_HOME/config/j2ee_instance_jazn.log ORACLE_HOME/cfgtoollogs/j2ee_instance_jazn.log
Use Metadata Repository Configuration Assistant	Configures OracleAS Metadata Repository for the Oracle Application Server middle tier. This includes the ability to expand J2EE and Web Cache middle tiers to a larger installation type. Before running this configuration assistant, check tha the `SHLIB_PATH` environment variable includes `ORACLE_HOME/lib32` and `ORACLE_HOME/network/lib`:	ORACLE_HOME/config/infratool_midtier_upgrade.log
Web Cache Configuration Assistant	Configures OracleAS Web Cache and registers it with Oracle Enterprise Manager 10g Application Server Control.	ORACLE_HOME/cfgtoollogs/configtoolstimestamp.log
Wireless Configuration Assistant	Configures OracleAS Wireless.	ORACLE_HOME/wireless/logs/wireless_CA.out ORACLE_HOME/cfgtoollogs/wireless_CA.out
OracleAS Wireless SDK Configuration Assistant	Configures the Wireless Development Kit.	ORACLE_HOME/wireless/logs/wdk_ca.out ORACLE_HOME/cfgtoollogs/wdk_ca.out