How to Add a Cluster File System to a Zone Cluster (clsetup)

How to Add a Cluster File System to a Zone Cluster (`clsetup`)

Ensure that the cluster file system you want to add to the zone cluster is configured. See Planning Cluster File Systems and Creating a Cluster File System.

The clsetup utility discovers and displays the available file systems that are configured on the cluster nodes where the selected zone cluster is configured. When you use the clsetup utility to add a file system, the file system is added in cluster scope.

You can add the following types of cluster file systems to a zone cluster:

ZFS cluster file system - The ZFS storage pool is imported in the global zone, and ZFS automatically mounts filesystem datasets configured in the pool.
UFS cluster file system - You specify the file system type in the /etc/vfstab file, using the global mount option. This file system can be located on the shared disk or on a Solaris Volume Manager device.
Oracle HSM shared file system - You specify the file system type in the /etc/vfstab file, using the shared mount option.
ACFS - Discovered automatically, based on the ORACLE_HOME path you provide.

Note:

Alternatively, you can use either the command line or the Oracle Solaris Cluster Manager to perform this task. To use the command line to perform this task, see one of the following procedures:

To use the Oracle Solaris Cluster Manager browser interface to perform this task, click Zone Clusters, click the zone cluster name to go to its page, click the Solaris Resources tab, then in the File Systems section click Add to start the file systems wizard. For Oracle Solaris Cluster Manager log-in instructions, see How to Access Oracle Solaris Cluster Manager in Administering an Oracle Solaris Cluster 4.4 Configuration.

Assume the root role on a node of the global cluster that hosts the zone cluster.

You perform all steps of this procedure from a node of the global cluster.
(For non-ZFS file systems only) On each node of the global cluster that hosts a zone-cluster node, add an entry to the /etc/vfstab file for the file system that you want to mount on the zone cluster.
```
phys-schost# vi /etc/vfstab
```
- For a UFS entry, include the global mount option, similar to the following example:
```
/dev/md/datadg/dsk/d0 /dev/md/datadg/rdsk/d0 /global/fs ufs 2 no global, logging
```
- For a shared QFS entry, include the shared mount option, similar to the following example:
```
Data-cz1    -    /db_qfs/Data1 samfs - no shared,notrace
```
On the global cluster, start the clsetup utility.
```
phys-schost# clsetup
```
The Main Menu is displayed.

Tip:
To return to a previous screen, type the < key and press Return.
Choose the Zone Cluster menu item.

The Zone Cluster Tasks Menu is displayed.
Choose the Add File System/Storage Device to a Zone Cluster menu item.

The Select Zone Cluster menu is displayed.
Choose the zone cluster where you want to add the file system.

The Storage Type Selection menu is displayed.
Choose the File System menu item.

The File System Selection for the Zone Cluster menu is displayed.
Choose a file system from the list.

You can also type e to manually specify all properties for a file system. If you are using an ACFS file system, you can select Discover ACFS and then specify the ORACLE_HOME directory.

The Mount Type Selection menu is displayed.
Choose the Loopback file system mount type for the zone cluster.

If you chose ACFS in Step 7, the clsetup utility skips this step because ACFS supports only the direct mount type.

For more information about creating loopback file systems, see the lofiadm(8) man page.

The File System Properties for the Zone Cluster menu is displayed.
Specify the mount point directory.

Type the number for the dir property and press Return. Then type the LOFS mount point directory name in the New Value field and press Return.

When finished, type d and press Return. The Review File Systems/Storage Devices for the Zone Cluster menu is displayed.

Type c to save the configuration change.

The results of your configuration change are displayed. For example:

  >>> Result of Configuration Change to the Zone Cluster(sczone) <<<

Adding file systems or storage devices to sczone zone cluster...

The zone cluster is being created with the following configuration

/usr/cluster/bin/clzonecluster configure sczone
add fs
set dir=/zones/sczone/dsk/d0
set special=/global/fs
set type=lofs
end

Configuration change to sczone zone cluster succeeded.

When finished, exit the clsetup utility.

Verify the addition of the LOFS file system.

phys-schost# clzonecluster show -v zone-cluster-name

Next Steps

(Optional) Configure the cluster file system to be managed by an HAStoragePlus resource. The HAStoragePlus resource manages the mounting of the file systems in the global cluster, and later performs a loopback mount on the zone-cluster nodes that currently host the applications that are configured to use the file system. For more information, see Configuring an HAStoragePlus Resource for Cluster File Systems in Planning and Administering Data Services for Oracle Solaris Cluster 4.4.