Registering and Configuring the Oracle RAC Framework Resource Group

Registering and configuring the Oracle RAC framework resource group enables Oracle RAC to run with Oracle Solaris Cluster software.

Note - You must register and configure the Oracle RAC framework resource group. Otherwise, Oracle RAC cannot run with Oracle Solaris Cluster software.

The Oracle RAC framework resource in the global-cluster voting node can support any Oracle RAC installation running in the global cluster. The Oracle RAC framework resource in a zone cluster supports the Oracle RAC installation running in that specific zone cluster. Multiple Oracle RAC framework resource groups can exist in a single Oracle Solaris Cluster configuration.

This section contains the following information about registering the Oracle RAC framework resource group:

Tools for Registering and Configuring the Oracle RAC Framework Resource Group
How to Register and Configure the Oracle RAC Framework Resource Group by Using clsetup

Tools for Registering and Configuring the Oracle RAC Framework Resource Group

Oracle Solaris Cluster software provides the following tools for registering and configuring the Oracle RAC framework resource group in the global cluster or in a zone cluster:

The clsetup utility. For more information, see How to Register and Configure the Oracle RAC Framework Resource Group by Using clsetup.
Oracle Solaris Cluster maintenance commands. For more information, see Appendix D, Command-Line Alternatives.

The clsetup utility provides a wizard for configuring resources for the Oracle RAC framework resource group. The wizard reduces the possibility of configuration errors that might result from command syntax errors or omissions. This wizard also ensures that all required resources are created and that all required dependencies between resources are set.

Note - The clsetup utility runs only in a voting node of the global cluster.

How to Register and Configure the Oracle RAC Framework Resource Group by Using `clsetup`

When you register and configure the Oracle RAC framework resource group for a cluster, the Oracle RAC framework resource group is created.

Perform this procedure during your initial setup of Support for Oracle RAC. Perform this procedure from one node only.

Before You Begin

Ensure that the following prerequisites are met:

All preinstallation tasks for Oracle RAC are completed.
The Oracle Solaris Cluster nodes are prepared.
The data services packages are installed.

Ensure that you have the following information:

The names of the nodes where you require Support for Oracle RAC to run.

Become superuser on any cluster node.
Start the clsetup utility.
```
# clsetup
```
The clsetup main menu is displayed.
Choose the menu item, Data Services.
The Data Services menu is displayed.
Choose the menu item, Oracle Real Application Clusters.
The clsetup utility displays information about Support for Oracle RAC.
Press Return to continue.
The clsetup utility prompts you to select whether you are performing the initial configuration of Support for Oracle RAC or administering an existing configuration.

Note - The clsetup utility currently allows ongoing administration of an Oracle RAC framework running only in the global cluster. For ongoing administration of an Oracle RAC framework configured in a zone cluster, you need to instead use the Oracle Solaris Cluster maintenance commands.
Choose the menu item, Oracle RAC Create Configuration.
The clsetup utility prompts you to select the Oracle RAC cluster location. This location can be the global cluster or a zone cluster.
Type the option number for the location of the Oracle RAC cluster and press Return.
- If you select the global cluster option, the clsetup utility displays the list of components of Oracle RAC to configure. Skip to Step 9.
- If you select the zone cluster option, the clsetup utility prompts you to select the required zone cluster. Proceed to Step 8.
Type the option number for the required zone cluster and press Return.
The clsetup utility displays a list of components of Oracle RAC to configure.
Choose the menu item, RAC Framework Resource Group .
The clsetup utility displays the list of prerequisites for performing this task.
Verify that the prerequisites are met, and press Return.
The clsetup utility displays a list of the cluster nodes on which the Support for Oracle RAC packages are installed.
Select the nodes where you require Support for Oracle RAC to run.
- To accept the default selection of all listed nodes in an arbitrary order, type a and press Return.
- To select a subset of the listed nodes, type a comma-separated or space-separated list of the option numbers for the nodes you choose and press Return.
  Ensure that the nodes are listed in the order in which the nodes are to appear in the Oracle RAC framework resource group's node list.
- To select all nodes in a particular order, type a comma-separated or space-separated ordered list of the option numbers for the nodes you choose and press Return.
  Ensure that the nodes are listed in the order in which the nodes are to appear in the Oracle RAC framework resource group's node list.
If needed to end the selection of nodes, type d and press Return.
The clsetup utility displays the names of the Oracle Solaris Cluster objects that the utility will create.
If you require a different name for any Oracle Solaris Cluster objects, change the name.
1. Type the option number for the object name to change and press Return.
  The clsetup utility displays a screen where you can specify the new name.
2. At the New Value prompt, type the new name and press Return.
The clsetup utility returns you to the list of the names of the Oracle Solaris Cluster objects that the utility will create.
To confirm your selection of Oracle Solaris Cluster object names, type d and press Return.
The clsetup utility displays information about the Oracle Solaris Cluster configuration that the utility will create.
To create the configuration, type c and Press Return.
The clsetup utility displays a progress message to indicate that the utility is running commands to create the configuration. When configuration is complete, the clsetup utility displays the commands that the utility ran to create the configuration.
Press Return to continue.
The clsetup utility returns you to the list of options for configuring Support for Oracle RAC.
(Optional) Type q and press Return repeatedly until you quit the clsetup utility.
If you prefer, you can leave the clsetup utility running while you perform other required tasks before using the utility again. If you choose to quit clsetup, the utility recognizes your existing Oracle RAC framework resource group when you restart the utility.
Determine whether the Oracle RAC framework resource group and its resources are online.
Use the clresourcegroup(1CL) utility for this purpose. By default, the clsetup utility assigns the name rac-framework-rg to the Oracle RAC framework resource group.
- In the global cluster, type the following command.
```
# clresourcegroup status rac-framework-rg
```
- In a zone cluster, type the following command.
```
# clresourcegroup status -Z zcname rac-framework-rg
```
If the Oracle RAC framework resource group and its resources are not online, bring them online.
- In the global cluster, type the following command.
```
# clresourcegroup online -emM rac-framework-rg
```
- In a zone cluster, type the following command.
```
# clresourcegroup online -emM -Z zcname rac-framework-rg
```

Resource Configuration

The following table lists the default resource configuration that the clsetup utility creates when you complete this task.

Resource Name, Resource Type, and Resource Group	Dependencies	Description
Resource type: `SUNW.rac_framework` Resource name: `rac-framework-rs` Resource group: `rac-framework-rg`	None.	Oracle RAC framework resource.

Next Steps

The next step depends on the volume manager that you are using, as shown in the following table.

Volume Manager	Next Step
Solaris Volume Manager for Sun Cluster	Registering and Configuring the Multiple-Owner Volume-Manager Framework Resource Group
None	Registering and Configuring Storage Resources for Oracle Files

Skip Navigation Links
Exit Print View
	Oracle Solaris Cluster Data Service for Oracle Real Application Clusters Guide Oracle Solaris Cluster 4.0