SUNW.ScalDeviceGroup(5) (Sun Cluster Reference Manual for Solaris OS)

Sun Cluster Reference Manual for Solaris OS

SUNW.ScalDeviceGroup(5)

NAME

SUNW.ScalDeviceGroup, ScalDeviceGroup – resource type implementation for a scalable device group

Description

The SUNW.ScalDeviceGroup resource type represents a scalable device group. An instance of this resource type represents one of the following types of device groups:

A Solaris Volume Manager for Sun Cluster multi-owner disk set
A Veritas Volume Manager with the cluster feature (VxVM) shared-disk group

The SUNW.ScalDeviceGroup resource type is a scalable resource type. An instance of this resource type is online on each node in the node list of the resource group that contains the resource.

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:
1. To register this resource type, use the clresourcetype(1CL) command.
2. To create instances of this resource type, use the clresource(1CL) command.

Standard properties and extension properties that are defined for the SUNW.ScalDeviceGroup resource type are described in the subsections that follow.

Standard Properties

For a description of all standard resource properties, see the r_properties(5) man page.

Standard resource properties are overridden for this resource type as follows:

Monitor_Start_timeout

Minimum: 10
Default: 300

Monitor_Stop_timeout

Minimum: 10
Default: 300

Postnet_Stop_timeout

Minimum: 60
Default: 300

Prenet_Start_timeout

Minimum: 60
Default: 300

Start_timeout

Minimum: 60
Default: 300

Stop_timeout

Minimum: 60
Default: 300

Thorough_probe_interval

Default: 300

Update_timeout

Minimum: 60
Default: 300

Validate_timeout

Minimum: 60
Default: 300

Extension Properties

The extension properties of this resource type are as follows:

debug_Level

This property specifies the level to which debug messages from the resource of this type are logged. When the debug level is increased, more debug messages are written to the log files.

Data type: Integer
Default: 0
Range: 0–10
Tunable: Any time

diskgroupname

This property specifies the name of the device group that the resource represents. You must set this property to one of the following items:

The name of an existing Solaris Volume Manager for Sun Cluster multi-owner disk set. This name was specified in the metaset(1M) command with which the disk set was created.
The name of an existing VxVM shared-disk group. This name was specified in the Veritas command with which the disk group was created.

The requirements for the device group that you specify are as follows:

The device group must be a valid, existing multi-owner disk set or shared-disk group.
The device group must be hosted on all nodes that can master the resource.
The device group must be accessible from all nodes that can master the scalable device group resource.
The device group must contain at minimum one volume.

Data type: String
Default: No default defined
Range: Not applicable
Tunable: When disabled

logicaldevicelist

This property specifies a comma-separated list of logical volumes that the fault monitor of the resource is to monitor. This property is optional. If you do not specify a value for this property, all logical volumes in the device group are to be monitored.

The status of the device group is derived from the statuses of the individual logical volumes that are monitored. If all monitored logical volumes are healthy, the device group is healthy. If any monitored logical volume is faulty, the device group is faulty.

The status of an individual logical volume is obtained by querying the volume's volume manager. If the status of a Solaris Volume Manager for Sun Cluster volume cannot be determined from a query, the fault monitor performs file input/output (I/O) operations to determine the status.

If a device group is discovered to be faulty, monitoring of the resource that represents the group is stopped and the resource is put into the disabled state.

Note –

For mirrored disks, if one submirror is faulty, the device group is still considered to be healthy.

The requirements for each logical volume that you specify are as follows:

The logical volume must exist.
The logical volume must be contained in the device group that the diskgroupname property specifies.
The logical volume must be accessible from all nodes that can master the scalable device group resource.

Data type: String array
Default: ""
Range: Not applicable
Tunable: Any time

monitor_retry_count

This property specifies the maximum number of restarts by the process monitor facility (PMF) that are allowed for the fault monitor.

Data type: Integer
Default: 4
Range: No range defined
Tunable: Any time

monitor_retry_interval

This property specifies the period of time in minutes during which the PMF counts restarts of the fault monitor.

Data type: Integer
Default: 2
Range: No range defined
Tunable: Any time

Examples

Example 1 Creating a `ScalDeviceGroup` Resource

This example shows the creation of a ScalDeviceGroup resource to represent a Solaris Volume Manager for Sun Cluster multi-owner disk set that is named datadg. The resource is named scaldatadg-rs. This example assumes that the following Sun Cluster objects exist:

A scalable resource group that is named scaldatadg-rg
An instance of the SUNW.rac_svm resource type that is named rac-svm-rs

# clresourcetype register SUNW.ScalDeviceGroup
# clresource create -t SUNW.ScalDeviceGroup \
-g scaldatadg-rg -p resource_dependencies=rac-svm-rs \
-p diskgroupname=datadg scaldatadg-rs

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWscu

Notes

In a configuration of Sun Cluster Support for Oracle Real Application Clusters (RAC), a resource of type SUNW.ScalDeviceGroup must depend on a resource of the appropriate type.

If the device group is a Solaris Volume Manager for Sun Cluster multi-owner disk set, the resource must depend on a resource of type SUNW.rac_svm. This resource type represents the Solaris Volume Manager for Sun Cluster component of the framework for Sun Cluster Support for Oracle RAC. For more information, see the SUNW.rac_svm(5) man page.
If the device group is a VxVM shared-disk group, the resource must depend on a resource of type SUNW.rac_cvm. This resource type represents the VxVM component of the framework for Sun Cluster Support for Oracle RAC. For more information, see the SUNW.rac_cvm(5) man page.

This dependency ensures that the resource of type SUNW.ScalDeviceGroup is brought online only if the resource of type SUNW.rac_svm or SUNW.rac_cvm is already online.

Create this dependency when you configure storage for the Sun Cluster Support for Oracle RAC data service. For more information, see Chapter 2, Configuring Storage for Oracle Files, in Sun Cluster Data Service for Oracle RAC Guide for Solaris OSin Sun Cluster Data Service for Oracle RAC Guide for Solaris OS.

Sun Cluster 3.2 Last Revised 05 Sep 2007