Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.

Dell Unity™ Family Unisphere® Command Line Interface User Guide

Create file systems

Create a multiprotocol file system, NFS file system, or CIFS (SMB) file system. You must create a file system for each type of share (NFS or CIFS) you plan to create. Once you create a file system, create the NFS or CIFS network shares and use the ID of the file system to associate it with a share.
NOTE:Size qualifiers provides details on using size qualifiers to specify a storage size.

Prerequisites

  • Configure at least one storage pool for the file system to use and allocate at least one drive to the pool. Configure custom pools explains how to create custom pools.
  • Configure at least one NAS server to which to associate the file system. Create a NAS server explains how to configure NAS servers.

Format

/stor/prov/fs create [-async] -name <value> [-descr <value>] {-server <value> | -serverName <value>} {-pool <value> | -poolName <value>} -size <value> [-thin {yes | no}] [-dataReduction {yes [-advancedDedup {yes | no}] | no}] [–minSizeAllocated <value>] -type {{nfs | cifs | multiprotocol [-accessPolicy {native | Windows | Unix}] [-folderRenamePolicy {allowedAll | forbiddenSmb | forbiddenAll}] [-lockingPolicy {advisory | mandatory}]} [–cifsSyncWrites {yes | no}] [-cifsOpLocks {yes | no}] [-cifsNotifyOnWrite {yes | no}] [-cifsNotifyOnAccess {yes | no}] [-cifsNotifyDirDepth <value>] | nfs} [-fastvpPolicy {startHighThenAuto | auto | highest | lowest}] [-sched <value> [-schedPaused {yes | no}]] [-replDest {yes | no}][-eventProtocols <value>] [-flr {disabled | {enterprise | compliance} [-flrMinRet <value>] [-flrDefRet <value>] [-flrMaxRet <value>]}]

Action qualifiers

QualifierDescription
-asyncRun the operation in asynchronous mode.
-nameType a name for the file system.
-descrType a brief description of the file system.
-serverType the ID of the NAS server that will be the parent NAS server for the file system. View NAS servers explains how to view the IDs of the NAS servers on the system.
-serverNameType the name of the NAS server that will be the parent NAS server for the file system.
-poolType the ID of the pool to be used for the file system.
-poolNameType the name of the pool to be used for the file system. This value is case insensitive. View pools explains how to view the names of the storage pools on the system.
-sizeType the quantity of storage to reserve for the file system.
-thinEnable thin provisioning on the file system. Valid values are:
  • yes (default)
  • no
-dataReductionSpecify whether data reduction is enabled for the thin file system. Valid values are:
  • yes (default)
  • no
NOTE:The thin file systems must be created on Unity systems running version 4.2.x or later.
-advancedDedupSpecify whether advanced deduplication is enabled for the thin file system. This option is available only after data reduction has been enabled. Valid values are:
  • yes
  • no (default)
NOTE:The thin file systems must be created on a Unity system running version 4.2.x or later. Advanced deduplication is available only on:
  • Dynamic or Traditional pools in Unity 380F, 480F, 680F, and 880F systems
  • Dynamic pools in Unity All-Flash 450F, 550F, and 650F systems
  • All-Flash pools and Hybrid Flash pools in Unity Hybrid 380, 480, 680, and 880 systems
-minSizeAllocated(Option available on a Unity system running OE version 4.1.) Specify the minimum size to allocate for the thin file system. Automatic and manual file shrink operations cannot decrease the file system size lower than this value. The default value is 3G, which is the minimum thin file system size.
-typeSpecify the type of network shares to export from the file system. Valid values are:
  • nfs — Network shares for Linux/UNIX hosts.
  • cifs — Network shares for Windows hosts.
  • multiprotocol — Network shares for multiprotocol sharing.
-accessPolicy (Applies to multiprotocol file systems only.) Specify the access policy for this file system. Valid values are:
  • native (default)
  • unix
  • windows
-folderRenamePolicy(Applies to multiprotocol file systems only.) Specify the rename policy for the file system. Valid values are:
  • forbiddenSMB (default)
  • allowedAll
  • forbiddenAll
-lockingPolicy(Applies to multiprotocol file systems only.) Specify the locking policy for the file system. Valid values are:
  • mandatory (default)
  • advisory
