Oracle® Application Server 10g Forms and Reports Services Installation Guide
10g (9.0.4) for Microsoft Windows
Part No. B13642-01
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:
Review the following information before performing any of the troubleshooting steps in this appendix:
Ensure that the computer meets the requirements specified in Chapter 5, " Requirements".
Read the Oracle Application Server 10g (9.0.4) Release Notes prior to installing Forms and Reports Services. The release notes are available with the platform-specific documentation. The latest version of the release notes is available on OTN at:
Read the Oracle Application Server 10g (9.0.4) Forms and Reports Services Release Notes, which contain release notes for Oracle Forms Services, Oracle Forms Developer, Oracle Reports Services, and Oracle Reports Developer. In addition, the Oracle Application Server 10g (9.0.4) Forms and Reports Services Release Notes contains information about the features that are available in this installation type.
If you encounter an error during installation of Forms and Reports Services:
If you entered incorrect information on one of the installation screens, return to that screen by clicking Back until you see the screen.
Exit the installer only if you want to access the component log files. The log files located
ORACLE_HOME\cfgtoollogs directory are inaccessible if the installer is still in use.
Note the error and review the installation logs for causes:
Remove the failed installation by following the steps in Appendix B, " Deinstallation and Reinstallation".
Correct the issue that caused the error.
Restart the installation.
To troubleshoot an installation error that occurs when the configuration assistants are running:
Review the installation log files listed in Section A.2, "What to Do If an Installation Error Occurs".
Review the configuration assistant log files located in the
ORACLE_HOME\cfgtoollogs directory for a specific Forms and Reports Services configuration assistant. Section A.4, "Descriptions of Oracle Application Server 10g (9.0.4) Forms and Reports Services Configuration Assistants" also lists any other log file locations for a specific configuration assistant. Try to fix the issue that caused the error.
If you see a "Fatal Error. Reinstall" message, try to find the cause of the problem by analyzing the log files. Refer to Section A.3.3, "Fatal Errors" for further instructions.
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:
|Configuration Assistant Succeeded||0|
|Configuration Assistant Failed||1|
|Configuration Assistant Cancelled||-1|
This result code is written to the following log file:
During installation, configuration assistants run when the Configuration Assistants screen appears. If a configuration assistant fails, try the following procedure to correct the problem:
Review the installation log files for this Forms and Reports Services instance.
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".
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".
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.
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
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:
ORACLE_HOME environment variable to the
PATH environment variable with
For the Register DCM Plug-Ins With EM Configuration Assistant only, set the
PERL5LIB environment variable to the
Note:If the description of a configuration assistant includes an "Initial Tasks" section, you must perform these tasks before running the configuration assistant.
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:
Deinstall the failed installation using the procedure described in Section B.1, "Deinstallation of 10g (9.0.4) Instances".
Correct the cause of the fatal error.
Reinstall Oracle Application Server 10g (9.0.4) Forms and Reports Services.
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".
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.
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.||
|BC4J Configuration Assistant||The BC4J Configuration Assistant integrates BC4J with the Oracle Enterprise Manager Application Server Control.
This configuration assistant requires the
|DCM Repository Backup Assistant||The DCM Repository Backup Assistant enables you to back up your DCM repository.||
|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.||
|HTTP Server Configuration Assistant||The HTTP Server Configuration Assistant configures Oracle HTTP Server and registers it with the Oracle Enterprise Manager Application Server Control.||
|Java Security Configuration Assistant||The Java Security Configuration Assistant changes default password and sets and reassigns new passwords for JAAS security.||
|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:
|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.||
|OPMN Configuration Assistant- start Oracle HTTP Server||Starts Oracle HTTP Server through OPMN.||
|OPMN Configuration Assistant- start DAS instance||Starts DAS instance through OPMN.||
|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.||
|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
|Register DCM Plug-Ins With EM Configuration Assistant||Registers DCM plug-ins with Enterprise Manager.||
|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.||
|Web Cache Configuration Assistant||The Web Cache Configuration Assistant configures OracleAS Web Cache and registers it with Oracle Enterprise Manager Application Server Control.||