How to Set Up the HAStoragePlus Resource Type for an NFS-Exported UNIX File System Using the Command Line Interface - Oracle® Solaris Cluster Data Service for NFS Guide

Language:

How to Set Up the `HAStoragePlus` Resource Type for an NFS-Exported UNIX File System Using the Command Line Interface

The HAStoragePlus resource type synchronizes the startups between resource groups and disk device groups. The HAStoragePlus resource type has an additional feature to make a local file system highly available. For background information about making a local file system highly available, see Enabling Highly Available Local File Systems in Planning and Administering Data Services for Oracle Solaris Cluster 4.4. To use both of these features, set up the HAStoragePlus resource type.

Note - These instructions explain how to use the HAStoragePlus resource type with the UNIX file system (UFS). For information about using the HAStoragePlus resource type with the Sun QFS file system, see your Sun QFS documentation.

The following example uses a simple NFS service that exports home directory data from a locally mounted directory /global/local-fs/nfs/export/ home. The example assumes the following:

The mount point /global/local-fs/nfs is used to mount a UFS local file system on an Oracle Solaris Cluster global device partition.
The /etc/vfstab entry for the /global/local-fs/nfs file system should omit the global option and specify that the mount at boot flag is no.
The path-prefix directory is on the root directory of the same file system that is to be mounted, for example, /global/local-fs/nfs. The path-prefix directory is the directory that HA-NFS uses to maintain administrative information and status information.

On a cluster node, become an administrator that provides solaris.cluster.admin authorization.

Determine whether the HAStoragePlus resource type and the SUNW.nfs resource type are registered.
The following command prints a list of registered resource types.
```
# clresourcetype show | egrep Type
```

If necessary, register the HAStoragePlus resource type and the SUNW.nfs resource type.

# clresourcetype register SUNW.HAStoragePlus
# clresourcetype register SUNW.nfs

Create the failover resource group nfs-rg.

# clresourcegroup create -p PathPrefix=/global/local-fs/nfs nfs-rg

Create a logical host resource of type SUNW.LogicalHostname.
```
# clreslogicalhostname create -g nfs-rg -h log-nfs nfs-lh-rs
```
Note - If you require a fully qualified hostname, you must specify the fully qualified name with the -h option and you cannot use the fully qualified form in the resource name.

Create the resource nfs-hastp-rs of type HAStoragePlus.
```
# clresource create -g nfs-rg -t SUNW.HAStoragePlus \
-p FilesystemMountPoints=/global/local-fs/nfs \
-p AffinityOn=True nfs-hastp-rs
```
The resource is created in the enabled state.

Note - You can use the FilesystemMountPoints extension property to specify a list of one or more mount points for file systems. This list can consist of mount points for both local file systems and global file systems. The mount at boot flag is ignored by HAStoragePlus for global file systems.
Bring online the resource group nfs-rg on a cluster node.
The node where the resource group is brought online becomes the primary node for the /global/local-fs/nfs file system's underlying global device partition. The file system /global/local-fs/nfs is then mounted on this node.
```
# clresourcegroup online -M nfs-rg
```

Create the resource nfs-rs of type SUNW.nfs and specify its resource dependency on the resource nfs-hastp-rs.
The file dfstab.nfs-rs must be present in /global/local-fs/nfs/SUNW.nfs.
```
# clresource create -g nfs-rg -t SUNW.nfs \
-p Resource_dependencies_offline_restart=nfs-hastp-rs nfs-rs
```
The resource is created in the enabled state.

Note - Before you can set the dependency in the nfs-rs resource, the nfs-hastp-rs resource must be online.
Take offline the resource group nfs-rg.
```
# clresourcegroup offline nfs-rg
```

Bring online the nfs-rg group on a cluster node.

# clresourcegroup online -eM nfs-rg

Caution - Ensure that you switch only the resource group. Do not attempt to switch the device group. If you attempt to switch the device group, the states of the resource group and the device group become inconsistent, causing the resource group to fail over.

Whenever the service is migrated to a new node, the primary I/O path for /global/local-fs/nfs will always be online and colocated with the NFS servers. The file system /global/local-fs/nfs is locally mounted before the NFS server is started.