Oracle Universal Installer Concepts Guide Release 2.0.1 Part Number A88812-01 |
|
The Oracle Universal Installer supports the installation of several active Oracle homes on the same machine. An Oracle home is the system context in which Oracle products run. This context consists of the directory location where the products are installed, the corresponding system path setup, and where applicable, the program groups associated with the products installed in that home, and the services running from that home.
The Oracle Universal Installer supports the installation of several active Oracle homes on the same machine as long as the products support this at runtime. You can have multiple versions of the same product or different products running from different Oracle homes concurrently. Products installed in one home will not conflict or interact with products installed in another home. You can update software in any home at any time, assuming all Oracle applications/services/processes installed on the target home are shut down. Processes from other homes may still be running.
The Oracle home currently accessed by the Oracle Universal Installer for installation or deinstallation is the target home. In order to upgrade or remove products from the target homes, those products must be shut down/stopped.
Different levels of support are available with multiple Oracle homes for the following product types:
Note: The installation guide of your products will specify what type they are and whether they can be installed once in a home or multiple times. |
The Home Selector is part of the installation software and is installed with the Oracle Universal Installer. It is installed in <oui_location>\HomeSelector
.
If your application is not installed in one of the Oracle homes, you need to ensure it uses the right product version, by pointing it to the right home. That specific (target) home must take precedence over the other homes in your path when you launch your application.
The Home Selector enables you to easily change your primary Oracle home (the one that appears first in the PATH environment variable). If you need to switch the active home or need to perform batch work which requires a "default home" to be active, the Oracle Home Selector can be used to change the Windows NT system settings.
When using the Home Selector to make a specific $ORACLE_HOME the active one, the software installation in question is moved to the top of the PATH variable, making it the first directory to be scanned for executables and library files.
When you perform an install on a system, the first $ORACLE_HOME will be named the "DEFAULT_HOME" and will register itself in the Windows NT registry under the key:
HKEY_LOCAL_MACHINE Software Oracle
This is the default Windows NT registry hive which contains all the "generic" Oracle settings. Also the PATH variable is adjusted and the BIN directory of the $ORACLE_HOME is added to the environment variable.
Starting with Oracle 8.0.4, the first version to be multiple $ORACLE_HOME aware, some additional parameters will also be written to the key:
HKEY_LOCAL_MACHINE Software Oracle Home0
With the Oracle Universal Installer, you can change the "DEFAULT_HOME" name to something else. Also, it registers all Oracle settings in the "Home0" subkey of the ORACLE key.
When an additional $ORACLE_HOME is added to the system, the PATH variable is adjusted again to add the new BIN directory of the newly installed Oracle software. The registry variables are written to a key named "HOMEx," where X is the next available number in the Oracle key.
When several $ORACLE_HOMEs are installed, the executables referenced are all found in the first $ORACLE_HOME\BIN directory of the PATH variable. When you want to switch the order of the PATH variable, you can use the Home Selector to switch the order of the $ORACLE_HOMEs installed on the system.
Together with the installation and registration of the software in the registry, a second series of registry variables are written in the following key:
HKEY_LOCAL_MACHINE Software Oracle ALL_HOMES
This is the starting point for the list of all $ORACLE_HOME installations, done on this system.
The following variables are written in this key:
If the Home Selector is started in interactive mode, the registry hive "ALL_HOMES" is read, including all subkeys, and a dialog box will be dispayed with all available installations. As soon as the you select one, the PATH variable will be adjusted at the system level.
In order to make batch processing possible, this tool also has a commandline interface, making it possible to use the tool to switch the PATH settings while executing a series of commands:
ohsel -switch "Oracle Home Name"
The name of this $ORACLE_HOME is one of the names found in the ID subkeys.
A typical Oracle home on Windows platforms contains the files and directories shown in Table 2-1.
Oracle Home Directory | Contents |
---|---|
\BIN |
Product executables and DLLs |
\DBS |
Common message files |
\PROD1 |
PROD1 product files |
\PROD2 |
PROD2 product files |
The Optimal Flexible Architecture (OFA) standard is a set of configuration guidelines for fast, reliable Oracle databases that require little maintenance.
OFA is designed to:
The OFA directory structure is described below.
ORACLE_BASE specifies the BASE of the Oracle directory structure for OFA-compliant databases. A typical ORACLE_BASE directory structure is described in Table 2-2. When installing an OFA-compliant database using the Oracle Installer, ORACLE_BASE is by default set to /pm/app/oracle
.
|
administrative files |
|
online documentation |
|
subtree for local Oracle software |
|
Oracle software |
The following is an example of an Oracle Server Install.
If you install an OFA-compliant Oracle Server, the ORACLE_HOME directory is /mount_point/app/oracle/product/
release_number. ORACLE_HOME directory structure and content are described in Table 2-3. Under UNIX, the ORACLE_HOME directory might contain the following subdirectories, as well as a subdirectory for each Oracle product selected.
To create an Oracle home, follow the steps below.
Note: A typical user does not need to modify the ORAPARAM.INI file. This file is manipulated when you are building your own installation using the Oracle Universal Installer. |
The ORAPARAM.INI is the Oracle Universal Installer's initialization file. Edit the parameters according to sample file provided. The file provides parameters for the following:
Set DISTRIBUTION to TRUE if the ORAPARAM.INI file is on a distribution media. A distribution media can be a CD-ROM or the Web.
Location of your staging area (the products.jar
file). This location is relative to the directory where oraparam.ini
exists.
Location of a text file for License information. This location is relative to the directory where oraparam.ini exists. The legal terms file should be a plain text file.
If you specify the LICENSE_LOCATION variable, the Oracle Universal Installer will ask for license acceptance after you click the Next button on the "Welcome" screen. The Oracle Universal Installer will let the user proceed only after license is accepted.
This parameter is ignored if the file is not found.
The value of this variable displays as the title of the license agreement. The Oracle Universal Installer only reads this value if the license dialog is displayed. That is, if the LICENSE_LOCATION variable has a valid value.
Location to the Java Runtime Environment (JRE) which will be used by the Oracle Universal Installer.
Location to the Oracle Universal Installer files.
Set these to increase the initial heap size for JRE.
Location of the default home.
The default name for the Oracle Home. This parameter is used only if the install takes place on a machine with no previous Oracle installations. This parameter is used only on Windows platforms.
List directories which you do not want to browse. These are typically large directories which will take a long time to list. For example, /net
, /nfs
.
Set NLS_ENABLED to TRUE for the Oracle Universal Installer to enable NLS support. Set NLS_ENABLED to FALSE to disable the installation session translations. The Oracle Universal Installer displays in English even if you run on a non-English system.
In the case of installing products that span multiple CDs, a "bootstrap" occurs in which temporary copies of OUI and JRE are placed in the TEMP or TMP directory so that these applications can be launched when you change CD-ROMs.
As a user/developer of an install, you need to set BOOTSTRAP to True or False. BOOTSTRAP tells the Oracle Universal Installer to attempt a bootstrap. Set BOOTSTRAP to True before cutting CDs, but set it to False once you have copied the staging area to the hard disk.
If you are running a multiple CD install, you must set the bootstrap variable BOOTSTRAP=TRUE.
Otherwise, the first CD cannot be ejected on Solaris because the file system is busy. The Oracle Universal Installer is holding open several files on the CD including the JRE executable, and on Solaris, ejectable volumes cannot be ejected if a process has opened files on the volume.
Setting the BOOTSTRAP variable to TRUE informs the Oracle Universal Installer to copy the Oracle Universal Installer classes and the JRE executables to a temporary directory where you can launch them; thereby freeing the CD device.
You may also need to launch runInstaller in the background by using the ampersand character:
./runInstaller &
By launching runInstaller in the background, you can change your current directory after you launch the Oracle Universal Installer so that you can eject the CD.
You may want to create a shell script that launches the Oracle Universal Installer in the background and then exits. If you choose to create a shell script, remember to also pass all parameters that passed to the shell script along to runInstaller in case you want to pass a response file name to run a silent installation.
Set the version of the Oracle Universal Installer you are using.
To show advertisements during an install, you must specify each image as a separate variable. For example:
FILE1=../stage/adimages/adimage0.gif
FILE2=../stage/adimages/adimage1.gif
This means the variables have to have the same structure of:
FILE<image_number>=<image location relative to oraparam.ini file's location>
Images display in the order they are listed in the oraparam.ini
file. The images will be shown on equal intervals throughout the install session. All images must be in .gif format. Oracle Universal Installer displays the images as follows:
The amount of space allocated to advertisement images is subject to change in future Oracle Universal Installer releases.
Note: Images are only visible to users running Oracle Universal Installer version 1.5.1.4.x or higher. Advertisement images should not exceed 160 (width) x 225 (height) pixels. |
A sample ORAPARAM.INI file is shown below.
[Oracle] DISTRIBUTION=TRUE #Set DISTRIBUTION to TRUE if the ORAPARAM.INI file is on a distribution media. A distribution media can be a CD-ROM or the Web. SOURCE=../stage/products.jar #Location of the products.jar file. This location is relative to the directory where oraparam.ini exists. LICENSE_LOCATION= #Location of a text file for License information. This location is relative to the directory where oraparam.ini exists. #After you click the Next button on the Welcome page, the Oracle Universal Installer will ask for license acceptance. If this file exists, the Oracle Universal Installer will let the user proceed only after license is accepted. JRE_LOCATION=../stage/Components/oracle/swd/jre/1.1.6.2.1o/2/DataFiles/Expanded /ojre #Relative location to the Java Runtime Environment (JRE) which will be used by the Oracle Universal Installer OUI_LOCATION=../stage/Components/oracle/swd/oui/1.5.1.4.2/1/DataFiles/Expanded #Relative location to the Oracle Universal Installer files DEFAULT_HOME_NAME="OUIHome" #The default name for the Oracle Home. This parameter is used only if the install takes place on a machine with no previous Oracle installations. This parameter is used only on Windows platforms. HLP_LOCATION= #For future use only EWT_LOCATION= #For future use only NLS_ENABLED=TRUE #Set NLS_ENABLED to FALSE to disable the translations. The Oracle Universal Installer displays in English even if you run on a non-English system. JRE_MEMORY_OPTIONS=-ms16m -mx32m #Set these to increase the initial heap size for JRE. NO_BROWSE= #list directories which you do not want to browse. These are typically large directories which will take a long time to list. # =/net, /nfs OUI_VERSION = <1.7.0.1.0> Set the version of the Oracle Universal Installer you are using. Note: you must set the version correctly in order for the bootstrap to work. [IMAGES] FILE1=images/installAd0.gif FILE2=images/installAd1.gif
.
.
|
Copyright © 2001 Oracle Corporation. All Rights Reserved. |
|