Sun Cluster Data Service for Oracle RAC Guide for Solaris OS

Registering and Configuring Storage Resources for Oracle Files

Storage resources provide fault monitoring and automatic fault recovery for global device groups and file systems.

If you are using global device groups or shared file systems for Oracle files, configure storage resources to manage the availability of the storage on which the Oracle software depends.

Configure storage resources for the following types of global device groups:

Solaris Volume Manager for Sun Cluster multi-owner disk sets
VxVM shared-disk groups

Configure storage resources for the following types of shared file systems:

A Sun StorageTek QFS shared file system
A file system on a qualified NAS device

Tools for Registering and Configuring Storage Resources for Oracle Files

Sun Cluster provides the following tools for registering and configuring storage resources for Oracle files:

The clsetup(1CL) utility. For more information, see How to Register and Configure Storage Resources for Oracle Files by Using clsetup.
Sun Cluster Manager. For more information, see the Sun Cluster Manager online help.
Sun Cluster maintenance commands. For more information, see Creating Storage Management Resources by Using Sun Cluster Maintenance Commands.

The clsetup utility and Sun Cluster Manager each provide a wizard for configuring storage resources for Oracle files. 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.

How to Register and Configure Storage Resources for Oracle Files by Using `clsetup`

This procedure provides the long forms of the Sun Cluster maintenance commands. Most commands also have short forms. Except for the forms of the command names, the commands are identical. For a list of the commands and their short forms, see Appendix A, Sun Cluster Object-Oriented Commands, in Sun Cluster Data Services Planning and Administration Guide for Solaris OS.

Perform this procedure from only one node of the cluster.

Before You Begin

Ensure that the following prerequisites are met:

The RAC framework resource group is created and is online. For more information, see Registering and Configuring the RAC Framework Resource Group.
Required volumes, global device groups, and file systems are created. For more information, see the following sections:
- Installing Storage Management Software With Sun Cluster Support for Oracle RAC
- Creating a Global Device Group for the Oracle RAC Database
Required file systems are mounted.

Ensure that you have the following information:

The name of each scalable device group that you are using for Oracle files, if any
The mountpoint of each shared file system that you are using for Oracle files, if any

On one node of the cluster, become superuser.

Start the clsetup utility.
# clsetup
The clsetup main menu is displayed.

Type the number that corresponds to the option for data services and press Return.

The Data Services menu is displayed.

Type the number that corresponds to the option for configuring Sun Cluster Support for Oracle RAC and press Return.

The clsetup utility displays information about Sun Cluster Support for Oracle RAC.

Press Return to continue.

The clsetup utility prompts you to select whether you are performing the initial configuration of Sun Cluster Support for Oracle RAC or administering an existing configuration.

Type the number that corresponds to the option for performing the initial configuration of Sun Cluster Support for Oracle RAC and press Return.

The clsetup utility displays a list of components of Oracle RAC to configure.

Type the number that corresponds to the option for storage resources for Oracle files and press Return.

The clsetup utility prompts you to select the Oracle RAC clusters location. This can be a global cluster or a zone cluster.

Type the number that corresponds to the option for the location of the Oracle RAC clusters and press Return.
- If you have selected the global cluster option, the clsetup utility displays the list of components of Oracle RAC to configure. Go to Step 10.
- If you have selected the zone cluster option, the clsetup utility prompts you to select the required zone cluster. Go to Step 9.

Type the number that corresponds to the option for the required zone cluster and press Return.

The clsetup utility displays the list of components of Oracle RAC to configure.

Type the number that corresponds to the option for the component of Oracle RAC and press Return.

The clsetup utility displays the list of prerequisites for performing in this task.

Verify that the prerequisites are met, and press Return.

The response of the clsetup utility depends on how the RAC framework resource group was configured.
- By using the clsetup wizard or the Sun Cluster Manager wizard. The clsetup utility displays a list of the resources for scalable device groups that are configured on the cluster. If no suitable resources exist, this list is empty.
- By using the scsetup utility or Sun Cluster maintenance commands. The clsetup utility displays a list of storage management schemes for Oracle files.

If you are prompted to select storage management schemes for Oracle files, select the schemes.

If you are prompted for resources for scalable device groups, omit this step.
1. Type the numbers that correspond to the storage management schemes that you are using for Oracle files and press Return.
2. To confirm your selection of storage management schemes, type d and press Return.
  
  The clsetup utility displays a list of the resources for scalable device groups that are configured on the cluster. If no suitable resources exist, this list is empty.

If no suitable resources exist, or if no resource exists for a device group that you are using, add a resource to the list.

If resources exist for all the device groups that you are using, omit this step.

For each resource that you are adding, perform the following steps:
1. Type c and press Return.
  
  The clsetup utility displays a list of the scalable device groups that are configured on the cluster.
