IN THIS ARTICLE
Outlines how to use Alternate Data Streams over SMB in Qumulo Core
- Cluster running Qumulo Core version 2.12.2 or above
Alternate Data Stream (ADS) is the SMB-centric name for a feature that stores more than one file-data object in a single file-object, or where one or more file-data object is stored in a directory object. Common use-cases of ADS include storing small amounts of extended metadata (e.g., stash display icons for the file) about a particular file or directory so that it stays alongside the standard data, but not act as a part of it.
Most documentation recommends that mission-critical data should not be stored in an ADS since support for the feature varies from one platform to the next. However, Qumulo Core provides full support for the feature, so this is not a concern—data integrity is assured.
Common Use Cases
Windows Use Case: A user downloads a file from the internet via Microsoft Edge onto an SMB share on their Qumulo cluster. This action will result in one named stream being applied to the downloaded file that Windows uses to identify whether or not the file is safe based on its source.
Mac Use Case: A user creates a file on an SMB share stored on their Qumulo cluster. They then open Finder, right-click on the file, and select a colored tag from the menu. Since the Mac Finder uses named streams for tracking, this action will result in two named streams being applied to the file.
View ADS Info via QQ CLI
To view your aggregated data for ADS, use the following qq command and include the file system path:
qq fs_read_dir_aggegates --path PATH
Details for the total streams and stream data is included in the output:
qq fs_read_dir_aggregates --path /grumpquat
- Alternate Data Streams will be replicated if both the source and target clusters are running 2.12.2 or above. If both clusters are not on 2.12.2 or above, the Replication Relationship will fail and not resume until both clusters are upgraded. In order to maintain cross Replication protocol version compatibility, please contact your CSM prior to upgrading either cluster to 2.12.2 or above.
- Replicating Alternate Data Streams will be supported without intervention when upgrading from 2.13.0 to the following future quarterly release of Qumulo Core.
- Qumulo Core limits the number of Alternate Data Streams on any file/directory to 31.
- ADS names (includes stream name + stream type over SMB) have a max character length of 255.
- While allowed on NTFS, Qumulo Core does not allow ADS to be created on or be a target of a symlink and does not permit the default (un-named) stream to be renamed.
- Support for managing Alternate Data Streams via the qq CLI will be available in a future release of Qumulo Core.
You should now have an overall understanding of Alternate Data Streams (ADS) over SMB in Qumulo Core
Like what you see? Share this article with your network!