• Configuring pools using the CLI

    PDF

    Configuring pools using the CLI

    Configure custom pools

    Pools are the groups of drives on which you create storage resources. Configure pools based on the type of storage resource and usage that will be associated with the pool, such as file system storage optimized for database usage. The storage characteristics differ according to the following:

    • Type of drive used to provide the storage.
    • (dual-SP virtual deployments only) RAID level implemented for the storage.
    Note:  Before you create storage resources, you must configure at least one pool.

    The following table lists the attributes for pools:

    Table 1. Custom pool attributes
    Attribute
    Description
    ID
    ID of the pool.
    Name
    Name of the pool.
    Type
    Pool type. Valid values are:
    • Dynamic
    • Traditional
    Description
    Brief description of the pool.
    Total space
    Total storage capacity of the pool.
    Current allocation
    Amount of storage in the pool allocated to storage resources.
    Preallocated space
    Amount of storage space reserved in the pool by storage resources for future needs to make writes more efficient. The pool may be able to reclaim some of this space if total pool space is running low. This value equals the sum of the sizePreallocated values of each storage resource in the pool.
    Remaining space
    Amount of storage in the pool not allocated to storage resources.
    Subscription
    For thin provisioning, the total storage space subscribed to the pool. All pools support both standard and thin provisioned storage resources. For standard storage resources, the entire requested size is allocated from the pool when the resource is created, for thin provisioned storage resources only incremental portions of the size are allocated based on usage. Because thin provisioned storage resources can subscribe to more storage than is actually allocated to them, pools can be over provisioned to support more storage capacity than they actually possess.
    Note:   The system automatically generates an alert when the total pool usage reaches 85% of the pool's physical capacity. -alertThreshold specifies the alert threshold value.
    Subscription percent
    For thin provisioning, the percentage of the total space in the pool that is subscription storage space.
    Alert threshold
    Threshold for the system to send an alert when hosts have consumed a specific percentage of the subscription space. Value range is 50 to 85.
    Drives
    List of the types of drives on the system, including the number of drives of each type, in the pool. If FAST VP is installed, you can mix different types of drives to make a tiered pool. However, SAS Flash 4 drives must be used in a homogeneous pool.
    Number of drives
    Total number of drives in the pool.
    Number of unused drives
    Number of drives in the pool that are not being used.
    RAID level (physical deployments only)
    RAID level of the drives in the pool.
    Stripe length (physical deployments only)
    Number of drives the data is striped across.
    Rebalancing
    Indicates whether a pool rebalancing is in progress. Valid values are:
    • yes
    • no
    Rebalancing progress
    Indicates the progress of the pool rebalancing as a percentage.
    System defined pool
    Indication of whether the system configured the pool automatically. Valid values are:
    • yes
    • no
    Health state
    Health state of the pool. The health state code appears in parentheses. Valid values are:
    • Unknown (0) - Health is unknown.
    • OK (5) - Operating normally.
    • OK BUT (7) - Pool has exceeded its user-specified threshold or the system specified threshold of 85%.
    • Degraded/Warning (10) - Pool is operating, but degraded due to one or more of the following:
      • Pool has exceeded the user-specified threshold.
      • Pool is nearing capacity.
      • Pool is almost full.
      • Pool performance has degraded.
    • Major failure (20) - Dirty cache has made the pool unavailable.
    • Critical failure (25) - Pool is full. To avoid data loss, add more storage to the pool, or create more pools.
    • Non-recoverable error (30) - Two or more drives in the pool have failed, possibly resulting in data loss.
    Health details
    Additional health information. See Appendix A, Reference, for health information details.
    FAST Cache enabled (physical deployments only)
    Indicates whether FAST Cache is enabled on the pool. Valid values are:
    • yes
    • no
    Non-base size used
    Quantity of storage used for thin clone and snapshot data.
    Auto-delete state
    Indicates the state of an auto-delete operation on the pool. Valid values are:
    • Idle
    • Running
    • Could not reach LWM
    • Could not reach HWM
      Note:   If the auto-delete operation cannot satisfy the high water mark, and there are snapshots in the pool, the auto-delete operation sets the auto-delete state for that watermark to Could not reach HWM , and generates an alert.
    • Failed
    Auto-delete paused
    Indicates whether an auto-delete operation is paused. Valid values are:
    • yes
    • no
    Auto-delete pool full threshold enabled
    Indicates whether the system will check the pool full high water mark for auto-delete. Valid values are:
    • yes
    • no
    Auto-delete pool full high water mark
    The pool full high watermark on the pool.
    Auto-delete pool full low water mark
    The pool full low watermark on the pool.
    Auto-delete snapshot space used threshold enabled
    Indicates whether the system will check the snapshot space used high water mark for auto-delete. Valid values are:
    • yes
    • no
    Auto-delete snapshot space used high water mark
    High watermark for snapshot space used on the pool.
    Auto-delete snapshot space used low water mark
    Low watermark for snapshot space used on the pool.
    Data Reduction space saved (physical deployments only)
    Storage size saved on the pool by using data reduction.
    Note:  Data reduction is available for thin LUNs and 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.
    Data Reduction percent (physical deployments only)
    Storage percentage saved on the pool by using data reduction.
    Note:  Data reduction is available for thin LUNs and 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.
    Data Reduction ratio (physical deployments only)
    Ratio between data without data reduction and data after data reduction savings.
    Note:  Data reduction is available for thin LUNs and 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.
    All flash pool
    Indicates whether the pool contains only Flash drives. Valid values are:
    • yes
    • no

    Create pools

    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
    /stor/config/pool create [-async] -name <value> [-type {dynamic | traditional}] [-descr <value>] {-diskGroup <value> -drivesNumber <value> [-storProfile <value>] | -disk <value>} [-alertThreshold <value>] [-snapPoolFullThresholdEnabled {yes|no}] [-snapPoolFullHWM <value>] [-snapPoolFullLWM <value>] [-snapSpaceUsedThresholdEnabled {yes|no}] [-snapSpaceUsedHWM <value>] [-snapSpaceUsedLWM <value>]
    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.
    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 disks, 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.

    Change pool settings

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

    Format
    /stor/config/pool {-id <value> | -name <value>} set [-async] –name <value> [-descr <value>] [-alertThreshold <value>] [-snapPoolFullThresholdEnabled {yes|no}] [-snapPoolFullHWM <value>] [-snapPoolFullLWM <value>] [-snapSpaceUsedThresholdEnabled {yes|no}] [-snapSpaceUsedHWM <value>] [-snapSpaceUsedLWM <value>] [-snapAutoDeletePaused no]
    Object qualifiers
    Qualifier
    Description
    -id
    Type the ID of the pool to change.
    -name
    Type the name of the pool to change.
    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%:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool -id pool_1 -set -alertThreshold 70 -FASTCacheEnabled no 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = pool_1
