Changes to resource types of resources in the RAC framework for Sun Cluster 3.2 software are summarized in the following table.
Table 7–1 Changes to RAC Framework Resource Types
Resource Type |
Changes |
---|---|
SPARC: SUNW.rac_cvm |
Extension property reservation_timeout removed. |
SUNW.rac_framework |
Extension property reservation_timeout added. |
Removed from Sun Cluster 3.2 software. |
|
SUNW.rac_svm |
Extension property reservation_timeout removed. |
SPARC: 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. |
SUNW.vucmm_framework |
Added in the Sun Cluster 3.2 11/09 release. |
SUNW.vucmm_svm |
Added in the Sun Cluster 3.2 11/09 release. |
SPARC: SUNW.vucmm_cvm |
Added in the Sun Cluster 3.2 11/09 release. |
Upgrade these resource types if you are upgrading 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
Information for Migrating Existing Instances of RAC Framework Resource Types
How to Preserve a Nondefault Value of the reservation_timeout Extension Property
The resource type versions of changed RAC framework resource types are listed in the following table for version 3.1 and version 3.2 11/09 of Sun Cluster software. This table also lists the name of the Resource Type Registration (RTR) file of each changed resource type.
Table 7–2 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 11/09 |
RTR File |
---|---|---|---|
SPARC: SUNW.rac_cvm |
1.0 |
4 |
/usr/cluster/lib/ucmm/rt/rac_cvm/etc/SUNW.rac_cvm |
SUNW.rac_framework |
1.0 |
5 |
/usr/cluster/lib/ucmm/rt/rac_framework/etc/SUNW.rac_framework |
SUNW.rac_svm |
1.0 |
4 |
/usr/cluster/lib/ucmm/rt/rac_svm/etc/SUNW.rac_svm |
SPARC: SUNW.rac_udlm |
1.0 |
3 |
/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 |
Specifies the resource type whose version you are determining.
The information that you require to edit each instance of RAC framework resource types is listed in the following table.
Table 7–3 Information for Migrating Existing Instances of RAC Framework Resource Types
Resource Type |
Value of type_version Property |
Possible Migration Times |
Changes to Extension Properties |
---|---|---|---|
SPARC: SUNW.rac_cvm |
4 |
Any time |
Extension property reservation_timeout removed. |
SUNW.rac_framework |
5 |
Any time |
Extension property reservation_timeout added. |
SUNW.rac_svm |
4 |
Any time |
Extension property reservation_timeout removed. |
SPARC: SUNW.rac_udlm |
3 |
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 to edit an instance of the SUNW.rac_udlm resource type.
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.
# clresource set -p type_version=3 \ -p port=100 rac_udlm-rs |
This command edits a SUNW.rac_framework resource as follows:
The SUNW.rac_udlm resource is named rac_udlm.
The type_version property of this resource is set to 3.
The communications port number that the Oracle UDLM uses is set to 100.
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 was an extension property of the following resource types:
SPARC: SUNW.rac_cvm
SUNW.rac_hwraid
SUNW.rac_svm
As of 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 as of 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 11/09, perform this task to preserve the value.
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 |
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.
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 |
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 11/09, version is 5.
Specifies the value to which you are setting the reservation_timeout extension property. This value is the value that you obtained in Step 1.
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.
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:
The type_version property is set to 4.
The reservation_timeout extension property is set to 350 seconds.
# clresource set -p type_version=4 \ -p reservation_timeout=350 rac_framework |
The following documentation:
Information for Registering the New Versions of RAC Framework Resource Types
Information for Migrating Existing Instances of RAC Framework Resource Types
The clresource(1CL) man page
As of 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 11/09. If a resource of this obsolete type is configured on your cluster, remove the resource.
Become superuser or assume a role that provides solaris.cluster.modify RBAC authorization.
Delete the instance of SUNW.rac_hwraid, if any.
# clresource delete -F -t SUNW.rac_hwraid + |
If no resource of type SUNW.rac_hwraid is configured on your cluster, a message to this effect is displayed. Ignore this message.