Registering and Configuring the RAC Framework Resource Group

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

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

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

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

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

Tools for Registering and Configuring the RAC Framework Resource Group

Oracle Solaris Cluster software provides the following tools for registering and configuring the 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 RAC Framework Resource Group by Using clsetup.
Oracle Solaris Cluster Manager. For more information, see the Oracle Solaris Cluster Manager online help.
Oracle Solaris Cluster maintenance commands. For more information, see Appendix D, Command-Line Alternatives.

The clsetup utility and Oracle Solaris Cluster Manager each provide a wizard for configuring resources for the RAC framework resource group. The wizards reduce the possibility of configuration errors that might result from command syntax errors or omissions. These wizards also ensure that all required resources are created and that all required dependencies between resources are set.

Note - Oracle Solaris Cluster Manager and the clsetup utility run only in a voting node of the global cluster.

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

When you register and configure the RAC framework resource group for a cluster, the 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.
If used, Oracle UDLM software is installed.

Alternatively on Oracle RAC 11g release 2, if you intend to use native SKGXN, ensure that Oracle UDLM software is not 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 a RAC framework running only in the global cluster. For ongoing administration of a 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 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 RAC framework resource group's node list.
If needed to end the selection of nodes, type d and press Return.
The clsetup utility displays a list of vendor clusterware support choices for Oracle files.
Type the option number for the vendor clusterware support to use and press Return.
The vendor clusterware support can be Oracle UNIX Distributed Lock Manager (Oracle UDLM) based or (Oracle 11g release 2 only) native SKGXN. If Oracle UDLM software is installed (SPARC only), Oracle UDLM is automatically chosen.
To confirm your selection of storage management schemes, 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 RAC framework resource group when you restart the utility.
Determine whether the 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 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 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.	RAC framework resource.
SPARC: Resource type: `SUNW.rac_udlm` Resource name: `rac-udlm-rs` Resource group: `rac-framework-rg`	Strong dependency on the RAC framework resource.	Oracle UDLM 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 or VxVM with the cluster feature	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