Manage Storage

Create a dynamic or traditional pool:

• Both traditional pools and dynamic pools are supported in the CLI and REST API for Unity All-Flash models running OE version 4.2.x or later. The default pool type is dynamic.
• Traditional pools are supported in all Unity hybrid and virtual models. They are also supported in Unity All-Flash models running OE version 4.1.x or earlier.

Format

Action qualifier

Qualifier	Description
-async	Run the operation in asynchronous mode. NOTE:  Simultaneous commands, asynchronous or synchronous, may fail if they conflict in trying to manage the same system elements.
-name	Type a name for the pool.
-type	(Available only for systems that support dynamic pools) Specify the type of pool to create. Value is one of the following: dynamic traditional Default value is dynamic.
-descr	Type a brief description of the pool.
-storProfile (physical deployments only)	Type the ID of the storage profiles, separated by commas, to apply to the pool, based on the type of storage resource that will use the pool and the intended usage of the pool. View storage profiles (physical deployments only) explains how to view the IDs of available storage profiles on the system. If this option is not specified, a default RAID configuration is selected for each particular drive type in the selected drive group: NL-SAS (RAID 6 with a stripe length of 8), SAS (RAID 5 with a stripe length of 5), or Flash (RAID 5 with a stripe length of 5).
-diskGroup (physical deployments only)	Type a comma-separated list of IDs of the drive groups to use in the pool. Specifying drive groups with different drive types causes the creation of a multi-tier pool. View drive groups explains how to view the IDs of the drive groups on the system.
-drivesNumber (physical deployments only)	Specify the drive numbers, separated by commas, from the selected drive groups to use in the pool. If this option is specified when -storProfile is not specified, the operation may fail when the -drivesNumber value does not match the default RAID configuration for each drive type in the selected drive group.
-disk (virtual deployments only)	Specify the list of drive IDs, separated by commas, to use in the pool. Specified drives must be reliable storage objects that do not require additional protection.
-alertThreshold	For thin provisioning, specify the threshold, as a percentage, when the system will alert on the amount of subscription space used. When hosts consume the specified percentage of subscription space, the system sends an alert. Value range is 50% to 85%.
-FASTCacheEnabled (physical deployments only)	Specify whether to enable FAST Cache on the pool. Value is one of the following: yes no Default value is yes.
-snapPoolFullThresholdEnabled	Indicate whether the system should check the pool full high water mark for auto-delete. Value is one of the following: yes no Default value is yes.
-snapPoolFullHWM	Specify the pool full high watermark for the pool. Valid values are 1-99. Default value is 95.
-snapPoolFullLWM	Specify the pool full low watermark for the pool. Valid values are 0-98. Default value is 85.
-snapSpaceUsedThresholdEnabled	Indicate whether the system should check the snapshot space used high water mark for auto-delete. Value is one of the following: yes no Default value is yes.
-snapSpaceUsedHWM	Specify the snapshot space used high watermark to trigger auto-delete on the pool. Valid values are 1-99. Default value is 95.
-snapSpaceUsedLWM	Specify the snapshot space used low watermark to trigger auto-delete on the pool. Valid values are 0-98. Default value is 20.

NOTE:  Use the Change disk settings (virtual deployments only) command to change the assigned tiers for specific drives.

Example 1 (physical deployments only)

The following command creates a dynamic pool. This example uses storage profiles profile_1 and profile_2, six drives from drive group dg_2, and ten drives from drive group dg_28. The configured pool receives ID pool_2.

NOTE:  Before using the stor/config/pool create command, use the /stor/config/profile show command to display the dynamic pool profiles and the /stor/config/dg show command to display the drive groups.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = pool_2
Operation completed successfully.
                        

Example 2 (physical deployments only)

The following command creates a traditional pool in models that support dynamic pools. This example uses storage profiles tprofile_1 and tprofile_2, five drives from drive group dg_3, and nine drives from drive group dg_28. The configured pool receives ID pool_6.

NOTE:  Before using the stor/config/pool create command, use the /stor/config/profile -traditional show command to display the traditional pool profiles (which start with "t") and the /stor/config/dg show command to display the drive groups.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = pool_6
Operation completed successfully.
                        

Example 3 (physical deployments only)

The following command creates a traditional pool in models that do not support dynamic pools. This example uses storage profiles profile_19 and profile_20, five drives from drive group dg_15, and nine drives from drive group dg_16. The configured pool receives ID pool_5.

NOTE:  Before using the stor/config/pool create command, use the /stor/config/profile show command to display the traditional pool profiles and the /stor/config/dg show command to display the drive groups.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = pool_5
Operation completed successfully.
                        

Example 4 (virtual deployments only)

The following command creates a traditional pool with two virtual disks, vdisk_0 and vdisk_2 in the Extreme Performance tier. The configured pool receives ID pool_4.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = pool_4
Operation completed successfully.
                        

Change the subscription alert threshold, FAST Cache, and snapshot threshold settings for a pool.

Format

Object qualifiers

Action qualifier

Qualifier	Description
-async	Run the operation in asynchronous mode. NOTE:  Simultaneous commands, asynchronous or synchronous, may fail if they conflict in trying to manage the same system elements.
-name	Type a name for the pool.
-descr	Type a brief description of the pool.
-alertThreshold	For thin provisioning, specify the threshold, as a percentage, when the system will alert on the amount of subscription space used. When hosts consume the specified percentage of subscription space, the system sends an alert. Value range is 50% to 84%.
-FASTCacheEnabled (physical deployments only)	Specify whether to enable FAST Cache on the pool. Value is one of the following: yes no
-snapPoolFullThresholdEnabled	Indicate whether the system should check the pool full high water mark for auto-delete. Value is one of the following: yes no
-snapPoolFullHWM	Specify the pool full high watermark for the pool. Valid values are 1-99. Default value is 95.
-snapPoolFullLWM	Specify the pool full low watermark for the pool. Valid values are 0-98. Default value is 85.
-snapSpaceUsedThresholdEnabled	Indicate whether the system should check the snapshot space used high water mark for auto-delete. Value is one of the following: yes no
-snapSpaceUsedHWM	Specify the snapshot space used high watermark to trigger auto-delete on the pool. Valid values are 1-99. Default value is 95.
-snapSpaceUsedLWM	Specify the snapshot space used low watermark to trigger auto-delete on the pool. Valid values are 0-98. Default value is 20.
-snapAutoDeletePaused	Specify whether to pause snapshot auto-delete. Typing no resumes the auto-delete operation.

Example

The following command sets the subscription alert threshold for pool pool_1 to 70%:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = pool_1
Operation completed successfully.
                        