-cifsSyncWritesEnable synchronous write operations for CIFS network shares. Valid values are:
  • yes
  • no (default)
-cifsOpLocksEnable opportunistic file locks (oplocks) for CIFS network shares. Valid values are:
  • yes (default)
  • no
-cifsNotifyOnWriteEnable to receive notifications when users write to a CIFS share. Valid values are:
  • yes
  • no (default)
-cifsNotifyOnAccessEnable to receive notifications when users access a CIFS share. Valid values are:
  • yes
  • no (default)
-cifsNotifyDirDepthIf the value for -cifsNotifyOnWrite or -cifsNotifyOnAccess is yes (enabled), specify the subdirectory depth to which the notifications will apply. Value range is within range 1–512. Default is 512.
-folderRenamePolicySpecify to rename the policy type for the specified file system. Valid values are:
  • allowedAll
  • forbiddenSmb (default)
  • forbiddenAll
-lockingPolicySet the locking policy for this type of file system. Valid values are:
  • advisory
  • mandatory (default)
-fastvpPolicySpecify the FAST VP tiering policy for the file system. This policy defines both the initial tier placement and the ongoing automated tiering of data during data relocation operations. Valid values (case insensitive):
  • startHighThenAuto (default) — Sets the initial data placement to the highest-performing drives with available space, and then relocates portions of the storage resource's data based on I/O activity.
  • auto — Sets the initial data placement to an optimum, system-determined setting, and then relocates portions of the storage resource's data based on the storage resource's performance statistics such that data is relocated among tiers according to I/O activity.
  • highest — Sets the initial data placement and subsequent data relocation (if applicable) to the highest-performing drives with available space.
  • lowest — Sets the initial data placement and subsequent data relocation (if applicable) to the most cost-effective drives with available space.
-schedType the ID of a protection schedule to apply to the storage resource. View protection schedules explains how to view the IDs of the schedules on the system.
-schedPausedSpecify whether to pause the protection schedule specified for -sched. Valid values are:
  • yes
  • no
-replDestSpecifies whether the resource is a replication destination. Valid values are:
  • yes
  • no (default)
-eventProtocolsSpecifies the comma-separated list of file system access protocols enabled for Events Publishing. By default, the list is empty. Valid values are:
  • nfs — Enable Events Publishing for NFS.
  • cifs — Enable Events Publishing for CIFS (SMB).
-flrSpecifies whether File-level Retention (FLR) is enabled and if so, which version of FLR is being used. Valid values are:
  • enterprise — Specify to enable FLR-E.
  • compliance — Specify to enable FLR-C.
  • disabled (default) — Specify to disable FLR.
-flrMinRetSpecify the shortest retention period for which files on an FLR-enabled file system will be locked and protected from deletion. Valid values are:
  • d: days (default is 1 day 1d)
  • m: months
  • y: years
  • infinite
-flrDefRetSpecify the default retention period that is used in an FLR-enabled file system where a file is locked, but a retention period was not specified at the file level.

The format is (<integer> d|m|y) | infinite.

  • d: days
  • m: months
  • y: years — FLR-C (compliance) default is 1 year--1y)
  • infinite — FLR-E (enterprise) default

Any non-infinite values plus the current date must be less than the maximum retention period of 2106-Feb-07.

The value of this parameter must be greater than the minimum retention period -flrMinRet.

-flrMaxRetSpecify the maximum date and time that has been set on any locked file in an FLR-enabled file system. Values are:
  • d: days
  • m: months
  • y: years
  • infinite (default)

The value should be greater than 1 day. Any non-infinite values plus the current date must be less than the maximum retention period of 2106-Feb-07.

The value of this parameter must be greater than the default retention period -flrDefRet.

Example

The following command creates a file system with these settings:

  • Name is FileSystem01.
  • Description is "Multiprotocol file system".
  • Uses the capacity storage pool.
  • Uses NAS server nas_2 as the parent NAS server.
  • Primary storage size is 3 GB.
  • Supports multiprotocol network shares.
  • Has a native access policy.
  • Is a replication destination.

The file system receives the ID res_28:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/prov/fs create -name FileSystem01 -descr "Multiprotocol file system" -server nas_2 -pool capacity -size 3G -type multiprotocol -accessPolicy native -replDest yes
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = res_28
Operation completed successfully.

Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\