B
Troubleshooting

This chapter describes possible troubleshooting issues.

• Debugging Mechanisms in the Oracle Universal Installer

• Oracle Universal Installer Errors

• Deinstalling, Upgrading, or Downgrading Oracle Universal Installer

• Other Tips

Debugging Mechanisms in the Oracle Universal Installer

During the install, the Oracle Universal Installer writes a text file that contains information on:

• variable settings

• action calls

• queries

• exception information

The installActions.log is located in the <oraInventory>\logs directory. It is backed-up as installActions<date>.log.

The Installation Log is used for debugging purposes only. All actions, queries, everything that happens during the install, and all modifications to the target machine are logged in the file.

A sample file is shown below:

installActions1999-06-16_09-52-16-AM.log
Environment variables: 
	ORACLE_HOME = 
	PATH = E:\OEM\bin;E:\ORACLE815\bin;C:\Program 
Files\Oracle\jre\1.1.7\bin;C:\ORATST\BIN
	CLASSPATH = C:\Program Files\Exceed.nt\hcljrcsv.zip;
Username is: pjlee

The installer version is 1.7.0.0.0

*** Welcome Page***
Setting value of FROM_LOCATION to E:\bootstrap\cd\Disk1\stage\products.jar
Setting value of INVENTORY_LOCATION to C:\Program Files\Oracle\Inventory
Setting value of UNIX_GROUP_NAME to  
Setting value of FROM_LOCATION to E:\bootstrap\cd\Disk1\stage\products.jar
Setting value of ORACLE_HOME to E:\Universal
Setting value of ORACLE_HOME_NAME to Universal

*** File Locations Page***
FromLocation = FROM_LOCATION = E:\bootstrap\cd\Disk1\stage\products.jar
ToLocation = ORACLE_HOME = E:\Universal
ToName = ORACLE_HOME_NAME = Universal
Initializing installer access setup
Setting value of ORACLE_HOME to E:\Universal
Setting value of ORACLE_HOME_KEY to Software\ORACLE\HOME3
Setting value of ORACLE_HOME_FOLDER to Oracle - Universal
Setting value of ORACLE_HOME_SERVICE to Universal
Setting value of ToplevelComp to oracle.swd, 1.7.0.0.0, >0.0, [ 912 453 615 50 
601 173 467 295 87 610 198 918 913 162 2 30 21 10021 111 90 168 888 ][OH:0]
Setting value of SELECTED_LANGUAGES to [en]
Doing operation for installer access setup
Initializing inventory setup WCCE
Doing operation in inventory setup WCCE

*** Available Products Page***
TopLevelComp = ToplevelComp = oracle.swd, 1.7.0.0.0, >0.0, [ 912 453 615 50 601 
173 467 295 87 610 198 918 913 162 2 30 21 10021 111 90 168 888 ][OH:0]
LangsSel = SELECTED_LANGUAGES = [en]
Setting value of ToplevelComp to oracle.swd, 1.7.0.0.0, >0.0, [ 912 453 615 50 
601 173 467 295 87 610 198 918 913 162 2 30 21 10021 111 90 168 888 ][OH:0]
Setting value of DepMode to Complete
Setting value of TLDepModes to Complete,

*** Installation Types Page***
DepMode = DepMode = Complete
TLDepModes = TLDepModes = Complete,
Setting value of DepMode to Complete
Setting value of PROD_HOME to E:\Universal\oracle.swd
Setting value of PROD_HOME to E:\Universal\oracle.swd
Setting value of PRE_REQUISITE to true
Setting value of PROD_HOME to E:\Universal\oracle.swd
Setting value of SHOW_COMPONENT_LOCATIONS_PAGE to true

*** Component Locations Page***
ShowCompLocs = SHOW_COMPONENT_LOCATIONS_PAGE = true
Entering  component: oracle.swd installation

*** Summary Page***
ShowSummary = SHOW_SUMMARY_PAGE = null
	Global Settings
		Source : E:\bootstrap\cd\Disk1\stage\products.jar
		Destination : E:\Universal

Text files are also written in the temp directory:

<temp>\OraInstall\oraInstall.err
<temp>\OraInstall\oraInstall.out

If a problem occurs during the installation, you should look for Java exceptions in these files.

Oracle Universal Installer Errors

Refer to the Release Notes for information on any Oracle Universal Installer limitations for a particular version.

The most common Oracle Universal Installer errors are listed below:

• out of "temp" space

  Make sure you have enough space in the default TEMP or TMP directory otherwise the installation will not succeed. The amount of space required depends on the product being installed.

• incomplete stage and missing files in file groups

  Verify the staging file. There may be runtime errors that the install developer missed which causes the unexpected environment changes.

• exceptions from action libraries:
  • NT Services, if a service is already started

  • file permissions

• UNCAUGHT_RUNTIME exception when user tries to install the product on his machine

  This is a blanket error catch which catches any runtime errors like NullPointers from libraries. Check if the temp\OraInstall\orainsrall.err has any stack trace. If there is none, the user will have to call support to debug his staging area.

Deinstalling, Upgrading, or Downgrading Oracle Universal Installer

Consider the following restrictions and guidelines when deinstalling, upgrading, or downgrading Oracle Universal Installer:

• You cannot deinstall the Oracle Universal Installer if you are running it from the installed area. To deinstall the Oracle Universal Installer, run it from the stage area.

• To upgrade the Oracle Universal Installer, you need to run it from the staging area.

• Downgrades are allowed for the Oracle Universal Installer and any other product.

Other Tips

Make sure the correct version of the JRE is used from the PATH.

If Java cannot run applications from a Sun machine on an NCD X terminal (the Oracle Universal Installer does not start), remove the following file:

$JAVA_HOME/lib/font.properties

X terminal emulators which were tested with the Oracle Universal Installer are listed below:

• Exceed

• Reflection X

  Refection X 6.2+: Select Settings/Window Manager/ Default Local Window Manager/ Reflection Window Manager. You may also have to select "X terminal desktop."

  Reflection X 6.0: Select Connection/New XDMCP Connection/Connection Settings/Direct method/ type host destination and press connect.

If you are deleting an Oracle Home manually without using the Oracle Universal Installer, the products remain registered with the Oracle Universal Installer. You must then simulate a de-install so that all Oracle Universal Installer references are removed.

If the install is canceled:

• Products will not be registered with the Oracle Universal Installer

• Some files may have been copied, depending on when you issued the Cancel.