Skip Headers
Oracle® Application Server Installation Guide
10g (10.1.4.0.1) for Microsoft Windows

Part Number B28192-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

E Configuration Assistants

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

E.1 Troubleshooting Configuration Assistants

Contents:

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. 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 C:\temp\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 Oracle Containers for J2EE entry in the targets.xml file:

    <Target TYPE="oc4j" NAME="instance2.domain.com_home" DISPLAY_NAME="home" VERSION="1.3" DISABLED="TRUE">
       <Property NAME="HTTPMachine" VALUE="stacu02.us.oracle.com"/>
       <Property NAME="OracleHome" VALUE="/local_host/oracle/product/10.1.4IM/OracleAS"/>
       <Property NAME="version" VALUE="9.0.4"/>
       <AssocTargetInstance ASSOC_TARGET="ias" TYPE="oracle_ias" NAME="instance2.domain.com"/>
       <CompositeMembership>
          <MemberOf TYPE="oracle_ias" NAME="instance2.domain.com"/>
       </CompositeMembership>
    </Target>
    
    
  5. 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.

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

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

    4. If the fatal error reoccurs, then you must remove all Oracle installations from your computer using the procedure in Section D.8, "Deinstalling All Oracle Products Manually".

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.

Note that the paths below use "/" as the directory delimiter. You might need to change it for your system. For example, use "\" if you are on a Windows system.

Table E-2 Oracle Application Server Configuration Assistants

Configuration Assistant Description Log File Location

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

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 PATH environment variable includes the ORACLE_HOME\lib directory.

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 PATH environment variable includes the ORACLE_HOME\lib directory

  • 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 PATH environment variable includes the ORACLE_HOME\lib directory.

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 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 Identity Management oneoff Patch Configuration Assistant

Automatically applies the OC4J and database patches using the OPatch tool.

ORACLE_HOME/cfgtoollogs/imoneoffpatchcatimestamp.log

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

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

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

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