How to Register and Configure the Oracle ASM Resource Group by Using clsetup - Oracle® Solaris Cluster Data Service for Oracle Real Application Clusters Guide

Language:

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

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

Perform this procedure from one node only.

Before You Begin

Ensure that Oracle ASM disk groups are configured. For more information, see Using Oracle ASM.

Ensure that you have the following information:

The name of the Oracle Grid Infrastructure home directory.
The list of Oracle ASM systems identifiers (SID).
The names of the Oracle ASM disk groups to use.

Note - If your Support for Oracle RAC configuration requires using Oracle ASM with Solaris Volume Manager mirrored logical volumes, you might experience either of the following conditions:

Performance degradation. See Article 603825.1 at My Oracle Support for additional information.
Failures of the SUNW.ScalDeviceGroup probe. These failures result in a loss of availability of any service that is dependent on the SUNW.ScalDeviceGroup resource.

You can mitigate these issues by increasing the IOTimeout property setting for the SUNW.ScalDeviceGroup resource type.

# clresource set -p IOTimeout=timeout-value-in-seconds resource-name

The default for the IOTimeout property is 30 seconds but can be set much higher. Determine the optimal setting for each system individually, starting with a value of at least 240 seconds.

Assume the root role on any cluster node.
Start the clsetup utility.
```
# clsetup
```
The clsetup main menu is displayed.
Type the option number for Data Services and press Return.
The Data Services menu is displayed.
Type the option number for Oracle Real Application Clusters and press Return.
The clsetup utility displays information about Support for Oracle RAC.
Press Return to continue.
The clsetup utility prompts you to select whether to create the configuration of Support for Oracle RAC or administer 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 a Support for Oracle RAC framework configured in a zone cluster, use instead the Oracle Solaris Cluster maintenance commands.
Type the option number for Support for Oracle RAC Create Configuration and press Return.
The clsetup utility prompts you to select the Support for Oracle RAC cluster location. This location can be the global cluster or a zone cluster.
Type the option number for the location of the Support for Oracle RAC cluster and press Return.
- If you select the global cluster option, the clsetup utility displays the list of components of Support for Oracle RAC to configure. Skip to Step 11.
- If you select the zone cluster option, the clsetup utility prompts you to select the required zone cluster. Proceed to Step 10.

Type the option number for the required zone cluster and press Return.
The clsetup utility displays a list of components of Support for Oracle RAC to configure.

Type the option number for Automatic Storage Management (ASM) and press Return.
The clsetup utility displays a list of the cluster nodes to select.
Select the nodes where you require Oracle ASM 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 a list of Oracle ASM instance resources.
Type the option number that corresponds to the Oracle ASM instance resource to use.
If no Oracle ASM instance resource is available and you are prompted to create a resource, press Return. Skip to Step 19.

To confirm your selection of an Oracle ASM instance resource, type d and press Return.
The clsetup utility displays the selection screen for the Oracle Grid Infrastructure home directory.

Type the option number to choose a listed directory or to specify a directory explicitly and press Return.
The clsetup utility displays a list of Oracle ASM system identifiers (SID) that are discovered in the cluster.
Review the list of SIDs.
- If the list is correct, type d and press Return.
- If the list is not correct, type the option number for the SID to change and press Return.
The clsetup utility displays information about Oracle ASM disk-group resources.
Respond to the prompt that asks whether to create a disk-group resource.
- To create a new disk-group resource, type y and press Return.
  The clsetup utility displays a list of existing Oracle ASM disk groups. Proceed to Step 26.
- If you do not want to create a new disk-group resource, type n and press Return.
  The clsetup utility displays a list of discovered storage resources. Skip to Step 30.

Specify the Oracle ASM disk groups.
Type the option number for each disk group to use and press Return. When all disk groups are selected, type d and press Return.

The selected Oracle ASM disk groups are added to the Oracle ASM disk-group resources selection panel.
Review the list of Oracle ASM disk-group resources.
- If the list is correct, type d and press Return.
- If the list is not correct, type the option number or letter to edit the list of resources and press Return.
  When the list of disk-group resources is correct, type d and press Return.
The clsetup utility displays a list of discovered storage resources.

Review the list of storage resources to manage the file-system mount point where the Oracle Grid Infrastructure home is installed.
- If the list is correct, type d and press Return.
- If no storage resource is listed, type d and press Return.
  The clsetup utility will create a new resource when you complete Oracle ASM configuration.