Add new drives to a pool to increase its storage capacity.

Format

Object qualifiers

Action qualifier

Example 1 (physical deployments only)

The following command extends pool pool_1 with seven drives from drive group DG_1:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = pool_1
Operation completed successfully.
                        

Example 2 (virtual deployments only)

The following command extends pool pool_1 by adding two virtual disks, vdisk_1 and vdisk_5.

                          Storage system address: 10.0.0.2
Storage system port: 443
HTTPS connection

ID = pool_1
Operation completed successfully.

                        

View a list of pools. You can filter on the pool ID.

NOTE:   The show action command explains how to change the output format.

Format

Object qualifiers

Example 1 (physical deployments only)

The following command shows details about all pools on a hybrid system:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection


 1:     ID                                               = pool_1
       Name                                              = Performance
       Description                                       = Multi-tier pool
       Total space                                       = 8663754342400 (7.8T)
       Current allocation                                = 0
       Preallocated space                                = 38310387712 (35.6G)
       Remaining space                                   = 8663754342400 (7.8T)
       Subscription                                      = 0
       Subscription percent                              = 0%
       Alert threshold                                   = 70%
       Drives                                            = 5 x 600.0G SAS; 5 x 1.6T SAS Flash 3
       Number of drives                                  = 10
       RAID level                                        = 5
       Stripe length                                     = 5
       Rebalancing                                       = no
       Rebalancing progress                              =
       Health state                                      = OK (5)
       Health details                                    = "The component is operating normally. No action is required."
       FAST Cache enabled                                = no
       Protection size used                              = 0
       Non-base size used                                = 0
       Auto-delete state                                 = Idle
       Auto-delete paused                                = no
       Auto-delete pool full threshold enabled           = yes
       Auto-delete pool full high water mark             = 95%
       Auto-delete pool full low water mark              = 85%
       Auto-delete snapshot space used threshold enabled = no
       Auto-delete snapshot space used high water mark   = 25%
       Auto-delete snapshot space used low water mark    = 20%
       Compression space saved                           = 0
       Compression Percent                               = 0%
       Compression Ratio                                 = 1:1
       Data Reduction space saved                        = 0
       Data Reduction percent                            = 0%
       Data Reduction ratio                              = 1:1
       All flash pool                                    = no

2:     ID                                                = pool_2
       Name                                              = Capacity
       Description                                       =
       Total space                                       = 4947802324992 (4.5T)
       Current allocation                                = 3298534883328 (3T)
       Preallocated space                                = 22194823168 (20.6G)
       Remaining space                                   = 4947802324992 (1.5T)
       Subscription                                      = 10995116277760 (10T)
       Subscription percent                              = 222%
       Alert threshold                                   = 70%
       Drives                                            = 12 x 2TB NL-SAS
       Number of drives                                  = 12
       Unused drives                                     = 7
       RAID level                                        = 6
       Stripe length                                     = 6       
       Rebalancing                                       = yes
       Rebalancing progress                              = 46%
       Health state                                      = OK (5)
       Health details                                    = "The component is operating normally. No action is required."
       FAST Cache enabled                                = yes
       Protection size used                              = 10995116238 (10G)
       Non-base size used                                = 10995116238 (10G)
       Auto-delete state                                 = Running
       Auto-delete paused                                = no
       Auto-delete pool full threshold enabled           = yes
       Auto-delete pool full high water mark             = 95%
       Auto-delete pool full low water mark              = 85%
       Auto-delete snapshot space used threshold enabled = yes
       Auto-delete snapshot space used high water mark   = 25%
       Auto-delete snapshot space used low water mark    = 20%
       Compression space saved                           = 4947802324992 (1.5T)
       Compression percent                               = 23%
       Compression ratio                                 = 1.3:1
       Data Reduction space saved                        = 4947802324992 (1.5T)
       Data Reduction percent                            = 23%
       Data Reduction ratio                              = 1.3:1
       All flash pool                                    = no

 3:    ID                                                = pool_3
       Name                                              = Extreme Performance
       Description                                       =
       Total space                                       = 14177955479552 (12.8T)
       Current allocation                                = 0
       Preallocated space                                = 14177955479552 (12.8T)
       Remaining space                                   = 14177955479552 (12.8T)
       Subscription                                      = 0
       Subscription percent                              = 0%
       Alert threshold                                   = 70%
       Drives                                            = 9 x 1.6T SAS Flash 3; 5 x 400.0G SAS Flash 2
       Number of drives                                  = 14
       RAID level                                        = 5
       Stripe length                                     = Mixed
       Rebalancing                                       = no
       Rebalancing progress                              =
       Health state                                      = OK (5)
       Health details                                    = "The component is operating normally. No action is required."
       FAST Cache enabled                                = no
       Protection size used                              = 0
       Non-base size used                                = 0
       Auto-delete state                                 = Idle
       Auto-delete paused                                = no
       Auto-delete pool full threshold enabled           = yes
       Auto-delete pool full high water mark             = 95%
       Auto-delete pool full low water mark              = 85%
       Auto-delete snapshot space used threshold enabled = no
       Auto-delete snapshot space used high water mark   = 25%
       Auto-delete snapshot space used low water mark    = 20%
       Compression space saved                           = 0
       Compression Percent                               = 0%
       Compression Ratio                                 = 1:1
       Data Reduction space saved                        = 0
       Data Reduction percent                            = 0%
       Data Reduction ratio                              = 1:1
       All flash pool                                    = yes
                        

Example 2

The following example shows all pools for a model that supports dynamic pools.

                          [Response]
Storage system address: 10.64.75.201
Storage system port: 443
HTTPS connection
1:    ID                                                = pool_3
      Type                                              = Traditional
      Name                                              = MyPool
      Description                                       = traditional pool
      Total space                                       = 14177955479552 (12.8T)
      Current allocation                                = 0
      Preallocated space                                = 38310387712 (35.6G)
      Remaining space                                   = 14177955479552 (12.8T)
      Subscription                                      = 0
      Subscription percent                              = 0%
      Alert threshold                                   = 70%
      Drives                                            = 9 x 1.6T SAS Flash 3; 5 x 400.0G SAS Flash 2
      Number of drives                                  = 14
      RAID level                                        = 5
      Stripe length                                     = Mixed
      Rebalancing                                       = no
      Rebalancing progress                              =
      Health state                                      = OK (5)
      Health details                                    = "The component is operating normally. No action is required."
      FAST Cache enabled                                = no
      Protection size used                              = 0
      Non-base size used                                = 0
      Auto-delete state                                 = Idle
      Auto-delete paused                                = no
      Auto-delete pool full threshold enabled           = yes
      Auto-delete pool full high water mark             = 95%
      Auto-delete pool full low water mark              = 85%
      Auto-delete snapshot space used threshold enabled = no
      Auto-delete snapshot space used high water mark   = 25%
      Auto-delete snapshot space used low water mark    = 20%
      Compression space saved                           = 0
      Compression Percent                               = 0%
      Compression Ratio                                 = 1:1
      Data Reduction space saved                        = 0
      Data Reduction percent                            = 0%
      Data Reduction ratio                              = 1:1
      All flash pool                                    = yes

