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`

Note - You can also use the Oracle Solaris Cluster Manager browser interface to perform this task, in addition to configuring the Oracle RAC framework resource group. For Oracle Solaris Cluster Manager log-in instructions, see How to Access Oracle Solaris Cluster Manager in Oracle Solaris Cluster 4.3 System Administration Guide . After you log in, click Tasks and then click Oracle Real Application Clusters to start the wizard.

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.
Any project you created to run Oracle ASM exists in the projects name service database for the user that runs that application. If no custom project is created for the application, the default project is used. For more information, see the projects (1) man page.

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 (https://support.oracle.com) 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.
The Data Services menu is displayed.
Type the option number for 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 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.
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.
- 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 9.
- If you select the zone cluster option, the clsetup utility prompts you to select the required zone cluster. Proceed to the next step.

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

Type the option number for Automatic Storage Management (ASM).
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.
- 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.
  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.
  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.
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 14.

To confirm your selection of an Oracle ASM instance resource, type d.
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.
The clsetup utility prompts you for the project to use.
Type the option number to choose a listed project.
If you did not create a project where Oracle ASM will run, select the default project. The clsetup utility prompts you for the Oracle ASM system identifier (SID).
Review the list of SIDs.
- If the list is correct, type d.
- If the list is not correct, type the option number for the SID to change.
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.
  The clsetup utility displays a list of existing Oracle ASM disk groups. Proceed to the next step.
- If you do not want to create a new disk-group resource, type n.
  The clsetup utility displays a list of discovered storage resources. Skip to Step 20.

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

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.
- If the list is not correct, type the option number or letter to edit the list of resources.
  When the list of disk-group resources is correct, type d.
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.
- If no storage resource is listed, type d.
  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.
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.
  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.
3. To confirm your selection of disk groups, type d.
  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.
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.
To confirm your selection of Oracle ASM disk groups, type d.
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.
  The clsetup utility prompts you for the new value.
2. At the prompt, type the new value.
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.
The clsetup utility displays information about the Oracle Solaris Cluster configuration that the utility will create.
To create the configuration, type c.
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 StorageTek QFS without a volume manager, this resource does not depend on any other resources.	Resource for the Oracle ASM home on a StorageTek QFS metadata server. One resource is created for each StorageTek 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 StorageTek 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.