Skip Headers

Oracle® Application Server 10g Forms and Reports Services Installation Guide
10g (9.0.4) for Microsoft Windows
Part No. B13642-01
  Go To Table Of Contents
Contents
Go To Index
Index

Previous Next  

A Troubleshooting

This appendix lists some methods for troubleshooting your Oracle Application Server 10g (9.0.4) Forms and Reports Services installation. It includes the following topics:

A.1 Verify Requirements

Review the following information before performing any of the troubleshooting steps in this appendix:


Read the Release Notes

A.2 What to Do If an Installation Error Occurs

If you encounter an error during installation of Forms and Reports Services:

A.3 Troubleshoot Configuration Assistants

To troubleshoot an installation error that occurs when the configuration assistants are running:

A.3.1 Configuration Assistant Failure

Oracle Application Server 10g (9.0.4) Forms and Reports Services configuration assistant failures are noted at the bottom of the installation screen. The Forms and Reports Services configuration assistant interface displays additional information, if applicable. The configuration assistant’s execution status will be identified by the result. The result codes are:

Status Result Code
Configuration Assistant Succeeded 0
Configuration Assistant Failed 1
Configuration Assistant Cancelled -1

This result code is written to the following log file:

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

A.3.2 Failure During Component Configuration and Startup

During installation, configuration assistants run when the Configuration Assistants screen appears. If a configuration assistant fails, try the following procedure to correct the problem:

  1. Review the installation log files for this Forms and Reports Services instance.

  2. Review the log files for each configuration assistant located in the ORACLE_HOME\cfgtoollogs directory. Default log file locations are described in Section A.4, "Descriptions of Oracle Application Server 10g (9.0.4) Forms and Reports Services Configuration Assistants".

  3. Refer to the section describing the configuration assistants in Section A.4, "Descriptions of Oracle Application Server 10g (9.0.4) Forms and Reports Services Configuration Assistants".

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

    2. Run the failing configuration assistant again. If you are using the installer, select the configuration assistant and click Retry.

      If the configuration assistant fails again after you click Retry, then you must remove the or lock entry and try re-running the configuration assistant again.

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

    4. 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 configToolCommands located in the ORACLE_HOME\cfgtoollogs directory to execute the failed configuration assistant again. The configToolCommands script is generated after you exit the installer. During silent or non-interactive installation of Forms and Reports Services the configToolCommands script is generated immediately after configuration assistant failure.

      You must set the following environment variables before using the generated script:

      • Set the ORACLE_HOME environment variable to the ORACLE_HOME path.

      • Append the PATH environment variable with ORACLE_HOME\lib and ORACLE_HOME\network\lib.

      • For the Register DCM Plug-Ins With EM Configuration Assistant only, set the PERL5LIB environment variable to the ORACLE_HOME\perl\lib\5.6.1 directory.


      Note:

      If the description of a configuration assistant includes an "Initial Tasks" section, you must perform these tasks before running the configuration assistant.

A.3.3 Fatal Errors

Some configuration assistant failures are "fatal errors". You cannot recover from a fatal error by correcting the problem and continuing. You must remove the current installation and reinstall Forms and Reports Services. The following tasks describe the recovery procedure:

  1. Deinstall the failed installation using the procedure described in Section B.1, "Deinstallation of 10g (9.0.4) Instances".

  2. Correct the cause of the fatal error.

  3. Reinstall Oracle Application Server 10g (9.0.4) Forms and Reports Services.

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

A.3.4 OC4J Instance Configuration Assistant Errors

If the OC4J Instance Configuration Assistant fails with the following error:

Adding dependent libraries for application 'portal'...done. 
Deploying application 'oraudrepl' to OC4J instance 'OC4J_Portal'... 
ERROR: Caught exception during deploy. 
java.rmi.RemoteException: deploy failed!: ; nested exception is: 
oracle.oc4j.admin.internal.DeployerException: User specified for 
application-client uddirepl, 'uddi_replicator' not found 
at com.evermind.server.rmi.RMIConnection.
EXCEPTION_ORIGINATES_FROM_THE_REMOTE_SERVER(RMIConnection.java:1520)
... lines omitted ...