2:    ID                                                = pool_4
      Type                                              = Dynamic
      Name                                              = dynamicPool
      Description                                       =
      Total space                                       = 1544309178368 (1.4T)
      Current allocation                                = 0
      Preallocated space                                = 38310387712 (35.6G)
      Remaining space                                   = 1544309178368 (1.4T)
      Subscription                                      = 0
      Subscription percent                              = 0%
      Alert threshold                                   = 70%
      Drives                                            = 6 x 400.0G SAS Flash 2
      Number of drives                                  = 6
      RAID level                                        = 5
      Stripe length                                     = 5
      Rebalancing                                       = no
      Rebalancing progress                              =
      Health state                                      = OK (5)
      Health details                                    = "The component is operating normally. No action is required."
      Protection size used                              = 0
      Non-base size used                                = 0
      Auto-delete state                                 = Idle
      Auto-delete paused                                = no
      Auto-delete pool full threshold enabled           = yes
      Auto-delete pool full high water mark             = 95%
      Auto-delete pool full low water mark              = 85%
      Auto-delete snapshot space used threshold enabled = no
      Auto-delete snapshot space used high water mark   = 25%
      Auto-delete snapshot space used low water mark    = 20%
      Compression space saved                           = 0
      Compression Percent                               = 0%
      Compression Ratio                                 = 1:1
      Data Reduction space saved                        = 0
      Data Reduction percent                            = 0%
      Data Reduction ratio                              = 1:1
      All flash pool                                    = yes
                        

Example 3 (virtual deployments only)

The following command shows details for all pools on a virtual system.

                          Storage system address: 10.0.0.2
Storage system port: 443
HTTPS connection

1:     ID                                                = pool_1
       Name                                              = Capacity
       Description                                       =
       Total space                                       = 4947802324992 (4.5T)
       Current allocation                                = 3298534883328 (3T)
       Preallocated space                                = 38310387712 (35.6G)
       Remaining space                                   = 4947802324992 (1.5T)
       Subscription                                      = 10995116277760 (10T)
       Subscription percent                              = 222%
       Alert threshold                                   = 70%
       Drives                                            = 1 x 120GB Virtual; 1 x 300GB Virtual
       Number of drives                                  = 2
       Health state                                      = OK (5)
       Health details                                    = "The component is operating normally.  No action is required."
       Non-base size used                                = 1099511625 (1G)
       Auto-delete state                                 = Running
       Auto-delete paused                                = no
       Auto-delete pool full threshold enabled           = yes
       Auto-delete pool full high water mark             = 95%
       Auto-delete pool full low water mark              = 85%
       Auto-delete snapshot space used threshold enabled = yes
       Auto-delete snapshot space used high water mark   = 25%
       Auto-delete snapshot space used low water mark    = 20%
                        

Delete a pool.

Format

Object qualifiers

Action qualifier

Qualifier	Description
-async	Run the operation in asynchronous mode. NOTE:  Simultaneous commands, asynchronous or synchronous, may fail if they conflict in trying to manage the same system elements.

Example

The following deletes pool pool_1:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.
                        

View a list of storage tiers. You can filter on the pool ID.

NOTE:   The show action command explains how to change the output format.

Format

Object qualifiers

Example 1 (physical deployments only)

The following command shows tier details about the specified pool:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:    Name                = Extreme Performance
      Drives              = 2 x 200.0G SAS Flash 2; 2 x 800.0G SAS Flash 2
      Drive type          = SAS Flash
      RAID level          = 10
      Stripe length       = 2
      Total space         = 868120264704 (808.5G)
      Current allocation  = 56371445760 (52.5G)
      Remaining space     = 811748818944 (756.0G)

2:    Name                = Performance
      Drives              = 15 x 600.0G SAS
      Drive type          = SAS
      RAID level          = 5
      Stripe length       = 5
      Total space         = 7087501344768 (6.4T)
      Current allocation  = 0
      Remaining space     = 7087501344768 (6.4T)

3:    Name                = Capacity
      Drives              = 8 x 6.0T NL-SAS
      Drive type          = NL-SAS
      RAID level          = 6
      Stripe length       = 8
      Total space         = 35447707271168 (32.2T)
      Current allocation  = 1610612736 (1.5G)
      Remaining space     = 35446096658432 (32.2T)
                        

Example 2 (virtual deployments only)

The following command shows details about pool pool_1 on a virtual system.

                          Storage system address: 10.0.0.2
Storage system port: 443
HTTPS connection

1:    Name                = Extreme Performance
      Drives              =
      Total space         = 0
      Current allocation  = 0 
      Remaining space     = 0


2:    Name                = Performance
      Drives              = 1 x 500GB Virtual
      Total space         = 631242752000 (500.0G)
      Current allocation  = 12624855040 (10.0G)
      Remaining space     = 618617896960 (490.0G)


3:    Name                = Capacity
      Drives              =
      Total space         = 0
      Current allocation  = 0 
      Remaining space     = 0

                        

Change FAST VP general settings.

Format

Action qualifier

Example

The following command changes the data relocation schedule to run on Mondays and Fridays from 23:00 to 07:00:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.
                        

View the FAST VP general settings.

Format

Example

The following command displays the FAST VP general settings:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1: Paused                              = no
   Schedule enabled                    = yes
   Frequency                           = Every Mon, Fri at 22:30 until 8:00
   Rate                                = high
   Data to move up                     = 4947802324992 (1.5T)
   Data to move down                   = 4947802324992 (1.5T)
   Data to move within                 = 4947802324992 (1.5T)
   Estimated scheduled relocation time = 7h 30m
                        

Configure FAST Cache. The storage system generates an error if FAST Cache is already configured.

Format

Action qualifier

Qualifier	Description
-async	Run the operation in asynchronous mode.
-diskGroup	Specify the drive group to include in the FAST Cache. NOTE:  Only SAS Flash 2 drives can be used in the FAST Cache.
-drivesNumber	Specify the number of drives to include in the FAST Cache.
-enableOnExistingPools	Specify whether FAST Cache is enabled on all existing pools. Valid values are: yes no

