3
Using the Oracle Universal Installer for Real Application Clusters

This chapter describes how to use the Oracle Universal Installer (OUI) to install the Oracle9i Enterprise Edition and the Real Application Clusters software. The topics in this chapter include:

• Starting the Oracle Universal Installer to Install Real Application Clusters
• Using the Pre-Configured Database Configuration Types
• Using the Customized Database Configuration Type
• Deinstalling Real Application Clusters with the Oracle Universal Installer

  Note: If you are not using a cluster file system, then perform the procedures in this chapter only after configuring your disk subsystem as described in Chapter 2. You must complete the procedures in this chapter before continuing with the procedures for using the Database Configuration Assistant (DBCA) in Chapter 4.

Starting the Oracle Universal Installer to Install Real Application Clusters

Follow these procedures to use the OUI to install the Oracle Enterprise Edition and the Real Application Clusters software.

1. Before running the OUI, from the node where you intend to run the Installer, verify that you have administrative privileges on the other nodes. Do this using one of the operating system-specific privilege verification methods in Table 3-1.

   Table 3-1  Privilege Verification Methods

   Operating System	Verification Method
   On UNIX	Perform a remote copy (rcp) to all the nodes, including the local node.
   On Windows NT and Windows 2000	Enter the following command for each node that will be part of the cluster database where node_name is the node name returned from the lsnodes.exe utility that is in the preinstall_rac directory on the installation CD: NET USE \\node_name\C$ Oracle Corporation recommends using the same user name and password on each node in a cluster or use a domain user name. If you use a domain user name, log on under a domain with a username and password that has administrative privileges on each node.

Then for UNIX platforms only, set the environment variables as described in the following two steps. For all other platforms proceed to step 4.

2. If this installation creates the first ORACLE_HOME on your cluster for Real Application Clusters, then set the SRVM_SHARED_CONFIG environment variable to the name of the 100MB volume raw device or shared file that you set up for configuration storage by entering, for example:

   setenv SRVM_SHARED_CONFIG shared_filename
   
   

   Where shared_filename is the name of the configuration raw device file. If you are using a cluster file system, then make sure the partition on which this file resides has least 100MB of free space.

3. Set the DBCA_RAW_CONFIG environment variable. Do this, for example, by executing the following where filename is the name of the ASCII file containing the configuration information:

   setenv DBCA_RAW_CONFIG filename 
   
   

   If this is the first installation on your cluster and you have not set the environment variable, then the Installer prompts you for the name of the 100MB file by displaying the Shared Configuration File Name page.

4. Run the Installer using one of the following procedures for your platform:
   • On UNIX execute the runInstaller command from the root directory of the first Oracle CD.
   • On Windows NT and Windows 2000 execute the setup.exe command.

   The Installer displays the Welcome page. This page presents the OUI for Real Application Clusters. Click Next.

5. The Node Selection page appears as shown in Figure 3-1.

   Figure 3-1 Oracle Universal Installer Cluster Node Selection Page

   

   Text description of the illustration nodesele.jpg

6. If the Installer does not display the Node Selection page, then perform clusterware diagnostics by executing the lsnodes -v command and analyzing the command output according to the following platform-specific instructions:
   • UNIX Clusterware Diagnostics

     For UNIX platforms, execute the lsnodes -v command from the /tmp/OraInstallYYYY-MM-DD_HH-MM-SSxx directory, where xx is AM or PM).

   • Windows NT and Windows 2000 Clusterware Diagnostics

     For Windows platforms, execute the lsnodes -v command from the preinstall_rac directory.

   For all platforms, refer to your vendor documentation if the output from the lsnodes -v command reveals clusterware problems.

