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 pools

Create a dynamic or traditional pool.

  • When creating a dynamic pool with NL-SAS drives, RAID 5, 6, and 10 are allowed.
  • 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, and for Unity hybrid models running OE version 5.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.
  • The minimum number of drives to use for a dynamic pool is the selected RAID width plus one drive.

Format

/stor/config/pool create [-async] -name <value> [-type {dynamic [-hotSpareCapacity <value>] | traditional}] [-descr <value>] {-diskGroup <value> -drivesNumber <value> [-storProfile <value>] | -disk <value>} [-tier <value>] [-alertThreshold <value>] [-snapPoolFullThresholdEnabled {yes|no}] [-snapPoolFullHWM <value>] [-snapPoolFullLWM <value>] [-snapSpaceUsedThresholdEnabled {yes|no}] [-snapSpaceUsedHWM <value>] [-snapSpaceUsedLWM <value>]

Action qualifier

QualifierDescription
-asyncRun the operation in asynchronous mode.
NOTE:Simultaneous commands, asynchronous or synchronous, may fail if they conflict in trying to manage the same system elements.
-nameType 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
    • -hotSpareCapacity Specifies the hot spare capacity for every 32 drives of dynamic pools. Valid values are 1 (reserve 1 drive capacity for every 32 drives as a spare) or 2 (reserve 2 drives capacity for every 32 drives as a spare).
    NOTE:The -hotSpareCapacity setting is used for a tier. This means that all disk groups in the same tier share the same -hotSpareCapacity value.
  • traditional

Default value is dynamic.

-descrType 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.
NOTE:When creating a dynamic pool on a hybrid Flash array, you cannot specify HDD system drives. When creating a traditional pool, you can specify HDD system drives.
-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.
-tier (virtual deployments only) Specify the comma-separated list of tiers to which the drives are assigned. If the tier is omitted, it is assigned automatically if tiering information for the associated drive is available. Value is one of the following:
  • capacity
  • performance
  • extreme
-alertThresholdFor 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.
-snapPoolFullThresholdEnabledIndicate 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.
-snapPoolFullHWMSpecify the pool full high watermark for the pool. Valid values are 1-99. Default value is 95.
-snapPoolFullLWMSpecify the pool full low watermark for the pool. Valid values are 0-98. Default value is 85.
-snapSpaceUsedThresholdEnabledIndicate 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.
-snapSpaceUsedHWMSpecify the snapshot space used high watermark to trigger auto-delete on the pool. Valid values are 1-99. Default value is 95.
-snapSpaceUsedLWMSpecify 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.
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! uemcli /stor/config/pool create -name MyPool -descr "dynamic pool" -diskGroup dg_2,dg_28 -drivesNumber 6,10 -storProfile profile_1,profile_2
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.
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool create -name MyPool -descr "traditional pool" -diskGroup dg_3,dg_28 -drivesNumber 5,9 -storProfile tprofile_1,tprofile_2 -type traditional
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.
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool create -name MyPool -descr "my big pool" -storProfile profile_19,profile_20 -diskGroup dg_15,dg_16 -drivesNumber 5,9 -FASTCacheEnabled yes
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 drives, vdisk_0 and vdisk_2 in the Extreme Performance tier. The configured pool receives ID pool_4.

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool create -name vPool -descr "my virtual pool" -disk vdisk_0,vdisk_2
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = pool_4
Operation completed successfully.

Example 5 (physical deployments only)

The following command creates a dynamic pool, using 7 drives from disk group dg_21 with a hot spare capacity of 1 drive; 6 drives from disk group dg_31 with a hot spare capacity of 2 drives; and 7 drives from drive group dg_18 with a hot spare capacity of 2 drives:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool create -name pool -diskGroup dg_21,dg_31,dg_18 -drivesNumber 7,6,7 -type dynamic -hotSpareCapacity 1,2,2
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = pool_1
Operation completed successfully.
NOTE:The -hotSpareCapacity setting is used for a tier. This means that all disk groups in the same tier share the same -hotSpareCapacity value. In this example, drive groups dg_31 and dg_18 belong to the same tier, and share the same -hotSpareCapacity setting of 2.

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: <>()\