SmartPools settings

SmartPools settings include directory protection, global namespace acceleration, L3 cache, virtual hot spare, spillover, requested protection management, and I/O optimization management.

Settings in Web Admin
Settings in CLI
Description
Notes
Increase directory protection to a higher level than its contents
--protect-directories-one-level-higher
Increases the amount of protection for directories at a higher level than the directories and files that they contain, so that data that is not lost can still be accessed.

When device failures result in data loss (for example, three drives or two nodes in a +2:1 policy), enabling this setting ensures that intact data is still accessible.

This setting should be enabled (the default).

When this setting is disabled, the directory that contains a file pool is protected according to your protection-level settings, but the devices used to store the directory and the file may not be the same. There is potential to lose nodes with file data intact but not be able to access the data because those nodes contained the directory.

As an example, consider a cluster that has a +2 default file pool protection setting and no additional file pool policies. OneFS directories are always mirrored, so they are stored at 3x, which is the mirrored equivalent of the +2 default.

This configuration can sustain a failure of two nodes before data loss or inaccessibility. If this setting is enabled, all directories are protected at 4x. If the cluster experiences three node failures, although individual files may be inaccessible, the directory tree is available and provides access to files that are still accessible.

In addition, if another file pool policy protects some files at a higher level, these too are accessible in the event of a three-node failure.

Enable global namespace acceleration
--global-namespace-acceleration-enabled
Specifies whether to allow per-file metadata to use SSDs in the node pool.
  • When disabled, restricts per-file metadata to the storage pool policy of the file, except in the case of spillover. This is the default setting.
  • When enabled, allows per-file metadata to use the SSDs in any node pool.
This setting is available only if 20 percent or more of the nodes in the cluster contain SSDs and at least 1.5 percent of the total cluster storage is SSD-based.

This setting is not applicable for IsilonSD Edge.

If nodes are added to or removed from a cluster, and the SSD thresholds are no longer satisfied, GNA becomes inactive. GNA remains enabled, so that when the SSD thresholds are met again, GNA is reactivated.

Note Image

Node pools with L3 cache enabled are effectively invisible for GNA purposes. All ratio calculations for GNA are done exclusively for node pools without L3 cache enabled.

Use SSDs as L3 Cache by default for new node pools
--ssd-l3-cache-default-enabled
For node pools that include solid-state drives, deploy the SSDs as L3 cache. L3 cache extends L2 cache and speeds up file system performance across larger working file sets.
L3 cache is enabled by default on new node pools. When you enable L3 cache on an existing node pool, OneFS performs a migration, moving any existing data on the SSDs to other locations on the cluster.

This setting is not applicable for IsilonSD Edge.

OneFS manages all cache levels to provide optimal data protection, availability, and performance. In case of a power failure, the data on L3 cache is retained and still available after power is restored.

Virtual Hot Spare
--virtual-hot-spare-deny-writes

--virtual-hot-spare-hide-spare

--virtual-hot-spare-limit-drives

--virtual-hot-spare-limit-percent

Reserves a minimum amount of space in the node pool that can be used for data repair in the event of a drive failure.

To reserve disk space for use as a virtual hot spare, select from the following options:

  • Ignore reserved disk space when calculating available free space. Subtracts the space reserved for the virtual hot spare when calculating available free space.

  • Deny data writes to reserved disk space. Prevents write operations from using reserved disk space.

  • VHS Space Reserved. You can reserve a minimum number of virtual drives (1-4), as well as a minimum percentage of total disk space (0-20%).

If you configure both the minimum number of virtual drives and a minimum percentage of total disk space when you configure reserved VHS space, the enforced minimum value satisfies both requirements.

If this setting is enabled and Deny new data writes is disabled, it is possible for the file system utilization to be reported at more than 100%.

Enable global spillover

--spillover-enabled

Specifies how to handle write operations to a node pool that is not writable.

  • When enabled, redirects write operations from a node pool that is not writable either to another node pool or anywhere on the cluster (the default).
  • When disabled, returns a disk space error for write operations to a node pool that is not writable.
Spillover Data Target
--spillover-target

--spillover-anywhere

Specifies another storage pool to target when a storage pool is not writable.

When spillover is enabled, but it is important that data writes do not fail, select anywhere for the Spillover Data Target setting, even if file pool policies send data to specific pools.

Manage protection settings
--automatically-manage-protection
When this setting is enabled, SmartPools manages requested protection levels automatically.

When Apply to files with manually-managed protection is enabled, overwrites any protection settings that were configured through File System Explorer or the command-line interface.

Manage I/O optimization settings
--automatically-manage-io-optimization
When enabled, uses SmartPools technology to manage I/O optimization.

When Apply to files with manually-managed I/O optimization settings is enabled, overwrites any I/O optimization settings that were configured through File System Explorer or the command-line interface

None
--ssd-qab-mirrors
Either one mirror or all mirrors for the quota account block (QAB) are stored on SSDs
Improve quota accounting performance by placing all QAB mirrors on SSDs for faster I/O. By default, only one QAB mirror is stored on SSD.
None
--ssd-system-btree-mirrors
Either one mirror or all mirrors for the system B-tree are stored on SSDs
Increase file system performance by placing all system B-tree mirrors on SSDs for faster access. Otherwise only one system B-tree mirror is stored on SSD.
None
--ssd-system-delta-mirrors
Either one mirror or all mirrors for the system delta are stored on SSDs
Increase file system performance by placing all system delta mirrors on SSDs for faster access. Otherwise only one system delta mirror is stored on SSD.