Operation completed successfully.

    Add drives to pools

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

    Format
    /stor/config/pool {-id <value> | -name <value>} extend [-async] {-diskGroup <value> -drivesNumber <value> [-storProfile <value>] |-disk <value>}
    Object qualifiers
    Qualifier
    Description
    -id
    Type the ID of the pool to extend.
    -name
    Type the name of the pool to extend.
    Action qualifier
    Qualifier
    Description
    -async
    Run the operation in asynchronous mode.
    -diskGroup (physical deployments only)
    Type the IDs of the drive groups, separated by commas, to add to the pool.
    -drivesNumber (physical deployments only)
    Type the number of drives from the specified drive groups, separated by commas, to add to 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.
    -storProfile (physical deployments only)
    Type the IDs of the storage profiles, separated by commas, to apply to the pool. 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).
    -disk (virtual deployments only)
    Specify the list of drives, separated by commas, to add to the pool. Specified drives must be reliable storage objects that do not require additional protection.
    Example 1 (physical deployments only)

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

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool –id pool_1 extend –diskGroup dg_1 –drivesNumber 7 -storProfile profile_12 
                              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.

    uemcli -d 10.0.0.2 -u Local/joe -p MyPassword456! /stor/config/pool –id pool_1 extend –disk vdisk_1,vdisk_5 
                              Storage system address: 10.0.0.2
Storage system port: 443
HTTPS connection

