Name | Description | Examples | Attributes | See Also | Notes
The SUNW.rac_cvm resource type represents the VxVM component of Sun Cluster Support for Oracle RAC. You can use the SUNW.rac_cvm resource type to represent this component only if the cluster feature of VxVM is enabled.
Instances of the SUNW.rac_cvm resource type hold VxVM component configuration parameters. Instances of this type also show the status of a reconfiguration of the VxVM component.
The SUNW.rac_cvm resource type is a single-instance resource type. Only one resource of this type may be created in the cluster.
To register this resource type and create instances of this resource type, use one of the following means:
Sun Cluster Manager
The clsetup(1CL) utility, specifying the option for configuring Sun Cluster Support for Oracle Real Application Clusters
The following sequence of Sun Cluster maintenance commands:
To register this resource type, use the clresourcetype(1CL) command.
To create instances of this resource type, use the clresource(1CL) command.
When a resource of this type is brought offline on a node, the transition from the online state to the offline state requires a finite time to complete. During the transition to the offline state, the resource continues to participate in reconfiguration processes. However, when the resource is offline on a node, changes to resource properties are not effective on the node until the resource is brought back online. Sun Cluster displays a warning message to this effect when a resource of this type is disabled.
The transition to the unmanaged state of a resource group that contains a resource of this type requires a finite time to complete. During the transition to the unmanaged state, the Oracle RAC framework continues to participate in framework reconfiguration processes. However, when the resource group is unmanaged, changes to resource properties are not effective on the node. To stop the Oracle RAC framework, the node must be rebooted.
The SUNW.rac_cvm resource type is only valid in a resource group that uses the SUNW.rac_framework resource type. Do not use this resource type in a SUNW.vucmm_framework resource group.
Many of the extension properties of the SUNW.rac_cvm resource type specify timeouts for steps in reconfiguration processes. The optimum values for most of these timeouts are independent of your cluster configuration. Therefore, you should not need to change the timeouts from their default values.
Timeouts that depend on your cluster configuration are described in Guidelines for Setting Timeouts in Sun Cluster Data Service for Oracle RAC Guide for Solaris OS. If timeouts occur during reconfiguration processes, increase the values of these timeout properties to accommodate your cluster configuration.
Before you increase the value of a timeout property, consult your VxVM documentation to ensure that the new value is acceptable. The upper limit of the extension property might exceed the maximum value that is acceptable to VxVM.
The extension properties of the SUNW.rac_cvm resource type are as follows.
Some extension properties are tunable only when the resource is disabled. You can modify such extension properties only when VxVM is not running in cluster mode on any cluster node.
Type integer; minimum 30; maximum 99999; defaults to 40. This property specifies the timeout (in seconds) for the abort step of a reconfiguration of the VxVM component of Sun Cluster Support for Oracle RAC. You can modify this property at any time. The modified value is used for the next reconfiguration of the VxVM component.
Type integer; minimum 30; maximum 99999; defaults to 40. This property specifies the timeout (in seconds) for the return step of a reconfiguration of the VxVM component of Sun Cluster Support for Oracle RAC. You can modify this property at any time. The modified value is used for the next reconfiguration of the VxVM component.
Type integer; minimum 30; maximum 99999; defaults to 120. This property specifies the timeout (in seconds) for the start step of a reconfiguration of the VxVM component of Sun Cluster Support for Oracle RAC. You can modify this property at any time. The modified value is used for the next reconfiguration of the VxVM component.
Type integer; minimum 30; maximum 99999; defaults to 100. This property specifies the timeout (in seconds) for step 1 of a reconfiguration of the VxVM component of Sun Cluster Support for Oracle RAC. You can modify this property at any time. The modified value is used for the next reconfiguration of the VxVM component.
Type integer; minimum 30; maximum 99999; defaults to 100. This property specifies the timeout (in seconds) for step 2 of a reconfiguration of the VxVM component of Sun Cluster Support for Oracle RAC. You can modify this property at any time. The modified value is used for the next reconfiguration of the VxVM component.
Type integer; minimum 30; maximum 99999; defaults to 240. This property specifies the timeout (in seconds) for step 3 of a reconfiguration of the VxVM component of Sun Cluster Support for Oracle RAC. You can modify this property at any time. The modified value is used for the next reconfiguration of the VxVM component.
Type integer; minimum 100; maximum 99999; defaults to 320. This property specifies the timeout (in seconds) for step 4 of a reconfiguration of the VxVM component of Sun Cluster Support for Oracle RAC. You can modify this property at any time. The modified value is used for the next reconfiguration of the VxVM component.
Type integer; minimum 30; maximum 99999; defaults to 40. This property specifies the timeout (in seconds) for the stop step of a reconfiguration of the VxVM component of Sun Cluster Support for Oracle RAC. You can modify this property at any time. The modified value is used for the next reconfiguration of the VxVM component.
Type integer; minimum 16; maximum 64; defaults to 32. This property specifies the number of communications ports that the vxclust program uses. You can modify this property only when the resource is disabled. The modified value is used for the next reconfiguration of the VxVM component.
Type integer; minimum 1024; maximum 65535; defaults to 5568. This property specifies the communications port number that the vxclust program uses. You can modify this property only when the resource is disabled. The modified value is used for the next reconfiguration of the VxVM component.
Type integer; minimum 1024; maximum 65535; defaults to 5560. This property specifies the communications port number that the VxVM component configuration daemon vxconfigd uses. You can modify this property only when the resource is disabled. The modified value is used for the next reconfiguration of the VxVM component.
Type integer; minimum 1024; maximum 65535; defaults to 5559. This property specifies the communications port number that the VxVM component messaging daemon vxkmsgd uses. You can modify this property only when the resource is disabled. The modified value is used for the next reconfiguration of the VxVM component.
This example registers the SUNW.rac_cvm resource type and creates an instance of the SUNW.rac_cvm resource type that is named rac_cvm-rs. The example assumes that the following Sun Cluster objects have been created:
A resource group that is named rac-framework-rg
A resource of type SUNW.rac_framework that is named rac_framework-rs
phys-schost-1# clresourcetype register SUNW.rac_cvm phys-schost-1# clresource create -g rac-framework-rg \ -t SUNW.rac_cvm \ -p resource_dependencies=rac_framework-rs rac_cvm-rs |
This example sets the timeout for step 4 of a reconfiguration of the VxVM component of Sun Cluster Support for Oracle RAC to 300 seconds. The example assumes that an instance of the SUNW.rac_cvm resource type named rac_cvm-rs has been created.
phys-schost-1# clresource set \ -p cvm_step4_timeout=300 rac_cvm-rs |
For examples to create a new SUNW.vucmm_cvm resource, see SUNW.vucmm_cvm(5).
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE |
ATTRIBUTE VALUE |
---|---|
Availability |
SUNWcvmr |
clresource(1CL), clresourcetype(1CL), clsetup(1CL), attributes(5), SUNW.vucmm_cvm(5)
Sun Cluster Data Service for Oracle RAC Guide for Solaris OS
On the Solaris 10 OS, if you are using only Oracle RAC, you can optionally configure an additional resource group that uses the SUNW.vucmm_framework resource type, in addition to the resource group that uses the SUNW.rac_framework resource type. If you use this SUNW.vucmm_framework resource group, it must include the VUCMM version of any storage resource types that you need, SUNW.vucmm_svm and SUNW.vucmm_cvm, instead of using the SUNW.rac_svmand SUNW.rac_cvm resource types in the SUNW.vucmm_framework resource group. You can then use the SUNW.vucmm_framework resource group to configure other data services.
If you configure any applications other than Oracle RAC to use a Sun QFS shared file system, you must use the SUNW.vucmm_framework resource group to contain all storage resource types that are used by the applications, including Oracle RAC. However, to support Oracle RAC you still need the separate resource group that is based on the SUNW.rac_framework resource type but does not contain the SUNW.rac_svm or SUNW.rac_cvm resource type.
At some future time you might decide to configure other data services to use a Sun QFS shared file system. To avoid the possible need to migrate an Oracle RAC configuration to accommodate such use, configure Oracle RAC to use a SUNW.vucmm_framework resource group that includes any needed VUCMM storage resource types.
Name | Description | Examples | Attributes | See Also | Notes