Example

The following command configures FAST Cache with six drives from drive group dg_2, and enables FAST Cache on existing pools:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.
                        

View the FAST Cache parameters.

Format

Example

The following command displays the FAST Cache parameters for a medium endurance Flash drive:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:     Total space           = 536870912000 (500G)
       Drives                = 6 x 200GB SAS Flash 2
       Number of drives      = 6
       RAID level            = 1
       Health state          = OK (5)
       Health details        = "The component is operating normally.  No action is required."
                        

Extend the FAST Cache by adding more drives.

Format

Action qualifier

Example

The following command adds six drives from drive group "dg_2" to FAST cache.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.
                        

Shrink the FAST Cache by removing storage objects.

Format

Action qualifier

Example

The following command removes Raid Group RG_1 from the FAST Cache.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.

                        

Delete the FAST Cache configuration. The storage system generates an error if FAST Cache is not configured on the system.

Format

Action qualifier

Example

The following command deletes the FAST Cache configuration:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.
                        

View a list of all storage objects, including RAID groups and drives, that are in the FAST Cache.

Format

Object qualifier

Example 1

The following example shows FAST Cache storage objects on the system.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:    ID                  = rg_6
      Type                = RAID group 
      Stripe length       = 2
      RAID level          = 1
      Number of drives    = 2
      Drive type          = SAS Flash 2
      Drives              = dae_0_1_disk_1, dae_0_1_disk_2 
      Total space         = 195400433664 (181.9G)
      Device state        = OK
                        

View details about drive groups on the system. You can filter on the drive group ID.

NOTE:   The show action command explains how to change the output format.

Format

Object qualifier

Example 1

The following command shows details about all drive groups that can be used to configure dynamic pools:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:     ID                           = dg_3
       Drive type                   = SAS Flash 2
       FAST Cache                   = yes
       Drive size                   = 393846128640 (366.7G)
       Vendor size                  = 400.0G
       Rotational speed             = 0 rpm
       Number of drives             = 3
       Unconfigured drives          = 3
       Capacity                     = 1181538385920 (1.1T)
       Recommended number of spares = 0
       Drives past EOL              = 0
       Drives approaching EOL       = 0 (0-30 days), 0 (0-60 days), 0 (0-90 days), 0 (0-180 days)

2:     ID                           = dg_2
       Drive type                   = SAS Flash 2
       FAST Cache                   = yes
       Drive size                   = 196971960832 (183.4G)
       Vendor size                  = 200.0G
       Rotational speed             = 0 rpm
       Number of drives             = 7
       Unconfigured drives          = 7
       Capacity                     = 1378803725824 (1.2T)
       Recommended number of spares = 0
       Drives past EOL              = 0
       Drives approaching EOL       = 1 (0-30 days), 2 (0-60 days), 2 (0-90 days), 3 (0-180 days)
                        

Example 2

The following command shows details about all drive groups that can be used to configure traditional pools in models that support dynamic pools:

                          [Response]
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

[Response]
Storage system address: 10.244.223.141
Storage system port: 443
HTTPS connection

1:     ID                           = dg_8
       Drive type                   = NL-SAS
       FAST Cache                   = no
       Drive size                   = 1969623564288 (1.7T)
       Vendor size                  = 2.0T
       Rotational speed             = 7200 rpm
       Number of drives             = 7
       Unconfigured drives          = 7
       Capacity                     = 13787364950016 (12.5T)
       Recommended number of spares = 1

2:     ID                           = dg_15
       Drive type                   = SAS
       FAST Cache                   = no
       Drive size                   = 590894538752 (550.3G)
       Vendor size                  = 600.0G
       Rotational speed             = 15000 rpm
       Number of drives             = 16
       Unconfigured drives          = 4
       Capacity                     = 9454312620032 (8.5T)
       Recommended number of spares = 1
                        

View the recommended drive groups from which to add drives to a pool based on a specified storage profile or pool type.

NOTE:   The show action command explains how to change the output format.

Format

Action qualifier

Example

The following command shows the recommended drive groups for pool pool_1:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:     ID                        = DG_1
       Drive type                = SAS
       Drive size                = 536870912000 (500GB)
       Number of drives          = 8
       Allowed numbers of drives = 4,8
       Capacity                  = 4398046511104 (4TB)

2:     ID                        = DG_2
       Drive type                = SAS
       Drive size                = 268435456000 (250GB)
       Number of drives          = 4
       Allowed numbers of drives = 4
       Capacity                  = 1099511627776 (1TB)
                        

View the current storage system capacity settings.

Format

Example

The following command displays details about the storage capacity on the system:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:      Free space                       = 4947802324992 (1.5T)
        Used space                       = 4947802324992 (1.5T)
        Total space                      = 9895604649984 (3.0T)
        Preallocated space               = 60505210880 (56.3G)
        Compression space saved          = 4947802324992 (1.5T)
        Compression percent              = 50%
        Compression ratio                = 1
        Data Reduction space saved       = 4947802324992 (1.5T)
        Data Reduction percent           = 50%
        Data Reduction ratio             = 1
                        

View the current system tier capacity settings.

Format

Example

The following command displays details about the storage tier capacity on the system:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:      Name        = Extreme Performance Tier
        Free space  = 4947802324992 (1.5T)
        Used space  = 4947802324992 (1.5T)
        Total space = 9895604649984 (3.0T)

2:      Name        = Capacity Tier
        Free space  = 4947802324992 (1.5T)
        Used space  = 4947802324992 (1.5T)
        Total space = 9895604649984 (3.0T)
                        

Prerequisites

• Configure at least one storage pool for the file system to use and allocate at least one drive to the pool.
• Configure at least one NAS server to which to associate the file system.

Format

Action qualifiers