ID = pool_1
Operation completed successfully.

    View pools

    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
    /stor/config/pool {-id <value> | -name <value>}] show
    Object qualifiers
    Qualifier
    Description
    -id
    Type the ID of a pool.
    -name
    Type the name of a pool.
    Example 1 (physical deployments only)

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

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool show -detail 
                              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.

    uemcli -d 10.0.0.2 -u Local/joe -p MyPassword456! /stor/config/pool show -detail 
                              [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.

    uemcli -d 10.0.0.2 -u Local/joe -p MyPassword456! /stor/config/pool show -detail 
                              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 pools

    Delete a pool.

    Format
    /stor/config/pool {-id <value> | -name <value>} delete [-async]
    Object qualifiers
    Qualifier
    Description
    -id
    Type the ID of the pool to delete.
    -name
    Type the name of the pool to delete.
    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:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool –id pool_1 delete 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.

    Manage pool tiers

    Storage tiers allow users to move data between different types of drives in a pool to maximize storage efficiency. Storage tiers are defined by the following characteristics:

    • Drive performance.
    • Drive capacity.

    The following table lists the attributes for storage profiles:

    Table 2. Storage tier attributes
    Attribute
    Description
    Name
    Storage tier name.
    Drives
    The list of drive types, and the number of drives of each type in the storage tier.
    RAID level (physical deployments only)
    RAID level of the storage tier.
    Stripe length (physical deployments only)
    Comma-separated list of the stripe length of the drives in the storage tier.
    Total space
    Total capacity in the storage tier.
    Current allocation
    Currently allocated space.
    Remaining space
    Remaining space.

    View storage tiers

    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
    /stor/config/pool/tier {-pool <value> | -poolName <value>} show
    Object qualifiers
    Qualifier
    Description
    -pool
    Type the ID of a pool.
    -poolName
    Type the name of a pool.
    Example 1 (physical deployments only)

    The following command shows tier details about the specified pool:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool/tier -pool pool_1 show -detail 
                              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.

    uemcli -d 10.0.0.2 -u Local/joe -p MyPassword456! /stor/config/pool/tier –pool pool_1 show -detail 
                              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

    View pool resources

    This command displays a list of storage resources allocated in a pool. This can be storage resources provisioned on the specified pool and NAS servers that have file systems allocated in the pool.

    The following table lists the attributes for pool resources.

    Table 3. Pool resources
    Attribute
    Description
    ID
    Storage resource identifier.
    Name
    Name of the storage resource.
    Resource type
    Type of the resource. Valid values are:
    • LUN
    • File system
    • LUN group
    • VMware NFS
    • VMware VMFS
    • NAS server
    Pool
    Name of the pool.
    Total pool space used
    Total space in the pool used by a storage resource. This includes primary data used size, snapshot used size, and metadata size. Space in the pool can be freed if snapshots and thin clones for storage resources are deleted, or have expired.
    Total pool space preallocated
    Total space reserved from the pool by the storage resource for future needs to make writes more efficient. The pool may be able to reclaim some of this if space is running low. Additional pool space can be freed if snapshots or thin clones are deleted or expire, and also if Data Reduction is applied.
    Total pool non-base space used
    Total pool space used by snapshots and thin clones.
    Health state
    Health state of the file system. The health state code appears in parentheses.
    Health details
    Additional health information. See Appendix A, Reference, for health information details.
    Format
    /stor/config/pool/sr [{-pool <value> | -poolName <value>}] show
    Object qualifiers
    Qualifier
    Description
    -pool
    Type the ID of the pool.
    -poolName
    Type the name of the pool.
    Example

    The following command shows details for all storage resources associated with the pool pool_1:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool/sr -pool pool_1 show -detail 
                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:       ID                             = res_1
         Name                           = File_System_1
         Resource type                  = File System
         Pool                           = pool_1
         Total pool space used          = 53024473088 (49.3G)
         Total pool preallocated        = 15695003648 (14.6G)
         Total pool snapshot space used = 7179124736 (6.6G)
         Total pool non-base space used = 7179124736 (6.6G)
         Health state                   = OK (5)
         Health details                 = "The component is operating normally. No action is required."

2:       ID                             = sv_1
         Name                           = AF LUN 1
         Resource type                  = LUN
         Pool                           = pool_1
         Total pool space used          = 14448566272 (13.4G)
         Total pool preallocated        = 4610351104 (4.2G)
         Total pool snapshot space used = 4593991680 (4.2G)
         Total pool non-base space used = 4593991680 (4.2G)
         Health state                   = OK (5)
         Health details                 = "The LUN is operating normally. No action is required."

3:       ID                             = res_2
         Name                           = File_System_2
         Resource type                  = File System
         Pool                           = pool_1
         Total pool space used          = 117361025024 (109.3G)
         Total pool preallocated        = 3166494720 (2.9G)
         Total pool snapshot space used = 41022308352 (38.2G)
         Total pool non-base space used = 41022308352 (38.2G)
         Health state                   = OK (5)
         Health details                 = "The component is operating normally. No action is required."

4:      ID                              = sv_2
        Name                            = AF LUN 2
        Resource type                   = LUN
        Pool                            = pool_1
        Total pool space used           = 9500246016 (8.8G)
        Total pool preallocated         = 2579349504 (2.4G)
        Total pool snapshot space used  = 0
        Total pool non-base space used  = 0
        Health state                    = OK (5)
        Health details                  = "The LUN is operating normally. No action is required."

5:      ID                              = res_3
        Name                            = CG1
        Resource type                   = LUN group
        Pool                            = pool_1
        Total pool space used           = 892542287872 (831.2G)
        Total pool preallocated         = 8863973376 (8.2G)
        Total pool snapshot space used  = 231799308288 (215.8G)
        Total pool non-base space used  = 231799308288 (215.8G)
        Health state                    = OK (5)
        Health details                  = "The component is operating normally. No action is required."

    View storage profiles (physical deployments only)

    Storage profiles are preconfigured settings for configuring pools based on the following:

    • Types of storage resources that will use the pools.
    • Intended usage of the pool.

    For example, create a pool for file system storage resources intended for general use. When configuring a pool, specify the ID of the storage profile to apply to the pool.

    Note:  Storage profiles are not restrictive with regard to storage provisioning. For example, you can provision file systems from an FC or iSCSI database pool. However, the characteristics of the storage will be best suited to the indicated storage resource type and use.

    Each storage profile is identified by an ID.

    The following table lists the attributes for storage profiles.

    Table 4. Storage profile attributes
    Attribute
    Description
    ID
    ID of the storage profile.
    Type
    (Available only for systems that support dynamic pools) Type of pool the profile can create. Value is one of the following:
    • Dynamic
    • Traditional
    Description
    Brief description of the storage profile.
    Drive type
    Types of drives for the storage profile.
    RAID level
    RAID level number for the storage profile. Value is one of the following:
    • 1 - RAID level 1.
    • 5 - RAID level 5.
    • 6 - RAID level 6.
    • 10 - RAID level 1+0.
    Maximum capacity
    Maximum storage capacity for the storage profile.
    Stripe length
    Number of drives the data is striped across.
    Note:  For best fit profiles, this value is Best fit .
    Disk group
    List of drive groups recommended for the storage pool configurations of the specified storage profile. This is calculated only when the -configurable option is specified.
    Maximum drives to configure
    List of the maximum number of drives allowed for the specified storage profile in the recommended drive groups. This is calculated only when the -configurable option is specified.
    Maximum capacity to configure
    List of the maximum number of free capacity of the drives available to configure for the storage profile in the recommended drive groups. This is calculated only when the -configurable option is specified.
    Note:   The show action command explains how to change the output format.
    Format
    /stor/config/profile [-id <value> | -driveType <value> [-raidLevel <value>] | -traditional] [-configurable] show
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of a storage profile.
    -driveType
    Specify the type of drive.
    -raidLevel
    Specify the RAID type of the profile.
    -traditional
    (Available only for systems that support dynamic pools) Specify this option to view the profiles that you can use for creating traditional pools. To view the profiles you can use for creating dynamic pools, omit this option.
    -configurable
    Show only profiles that can be configured, that is, those with non-empty drive group information. If specified, calculates the following drive group information for each profile:
    • Disk group
    • Maximum drives to configure
    • Maximum capacity to configure

    If the profile is for a dynamic pool, the calculated information indicates whether the drive group has enough drives for pool creation. The calculation assumes that the pool will be created with the drives in the specified drive group only.

    Example 1

    The following command shows details for storage profiles that can be used to create dynamic pools:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/profile -configurable show 
                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:    ID                            = profile_22
      Type                          = Dynamic
      Description                   = SAS Flash 2 RAID5 (4+1)
      Drive type                    = SAS Flash 2
      RAID level                    = 5
      Maximum capacity              = 4611148087296 (4.1T)
      Stripe length                 = Maximum capacity
      Disk group                    = 
      Maximum drives to configure   = 
      Maximum capacity to configure = 

2:    ID                            = profile_30
      Type                          = Dynamic
      Description                   = SAS Flash 2 RAID10 (1+1)
      Drive type                    = SAS Flash 2
      RAID level                    = 10
      Maximum capacity              = 9749818597376 (8.8T)
      Stripe length                 = 2
      Disk group                    = 
      Maximum drives to configure   = 
      Maximum capacity to configure = 

3:    ID                            = profile_31
      Type                          = Dynamic
      Description                   = SAS Flash 2 RAID10 (2+2)
      Drive type                    = SAS Flash 2
      RAID level                    = 10
      Maximum capacity              = 9749818597376 (8.8T)
      Stripe length                 = 4
      Disk group                    = 
      Maximum drives to configure   = 
      Maximum capacity to configure =
    Example 2

    The following command shows details for storage profiles that can be used to create traditional pools in models that support dynamic pools:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/profile -traditional -configurable show 
                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:    ID                            = tprofile_22
      Type                          = Traditional
      Description                   = SAS Flash 3 RAID5 (4+1)
      Drive type                    = SAS Flash 3
      RAID level                    = 5
      Maximum capacity              = 4611148087296 (4.1T)
      Stripe length                 = Maximum capacity
      Disk group                    = dg_16
      Maximum drives to configure   = 5
      Maximum capacity to configure = 1884243623936 (1.7T)

2:    ID                            = tprofile_30
      Type                          = Traditional
      Description                   = SAS Flash 3 RAID10 (1+1)
      Drive type                    = SAS Flash 3
      RAID level                    = 10
      Maximum capacity              = 9749818597376 (8.8T)
      Stripe length                 = 2
      Disk group                    = dg_13, dg_15
      Maximum drives to configure   = 10, 10
      Maximum capacity to configure = 1247522127872 (1.1T), 2954304921600 (2.6T)

3:    ID                            = tprofile_31
      Type                          = Traditional
      Description                   = SAS Flash 3 RAID10 (2+2)
      Drive type                    = SAS Flsh 3
      RAID level                    = 10
      Maximum capacity              = 9749818597376 (8.8T)
      Stripe length                 = 4
      Disk group                    = dg_13, dg_15
      Maximum drives to configure   = 8, 8
      Maximum capacity to configure = 2363443937280 (2.1T), 952103075840 (886.7G)

    Manage drive groups (physical deployments only)

    Drive groups are the groups of drives on the system with similar characteristics, including type, capacity, and spindle speed. When configuring pools, you select the drove group to use and the number of drives from the group to add to the pool.

    Each drive group is identified by an ID.

    The following table lists the attributes for drive groups.

    Table 5. Drive group attributes
    Attribute
    Description
    ID
    ID of the drive group.
    Drive type
    Type of drives in the drive group.
    FAST Cache
    Indicates whether the drive group's drives can be added to FAST Cache.
    Drive size
    Capacity of one drive in the drive group.
    Rotational speed
    Rotational speed of the drives in the group.
    Number of drives
    Total number of drives in the drive group.
    Unconfigured drives
    Total number of drives in the drive group that are not in a pool.
    Capacity
    Total capacity of all drives in the drive group.
    Recommended number of spares
    Number of spares recommended for the drive group.
    Drives past EOL
    Number of drives past EOL (End of Life) in the group.
    Drives approaching EOL
    Number of drives that will reach EOL in 0-30 days, 0-60 days, 0-90 days and 0-180 days.

    View drive groups

    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
    /stor/config/dg [-id <value>] [-traditional] show
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of a drive group.
    -traditional
    (Available only for systems that support dynamic pools) Specify this qualifier to have the system assume that the pools to be created are traditional pools.
    Example 1

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

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/dg show -detail 
                              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:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/dg -traditional show 
                              [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 recommended drive group configurations

    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
    /stor/config/dg recom {–profile <value>| -pool <value> | -poolName <value>}
    Action qualifier
    Qualifier
    Description
    -profile
    Type the ID of a storage profile. The output will include the list of drive groups recommended for the specified storage profile.
    -pool
    Type the ID of a pool. The output will include the list of drive groups recommended for the specified pool.
    -poolName
    Type the name of a pool. The output will include the list of drive groups recommended for the specified pool.
    Example

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

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/dg recom -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)

    Manage storage system capacity settings

    The following table lists the general storage system capacity attributes:

    Table 6. General storage system capacity attributes
    Attributes
    Description
    Free space
    Specifies the amount of space that is free (available to be used) in all storage pools on the storage system.
    Used space
    Specifies the amount of space that is used in all storage pools on the storage system.
    Preallocated space
    Space reserved across all of the pools on the storage system. This space is reserved for future needs of storage resources, which can make writes more efficient. Each pool may be able to reclaim preallocated space from storage resources if the storage resources are not using the space, and the pool space is running low.
    Total space
    Specifies the total amount of space, both free and used, in all storage pools on the storage system.
    Data Reduction space saved
    Specifies the storage size saved on the entire system when using data reduction.
    Note:  Data reduction is available for thin LUNs and 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.
    Data Reduction percent
    Specifies the storage percentage saved on the entire system when using data reduction.
    Note:  Data reduction is available for thin LUNs and 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.
    Data Reduction ratio
    Specifies the ratio between data without data reduction and data after data reduction savings.
    Note:  Data reduction is available for thin LUNs and 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.

    View system capacity settings

    View the current storage system capacity settings.

    Format
    /stor/general/system show
    Example

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

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/general/system show 
                              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

    Manage system tier capacity settings

    The following table lists the general system tier capacity attributes:

    Table 7. General system tier capacity attributes
    Attributes
    Description
    Name
    Name of the tier. One of the following:
    • Extreme Performance
    • Performance
    • Capacity
    Free space
    Specifies the amount of space that is free (available to be used) in the tier.
    Used space
    Specifies the amount of space that is used in the tier.
    Total space
    Specifies the total amount of space, both free and used, in the tier.

    View system tier capacity

    View the current system tier capacity settings.

    Format
    /stor/general/tier show
    Example

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

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/general/tier show 
                              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)

    Change disk settings (virtual deployments only)

    Change settings of an existing disk.

    Format
    /env/disk -id <value> set [-async] [-name <value>] [-tier <value>]
    Object qualifier
    Qualifier
    Description
    -id
    Disk identifier.
    Action qualifier
    Qualifier
    Description
    -async
    Run the operation in asynchronous mode.
    -name
    Specify the new name for the disk.
    -tier
    Specify the new tier. Valid values are:
    • capacity
    • performance
    • extreme
    Note:  Disks without a tier cannot be used for pool provisioning.
    Example

    The following command changes the name of the virtual disk with the ID "vdisk_1".

    uemcli -d 10.0.0.2 -u Local/joe -p MyPassword456! /env/disk -id vdisk_1 set -name "High-performance storage" 
                          Storage system address: 10.0.0.2
