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

Sun Cluster Reference Manual for Solaris OS

SUNW.ScalMountPoint(5)

NAME

SUNW.ScalMountPoint, ScalMountPoint– resource type implementation for a scalable file-system mount point

DESCRIPTION

The SUNW.ScalMountPoint resource type represents a scalable file-system mount point. An instance of this resource type represents the mount point of one of the following types of file systems:

A Sun StorEdge^TM QFS shared file system
A file system on a Network Appliance network-attached storage (NAS) device

The Network Appliance NAS device and the file system must already be configured for use with Sun Cluster. For more information, see Sun Cluster With Network-Attached Storage Devices Manual for Solaris OS.

The SUNW.ScalMountPoint 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.ScalMountPoint 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 for a file-system mount point 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

filesystemtype

This property specifies the type of file system whose mount point the resource represents. You must specify this property. Set this property to one of the following values:

nas: Specifies that the file system is a file system on a Network Appliance NAS device.
s-qfs: Specifies that the file system is a Sun StorEdge QFS shared file system.

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

iotimeout

This property specifies the timeout value in seconds that the fault monitor uses for file input/output (I/O) probes. To determine if the mounted file system is available, the fault monitor performs I/O operations such as opening, reading, and writing to a test file on the file system. If an I/O operation is not completed within the timeout period, the fault monitor reports an error.

Data type: Integer
Default: 300
Range: 5–300
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

mountoptions

This property specifies a comma-separated list of mount options that are to be used when the file system that the resource represents is mounted. This property is optional. If you do not specify a value for this property, mount options are obtained from the file system's table of defaults.

For a Sun StorEdge QFS shared file system, these options are obtained from the /etc/opt/SUNWsamfs/samfs.cmd file.
For a file system on a Network Appliance NAS device, these options are obtained from the /etc/vfstab file.

Mount options that you specify through this property override the mount options in the file system's table of defaults.

Data type: String
Default: ""
Range: Not applicable
Tunable: When disabled

mountpointdir

This property specifies the mount point of the file system that the resource represents. The mount point is the full path to the directory where the file system is attached to the file system hierarchy when the file system is mounted. You must specify this property.

The directory that you specify must already exist.

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

targetfilesystem

This property specifies the file system that is to be mounted at the mount point that the mountpointdir extension property specifies. You must specify this property. The type of the file system must match the type that the filesystemtype property specifies. The format of this property depends on the type of the file system as follows:

For a Sun StorEdge QFS shared file system, set this property to the name that was assigned to the file system when the file system was created. The file system must be correctly configured. For more information, see your Sun StorEdge QFS shared file system documentation.
For a file system on a Network Appliance NAS device, set this property to nas-device:path. The replaceable items in this format are as follows:

nas-device

Specifies the name of the Network Appliance NAS device that is exporting the file system. You can optionally qualify this name with a domain.

path

Specifies the full path to the file system that the Network Appliance NAS device is exporting.

The Network Appliance NAS device and the file system must already be configured for use with Sun Cluster. For more information, see Sun Cluster With Network-Attached Storage Devices Manual for Solaris OS.

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

EXAMPLES

Example 1 Creating a `ScalMountPoint` Resource

This example shows the creation of a ScalMountPoint resource to represent the mount point of a Sun StorEdge QFS shared file system that is used with Solaris Volume manager for Sun Cluster. The resource is named scal-db_qfs-Data-rs. The characteristics of the file system are as follows:

The mount point of the file system is /db_qfs/Data.
The file system that is to be mounted is Data.
Mount options are obtained from the file system's table of defaults, that is the /etc/opt/SUNWsamfs/samfs.cmd file.

This example assumes that the following Sun Cluster objects exist:

A scalable resource group that is named scaldatadg-rg
An instance of the SUNW.qfs resource type that is named qfs-db_qfs-Data-rs
An instance of the SUNW.ScalDeviceGroup resource type that is named scaldatadg-rs

# clresourcetype register SUNW.ScalMountPoint
# clresource create -t SUNW.ScalMountPoint \
-g scaldatadg-rg  \
-p resource_dependencies=qfs-db_qfs-Data-rs,scaldatadg-rs \
-p mountpointdir=/db_qfs/Data -p filesystemtype=s-qfs \
-p targetfilesystem=Data scal-db_qfs-Data-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.ScalMountPoint that represents the mount point of a Sun StorEdge QFS shared file system must depend on an instance of the SUNW.qfs resource type. If you are using Sun StorEdge QFS shared file system with Solaris Volume Manager for Sun Cluster, the resource of SUNW.ScalMountPoint type must also depend on an instance of the SUNW.ScalDeviceGroup resource type.

These dependencies ensure that the resource of type SUNW.ScalMountPoint is brought online only if the resources of type SUNW.qfs and SUNW.DeviceGroup are already online.

Create these dependencies when you configure storage for the Sun Cluster Support for Oracle RAC data service. For more information, see “Configuring Storage for Oracle Files” in Sun Cluster Data Service for Oracle RAC Guide for Solaris OS.

Sun Cluster 3.2 Last Revised 8 Jun 2006