Qualifier	Description
-async	Run the operation in asynchronous mode.
-name	Type a name for the file system.
-descr	Type a brief description of the file system.
-server	Type 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.
-serverName	Type the name of the NAS server that will be the parent NAS server for the file system.
-pool	Type the ID of the pool to be used for the file system.
-poolName	Type the name of the pool to be used for the file system. This value is case insensitive.
-size	Type the quantity of storage to reserve for the file system.
-thin	Enable thin provisioning on the file system. Valid values are: yes (default) no
-dataReduction	Specify whether data reduction is enabled for the thin file system. Valid values are: yes (default) no NOTE:  Data reduction is available for thin file systems in an All-Flash pool only. The thin file systems must be created on Unity systems running version 4.2.x or later.
-advancedDedup	Specify 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 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.
-type	Specify the type of network shares to export from the file system. Valid values are: 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
-cifsSyncWrites	Enable synchronous write operations for CIFS network shares. Valid values are: yes no (default)
-cifsOpLocks	Enable opportunistic file locks (oplocks) for CIFS network shares. Valid values are: yes (default) no
-cifsNotifyOnWrite	Enable to receive notifications when users write to a CIFS share. Valid values are: yes no (default)
-cifsNotifyOnAccess	Enable to receive notifications when users access a CIFS share. Valid values are: yes no (default)
-cifsNotifyDirDepth	If 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.
-folderRenamePolicy	Specify to rename the policy type for the specified file system. Valid values are: allowedAll forbiddenSmb (default) forbiddenAll
-lockingPolicy	Set the locking policy for this type of file system. Valid values are: advisory mandatory (default)
-fastvpPolicy	Specify 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.
-sched	Type the ID of a protection schedule to apply to the storage resource.
-schedPaused	Specify whether to pause the protection schedule specified for -sched. Valid values are: yes no
-replDest	Specifies whether the resource is a replication destination. Valid values are: yes no (default)
-eventProtocols	Specifies 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).
-flr	Specifies 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.
-flrMinRet	Specify 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
-flrDefRet	Specify 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.
-flrMaxRet	Specify 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:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = res_28
Operation completed successfully.
                        

View details about a file system. You can filter on the file system ID.

NOTE:   The show action command explains how to change the output format.

Format

Object qualifiers

Example

The following command lists details about all file systems on the storage system:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:    ID                              = res_1
      Name                            = fs
      Description                     =
      Health state                    = OK (5)
      Health details                  = "The component is operating normally. No action is required."
      File system                     = fs_1
      Server                          = nas_1
      Storage pool ID                 = pool_1
      Storage pool                    = pool
      Format                          = UFS64
      Protocol                        = nfs
      Access policy                   = unix
      Folder rename policy            = forbiddenSmb
      Locking policy                  = mandatory
      Size                            = 53687091200 (50.0G)
      Size used                       = 1620303872 (1.5G)
      Maximum size                    = 281474976710656 (256.0T)
      Thin provisioning enabled       = yes
      Compression enabled             = no
      Compression space saved         = 0
      Compression percent             = 0%
      Compression ratio               = 1.0:1
      Data Reduction enabled          = no
      Data Reduction space saved      = 0
      Data Reduction percent          = 0%
      Data Reduction ratio            = 1.0:1
      Advanced deduplication enabled  = no
      Current allocation              = 283140096 (270.0M)
      Preallocated                    = 2401214464 (2.2G)
      Total Pool Space Used           = 4041236480 (3.7G)
      Minimum size allocated          =
      Protection size used            = 0
      Snapshot count                  = 0
      Protection schedule             =
      Protection schedule paused      = no
      FLR mode                        = Disabled
      FLR has protected files         =
      FLR clock time                  =
      FLR max retention date          =
      FLR min retention period        =
      FLR default retention period    =
      FLR max retention period        =
      FLR auto lock enabled           =
      FLR auto delete enabled         =
      FLR policy interval             =
      Error threshold                 = 95%
      Warning threshold               = 75%
      Info threshold                  = 10%
      CIFS synchronous write          = no
      CIFS oplocks                    = no
      CIFS notify on write            = no
      CIFS notify on access           = no
      CIFS directory depth            = 512
      Replication type                = none
      Synchronous replication type    = none
      Replication destination         = no
      Migration destination           = no
      FAST VP policy                  = Start high then auto-tier
      FAST VP distribution            =
      Creation time                   = 2018-12-03 10:04:10
      Last modified time              = 2018-12-04 06:49:31
      Pool full policy                = Fail Writes
      Event publishing protocols      =
                        

Change the settings for a file system.

Format

Object qualifiers

Action qualifiers

Qualifier	Description
-async	Run the operation in asynchronous mode.
-descr	Type a brief description of the file system.
-accessPolicy	Specify the access policy for the file system. Valid values are: native unix windows
-folderRenamePolicy	Specify the rename policy for the file system. Valid values are: forbiddenSMB (default) allowedAll forbiddenAll
-lockingPolicy	Specify the locking policy for the file system. Valid values are: mandatory (default) advisory
-size	Type the amount of storage in the pool to reserve for the file system.
-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.
-dataReduction	Enable data reduction on the thin file system. Valid values are: yes no NOTE:  Data reduction is available for thin file systems in an All-Flash pool only. The thin file systems must have been created on Unity systems running version 4.2.x or later.
-advancedDedup	Enable advanced deduplication on 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 in Unity Hybrid 380, 480, 680, and 880 systems
-cifsSyncWrites	Enable synchronous write operations for CIFS (SMB) network shares. Valid values are: yes no
-cifsOpLocks	Enable opportunistic file locks (oplocks) for CIFS network shares. Valid values are: yes no
-cifsNotifyOnWrite	Enable to receive notifications when users write to a CIFS share. Valid values are: yes no
-cifsNotifyOnAccess	Enable to receive notifications when users access a CIFS share. Valid values are: yes no
-cifsNotifyDirDepth	If the value for -cifsNotifyOnWrite or -cifsNotifyOnAccess is yes (enabled), specify the subdirectory depth to which the notifications will apply. Value range is 1–512. Default is 512.
-sched	Type the ID of the schedule to apply to the file system.
-schedPaused	Pause the schedule specified for the -sched qualifier. Valid values are: yes no
-noSched	Unassigns the protection schedule.
-fastvpPolicy	Specify 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.
-replDest	Specifies whether the resource is a replication destination. Valid values are: yes no
-poolFullPolicy	Specifies the policy to follow when the pool is full and a write to the file system is tried. This attribute enables you to preserve snapshots on the file system when a pool is full. Valid values are: deleteAllSnaps—Delete snapshots that are associated with the file system when the pool reaches full capacity. failWrites—Fail write operations to the file system when the pool reaches full capacity.
-eventProtocols	Specifies a 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).
-flrMinRet	Specify 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
-flrDefRet	Specify 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.
-flrMaxRet	Specify 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.
-flrAutoLock	Specify whether automatic file locking is enabled for all new files in an FLR-enabled file system. Valid values are: yes no
-flrAutoDelete	Specify whether locked files in an FLR-enabled file system will automatically be deleted once the retention period expires. Valid values are: yes no
-flrPolicyInterval	If -flrAutoLock is set to yes, specify a time interval for how long after files are modified they will be automatically locked in an FLR-enabled file system. The format is <value> <qualifier>, where value is an integer and the qualifier is: m--minutes h--hours d--days The value should be greater than 1 minute and less than 366 days.
-errorThreshold	Specify the threshold percentage that, when exceeded, error alert messages will be generated. The range is from 0 to 99, and the default value is 95%. If the threshold value is set to 0, this alert is disabled. This option must be set to a value greater than the -warningThreshold.
-warningThreshold	Specify the threshold percentage that, when exceeded, warning alert messages will be generated. The range is from 0 to 99, and the default value is 75%. If the threshold value is set to 0, this alert is disabled. This option must be set to a value less than the -errorThreshold value, and greater than or equal to the -infoThreshold value.
-infoThreshold	Specify the threshold percentage that, when exceeded, informational alert messages will be generated. The range is from 0 to 99, and the default value is 0 (disabled). This option must be set to a value less than the -warningThreshold value.

