Sun Cluster Data Service for Oracle RAC Guide for Solaris OS

Registering and Configuring the RAC Framework Resource Group 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.

Overview of the 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:

In addition, the RAC framework resource group contains an instance of a single-instance resource type that represents the volume manager that you are using for Oracle files, if any.


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.


ProcedureHow to Register and Configure the RAC Framework Resource Group 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.

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

  2. Create a scalable 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 resource group.

  3. Register the SUNW.rac_framework resource type.


    # clresourcetype register SUNW.rac_framework
    
  4. 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.

  5. 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 the 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 7.


  6. 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.

  7. 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 SUNW.rac_svm resource type.


        # clresourcetype register SUNW.rac_svm
        
      2. Add an instance of the SUNW.rac_svm resource type to the resource group that you created in Step 2.

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


        # clresource create -g rac-fmwk-rg \
          -t SUNW.rac_svm \
          -p resource_dependencies=rac-fmwk-rs rac-svm-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-svm-rs

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

    • If you are using VxVM with the cluster feature, register and add the instance as follows.

      1. Register the SUNW.rac_cvm resource type.


        # clresourcetype register SUNW.rac_cvm
        
      2. Add an instance of the SUNW.rac_cvm resource type to the resource group that you created in Step 2.

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


        # clresource create -g rac-fmwk-rg \
          -t SUNW.rac_cvm \
          -p resource_dependencies=rac-fmwk-rs rac-cvm-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-cvm-rs

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

  8. Bring online and in a managed state the RAC framework resource group and its resources.


    # clresourcegroup online -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.

ProcedureHow to Register and Configure the RAC Framework Resource Group in the Zone 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 the steps in this procedure to register and configure the RAC framework resource group in a zone cluster for the Sun StorageTek QFS shared file system with SVM. 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 RAC Framework Resource Group in the Global Cluster by Using Sun Cluster Maintenance Commands.


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

  2. Create a scalable 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
    
  3. Register the SUNW.rac_framework resource type.


    # clresourcetype register -Z zcname SUNW.rac_framework
    
  4. 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.

  5. Register the SUNW.rac_udlm resource type.


    # clresourcetype register -Z zcname SUNW.rac_udlm
    
  6. 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.

  7. 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.