2. Type the number that corresponds to the device group that you are using for Oracle files and press Return.
  
  Once you select the device group, you can either select the entire disk group or choose to specify logical devices, or disks, in the disk group.
3. Choose whether you want to specify logical devices.
  - If you choose to specify logical devices, type yes. Go to Step d.
  - If you want to select the entire disk group, type no. Go to Step e.
4. Type a comma-separated list of numbers that corresponds to the logical devices or disks you choose or type a for all.
  
  The clsetup utility returns you to the list of resources for scalable device groups that are configured on the cluster.
5. To confirm your selection of device groups, type d and press Return.
  
  The clsetup utility returns you to the list of the resources for scalable device groups that are configured on the cluster. The resource that you are creating is added to the list.

If a suitable existing resource that you intend to use is not listed, type r to refresh the list.

When the list contains resources for all the device groups that you are using, type the numbers that correspond to the resources that you require.

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 device groups, type d and press Return.

The clsetup utility displays a list of the resources for shared file-system mountpoints that are configured on the cluster. If no suitable resources exist, this list is empty.

If no suitable resources exist, or if no resource exists for a file-system mountpoint that you are using, add a resource to the list.

If resources exist for all the file-system mountpoints that you are using, omit this step.

For each resource that you are adding, perform the following steps:
1. Type c and press Return.
  
  The clsetup utility displays a list of the shared file systems that are configured on the cluster.
2. Type a comma-separated or space-separated list of numbers that correspond to the file systems that you are using for Oracle files and press Return.
3. To confirm your selection of file systems, type d and press Return.
  
  The clsetup utility returns you to the list of the resources for file-system mountpoints that are configured on the cluster. The resource that you are creating is added to the list.

If a suitable existing resource that you intend to use is not listed, type r to refresh the list.

When the list contains resources for all the file-system mountpoints that you are using, type the numbers that correspond to the resources that you require.

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 file-system mountpoints, type d and press Return.

The clsetup utility displays the names of the Sun Cluster objects that the utility will create or add to your configuration.

If you need to modify a Sun Cluster object that the utility will create, modify the object as follows:
1. Type the number that corresponds to the Sun Cluster object that you are modifying and press Return.
  
  The clsetup utility displays a list of properties that are set for the object.
2. Modify each property that you are changing as follows:
  1. Type the number that corresponds to the property that you are changing 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.
3. When you have modified all the properties that you need to change, type d.
  
  The clsetup utility returns you to the list of the names of the Sun Cluster objects that the utility will create or add to your configuration.

When you have modified all the Sun Cluster objects that you need to change, type d.

The clsetup utility displays information about the RAC framework resource group for which storage resources will be configured.

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 Sun Cluster 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 if the resource groups that the wizard created are online.
# clresourcegroup status

If a resource group that the wizard created is not online, bring the resource group online.

For each resource group that you are bringing online, type the following command:
# clresourcegroup online -emM rac-storage-rg
rac-storage-rg

Specifies the name of the resource group that you are bringing online.

Resource Configuration

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

Resource Type, Resource Name, and Resource Group	Dependencies	Description
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 RAC framework resource group for the volume manager that is associated with the device group: either the Solaris Volume Manager for Sun Cluster resource or the VxVM resource.	Scalable device-group resource. One resource is created for each scalable device group that you are using for Oracle files.
Resource type: `SUNW.qfs` Resource name: `qfs-mp-dir-rs`, where `mp-dir` is the mountpoint of the file system, with `/` replaced by `–` Resource group: `qfsmds-rg`	Strong dependency on the scalable wait_zc_boot resource and scalable device-group resource, if any. If you are using Sun StorageTek QFS without a volume manager, this resource does not depend on any other resources.	Resource for the Sun StorageTek QFS metadata server. One resource is created for each Sun StorageTek QFS shared file system that you are using for Oracle files.
Resource type: `SUNW.ScalMountPoint` Resource name: `scal-mp-dir-rs`, where `mp-dir` is the mountpoint of the file system, with `/` replaced by `–` Resource group: `scalmnt-rg`	Strong dependency on the resource for the Sun 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.	Scalable file system mountpoint resource. One resource is created for each shared file system that you are using for Oracle files.
Resource type: `SUNW.wait_zc_boot` Resource name: wait-zc-rs, where `zc` is the zone cluster name. Resource group: `scalmnt-rg`	None	Resource to ensure that the Sun StorageTek QFS shared file system configured to the zone cluster are mounted only after zone cluster is booted.

Note –

For detailed information for the resource configuration for zone clusters, see the figures in Appendix A, Sample Configurations of This Data Service.

Next Steps

Go to Chapter 3, Enabling Oracle RAC to Run in a Cluster.