C Troubleshooting

This appendix contains information on troubleshooting. It includes information on the following topics:

X Windows Display Errors
Reviewing the Log of an Installation Session
Silent-Mode Response File Error Handling
Cleaning Up After a Failed Installation

C.1 X Windows Display Errors

When you run Oracle Universal Installer, you might see error messages similar to the following:

"Failed to connect to server"
"Connection refused by server"
"Can't open display"

If you see one of these error messages, perform the following tasks:

In the session on your workstation, enter the following command:
```
$ xhost +
```
From the workstation where you will run Oracle Universal Installer, log in to the server where you intend to install Oracle Database 10g.
Enter the following commands, where workstation_name is the name of your workstation:
```
$ DISPLAY=workstation_name:0.0
$ export DISPLAY
```
To determine whether your X Window system is working properly on your local system, enter the following command:
```
$ xclock
```
The X clock should appear on your monitor.

C.2 Reviewing the Log of an Installation Session

During an installation, Oracle Universal Installer records all of the actions that it performs in a log file. If you encounter problems during the installation, review the log file for information about possible causes of the problem.

To view the log file, follow these steps:

If necessary, enter the following command to determine the location of the oraInventory directory:
```
$ more /var/opt/oraInst.loc
```
The inventory_loc parameter in this file specifies the location of the oraInventory directory.
Enter the following command to change directory to the Oracle Universal Installer log file directory, where orainventory_location is the location of the oraInventory directory:
```
$ cd /orainventory_location/logs
```
Enter the following command to determine the file name of the log file:
```
$ ls -ltr
```
This command lists the files in the order of creation, with the most recent file shown last. Oracle Universal Installer log files have names similar to the following, where date_time indicates the date and time that the installation started:
```
installActionsdate_time.log
```
To view the most recent entries in the log file, where information about a problem is most likely to appear, enter a command similar to the following:
```
$ tail -50 installActionsdate_time.log | more
```
This command displays the last 50 lines in the log file.
If the error displayed by Oracle Universal Installer or listed in the log file indicates a relinking problem, see the following file for more information:
```
$ORACLE_HOME/install/make.log
```

C.3 Silent-Mode Response File Error Handling

To determine whether a noninteractive installation succeeds or fails, see the following log file:

/oraInventory_location/logs/silentInstalldate_time.log

If necessary, see the previous section for information on determining the location of the oraInventory directory.

A noninteractive 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 runtime. If the validation fails, then the noninteractive 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. Variables that are outside any section are ignored.

C.4 Cleaning Up After a Failed Installation

If an installation fails, you must remove files that Oracle Universal Installer created during the attempted installation and remove the Oracle home directory. Perform the following steps to remove the files:

Start Oracle Universal Installer as described in the "Installing the Oracle Database Software" section.
Click Deinstall Products on the Welcome window or Installed Products available on any Oracle Universal Installer window. The Inventory window appears, listing installed products.
Select any products that you want to remove, then click Remove.

Note:
If you have more than one installation on the system, then products installed in other Oracle homes appear in the Inventory window. If you select products from other Oracle homes, then they are deinstalled.
Manually remove the Oracle home directory used by the failed installation.