Go to main content

Reference for Oracle Solaris Cluster 4.4

Exit Print View

Updated: August 2018
 
 

SUNW.ScalDeviceGroup (7)

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 type of device group:

  • A Solaris Volume Manager for Sun Cluster multi-owner disk set

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:

  • Oracle Solaris Cluster Manager

  • The clsetup utility, specifying the option for configuring Oracle Solaris Cluster Support for Oracle Real Application Clusters

  • The following sequence of Oracle Solaris Cluster maintenance commands:

    1. To register this resource type, use the clresourcetype command.

    2. To create instances of this resource type, use the clresource 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(7) 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(8) command with which the disk set 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

IOTimeout

This property specifies the timeout value (in seconds) for I/O probing.

Default

30

Range

1-1800

Tunable

Anytime

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.

Note -  When using Solaris Volume Manager for Sun Cluster, if soft partitions are to be specified to be monitored, then the corresponding top level or bottom level meta devices should also be specified.

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

RebootOnFailure

This property specifies whether to reboot the local system when failure is detected by the probe. When this property is set to TRUE, all devices that are used by the resource, directly or indirectly, must be monitored by disk-path monitoring.

If RebootOnFailure is set to TRUE and at least one device is found available for each entity specified in the GlobalDevicePaths, FileSystemMountPoints, or Zpoolsproperty, the local system is rebooted. The local system refers to the global-cluster node or the zone-cluster node where the resource is online.

Default

FALSE

Tunable

Anytime

Examples

Example 1 Creating a ScalDeviceGroup Resource Using the SUNW.vucmm_svm Resource Type

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 using SUNW.vucmm_svm resource type. The resource is named scaldatadg-rs. This example assumes that the following Oracle Solaris Cluster objects exist:

  • A scalable resource group that is named scaldatadg-rg .

  • An instance of the SUNW.vucmm_svm resource type that is named vucmm-svm-rs.

# clresourcetype register SUNW.ScalDeviceGroup
# clresource create -t SUNW.ScalDeviceGroup \
-g scaldatadg-rg \
-p Resource_dependencies=vucmm-svm-rs \
-p DiskGroupName=datadg \
scaldatadg-rs

Attributes

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

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
ha-cluster/system/core

See Also

SUNW.vucmm_svm(7), attributes(7), r_properties(7), clresource(8CL), clresourcetype(8CL), clsetup(8CL), metaset(8)

Oracle Solaris Cluster Data Service for Oracle Real Application Clusters Guide