7. Select the nodes to include as part of your Real Application Clusters database. Note that the local node is always selected even though it may not be highlighted on the Node Selection page. Click Next. The Installer displays the File Locations page.
8. On the File Locations page in the Path field under the Destination heading, enter the name of the Oracle home into which you are going to install the Oracle Enterprise Edition and Real Application Clusters software. Click Next. The Installer displays the Available Products page.
9. On the Available Products page, select Oracle9i and click Next. The Installer displays the Install Types page.
10. On the Install Types page, select Enterprise Edition and click Next. The Installer displays the Database Configuration page.

    Before continuing, read the following section under the heading, "Selecting a Database Configuration Type", which explains how the DBCA creates your database. This section also describes the configuration types and the underlying configuration that the DBCA creates.

    However, if you are familiar with the DBCA and have already chosen a database configuration type, then:

    11. On the Database Configuration page, select a configuration type and click Next and proceed to one of the following sections:
    • "Using the Pre-Configured Database Configuration Types"
    • "Using the Customized Database Configuration Type"

    Selecting a Database Configuration Type

    When you run the OUI and select the Oracle9i Enterprise Edition, you can select the General Purpose, Transaction Processing, Data Warehouse, or Customized database configuration type for Real Application Clusters. For the first three configuration types, you must complete additional procedures described later in this chapter. Then the Installer runs without further input.

    If you select the Installer's Customized configuration, then you can use the DBCA to create the database as described in Chapter 4 or create the database manually as described in Chapter 5. Oracle Corporation recommends that you use the DBCA to create you database.

    You can also select the OUI Customized configuration and select a preconfigured template, customize the template, and use the DBCA to create a database using a that customized version of the template. These templates correspond to the Installer's General Purpose, Transaction Processing, and Data Warehouse configuration types. The DBCA can also use the New Database template to create a database.

    To manually configure your environment, select the Software Only database configuration option. However, Oracle Corporation strongly recommends that you use one of the preconfigured database options or use the New Database option and the DBCA.

    Configuration Type Descriptions

    The configuration type that you select determines how you proceed. Table 3-2 describes the installation types.

    Table 3-2  Oracle Universal Installer Database Configuration Types

    Configuration Type	Description	Advantages
    General Purpose, Transaction Processing, and Data Warehouse	Installs a preconfigured starter database, licensable Oracle options (including Oracle9i Real Application Clusters), networking services, Oracle9i utilities, and online documentation. At the end of the installation, the DBCA creates a Real Application Clusters database and configures it for use.	Minimal input required. You can create your database more quickly than with the Customized type.
    Customized	Enables you to customize your database options and storage components.	Enables you to create arbitrary tablespaces and datafiles and customize all aspects of your database.
    Software Only	Installs only the software. Does not configure the listeners or network infrastructure and does not create a database.	--

    The General Purpose, Transaction Processing, and Data Warehouse Configuration Types

    If you select one of the first three configuration types on the Installer's Database Configuration screen, then complete the procedures in this chapter under the heading "Using the Pre-Configured Database Configuration Types". These three configuration types use preconfigured templates. As mentioned, after you complete these procedures, the Oracle Net Configuration Assistant and the DBCA run without further input and the Installer displays a progress indicator while it completes the installation.

    The DBCA processing for these configuration types creates a starter database and configures the Oracle network services. As mentioned, if you do not use a cluster file system, then the DBCA verifies that you configured the raw devices for each tablespace.

    Note: If you have not properly configured the raw devices as described in Chapter 2, the DBCA cannot create your database.

    If you select the Customized configuration, then you must enter specific information as described in the next section.

    Using The Customized Configuration Type

    When you select the Customized configuration type, the OUI runs the DBCA which offers four database templates:

    • General Purpose
    • Transaction Processing
    • Data Warehouse
    • New Database

    The first three templates create a database that is optimized for that environment. You also can customize these templates. The New Database type, however, creates a database without using preconfigured options. Therefore, if you are not using a cluster file system, then you must enter specific raw device information for the datafiles to complete a New Database installation as described in Chapter 4, "Creating Cluster Databases with the Database Configuration Assistant".

    The following section provides more detail about DBCA processing when it creates a Real Application Clusters database.

    Database Configuration Assistant Processing

    The DBCA runs as part of the OUI installation process. When the Installer begins processing, the Oracle Net Configuration Assistant runs. If you configured LDAP directory access with the Oracle Net Configuration Assistant, then the DBCA will add an entry for the database service to the directory. Clients that you configured with directory access can also access the network information for the database service and connect to the database without a tnsnames.ora file.

    After the Oracle Net Configuration Assistant completes its processing, the DBCA creates your database using the optimal flexible architecture (OFA). This means that the DBCA creates your database files, including the default server parameter file, using standard file naming and file placement practices. The primary phases of DBCA processing are:

    • Verify that you correctly configured the shared disks for each tablespace (for non-cluster file system platforms)
    • Create the database
    • Configure the Oracle network services
    • Start the listeners and database instances

    You can also use the DBCA in standalone mode to create a database.

    See Also: The Oracle9i Net Services Administrator's Guide if you experience problems, for example, with the listener configuration, and for further information about Lightweight Directory Access Protocol (LDAP)-compliant support

    Using the Pre-Configured Database Configuration Types

    Continuing from Step 10, execute the following procedures to complete a General Purpose, Transaction Processing, or Data Warehouse configuration:

    1. On the Database Configuration page, select General Purpose, Transaction Processing, or Data Warehouse.
    2. The Installer displays the Upgrading or Migrating an Existing Database page if it discovers an Oracle database installation on the node on which it is running. Click Next.

       See Also: Oracle9i Database Migration for information about using the Database Upgrade Assistant in Real Application Clusters environments

