Registering and Configuring the Framework Resource Groups by Using Sun Cluster Maintenance Commands

The task in this section is an alternative for the resource-configuration steps in How to Register and Configure the RAC Framework Resource Group by Using clsetup. Instructions include configuring the multiple-owner volume-manager framework, which currently you cannot configure by using clsetup. The following information is in this section:

Overview of the Framework Resource Groups

This section describes the following framework resource groups:

RAC Framework Resource Group

The RAC framework resource group enables Oracle RAC to run with Sun Cluster. This resource group contains an instance of the following single-instance resource types:

SUNW.rac_framework, which represents the framework that enables Oracle RAC to be managed by using Sun Cluster commands
SPARC: SUNW.rac_udlm, which represents the UNIX Distributed Lock Manager (Oracle UDLM) component of Sun Cluster Support for Oracle RAC

In addition, the RAC framework resource group can contain an instance of a single-instance resource type that represents the volume manager that you are using for Oracle files, if any. This is the legacy configuration that is used in releases before the Sun Cluster 3.2 11/09 release, before the introduction of the SUNW.vucmm_framework resource group to contain multiple-owner volume-manager resources.

Note –

This legacy use of the SUNW.rac_framework resource group to contain volume-manager resources is still supported in this release, but might be deprecated in a future Sun Cluster release.

Solaris Volume Manager for Sun Cluster is represented by the SUNW.rac_svm resource type.
SPARC: VxVM with the cluster feature is represented by the SUNW.rac_cvm resource type.

Note –

The resource types that are defined for the RAC framework resource group do not enable the Resource Group Manager (RGM) to manage instances of Oracle RAC.

Multiple-Owner Volume-Manager Framework Resource Group

The multiple-owner volume-manager framework resource group enables a multiple-owner shared-storage feature to be used by Oracle RAC.

The multiple-owner volume-manager framework resource group is based on the SUNW.vucmm_framework resource type. This resource group contains the volume manager resources for the multiple-owner volume-manager framework, SUNW.vucmm_svm or SUNW.vucmm_cvm.

When a multiple-owner volume-manager framework resource group is configured, you do not also put a SUNW.rac_svm or SUNW.rac_cvm resource in the SUNW.rac_framework resource group.

How to Register and Configure the Framework Resource Groups in the Global Cluster by Using Sun Cluster Maintenance Commands

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 on only one node of the cluster.

Become superuser or assume a role that provides solaris.cluster.admin and solaris.cluster.modify RBAC authorizations.

Create a scalable Oracle RAC resource group.

Tip –
If you require Sun Cluster Support for Oracle RAC to run on all cluster nodes, specify the -S option in the command that follows and omit the options -n, -p maximum_primaries, -p desired_primaries, and -p rg_mode.
# clresourcegroup create -n nodelist \ -p maximum_primaries=num-in-list \ -p desired_primaries=num-in-list \ [-p rg_description="description"] \ -p rg_mode=Scalable rac-fmwk-rg
-n nodelist=nodelist

Specifies a comma-separated list of cluster nodes on which Sun Cluster Support for Oracle RAC is to be enabled. The Sun Cluster Support for Oracle RAC software packages must be installed on each node in this list.

-p maximum_primaries=num-in-list

Specifies the number of nodes on which Sun Cluster Support for Oracle RAC is to be enabled. This number must equal the number of nodes in nodelist.

-p desired_primaries=num-in-list

Specifies the number of nodes on which Sun Cluster Support for Oracle RAC is to be enabled. This number must equal the number of nodes in nodelist.

-p rg_description="description"

Specifies an optional brief description of the resource group. This description is displayed when you use Sun Cluster maintenance commands to obtain information about the resource group.

-p rg_mode=Scalable

Specifies that the resource group is scalable.

rac-fmwk-rg

Specifies the name that you are assigning to the Oracle RAC resource group.

# clresourcetype register SUNW.rac_framework

Add an instance of the SUNW.rac_framework resource type to the resource group that you created in Step 2.
# clresource create -g rac-fmwk-rg -t SUNW.rac_framework rac-fmwk-rs
-g rac-fmwk-rg

Specifies the resource group to which you are adding the resource. This resource group must be the resource group that you created in Step 2.

rac-fmwk-rs

Specifies the name that you are assigning to the SUNW.rac_framework resource.