Example

The following command specifies Events Publishing protocols:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = res_1
Operation completed successfully.
                        

Delete a file system.

NOTE:  Deleting a file system removes all network shares, and optionally snapshots associated with the file system from the system. After the file system is deleted, the files and folders inside it cannot be restored from snapshots. Back up the data from a file system before deleting it from the storage system.

NOTE:  You cannot delete an FLR-C enabled file system that has currently locked and protected files. An FLR-E file system can be deleted, even if it does contain protected files.

Format

Object qualifiers

Action qualifiers

Example

The following command deletes file system FS_1:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.
                        

You can create user quotas on a file system or quota tree:

• Create a user quota on a file system to limit or track the amount of storage space that an individual user consumes on that file system. When you create or modify a user quota on a file system, you have the option to use default hard and soft limits that are set at the file-system level.
• Create a user quota on a quota tree to limit or track the amount of storage space that an individual user consumes on that tree. When you create a user quota on a quota tree, you have the option to use the default hard and soft limits that are set at the quota-tree level.

Format

Action qualifiers

Qualifier	Description
-async	Run the operation in asynchronous mode.
-fs	Specify the ID of the file system that the quota will act upon. The file system cannot be read-only or a replication destination.
-fsName	Specify the name of the file system that the quota will act upon. The file system cannot be read-only or a replication destination.
-path	Specify either of the following: If the user quota is for a file system, either do not use this qualifier, or set its value to /. If the user quota is for a quota tree, specify the quota tree path relative to the root of the file system.
-userId	Specify the user ID on the file system or quota tree.
-unixName	Specify the UNIX user name associated with the specified user ID.
-winName	Specify the Windows user name associated with the specified user ID. The format is: [<domain>\]<name>
-default	Inherit the default quota limit settings for the user. To view the default limits, use the following command: /quota/config -fs <value> -path <value> show If a soft limit or hard limit has not been specified for the user, the default limit is applied.
-softLimit	Specify the preferred limit on storage usage by the user. A value of 0 means no limitation. If the hard limit is specified and the soft limit is not specified, there will be no soft limitation.
-hardLimit	Specify the absolute limit on storage usage by the user. A value of 0 means no limitation. If the soft limit is specified and the hard limit is not specified, there will be no hard limitation. NOTE:  The hard limit should be larger than the soft limit.

Example

The following command creates a user quota for user 201 on file system res_1, quota tree /qtree_1. The new user quota has the following limits:

• Soft limit is 20 GB.
• Hard limit is 50 GB.

                          Storage system address: 10.64.75.201
Storage system port: 443
HTTPS connection

Operation completed successfully.
                        

You can display space usage and limit information for user quotas on a file system or quota tree.

Because there can be a large amount of user quotas on a file system or quota tree, to reduce the impact on system performance, the system only updates user quota data every 24 hours. You can use the refresh action to update the data more often. Use the /quota/config show command to see the time spent for the data refresh.

NOTE:  The Unix name and Windows name values are returned only when displaying a single user quota.

NOTE:   The show action command explains how to change the output format.

Format

Object qualifiers

Example

The following command displays space usage information for user nasadmin on file system res_1, quota tree /qtree_1:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:    User ID             = 201
      Unix name           = nasadmin
      Windows names       = dell asadmin, dell asad
      Windows SIDs        = S-1-5-32-544, S-1-5-32-545      
      Space used          = 32768 (32K)
      Soft limit          = 16384 (16K)
      Hard limit          = 65536 (64K)
      Grace period left   = 7d 3h
      State               = Soft limit exceeded
                        

You can change limits for user quotas on a file system or quota tree.

Format

Object qualifiers

Action qualifiers

Qualifier	Description
-async	Run the operation in asynchronous mode.
-default	Inherit the default quota limit settings for the user. To view the default limit, use the command: config -fs <value> -path <value> show If a soft or hard limit has not been specified for the user, the default limit is applied.
-softLimit	Specify the preferred limit on storage usage by the user. A value of 0 means no limitation. If the hard limit is specified and the soft limit is not specified, there will be no soft limitation.
-hardLimit	Specify the absolute limit on storage usage by the user. A value of 0 means no limitation. If the soft limit is specified and the hard limit is not specified, there will be no hard limitation. NOTE:  The hard limit should be larger than the soft limit.

Example

The following command makes the following changes to the user quota for user 201 on file system res_1, quota tree path /qtree_1:

• Sets the soft limit to 10 GB.
• Sets the hard limit to 20 GB.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.
                        

Because there can be a large amount of user quotas on a file system or quota tree, to reduce the impact on system performance, the system only updates user quota data every 24 hours. Use the refresh action to update the data more often. Use the /quota/config show command to view the time spent for the data refresh.

Format

Object qualifiers

Qualifier	Description
-fs	Specify the ID of the file system.
-fsName	Specify the name of the file system.
-path	Specify either of the following: If the user quota is on a file system, either do not use this qualifier, or set its value to /. If the user quota is on a quota tree, specify the quota tree path relative to the root of the file system.
-updateNames	Refresh the usage data of user quotas and the Windows user names, Windows SIDs, and Unix user names within a file system or quota tree. NOTE:   Refreshing user names causes latency because the system needs to query the name servers, so use this qualifier sparingly. The system automatically updates Windows user names, Windows SIDs, and Unix user names for user quotas every 24 hours.

Action qualifier

Example

The following command refreshes all user quotas on file system res_1, quota tree tree_1:

                          [Response]
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.
                        

Create a quota tree to track or limit the amount of storage consumed on a directory. You can use quota trees to:

• Set storage limits on a project basis. For example, you can establish quota trees for a project directory that has multiple users sharing and creating files in it.
• Track directory usage by setting the quota tree's hard and soft limits to 0 (zero).

Format

