This chapter explains how to upgrade a configuration of Sun Cluster Support for Oracle RAC.
If you upgrade Sun Cluster core software, you must also upgrade the Sun Cluster Support for Oracle RAC software. For more information, see Sun Cluster Upgrade Guide for Solaris OS.
Your existing configuration of Sun Cluster Support for Oracle RAC might not include the RAC framework resource group. In this situation, you must register and configure the RAC framework resource group after upgrading Sun Cluster software. Otherwise, Oracle RAC cannot run with Sun Cluster software. For more information, see Registering and Configuring the RAC Framework Resource Group.
Information about how to upgrade an existing configuration is provided in the subsections that follow:
Adding Resources for Interoperation With Oracle 10g Release 2 or 11g CRS
Upgrading to Sun Cluster 3.2 Resource Types for Oracle 9i RAC Database Instances
The SUNW.oracle_rac_server resource type and the SUNW.oracle_listener resource type are unchanged in Sun Cluster 3.2 software. If you choose to continue to use the SUNW.oracle_rac_server resource type and the SUNW.oracle_listener resource type for Oracle 9i RAC database instances, no upgrade of these resource types is required.
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.
Sun Cluster 3.2 11/09 software includes resource types that 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, add storage resources to manage the availability of the storage on which the Oracle software depends.
Before adding storage resources for Oracle files, ensure that you have upgraded resources in the RAC framework resource group. For more information, see Upgrading Resources in the RAC Framework Resource Group.
For detailed instructions for adding storage resources for Oracle files, see Registering and Configuring Storage Resources for Oracle Files.
Follow these instructions only if you are adding storage resources to an existing configuration of storage management schemes. If you are extending an existing configuration of Sun Cluster Support for Oracle RAC by supporting additional storage management schemes, see the following sections:
Sun Cluster 3.2 11/09 software includes resource types that enable Sun Cluster software and Oracle 10g Release 2 or 11g CRS to interoperate. These resource types also enable Oracle RAC database instances to be administered from Sun Cluster.
Sun Cluster resource types cannot be used to interoperate with Oracle 10g Release 1 CRS. Instead, use Oracle 10g Release 1 CRS commands to start and shut down Oracle RAC database instances.
Before adding resources for interoperation with Oracle 10g Release 2 or 11g CRS, ensure that you have performed the tasks in the following sections:
For detailed instructions for adding resources for interoperation with Oracle 10g Release 2 or 11g CRS, see Configuring Resources for Oracle RAC Database Instances.
As of the Sun Cluster 3.2 release, the failover resource types that automate the startup and shutdown of Oracle 9i RAC database instances can be replaced with multi-master resource types. The multi-master resources simplify the administration and enhance the scalability of Sun Cluster Support for Oracle RAC.
Upgrading from Sun Cluster 3.1 software to Sun Cluster 3.2 11/09 resource types for Oracle 9i RAC database instances involves the tasks that are described in the following sections:
How to Take Offline Resource Groups for Oracle RAC Database Components and Restart the Components
How to Modify the Configuration of Sun Cluster Resources for Oracle 9i RAC Database Instances
Perform these tasks in the order in which they are listed.
This task involves taking offline resource groups for Oracle RAC database components and restarting the components on each cluster node individually.
This sequence of operations avoids downtime by ensuring that the Oracle RAC database components remain online on other cluster nodes.
Perform this task on each cluster node individually.
Ensure that you have upgraded resources in the RAC framework resource group. For more information, see Upgrading Resources in the RAC Framework Resource Group.
Become superuser on the cluster node.
If you configured Oracle listener resources in separate resource groups, take offline the resource groups from the node.
If you configured Oracle listener resources in the same resource group as the Oracle RAC server resource, omit this step.
For each resource group that you are taking offline, type the following command:
# clresourcegroup offline -n node rac-listener-rg |
Specifies the node from which you are taking the resource group offline. This node is the node where you are performing this task.
Specifies the resource group for Oracle listener resources that you are taking offline.
When the resource group is taken offline, the Oracle listener is stopped on the node. The Oracle listeners on other nodes are unaffected.
Take offline the resource group for the RAC server from the node.
# clresourcegroup offline -n node rac-server-rg |
Specifies the node from which you are taking the resource group offline. This node is the node where you are performing this task.
Specifies the resource group for the Oracle RAC server resource that you are taking offline.
When the resource group is taken offline, the Oracle RAC server is stopped on the node. The Oracle RAC servers on other nodes are unaffected.
If you configured Oracle listener resources in the same resource group as the Oracle RAC server resource, the listeners are also stopped on the node. The Oracle listeners on other nodes are unaffected.
Use Oracle utilities to restart the Oracle RAC server and Oracle listener on the node.
Go to How to Modify the Configuration of Sun Cluster Resources for Oracle 9i RAC Database Instances.
Perform this task from one cluster node.
Ensure that the task that is explained in How to Take Offline Resource Groups for Oracle RAC Database Components and Restart the Components has been performed.
Become superuser or assume a role that provides solaris.cluster.admin and solaris.cluster.modify RBAC authorizations.
If you configured Oracle listener resources in separate resource groups, remove the resource groups.
If you configured Oracle listener resources in the same resource group as Oracle RAC server resources, omit this step.
For each resource group that you are removing, type the following command:
# clresourcegroup delete -F rac-listener-rg |
Specifies the resource group for Oracle listener resources that you are removing.
Remove all resource groups that contain an Oracle RAC server resource.
For each resource group that you are removing, type the following command:
# clresourcegroup delete -F rac-server-rg |
Specifies the resource group that contains an Oracle RAC server resource that you are removing.
If you are using a Sun QFS shared file system, remove all resource groups that contain resources for the Sun QFS metadata server.
If you are not using a Sun QFS shared file system, omit this step.
For each resource group that you are removing, type the following command:
# clresourcegroup delete -F qfs-mds-rg |
Specifies the resource group that contains resources for the Sun QFS metadata server that you are removing.
If you are using global device groups or shared file systems for Oracle files, add storage resources to manage the availability of the storage on which the Oracle software depends.
If you are not using global device groups or shared file systems for Oracle files, omit this step.
For instructions for performing this task, see Adding Storage Resources for Oracle Files.
Configure new resources for Oracle 9i RAC database instances.
For instructions for performing this task, see Configuring Resources for Oracle RAC Database Instances.