This error is seen when you are installing a middle tier against an Oracle Internet Directory that was upgraded from 9.2.0.x to 10g (9.0.4), but not all the upgrade steps were completed. Make sure you followed the steps on upgrading Oracle Internet Directory 9.2.0.x to 10g (9.0.4) as documented in the Oracle Application Server 10g Upgrading to 10g (9.0.4) guide. The instructions are in the "Upgrading the Identity Management Services" chapter.

A.4 Descriptions of Oracle Application Server 10g (9.0.4) Forms and Reports Services Configuration Assistants

Table A-1 lists the Forms and Reports Services configuration assistants in alphabetical order. Different installations use different configuration assistants depending on installation type and configuration options you selected.

Table A-1 Oracle Application Server 10g (9.0.4) Forms and Reports Services Configuration Assistants

Configuration Assistant Description Log File Location
Application Server Control Configuration Assistant The Application Server Control Configuration Assistant starts the Oracle Management Agent and the Application Server Control to deploy applications through the Oracle Enterprise Manager Application Server Control.
NA
BC4J Configuration Assistant The BC4J Configuration Assistant integrates BC4J with the Oracle Enterprise Manager Application Server Control.

This configuration assistant requires the ORACLE_HOME\jlib\ emConfigInstall.jar file.

NA
DCM Repository Backup Assistant The DCM Repository Backup Assistant enables you to back up your DCM repository.
NA
Forms Configuration Assistant The Forms Configuration Assistant configures the Oracle Application Server Forms Services server and integrates Oracle Application Server Forms Services with Oracle Enterprise Manager Application Server Control.
ORACLE_HOME\forms90\config\ formsConfig.log
HTTP Server Configuration Assistant The HTTP Server Configuration Assistant configures Oracle HTTP Server and registers it with the Oracle Enterprise Manager Application Server Control.
ORACLE_HOME\Apache\Apache\httpd.log
Java Security Configuration Assistant The Java Security Configuration Assistant changes default password and sets and reassigns new passwords for JAAS security.
ORACLE_HOME\cfgtoollogs\jaznca.log
OC4J Configuration Assistant The OC4J Configuration Assistant integrates OC4J with the Oracle Enterprise Manager Application Server Control. It uses the Oracle Enterprise Manager Application Server Control-provided APIs to perform the following steps:
  • Add entries to the targets.xml file

  • Add entries to the iasadmin.properties file

  • This configuration assistant is dependent on the presence of the deploy.ini file.

NA
OC4J Instance Configuration Assistant The OC4J Instance Configuration Assistant configures OC4J instances for deployed Oracle Application Server 10g (9.0.4) Forms and Reports Services applications. NA
OPMN Configuration Assistant The OPMN Configuration Assistant starts OPMN and OPMN-managed processes.
ORACLE_HOME\opmn\logs\opmn.log
OPMN Configuration Assistant- start Oracle HTTP Server Starts Oracle HTTP Server through OPMN.
ORACLE_HOME\opmn\logs\HTTP_Server.log
OPMN Configuration Assistant- start DAS instance Starts DAS instance through OPMN.
ORACLE_HOME\opmn\logs\opmn.log
Oracle Net Configuration Assistant The Oracle Net Configuration Assistant configures the database listener and configures the mid-tier Oracle Application Server 10g (9.0.4) Forms and Reports Services instances to use the LDAP naming by default.
ORACLE_HOME\oraInventory\logs\ installActions<time.stamp>.log
OracleAS Instance Configuration Assistant The OracleAS Instance Configuration Assistant adds Oracle Application Server 10g (9.0.4) Forms and Reports Services instance name into the ORACLE_HOME\config\ targets2add.xml file
NA
Register DCM Plug-Ins With EM Configuration Assistant Registers DCM plug-ins with Enterprise Manager. NA
Reports Configuration Assistant The Reports Configuration Assistant configures the Oracle Application Server Reports Services server and integrates Oracle Application Server Reports Services with Oracle Enterprise Manager Application Server Control.
ORACLE_HOME\reports\config\ reportsConfig.log
Web Cache Configuration Assistant The Web Cache Configuration Assistant configures OracleAS Web Cache and registers it with Oracle Enterprise Manager Application Server Control.
ORACLE_HOME\webcache\log\log.xml