Action qualifiers

Qualifier	Description
-async	Run the operation in asynchronous mode.
-fs	Specify the ID of the file system in which the quota tree will reside. The file system cannot be read-only or a replication destination.
-fsName	Specify the name of the file system in which the quota tree will reside. The file system cannot be read-only or a replication destination
-path	Specify the quota tree path relative to the root of the file system.
-descr	Specify the quota tree description.
-default	Specify to inherit the default quota limit settings for the tree. Use the View quota trees command to view these default limits.
-softLimit	Specify the preferred limit for storage space consumed on the quota tree. A value of 0 means no limitation. If the hard limit is specified and soft limit is not specified, there will be no soft limitation.
-hardLimit	Specify the absolute limit for storage space consumed on the quota tree. A value of 0 means no limitation. If the soft limit is specified and the hard limit is not specified, there will be no hard limitation. NOTE:  The hard limit should be larger than the soft limit.

Example

The following command creates quota tree /qtree_1 on file system res_1. The new quota tree has the following characteristics:

• Soft limit is 100 GB.
• Hard limit is 200 GB.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.

                        

You can display space usage and limit information for all quota trees on a file system or a single quota tree.

Because there can be a large amount of quota trees on a file system, to reduce the impact on system performance, the system only updates quota data every 24 hours. You can use the refresh action to update the data more often. Use the /quota/config show command to view the time spent for the data refresh.

NOTE:   The show action command explains how to change the output format.

Format

Object qualifiers

Example

The following command displays space usage information for all quota trees on file system res_1:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:    Path                = /qtree_1
      Description         = this is tree 1
      Space used          = 32768 (32K)
      Soft limit          = 53687091200 (50G)
      Hard limit          = 107374182400 (100G)
      Grace period left   = 7d
      State               = OK

2:    Path                = /qtree_2
      Description         =
      Space used          = 32768 (32K)
      Soft limit          = 16384 (16K)
      Hard limit          = 65536 (64K)
      Grace period left   = 7d
      State               = Soft limit exceeded

                        

You can specify that a specific quota tree inherit the associated file system's default quota limit settings, or you can manually set soft and hard limits on the quota tree.

Format

Object qualifiers

Action qualifiers

Qualifier	Description
-async	Run the operation in asynchronous mode.
-descr	Quota tree description.
-default	Inherit the default quota limit settings from the associated file system. To view the default limits, use the following command: /quota/config -fs <value> -path <value> show
-softLimit	Specify the preferred limit for storage space consumed on the quota tree. A value of 0 means no limitation.
-hardLimit	Specify the absolute limit for storage space consumed on the quota tree. A value of 0 means no limitation. NOTE:  The hard limit should be equal to or larger than the soft limit.

Example

The following command makes the following changes to quota tree /qtree_1 in file system res_1:

• Sets the soft limit is 50 GB.
• Sets the hard limit is to 100 GB.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.
                        

Because there can be a large amount of quota trees on a file system, to reduce the impact on system performance, the system only updates quota data every 24 hours. You can use the refresh action to update the data more often. To view the updating time of the data refresh, see the output field Tree quota update time for the /quota/config show command.

Format

Object qualifier

Action qualifier

Example

The following command refreshes quota information for all quota trees on file system res_1:

                          [Response]
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.

                        

You can delete all quota trees on a file system or a specified quota tree.

Format

Object qualifier

Action qualifier

Example

The following command deletes quota tree /qtree_1 on file system res_1:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.
                        

You can configure quota configuration settings for a file system or quota tree.

Format

Object qualifiers

Action qualifiers

Qualifier	Description
-async	Run the operation in asynchronous mode.
-userQuota	Indicates whether to enforce user quotas on the file system or quota tree. Valid values are: on - Enable the enforcement of user quotas on the file system or quota tree. off - Disable the enforcement of user quotas on the file system or quota tree. When you disable user quotas, the current user quota settings still exist unless you clear them. These settings are automatically reapplied when user quotas are re-enabled. clear - Clear user quota settings after disabling a user quota. Because enabling and disabling the enforcement of user quotas impacts system performance, it is recommended that you perform these operations only during non-peak production hours. When user quota enforcement is enabled, you can change user quota settings without impacting performance.
-policy	Specify the quota policy for the file system. Valid values are: blocks (Blocks policy) - Calculates space usage in terms of file system blocks (8 KB units), and includes drive usage by directories and symbolic links in the calculations. filesize (File policy) - Calculates space usage in terms of logical file sizes, and ignores the size of directories and symbolic links. For more information, see Configure quota settings
-gracePeriod	Specify the time period for which the system counts down days once the soft limit is met. If the grace period expires for a quota tree, users cannot write to the quota tree until more space becomes available, even if the hard limit has not been crossed. If the grace period expires for a user quota on a file system or quota tree, the individual user cannot write to the file system or quota tree until more space becomes available for that user. The default grace period is 7 days. The format is: <value><qualifier> where: value - An integer value, depending on the associated qualifier: If the qualifier is m (minutes), the valid range is from 1 to 525600. If the qualifier is h (hours), the valid range is from 1 to 8760. If the qualifier is d (days), the valid range is from 1 to 365. qualifier - One of the following value qualifiers (case insensitive): m - Minutes h - Hours d - Days NOTE:  If you update a grace period value, the new value affects only the quota or quotas which will exceed the soft limit after the update is performed. Any existing quotas which have been counting down using the older grace period value will not be affected.
-defaultSoft	Specifies the default preferred limit on storage usage for user quotas on the file system, quota trees in the file system, and user quotas on the quota trees in the file system. The system issues a warning when the soft limit is reached.
-defaultHard	Specify the default hard limit for on storage usage for user quotas on the file system, quota trees in the file system, and user quotas on the file system's quota trees. If the hard limit is reached for a quota tree, users will not be able to write data to the file system or tree until more space becomes available. If the hard limit is reached for a user quota on a file system or quota tree, that particular user will not be able to write data to the file system or tree. NOTE:  The hard limit should be larger than the soft limit.
-denyAccess	Indicates whether to enable quota limits for the file system. Valid values are: yes - Enable quota functionality for the file system. When you choose this option, the ability to allocate space is determined by the quota settings. no - Disable quota functionality for the file system. When you choose this option, the ability to allocate space will not be denied when a quota limit is reached.

Example

The following command configures quota tree /qtree_1 in file system res_1 as follows:

• Sets the default grace period to 5 days.
• Sets the default soft limit 10 GB.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.
                        

You can display the quota configuration settings for a file system, a specific quota tree, or a file system and all of its quota trees.

Format

Object qualifiers

