vucmm_cvm(5) (Sun Cluster Reference Manual for Solaris OS)

Sun Cluster Reference Manual for Solaris OS

vucmm_cvm(5)

Name

SUNW.vucmm_cvm, vucmm_cvm– resource type implementation that represents the Veritas Volume Manager (VxVM) component of the Sun Cluster volume manager reconfiguration framework

Description

The SUNW.vucmm_cvm resource type represents the VxVM component of the Sun Cluster volume manager reconfiguration framework. You can use the SUNW.vucmm_cvm resource type to represent this component only if the cluster feature of VxVM is enabled.

Instances of the SUNW.vucmm_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.vucmm_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 following means:

To register this resource type, use the clresourcetype(1CL) command.
To create instances of this resource type, use the clresource(1CL) command.

The SUNW.vucmm_cvm resource type is only valid in a resource group that uses the SUNW.vucmm_framework resource type. Do not use this resource type in a SUNW.rac_framework resource group.

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 software 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 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 framework, you must reboot the node.

Many of the extension properties of the SUNW.vucmm_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 the individual data service guides, such as 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.

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.vucmm_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.

cvm_abort_step_timeout: 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 the volume manager reconfiguration framework. You can modify this property at any time. The modified value is used for the next reconfiguration of the VxVM component.
cvm_return_step_timeout: 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 the volume manager reconfiguration framework. You can modify this property at any time. The modified value is used for the next reconfiguration of the VxVM component.
cvm_start_step_timeout: 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 the volume manager reconfiguration framework. You can modify this property at any time. The modified value is used for the next reconfiguration of the VxVM component.
cvm_step1_timeout: 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 the volume manager reconfiguration framework. You can modify this property at any time. The modified value is used for the next reconfiguration of the VxVM component.
cvm_step2_timeout: 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 the volume manager reconfiguration framework. You can modify this property at any time. The modified value is used for the next reconfiguration of the VxVM component.
cvm_step3_timeout: 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 the volume manager reconfiguration framework. You can modify this property at any time. The modified value is used for the next reconfiguration of the VxVM component.
cvm_step4_timeout: 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 the volume manager reconfiguration framework. You can modify this property at any time. The modified value is used for the next reconfiguration of the VxVM component.
cvm_stop_step_timeout: 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 the volume manager reconfiguration framework. You can modify this property at any time. The modified value is used for the next reconfiguration of the VxVM component.
vxclust_num_ports: 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.
vxclust_port: 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.
vxconfigd_port: 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.
vxkmsgd_port: 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.

Examples

Example 1 Creating a `vucmm_cvm` Resource

This example registers the SUNW.vucmm_cvm resource type and creates an instance of the SUNW.vucmm_cvm resource type that is named vucmm_cvm-rs. The example assumes that the following Sun Cluster objects have been created:

A resource group that is named vucmm_framework-rg
A resource of type SUNW.vucmm_framework that is named vucmm_framework-rs

phys-schost-1# clresourcetype register SUNW.vucmm_cvm
phys-schost-1# clresource create -g vucmm_framework-rg \
-t SUNW.vucmm_cvm \
-p resource_dependencies=vucmm_framework-rs vucmm_cvm-rs

Example 2 Changing a Property of a `vucmm_cvm` Resource

This example sets the timeout for step 4 of a reconfiguration of the VxVM component of the volume manager reconfiguration framework to 300 seconds. The example assumes that an instance of the SUNW.vucmm_cvm resource type named vucmm_cvm-rs has been created.

phys-schost-1# clresource set -p cvm_step4_timeout=300 vucmm_cvm-rs

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWscu

Notes

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.

Sun Cluster 3.2 Last Revised 20 Aug 2009