Storage system port: 443
HTTPS connection

Operation completed successfully.

    Pool use cases

    This section describes different CLI use cases for pools.

    Create a pool using drives with specific characteristics

    This example applies to hybrid Flash arrays, which only support traditional pools.

    Retrieve the list of storage profiles
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/profile -configurable show 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:    ID                             = profile_22
      Description                    = SAS RAID5
      Drive type                     = SAS
      RAID level                     = 5
      Maximum capacity               = 4611148087296 (4.1T)
      Stripe length                  = Maximum capacity
      Disk group                     = dg_16
      Maximum drives to configure    = 5
      Maximum capacity to configure  = 1884243623936 (1.7T)

2:    ID                             = profile_30
      Description                    = SAS RAID10 (1+1)
      Drive type                     = SAS
      RAID level                     = 10
      Maximum capacity               = 9749818597376 (8.8T)
      Stripe length                  = 2
      Disk group                     = dg_13, dg_15
      Maximum drives to configure    = 10, 10
      Maximum capacity to configure  = 1247522127872 (1.1T), 2954304921600 (2.6T)

3:    ID                             = profile_31
      Description                    = SAS RAID10 (2+2)
      Drive type                     = SAS
      RAID level                     = 10
      Maximum capacity               = 9749818597376 (8.8T)
      Stripe length                  = 4
      Disk group                     = dg_13, dg_15
      Maximum drives to configure    = 8, 8
      Maximum capacity to configure  = 2363443937280 (2.1T), 952103075840 (886.7G)
    Configure a new pool
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool create -name MyPool -description "My custom pool" -storProfile profile_22 -diskGroup dg_16 -drivesNumber 5 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = GP_4
Operation completed successfully.

    Configure a dynamic pool

    You can configure dynamic pools for all-Flash models of Unity running OE version 4.2.x or later. New pools created for these models are dynamic pools by default. Dynamic pools implement advanced RAID technology. In dynamic pools, a RAID group is spread across drive extents in multiple drives. The required spare space is also spread across drive extents in multiple drives. When a drive fails, the extents on the failed drive are rebuilt to spare space extents within the pool.

    When you configure dynamic pools, you can select different capacity drives from different drive groups with the same Flash drive types to create a tier. The total drive count of the drive type must be at least the stripe width plus one. For example, the total drive count for a RAID 4 + 1 group must be at least 6.

    Step 1: View the list of available drive groups

    View the list of available drive groups, as shown in the following example: 

                              [Request]