Example

The following command lists configuration information for quota tree /quota/config on file system res_1:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:    Path                     = /
      Quota policy             = blocks
      User quota               = on
      Deny access              = yes
      Grace period             = 7d
      User soft limit          = 53687091200 (50G)
      User hard limit          = 107374182400 (100G)
      Tree quota update time   = 2014-10-31 13:17:28
      User quota update time   = 2014-10-31 13:20:22

2:    Path                     = /qtree_1
      Quota policy             = blocks
      User quota               = on
      Deny access              = yes
      Grace period             = 7d
      User soft limit          = 1073741824 (1G)
      User hard limit          = 10737418240 (10G)
      Tree quota update time   =
      User quota update time   =


                        

Create an NFS share to export a file system through the NFS protocol.

NOTE:  Share access permissions set for specific hosts take effect only if the host-specific setting is less restrictive than the default access setting for the share. Additionally, setting access for a specific host to “No Access” always takes effect over the default access setting.

• Example 1: If the default access setting for a share is Read-Only, setting the access for a specific host configuration to Read/Write will result in an effective host access of Read/Write.
• Example 2: If the default access setting for the share is Read-Only, setting the access permission for a particular host configuration to No Access will take effect and prevent that host from accessing to the share.
• Example 3: If the default access setting for a share is Read-Write, setting the access permission for a particular host configuration to Read-Only will result in an effective host access of Read/Write.

Prerequisite

Configure a file system to which to associate the NFS network shares. Create file systems explains how to create file systems on the system.

Format

Action qualifiers

Example 1

The following command shows output for when the path is not found because the path does not start with "/", and the shares are not created successfully.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation failed. Error code: 0x900a002
The system could not find the specified path. Please use an existing path. (Error Code:0x900a002)
Job ID = N-1339
                        

Example 2

The following command shows output for when the path is correctly specified and the shares are successfully created. The new NFS share has the following settings:

• NFS share name of "testnfs112"
• Parent file system of "res_26"
• On the directory "/mypath"

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = NFSShare_20
Operation completed successfully.
                        

View details of an NFS share. You can filter on the NFS share ID or view the NFS network shares associated with a file system ID.

Format

Object qualifiers

Example

The following command lists details for all NFS network shares on the system:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:     ID                    = NFSShare_1
       Name                  = MyNFSshare1
       Description           = My nfs share
       File system           = res_26
       Local path            = /mypath
       Export path           = SATURN.domain.emc.com:/MyNFSshare1
       Default access        = na
       Advanced host mgmt.   = yes
       Read-only hosts       = 1014, 1015
       Read/write hosts      = 1016
       Read-only root hosts  =
       Root hosts            =
       No access hosts       =
       Creation time         = 2012-08-24 12:18:22
       Last modified time    = 2012-08-24 12:18:22
       Role                  = production
       Minimum security      = krb5
       Allow SUID            = yes
       Anonymous UID         = 4294967294
       Anonymous GID         = 4294967294
                        

Change the settings of an NFS share.

Format

Object qualifiers

Action qualifiers

Example

The following command changes NFS share NFSShare_1 to block access to the share and its snapshots for host HOST_1:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = NFSShare_1
Operation completed successfully.
                        

Delete an NFS share.

Format

Object qualifiers

Action qualifier

Example

The following command deletes NFS share NFSShare_1:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.
                        

Create a CIFS (SMB) share to export a file system through the CIFS protocol.

Prerequisite

Configure a file system to which to associate the CIFS network shares. Create file systems explains how to create file systems on the system.

Format

Action qualifiers

Qualifier	Description
-async	Run the operation in asynchronous mode.
-name	Type a name for the share. NOTE:  This value, along with the name of the NAS server, constitutes the export path by which hosts access the share.
-descr	Type a brief description of the share.
-fs	Type the ID of the parent file system associated with the CIFS share.
-fsName	Type the name of the parent file system associated with the CIFS share.
-path	Type the path to the directory within the file system that will be shared. This path must correspond to an existing directory/folder name within the share that was created from the host-side. The default path is the root of the file system. Local paths must point to an existing directory within the file system. The same path on a file system can be shared an unlimited number of times, but each share name must be unique. The initial share will be created on the file system root directory. Before you can create additional network shares or subdirectories within an NFS file system, you must create network shares or subdirectories within it from a Windows host that is connected to the file system. After a share has been created from a mounted host, you can create a corresponding share on the system and set access permissions accordingly.
-enableContinuousAvailability	Specify whether continuous availability is enabled.
-enableCIFSEncryption	Specify whether CIFS encryption is enabled.
-umask	Type the default Unix umask for new files created on the share.
-enableABE	Specify if Access-based Enumeration (ABE) is enabled. Valid values include: yes no (default)
-enableBranchCache	Specify if BranchCache is enabled. Valid values include: yes no (default)
-offlineAvailability	Specify the type of offline availability. Valid values include: none (default) — Prevents clients from storing documents and programs in offline cache. documents — Allows all files that clients open to be available offline. programs — Allows all programs and files that clients open to be available offline. Programs and files will open from offline cache, even when connected to the network. manual — Allows only specified files to be available offline.

Example

The following command creates a CIFS share with these settings:

• Name is CIFSshare.
• Description is “My share.”
• Associated to file system res_1.
• Local path on the file system is directory "/cifsshare".
• Continuous availability is enabled.
• CIFS encryption is enabled.

The share receives ID CIFSShare_1:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = CIFS_1
Operation completed successfully.
                        

View details of a CIFS (SMB) share. You can filter on the CIFS share ID or view the CIFS network shares associated with a file system ID.

NOTE:   The show action command explains how to change the output format.

Format

Object qualifiers

Example

The following command lists details for all CIFS network shares on the system:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:     ID           = SMBShare_1
       Name         = fsmup
       Description  =
       File system  = res_1
       Local path   = /
       Export path  = \\sys-123.abc.xyz123.test.lab.emc.com\fsmup, \\10.0.0.0\fsmup

2:     ID           = SMBShare_2
       Name         = fsmup
       Description  =
       File system  = res_5
       Local path   = /
       Export path  = \\sys-123.abc.xyz123.test.lab.emc.com\fsmup, \\10.0.0.0\fsmup
                        

Change the settings of an CIFS (SMB) share.

Format

Object qualifiers

Action qualifier

Example

The following command sets the description of CIFS share SMBShare_1 to My share.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = SMBShare_1
Operation completed successfully.
                        

Delete a CIFS (SMB) share.

Format

Object qualifiers

Action qualifier

Example

The following command deletes CIFS share CIFSShare_1:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.