Sun Cluster Data Service for Oracle RAC Guide for Solaris OS

Upgrading Resources in the RAC Framework Resource Group

Changes to resource types of resources in the RAC framework for Sun Cluster 3.2 are summarized in the following table.

Table 6–2 Changes to RAC Framework Resource Types

Resource Type 

Changes 

SUNW.rac_cvm

Extension property reservation_timeout removed.

SUNW.rac_framework

Extension property reservation_timeout added.

SUNW.rac_hwraid

Removed from Sun Cluster 3.2. 

SUNW.rac_svm

Extension property reservation_timeout removed.

SUNW.rac_udlm

Tunability of the oracle_config_file extension property changed from any time to when disabled.

Minimum allowed value of port extension property reduced from 1024 to 1.

Upgrade these resource types if you are upgrading to version 3.2 from an earlier version of Sun Cluster Support for Oracle RAC.

For general instructions that explain how to upgrade a resource type, see Upgrading a Resource Type in Sun Cluster Data Services Planning and Administration Guide for Solaris OS.

The information that you require to complete the upgrade of the RAC framework resource types is provided in the subsections that follow.

Information for Registering the New Versions of RAC Framework Resource Types

The resource type versions of changed RAC framework resource types are listed in the following table for version 3.1 and version 3.2 of Sun Cluster. This table also lists the name of the Resource Type Registration (RTR) file of each changed resource type.

Table 6–3 Information for Registering the New Version of RAC Framework Resource Types

Resource Type 

Resource Type Version in Sun Cluster 3.1  

Resource Type Version in Sun Cluster 3.2 

RTR File 

SUNW.rac_cvm

1.0 

/usr/cluster/lib/ucmm/rt/rac_cvm/etc/SUNW.rac_cvm

SUNW.rac_framework

1.0 

/usr/cluster/lib/ucmm/rt/rac_framework/etc/SUNW.rac_framework

SUNW.rac_svm

1.0 

/usr/cluster/lib/ucmm/rt/rac_svm/etc/SUNW.rac_svm

SPARC: SUNW.rac_udlm

1.0 

/usr/cluster/lib/ucmm/rt/rac_udlm/SUNW.rac_udlm

To determine the version of the resource type that is registered, use the following command:


# clresourcetype show resource-type
resource-type

Specifies the resource type whose version you are determining.

Information for Migrating Existing Instances of RAC Framework Resource Types

The information that you require to edit each instance of RAC framework resource types is listed in the following table.

Table 6–4 Information for Migrating Existing Instances of RAC Framework Resource Types

Resource Type 

Value of type_version Property

Possible Migration Times 

Changes to Extension Properties 

SUNW.rac_cvm

Any time 

Extension property reservation_timeout removed.

SUNW.rac_framework

2  

Any time 

Extension property reservation_timeout added.

SUNW.rac_svm

2  

Any time 

Extension property reservation_timeout removed.

SPARC: SUNW.rac_udlm

Any time 

Tunability of the oracle_config_file extension property changed from any time to when disabled.

Minimum allowed value of port extension property reduced from 1024 to 1.

The following example shows a command for editing an instance of the SUNW.rac_udlm resource type.


Note –

The example shows the setting of an extension property that can be set only when the resource is disabled. The step for disabling the resource is not shown in the example.



Example 6–1 Editing an Instance of the SUNW.rac_udlm Resource Type


# clresource set -p type_version=2 \
-p port=100 rac_udlm-rs 

This command edits a SUNW.rac_framework resource as follows:


ProcedureHow to Preserve a Nondefault Value of the reservation_timeout Extension Property

The reservation_timeout extension property specifies the timeout value in seconds for the reservation step of a reconfiguration of Sun Cluster Support for Oracle RAC.

In Sun Cluster release 3.1, reservation_timeout is an extension property of the following resource types:

In Sun Cluster release 3.2, reservation_timeout is an extension property only of the SUNW.rac_framework resource type. This property is removed from the SUNW.rac_cvm resource type and the SUNW.rac_svm resource type. The SUNW.rac_hwraid resource type is removed from Sun Cluster release 3.2.

A nondefault value of the reservation_timeout extension property might be set for an existing resource of type SUNW.rac_hwraid, SUNW.rac_cvm, or SUNW.rac_svm. If you require this value after you upgrade to Sun Cluster release 3.2, perform this task to preserve the value.

  1. Before you migrate or remove the resource for which the reservation_timeout extension property is set, obtain the value of this property.


    # clresource show -p reservation_timeout -t resource-type
    
    resource-type

    Specifies the resource type of the resource for which the reservation_timeout extension property is set, namely, SUNW.rac_cvm, SUNW.rac_hwraid, or SUNW.rac_svm.

  2. When you migrate the existing instance of the SUNW.rac_framework resource type, set the reservation_timeout extension property to the value that you obtained in Step 1.


    # clresource set -p type_version=version \
    -p reservation_timeout=timeout rac-framework-rs 
    
    version

    Specifies the value of the type_version property for the version of SUNW.rac_framework to which you are migrating the instance. In Sun Cluster release 3.2, version is 2.

    timeout

    Specifies the value to which you are setting the reservation_timeout extension property. This value is the value that you obtained in Step 1.

    rac-framework-rs

    Specifies the name of the resource of type SUNW.rac_framework on your cluster. If the scsetup utility of Sun Cluster release 3.1 was used to create the RAC framework resource group, this resource is named rac_framework.


Example 6–2 Preserving a Nondefault Value of the reservation_timeout Extension Property

This example shows the commands for preserving a nondefault value of the reservation_timeout extension property that was set for a resource of type SUNW.rac_svm.

Before the migration of the resource of type SUNW.rac_svm, the following command is run to obtain the value of the reservation_timeout extension property:


# clresource show -p reservation_timeout -t SUNW.rac_svm

=== Resources ===                              

Resource:                                       rac-svm-rs

  --- Standard and extension properties ---    

  Reservation_timeout:                          350
    Class:                                         extension
    Description:                                   Timeout (in seconds) for the 
reservation step of Sun Cluster framework for RAC
    Per-node:                                      False
    Type:                                          int

During the migration of the resource of type SUNW.rac_framework, the following command is run to set properties as follows:


# clresource set -p type_version=2 \
-p reservation_timeout=350 rac_framework 

See Also

The following documentation:

ProcedureHow to Remove the Resource of Type SUNW.rac_hwraid

In Sun Cluster release 3.2, the SUNW.rac_hwraid resource type is obsolete and is not supplied with this release. Any resource of type SUNW.rac_hwraid is not required after an upgrade to Sun Cluster release 3.2. If a resource of this obsolete type is configured on your cluster, remove the resource.

  1. Become superuser or assume a role that provides solaris.cluster.modify RBAC authorization.

  2. Delete the instance of SUNW.rac_hwraid, if any.


    # clresource delete -F -t SUNW.rac_hwraid +
    

    Note –

    If no resource of type SUNW.rac_hwraid is configured on your cluster, a message to this effect is displayed. Ignore this message.