Uemcli /stor/config/dg show

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

1:    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             = 12
      Unconfigured drives          = 12
      Capacity                     = 2363663529984 (2.1T)
      Recommended number of spares = 0

2:    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             = 12
      Unconfigured drives          = 6
      Capacity                     = 4726153543680 (4.2T)
      Recommended number of spares = 0
    Step 2: View the list of storage profiles

    View the list of storage profiles, as shown in the following example: 

                              [Request]
Uemcli /stor/config/profile show

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

1:    ID                            = profile_1
      Type                          = Dynamic
      Description                   = SAS Flash 2 RAID5 (4+1)
      Drive type                    = SAS Flash 2
      RAID level                    = 5
      Maximum capacity              = 97373737844736 (88.5T)
      Stripe length                 = 5
      Disk group                    =
      Maximum drives to configure   =
      Maximum capacity to configure =
    Step 3: Configure the dynamic pool

    Configure the dynamic pool with the specified drive groups and profiles. Optionally set -type to dynamic and make sure that the -drivesNumber value for each drive type is not less than the drive group's RAID group width plus one: 

                              uemcli /stor/config/pool create –name mypool -diskGroup dg_2,dg_3 -drivesNumber 4,2 
-storProfile profile_1 -type dynamic
Storage system address: 127.0.0.1
Storage system port: 443
HTTPS connection

ID = pool_13
Operation completed successfully.[Request]

    Configure a traditional pool for an all-Flash model

    You can configure traditional pools for all-Flash models of Unity running OE version 4.2.x by explicitly setting the Type attribute to traditional. If you do not set Type to traditional when you create a pool in the Unisphere CLI, a dynamic pool is created.

    Step 1: View the list of storage profiles

    View the list of storage profiles, as shown in the following example: 

                              [Request]
uemcli /stor/config/profile -traditional -configurable show

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

1:    ID                            = tprofile_2
      Type                          = Traditional
      Description                   = SAS Flash 2 RAID5 (8+1)
      Drive type                    = SAS Flash 2
      RAID level                    = 5
      Maximum capacity              = 95010661072896 (86.4T)
      Stripe length                 = 9
      Disk group                    = dg_34, dg_26
      Maximum drives to configure   = 9, 9
      Maximum capacity to configure = 60189403250688 (54.7T), 2232208064512 (2.0T)

2:    ID                            = tprofile_4
      Type                          = Traditional
      Description                   = SAS Flash 2 RAID5
      Drive type                    = SAS Flash 2
      RAID level                    = 5
      Maximum capacity              = 95010661072896 (86.4T)
      Stripe length                 = Maximum capacity
      Disk group                    = dg_34, dg_26
      Maximum drives to configure   = 9, 10
      Maximum capacity to configure = 60189403250688 (54.7T), 2691354329088 (2.4T)
    Step 2: Configure the traditional pool

    Configure a traditional pool with the specified profile. Make sure you set -type to traditional and that the -drivesNumber is a multiple of the RAID group width. 

                              uemcli /stor/config/pool create -name test -diskGroup dg_34 -drivesNumber 9 
