Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Reference Manual Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

### 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:

- 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`(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 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 the device group that is specified in the `DiskGroupName` property, 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`(5) for descriptions of the following attributes:

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

## See Also

`clresource`(1CL), `clresourcetype`(1CL), `clsetup`(1CL), `metaset`(1M), `attributes`(5), `r_properties`(5), `SUNW.vucmm_svm`(5)

Oracle Solaris Cluster Data Service for Oracle Real Application Clusters Guide

Copyright © 2000, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices |