B Oracle Database Gateway Troubleshooting
Verify Requirements
Before performing any of the troubleshooting steps in this appendix, ensure that the system meets the requirements and that you have completed all of the pre-installation tasks specified in respective topics.
Read the Release Notes
Read the release notes for the product before installing it. The latest version of the release notes is also available on the OTN Web site:
http://docs.oracle.com
What to Do if an Installation Error Occurs
If you encounter an error during installation:
-
Do not exit Oracle Universal Installer.
-
If you clicked Next after you entered incorrect information about one of the installation screens, then click Back to return to the screen and correct the information.
-
If you encounter an error while Oracle Universal Installer is copying or linking files, see Reviewing the Log of an Installation Session.
-
If you encounter an error while a configuration assistant is running, see Troubleshooting Configuration Assistants.
-
If you cannot resolve the problem, then remove the failed installation by following the steps listed in Cleaning Up After a Failed Installation.
Reviewing the Log of an Installation Session
During an installation, Oracle Universal Installer records all the actions that it performs, in a log file. If you encounter problems during the installation, then review the log file for information about possible causes of the problem.
To view the log file, follow these steps:
Troubleshooting Configuration Assistants
-
Review the installation log files listed in Reviewing the Log of an Installation Session.
-
Review the specific configuration assistant log file located in the
$ORACLE_HOME/cfgtoollogs
directory. Try to fix the issue that caused the error. -
If you see the "Fatal Error. Reinstall" message, look for the cause of the problem by reviewing the log files. Refer to Fatal Errors for further instructions.
Configuration Assistant Failure
Oracle configuration assistant failures are noted at the bottom of the installation screen. The configuration assistant interface displays additional information, if available. The configuration assistant execution status is stored in the following file:
oraInventory_location/logs/installActionsdate_time.log
The execution status codes are listed in the following table:
Status | Result Code |
---|---|
Configuration assistant succeeded |
0 |
Configuration assistant failed |
1 |
Configuration assistant cancelled |
-1 |
Fatal Errors
If you receive a fatal error while a configuration assistant is running then:
- Remove the failed installation as described in Cleaning Up After a Failed Installation.
- Correct the cause of the fatal error.
- Reinstall the Oracle software.
Silent-Mode Response File Error Handling
To determine whether a silent-mode installation succeeds or fails, refer to the following log file:
/oraInventory_location/logs/silentInstalldate_time.log
If necessary, refer to the previous section for information about determining the location of the oraInventory
directory.
A silent installation fails if:
-
You do not specify a response file
-
You specify an incorrect or incomplete response file
-
Oracle Universal Installer encounters an error, such as insufficient disk space
Oracle Universal Installer or configuration assistant validates the response file at run time. If the validation fails, then the silent-mode installation or configuration process ends. Oracle Universal Installer treats values for parameters that are of the wrong context, format, or type as if no value was specified in the file.