SUNW.ScalDeviceGroup, ScalDeviceGroup - resource type implementation for a scalable device group
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:
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:
To register this resource type, use the clresourcetype command.
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.
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:
10
300
10
300
60
300
60
300
60
300
60
300
300
60
300
60
300
The extension properties of this resource type are as follows:
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.
Integer
0
0-10
Any time
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.
String
No default defined
Not applicable
When disabled
This property specifies the timeout value (in seconds) for I/O probing.
30
1-1800
Anytime
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.
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.
String array
""
Not applicable
Any time
This property specifies the maximum number of restarts by the process monitor facility (PMF) that are allowed for the fault monitor.
Integer
4
No range defined
Any time
This property specifies the period of time in minutes during which the PMF counts restarts of the fault monitor.
Integer
2
No range defined
Any time
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.
FALSE
Anytime
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
See attributes(5) for descriptions of the following attributes:
|
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