- If the list is not correct, type the option number for the correct storage resource and press Return.
The clsetup utility displays a list of Oracle ASM disk-group resources that manage Oracle ASM disk groups.
If no suitable disk-group resources exist, or if no resource exists for an Oracle ASM disk group that you are using, add a resource to the list.
1. Type y and press Return.
  The clsetup utility discovers Oracle ASM disk groups.
2. Type a comma-separated or space-separated list of the option numbers for the Oracle ASM disk groups to use and press Return.
3. To confirm your selection of disk groups, type d and press Return.
  The clsetup utility returns you to the list of Oracle ASM disk-group resources. The resource that you are creating is added to the list.
Type the option numbers for the resources that you require, if not already selected.
You can select existing resources, resources that are not yet created, or a combination of existing resources and new resources. If you select more than one existing resource, the selected resources must be in the same resource group.
To confirm your selection of resources for Oracle ASM disk groups, type d and press Return.
The clsetup utility displays a list of discovered underlying disk sets or disk groups.
Type a comma-separated list of the option numbers for the Oracle ASM disk groups to use and press Return.
To confirm your selection of Oracle ASM disk groups, type d and press Return.
The clsetup utility displays the names of the Oracle Solaris Cluster objects for Oracle ASM that the utility will create or add to your configuration.
If you need to modify an Oracle Solaris Cluster object, modify the object.
1. Type the option number for the object to modify and press Return.
  The clsetup utility prompts you for the new value.
2. At the prompt, type the new value and press Return.
The clsetup utility returns you to the list of properties that are set for the object.
When you have modified all the Oracle Solaris Cluster objects that you need to change, 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.

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.scalable_rac_server_proxy` Resource name: `rac_server_proxy-rs` Resource group: `rac_server_proxy-rg`	Strong dependency on the Support for Oracle RAC framework resource. Offline-restart dependency on the clustered Oracle ASM disk-group resource. Offline-restart dependency on the Oracle Grid Infrastructure framework resource. When configured with Solaris Volume Manager for Sun Cluster, strong positive affinity by the Support for Oracle RAC instance proxy resource group for the Support for Oracle RAC framework resource group. When configured with hardware RAID, strong positive affinity by the Support for Oracle RAC instance proxy resource group for the clustered Oracle ASM disk-group resource group.	Support for Oracle RAC instance proxy resource
Resource type: `SUNW.oracle_asm_diskgroup` Resource name: `asm-dg-rs` Resource group: `asm-dg-rg`	Strong positive affinity by the clustered Oracle ASM disk-group resource group for the clustered Oracle ASM instance resource group. When configured with Solaris Volume Manager for Sun Cluster: Strong dependency on the clustered Oracle ASM instance resource. Offline-restart dependency on the scalable device-group resource for database files. When configured with hardware RAID, offline-restart dependency on the clustered Oracle ASM disk-group resource.	Clustered Oracle ASM disk-group resource
SPARC: Resource type: `SUNW.scalable_oracle_asm_instance_proxy` Resource name: `asm-inst-rs` Resource group: `asm-inst-rg`	Offline-restart dependency on the Oracle Grid Infrastructure resource. When configured with hardware RAID, strong positive affinity by the clustered Oracle ASM instance resource group for the Oracle Clusterware framework resource group.	Clustered Oracle ASM instance resource
SPARC: Resource type: `SUNW.sqfs` Resource name: `asm-home-sqfs-rs` Resource group: `asm-home-sqfs-rg`	Strong dependency on the scalable `wait_zc_boot` resource and scalable device-group resource, if any. If you are using Sun QFS without a volume manager, this resource does not depend on any other resources.	Resource for the Oracle ASM home on a Sun QFS metadata server. One resource is created for each Sun QFS shared file system that you are using for Oracle files.
Resource type: `SUNW.ScalMountPoint` Resource name: `asm-mp-rs` Resource group: `asm-mp-rg`	Strong dependency on the resource for the Sun QFS metadata server, if any. Offline-restart dependency on the scalable device-group resource, if any. If you are using a file system on a qualified NAS device without a volume manager, this resource does not depend on any other resources.	Resource for the Oracle Grid Infrastructure home on a scalable file system mount point. One resource is created for each shared file system that you are using for Oracle files.
Resource type: `SUNW.ScalDeviceGroup` Resource name: `scaldg-name-rs`, where `dg-name` is the name of the device group that the resource represents Resource group: `scaldg-rg`	Strong dependency on the resource in the multiple-owner volume-manager framework resource group for the volume manager that is associated with the device group: either the Solaris Volume Manager for Oracle Solaris Cluster resource.	Scalable device-group resource. One resource is created for each scalable device group that you are using for Oracle files.

Next Steps

Go to Chapter 4, Enabling Support for Oracle RAC to Run in a Cluster.