# Sun Cluster HA for Oracle

> Overview
> Before Starting
> Installing Sun Cluster HA for Oracle
> Customizing Sun Cluster HA for Oracle

## Overview

SunPlexTM Manager uses the Oracle Universal Installer to install the Oracle® software and configure Sun Cluster HA for Oracle. For a list of Oracle releases that are supported for use with SunTM Cluster, ask your Sun sales representative.

SunPlex Manager sets up a "Typical" Oracle installation. The Oracle documentation contains more detail.

| Oracle is a complex product, and the configuration possible through SunPlex Manager is limited. You must have a thorough understanding of Oracle before you install and configure it. See the Oracle documentation for details.

You must configure Sun Cluster HA for Oracle as a failover service.

For a more advanced configuration, you might be able to manually customize your configuration after SunPlex Manager completes the installation. The Oracle documentation contains more detail.

To completely customize your Sun Cluster HA for Oracle installation, following the instructions in the Oracle documentation or the Sun Cluster 3.1 Data Services Installation and Configuration Guide.

Return to top

## Before Starting

Before you install Sun Cluster HA for Oracle, check the following items:

- Ensure the logical host name is set up. In most cases, you set up the logical host name when you install Sun Cluster. If the logical host name is not set up, see Creating a Logical Host Name Resource.

- Ensure that your system meets installation requirements for Oracle. The Oracle installation documentation contains more detail.

- Verify that you have sufficient swap space. See the Oracle documentation for Oracle's swap requirements.

- Determine where to install the Oracle application files, such as Oracle binaries, configuration files, and parameter files. Also, determine where to install the Oracle database-related files, such as control file, redo logs, and data files. The Oracle application files can be installed locally or globally. The database-related files must be installed globally.

- Configure the UNIX&174; kernel for Oracle 8i as specified in the Oracle installation documentation.

  Oracle requires special settings for kernel variables that are related to
  shmsys
  and
  semsys
  . These variables are set in the
  /etc/system
  file, and changes are activated after the system is rebooted. If you have not rebooted since you last modified these settings, reboot the cluster nodes before you begin the Sun Cluster HA for Oracle installation. See the Oracle installation documentation for more information.

- Reboot the cluster nodes if you have made changes to the
  /etc/system
  file since you last rebooted.

  Note: If no entries exist for shmsys and semsys in /etc/system , default values for these variables are automatically inserted in /etc/system . The system must then be rebooted. Check Oracle installation documentation to verify that these values are correct for your database.

Return to top

## Installing Sun Cluster HA for Oracle

| Sun Cluster HA for Oracle takes approximately three hours to install.
| When you exit SunPlex Manager or click Back in your web browser after you begin the installation, the data service disconnects you from the installation. This disconnection can result in an incomplete installation because of insufficient information or an unresolved error message. To clean up an incomplete installation, you must remove the application files and resources and resource groups that were created.

To install Sun Cluster HA for Oracle, complete the following steps:

1. In a terminal window, type the following command:

   % xhost
   [node names]

   The system enables all of the cluster nodes. You are then allowed to display the Oracle installer windows on the workstation that you are using.

2. From the navigation frame in SunPlex Manager, choose [cluster name] Cluster.

   The cluster overview window appears.

3. From the Install Data Service menu, choose Oracle Database.

   SunPlex Manager ensures that:

   - The Sun Cluster HA for Oracle data service packages are already installed.
   - The Sun Cluster HA for Oracle data services are registered with RGM.

   If SunPlex Manager finds that these criteria are met, proceed to the next step.

   If SunPlex Manager does not find
   SUNW.oracle.server
   or
   SUNW.oracle.listener
   , SunPlex Manager guides you through installation and registration. You need to provide the location of the CD that contains the Sun Cluster 3.1 data service.

   SunPlex Manager then displays a page that prompts you to provide installation information.

4. Choose the type of installation that is correct for your system:

   - Install Oracle and database - Choose this type of installation if you want to install Oracle and if you want to create a sample database.
   - Install Oracle and an existing database - This option only appears if a database is already installed on the cluster.

5. A window that contains configuration information appears.

6. On the configuration page, modify the information for your system.

   Field | Description
   --- | ---
   | X Display to Use | The name of the display that is used to display the Oracle installer window. The cluster nodes must have xhost access to this display. This display must be the display that you intend to use to view the web browser.
   Directory Holding Oracle CD-ROM Image | The directory that contains the runInstaller command.
   ORACLE_BASE directory | The directory at the top of the Oracle software and administrative file structure.
   ORACLE_HOME directory | The home directory that contains the Oracle software for a specific release.
   Database Name | The full database name that uniquely distinguishes the database from other databases in your network domain.
   Database Directory | The path of the mount point for the database file. This path must be a global file system on a different disk than ORACLE_BASE .

7. Click Install.

   The parameters that you specified on the configuration page are used to install Sun Cluster HA for Oracle.

   SunPlex Manager verifies the information on the configuration page. If SunPlex Manager finds no errors, it loads the Oracle Universal Installer. The Oracle Universal Installer then begins to install the Oracle software. If SunPlex Manager discovers errors, it displays an error message.

   | Do not click Continue in the SunPlex Manager window while the Oracle Universal Installer is installing Oracle. You must wait until the installer is finished, then click Okay in the Oracle Universal Installer window before you proceed in the SunPlex Manager window.

   Note: If you are installing Oracle on a local file system, one Oracle Universal Installer window appears for each node. A window appears for each node because a separate installation is necessary on each node. If you are installing the Oracle software on a global file system, one installer window appears. The progress bars in the various Oracle Universal Installer windows might grow to 100 per cent several times during the installation. Wait until the installer displays the dialog box that states that the Database creation is complete before proceeding.

   The Oracle Universal Installer displays a dialog box that tells you that the Database creation is complete and the database information that was created.

8. Click Okay.

   The Oracle Universal Installer closes. You can continue with the Sun Cluster HA for Oracle installation. The installer displays a confirmation message.

9. Click Continue.

   The
   root.sh
   script runs.

   If a dialog box appears stating that the transfer was interrupted, ignore this message. The installer displays a confirmation message.

10. Click Continue.

    The installer sets up the configuration files.

    A configuration page appears.

11. Modify the information on the configuration page for your system.

    Field | Description
    --- | ---
    | Network Resource | The logical host name that is used to access the database.
    Prefix for Oracle Resources | The listener resource has "-listener" appended to this prefix, and the server resource has "-server" appended to this prefix.
    ORACLE_HOME directory | The directory that is to contain the Oracle products.
    Database Name | The full database name that uniquely distinguishes that database from other databases in your network domain.
    Connection ID/Password | The connection ID and password that the fault monitor uses to connect to the database.
    Alert Logfile Location | The location of the alert file.
    Listener Name | The name of the Oracle listener process.

12. Click Continue.

    The installer sets up and runs resources.

    The installer displays a confirmation message when the resources are set up. Your Sun Cluster HA for Oracle installation is now complete.

| Recommended step. To test the data service, set up a tnsnames.ora file on a client as specified and connect to the database.

Return to top

## Customizing Sun Cluster HA for Oracle

Instructions about customizing the Sun Cluster HA for Oracle installation are presented in the Oracle documentation and the Sun Cluster 3.1 Data Services Installation and Configuration Guide.