-storProfile tprofile_2 -type traditional

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

ID = pool_6
Operation completed successfully.

    Add drives to an existing pool

    Retrieve the list of existing pools
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /store/config/pool show 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:     ID               = SPL_1
       Name             = Performance
       Description      =
       Free space       = 408944640 (390G)
       Capacity         = 1099511627776 (1T)
       Drives           = 6 x 250GB SAS
       Number of drives = 6
       Unused drives    = 1
       RAID level       = 5
       System pool      = yes 

2:     ID               = SPL_2
       Name             = Capacity
       Description      =
       Free space       = 1319413953331 (1.2T)
       Capacity         = 13194139533312 (12T)
       Drives           = 8 x 2GB NL-SAS
       Number of drives = 8
       Unused drives    = 0
       RAID level       = 6
       System pool      = yes

3:     ID               = SPL_3
       Name             = Extreme Performance
       Description      = 
       Free space       = 209715200 (200M)
       Capacity         = 322122547200 (300G)
       Drive type       = EFD
       Number of drives = 4
       Unused drives    = 0
       RAID level       = 5
       System pool      = yes
    Retrieve the list of recommended disk groups for the selected pool
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/dg recom –pool SPL_3 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:     ID                        = DG_4
       Drive type                = EFD
       Drive size                = 107374182400 (100G)
       Number of drives          = 4
       Allowed numbers of drives = 4
       Capacity                  = 419430400 (400G)
    Extend the existing pool
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool –id SPL_3 extend –diskGroup DG_4 –drivesNumber 4 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = SPL_3
Operation completed successfully.

    The show action command

    The show action command displays a list of objects that exist on the system and the attributes of those objects. You can specify an object qualifier to view the attributes for a single object. The show action command provides qualifiers for changing the display of the output, including the format and the attributes to include. The available output formats are name-value pair (NVP), table, and comma-separated values (CSV).

    Format
    uemcli [<switches>] <object> [<object qualifier>] show [{-detail | -brief | -filter <value>] [-output {nvp | table [-wrap] | csv}]
    Action qualifier
    Qualifier
    Description
    -output|-o
    Specify the output format. Value is one of the following:
    • nvp — The name-value pair (NVP) format displays output as name=value. Name-value pair format provides an example of the NVP format.
    • table — The table format displays output as a table, with column headers and rows. By default, values that are too long to fit in a column are cut off. Add -wrap after the table qualifier, separated by a space, so that the values wrap. Table format provides an example of the table format.
    • csv — The comma-separated values (CSV) format is similar to the table format, but the names and values are separated by commas. Comma-separated values format provides an example of the CSV format.
    -detail
    Display all attributes.
    -brief
    Display only the basic attributes (default).
    -filter
    Comma-separated list of attributes which are included into the command output.
    Name-value pair format 
                          1:     ID                 = la0_SPA
       SP                 = SPA
       Ports              = eth0_SPA,eth1_SPA
       Health state       = OK (5)

2:     ID                 = la0_SPB
       SP                 = SPB
       Ports              = eth0_SPB,eth1_SPB
       Health state       = OK (5)
    Table format 
                          ID      | SP  | Ports             | Health state
--------+-----+-------------------+--------------
la0_SPA | SPA | eth0_SPA,eth1_SPA | OK (5)
la0_SPB | SPB | eth0_SPB,eth1_SPB | OK (5)
    Comma-separated values format 
                          ID,SP,Ports,Health state
la0_SPA,SPA,”eth0_SPA,eth1_SPA”,OK (5)
la0_SPB,SPB,”eth0_SPB,eth1_SPB”,OK (5)
    Example

    The following command modifies the set of attributes in the show action output. For example, if you add -filter "ID,ID,ID,ID" to the command, in the output you will see four lines with the "ID" attribute for each listed instance: 

                          1:  ID = la_0
    ID = la_0
    ID = la_0
    ID = la_0
    uemcli /net/nas/server show -filter “ID, SP, Health state, ID, Name”
    Filter format 
                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:     ID           = nas_1
       SP           = SPA
       Health state = OK (5)
       ID           = nas_1
       Name         = Mynas1

2:     ID           = nas_2
       SP           = SPA
       Health state = OK (5)
       ID           = nas_2
       Name         = Mynas2