SPARC: Register the SUNW.rac_udlm resource type.
# clresourcetype register SUNW.rac_udlm
Note –
If you are performing the steps in this procedure to register and configure the RAC resource framework in a zone cluster and RAC support is not required in the global cluster, you do not need to create the SUNW.rac_udlm resource in the global cluster. In that case, go to Step 10.

SPARC: Add an instance of the SUNW.rac_udlm resource type to the resource group that you created in Step 2.

Ensure that this instance depends on the SUNW.rac_framework resource that you created in Step 4.
# clresource create -g resource-group \ -t SUNW.rac_udlm \ -p resource_dependencies=rac-fmwk-rs rac-udlm-rs
-g rac-fmwk-rg

Specifies the resource group to which you are adding the resource. This resource group must be the resource group that you created in Step 2.

-p resource_dependencies=rac-fmwk-rs

Specifies that this instance depends on the SUNW.rac_framework resource that you created in Step 4.

rac-udlm-rs

Specifies the name that you are assigning to the SUNW.rac_udlm resource.

Create a scalable multiple-owner volume-manager framework resource group, if one does not already exist.

If you do not intend to create a multiple-owner volume-manager framework resource group, skip to Step 10.
# clresourcegroup create -n nodelist -S vucmm-fmwk-rg
-n nodelist=nodelist

Specifies the same node list that you configured for the scalable Oracle RAC resource group.

vucmm-fmwk-rg

Specifies the name that you are assigning to the multiple-owner volume-manager framework resource group.

Register the SUNW.vucmm_framework resource type.

If you did not create a multiple-owner volume-manager framework resource group, skip to Step 10.
# clresourcetype register SUNW.vucmm_framework

Add an instance of the SUNW.vucmm_framework resource type to the resource group that you created in Step 7.

If you did not create a multiple-owner volume-manager framework resource group, skip to Step 10.
# clresource create -g vucmm-fmwk-rg -t SUNW.vucmm_framework vucmm-fmwk-rs
-g vucmm-fmwk-rg

Specifies the resource group to which you are adding the resource. This resource group must be the resource group that you created in Step 7.

vucmm-fmwk-rs

Specifies the name that you are assigning to the SUNW.vucmm_framework resource.

Register and add an instance of the resource type that represents the volume manager that you are using for Oracle files, if any.

If you are not using a volume manager, omit this step.
- If you are using Solaris Volume Manager for Sun Cluster, register and add the instance as follows:
  1. Register the resource type.
    # clresourcetype register svm-rt
    svm-rt
    Specifies the resource type you register.
    
    If you are using a SUNW.vucmm_framework based resource group, register the SUNW.vucmm_svm resource type.
    
    If you are using only a SUNW.rac_framework based resource group, register the SUNW.rac_svm resource type.
  2. Add an instance of the resource type to the resource group to contain the volume manager resource.
    
    Ensure that this instance depends on the framework resource that you created.
    # clresource create -g fmwk-rg \ -t svm-rt \ -p resource_dependencies=fmwk-rs svm-rs
    -g fmwk-rg
    Specifies the resource group to which you are adding the resource.
    
    If you are using a SUNW.vucmm_framework based resource group, specify the resource group that you created in Step 7.
    
    If you are using only a SUNW.rac_framework based resource group, specify the resource group that you created in Step 2.
    -p resource_dependencies=fmwk-rs
    Specifies that this instance depends on the framework resource that you created.
    
    If you are using a SUNW.vucmm_framework based resource group, specify the resource group that you created in Step 9.
    
    If you are using only a SUNW.rac_framework based resource group, specify the resource group that you created in Step 4.
    svm-rs
    
    Specifies the name that you are assigning to the SUNW.vucmm_svm or SUNW.rac_svm resource.
