- resource type implementation that represents the Veritas Volume Manager (VxVM) component of Oracle Solaris Cluster Support for Oracle Real Application Clusters (RAC)
The SUNW.rac_cvm resource type represents the VxVM component of Oracle Solaris 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:
Oracle Solaris Cluster Manager
The clsetup(1CL) utility, specifying the option for configuring Oracle Solaris Cluster Support for Oracle Real Application Clusters
The following sequence of Oracle Solaris 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. Oracle Solaris 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 Oracle Solaris Cluster Data Service for Oracle Real Application Clusters Guide. If timeouts occur during reconfiguration processes, increase the values of these timeout properties to accommodate your cluster configuration.
Note - 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.
Note - 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 Oracle Solaris 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 Oracle Solaris 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 Oracle Solaris 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 Oracle Solaris 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 Oracle Solaris 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 Oracle Solaris 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 Oracle Solaris 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 Oracle Solaris 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.
Example 1 Creating a rac_cvm Resource
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 Oracle Solaris 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
Example 2 Changing a Property of a rac_cvm Resource
This example sets the timeout for step 4 of a reconfiguration of the VxVM component of Oracle Solaris 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
See attributes(5) for descriptions of the following attributes:
|
clresource(1CL), clresourcetype(1CL), clsetup(1CL), attributes(5), SUNW.vucmm_cvm(5)
Oracle Solaris Cluster Data Service for Oracle Real Application Clusters Guide