Property Settings for ZFS File System Datasets and ZFS Storage Pools

This section describes requirements and restrictions for property settings of ZFS file system datasets and ZFS storage pools (zpools).

Note:

You can alternatively configure this and other types of file systems as highly available local file systems. For more information, see Enabling Highly Available Local File Systems in Planning and Administering Data Services for Oracle Solaris Cluster 4.4.

The following is an Oracle Solaris ZFS pool property.

clustered=on | off

For ZFS pools, the clustered property determines the accessibility of the datasets of the pool. If the pool is imported with the clustered property set to on, then all the file system datasets in that pool will be mounted globally and available from all the cluster nodes. Normally, a ZFS pool that hosts the ZFS cluster file systems is managed by a device group which automatically sets the clustered property to on at pool import time. Hence, you do not have to set this manually.

For more information about the clustered property, see the zpool(8) man page.

The following ZFS dataset properties are not allowed to be set to new values while the file system is globally mounted. To change any of these properties, unmount the ZFS dataset or mount it locally. For more information on these and other zfs properties, see the zfs(8) man page.

  • atime

  • devices

  • exec

  • readonly

  • rstchown

  • setuid

  • xattr

  • sync

  • canmount

  • mountpoint

  • zoned

A ZFS file system must have its zoned property set to off for a global mount to succeed.

For example, to change the mountpoint property of dataset globalzpool/fs1 where globalzpool has clustered property set to on, complete the following steps.

  1. Unmount the dataset.

    # zfs unmount globalzpool/fs1
  2. Update the mountpoint property.

    # zfs set mountpoint=/global/gzpool/fs1 globalzpool/fs1
  3. Re-mount the dataset.

    # zfs mount globalzpool/fs1

Sharing of a ZFS file system using the zfs share and zfs unshare commands with the share.nfs or share.smb ZFS property is not currently supported for globally mounted ZFS file systems. Instead, configure legacy sharing using the Oracle Solaris Cluster HA for Network File System (NFS) data service. For more information, see the Oracle Solaris Cluster Data Service for NFS Guide.