3. The Installer displays the Database Identification page on which you should enter a global database name. This is a name that comprises the database name and database domain, such as db.us.acme.com. Accept or change the common prefix for the Oracle sid for each instance.

   Each instance has a sid that comprises the common prefix you enter in this step and a thread ID that is automatically generated. For example, if you enter db for the sid, the first database instance is given a sid of db1, and the second instance is given a sid of db2. Click Next.

4. The Installer displays the Database Character Set page. Select a character set and click Next.
5. The Installer displays a summary page. Review the components to be installed and click Install to begin the installation.

During the installation, the installer displays progress indicators showing which components are installed.

When you complete these procedures, you are ready to administer and deploy your Real Application Clusters environment as described in Oracle9i Real Application Clusters Administration and Oracle9i Real Application Clusters Deployment and Performance.

The Installer displays the Summary page showing the names of all Oracle products and the nodes onto which the Installer will install the Oracle Real Application Clusters software. After you click OK on the Summary page, the OUI displays a progress message indicator to show that the Installer is performing the remote installations. After installation, the OUI invokes the post-installation tools such as the Cluster Configuration Assistant (ClustCA), Net Configuration Assistant (NetCA), and the DBCA to set up and configure your Real Application Clusters database.

Using the Customized Database Configuration Type

Continuing from Step 10, execute the following procedures to complete a Customized configuration:

1. On the Database Configuration page, select Customized.
2. If you have not already set the raw device environment variable and if this is the first Oracle installation on this cluster, then the Installer displays the Shared Configuration File Name page. Enter the name of a raw device that is at least 100MB in size, or a cluster file system file and click Next.
3. If the Installer detects a pre-existing Oracle database, then the Installer displays the Upgrading or Migrating an Existing Database page. Click Next.

   See Also: Oracle9i Database Migration for information about using the Database Upgrade Assistant in Real Application Clusters environments

4. The Installer displays the Database Identification page on which you must enter a global database name. This is a name that comprises the database name and database domain, such as db.us.acme.com. Accept or change the common prefix to use for the Oracle sid for each instance.

   Each instance has a sid that comprises the common prefix that you enter in this step and a thread ID that is automatically generated. For example, if you enter db for the sid, Oracle assigns the first database instance a sid of db1, and the second instance is assigned a sid of db2. Click Next.

   The Installer displays the Database Character Set page. Select a character set and click Next.

5. The Installer displays a summary page. Review the components to be installed and click Install to begin the installation. The Installer displays the Summary page showing the names of all Oracle products and the nodes onto which the Installer will install the Oracle Real Application Clusters software. After you click OK on the Summary page, the OUI displays a progress message indicator to show that the Installer is performing the installation.

After installing the Oracle database software, the OUI invokes the post-installation configuration tools such as the Cluster Configuration Assistant (ClustCA), Net Configuration Assistant (NetCA), and the DBCA to set up and configure your Real Application Clusters database.

When you complete these procedures, proceed to Chapter 4, "Creating Cluster Databases with the Database Configuration Assistant".

Deinstalling Real Application Clusters with the Oracle Universal Installer

Use the following procedures to deinstall the Oracle and Real Application Clusters software with the OUI.

1. Perform Steps 1 and 4 under the heading "Starting the Oracle Universal Installer to Install Real Application Clusters".
2. On the File Locations page in the Path field under the Destination heading, enter the name of the Oracle home from which to deinstall the Oracle Enterprise Edition and Real Application Clusters software.
3. On the Available Products page select Deinstall and click Next.
4. When the Installer displays the deinstallation alert dialog, verify the information for the Oracle home from which the Installer will remove the Oracle software and click OK.

The Installer displays progress indicators as it completes deinstallation. The deinstall process deletes the Oracle software from all nodes in your cluster that have an ORACLE_HOME matching your entry on the File Locations page.