- SPARC: If you are using VxVM with the cluster feature, register and add the instance as follows.
  1. Register the resource type.
    # clresourcetype register cvm-rt
    cvm-rt
    Specifies the resource type you register.
    
    If you are using a SUNW.vucmm_framework based resource group, register the SUNW.vucmm_cvm resource type.
    
    If you are using only a SUNW.rac_framework based resource group, register the SUNW.rac_cvm resource type.
  2. Add an instance of the resource type to the resource group that you created.
    
    Ensure that this instance depends on the framework resource that you created.
    # clresource create -g fmwk-rg \ -t cvm-rt \ -p resource_dependencies=fmwk-rs cvm-rs
    -g fmwk-rg
    Specifies the resource group to which you are adding the resource. This resource group must be the resource group that you created.
    
    If you are using a SUNW.vucmm_framework based resource group, specify the resource group that you created in Step 7.
    
    If you are using only a SUNW.rac_framework based resource group, specify the resource group that you created in Step 2.
    -p resource_dependencies=fmwk-rs
    Specifies that this instance depends on the framework resource that you created.
    
    If you are using a SUNW.vucmm_framework based resource group, specify the resource group that you created in Step 9.
    
    If you are using only a SUNW.rac_framework based resource group, specify the resource group that you created in Step 4.
    cvm-rs
    
    Specifies the name that you are assigning to the SUNW.vucmm_cvm or SUNW.rac_cvm resource.

Bring online and in a managed state the RAC framework resource group, the multiple-owner volume-manager framework resource group if used, and their resources.
# clresourcegroup online -emM rac-fmwk-rg [vucmm-fmwk-rg]
rac-fmwk-rg

Specifies that the RAC resource group that you created in Step 2 is to be moved to the MANAGED state and brought online.

vucmm-fmwk-rg

Specifies that the multiple-owner volume-manager framework resource group that you created in Step 7 is to be moved to the MANAGED state and brought online.

How to Register and Configure the RAC Framework Resource Group in a Zone Cluster by Using Sun Cluster Maintenance Commands

Perform the steps in this procedure to register and configure the RAC framework resource group in a zone cluster for the Sun QFS shared file system with Solaris Volume Manager. For this configuration, you need to create the RAC framework resource group in both the global cluster and zone cluster.

Note –

When a step in the procedure requires running the Sun Cluster commands in a zone cluster, you should run the command from the global cluster and use the -Z option to specify the zone cluster.

Before You Begin

Perform the steps to register and configure the RAC framework resource group rac-fmwk-rg, with resources rac-fmwk-rs and rac-svm-rs in the global cluster.

Note –

For information on registering and configuring the RAC framework resource group in the global cluster, see How to Register and Configure the Framework Resource Groups in the Global Cluster by Using Sun Cluster Maintenance Commands.

Become superuser or assume a role that provides solaris.cluster.admin and solaris.cluster.modify RBAC authorizations.

Create a scalable Oracle RAC resource group.

Tip –
If you require Sun Cluster Support for Oracle RAC to run on all cluster nodes, specify the -S option in the command that follows and omit the options -n, -p maximum_primaries, -p desired_primaries, and -p rg_mode.
# clresourcegroup create -Z zcname -n nodelist \ -p maximum_primaries=num-in-list \ -p desired_primaries=num-in-list \ [-p rg_description="description"] \ -p rg_mode=Scalable rac-fmwk-rg

# clresourcetype register -Z zcname SUNW.rac_framework

Add an instance of the SUNW.rac_framework resource type to the resource group that you created in Step 2.
# clresource create -Z zcname -g rac-fmwk-rg \ -t SUNW.rac_framework rac-fmwk-rs
-g rac-fmwk-rg

Specifies the resource group to which you are adding the resource. This resource group must be the resource group that you created in Step 2.

rac-fmwk-rs

Specifies the name that you are assigning to the SUNW.rac_framework resource.

SPARC: Register the SUNW.rac_udlm resource type.

# clresourcetype register -Z zcname SUNW.rac_udlm

SPARC: Add an instance of the SUNW.rac_udlm resource type to the resource group that you created in Step 2.

Ensure that this instance depends on the SUNW.rac_framework resource that you created in Step 4.
# clresource create -Z zcname -g resource-group \ -t SUNW.rac_udlm \ -p resource_dependencies=rac-fmwk-rs rac-udlm-rs
-g rac-fmwk-rg

Specifies the resource group to which you are adding the resource. This resource group must be the resource group that you created in Step 2.

-p resource_dependencies=rac-fmwk-rs

Specifies that this instance depends on the SUNW.rac_framework resource that you created in Step 4.

rac-udlm-rs

Specifies the name that you are assigning to the SUNW.rac_udlm resource.

Bring online and in a managed state the RAC framework resource group and its resources.
# clresourcegroup online -Z zcname -emM rac-fmwk-rg
rac-fmwk-rg

Specifies that the resource group that you created in Step 2 is to be moved to the MANAGED state and brought online.