• Configuring pools using the CLI

    PDF

    Configuring pools using the CLI

    Configure pools automatically

    Pools are the groups of physical or virtual disks, called disk groups, on which you create storage resources. The system can automatically configure pools by selecting the appropriate disk groups based on the type and availability of disks in the system.

    In order to automatically create pools, the following criteria must be met:

    • A FAST VP/FAST Cache license is not installed
    • No other pools have been created
    • For virtual deployments, all virtual disks have been assigned a tier type
    Configure custom pools explains how to configure custom pools. Before you create storage resources (including NAS servers), you must configure at least one pool.

    The following table lists the attributes for automatic pool configuration.

    Table 1. Automatic pool configuration attributes
    Attribute
    Description
    Target
    Type of disk configuration. Value is one of the following:
    • pool - Disks configured in a pool.
    • spares - Disks assigned to pools as spares. The number of spares assigned to a pool is dependent on the disk type and pool type:
      • For Capacity pools, no spare disks are assigned.
      • For Performance pools, a spare disk is assigned for the first 0-30 disks, and then another spare disk is assigned for every group of thirty disks after that.
      • For Flash pools, a spare disk is assigned for the first 0-30 disks, and then another spare disk is assigned for every group of thirty disks after that.
    Name
    Name of the pool. The system allocates disks to one or more of the following pools based on the types and characteristics of the disks on the system:
    • Capacity - Storage allocated from near-line (NL) serial attached SCSI (SAS) disks. Provides high-capacity storage, but with lower overall performance to regular SAS and Enterprise Flash Drive (EFD) disks. Use NL SAS disks to provide extremely economical storage for operations, such as data backup, that do not require high I/O performance.
    • Performance - Storage allocated from serial attached SCSI (SAS) disks. Provides medium performance and medium capacity storage for applications that require balance of performance and capacity.
    • Flash - Storage allocated from Flash disks. Extremely high level performance, but at a relatively high cost per GB of storage. Flash disks are most applicable to applications that require high I/O performance and energy efficiency.
    Depending on the pool type, the system configures the disks into different RAID groups and assigns disks to pools as spares. The Unisphere online help provides more details about pools and spares.
    Drives (current)
    List of disks currently in the pool.
    Drives (new)
    List of disks to be added to the pool.
    RAID level (physical deployments only)
    RAID level applied.
    Stripe length (physical deployments only)
    Comma-separated list of disks in the stripe.

    Initiate automatic pool configuration

    Start configuring pools automatically. View configuration settings for automatic pool creation displays the configuration settings that the system will apply when you run this command.

    Format
    /stor/config/auto set
    Action qualifier
    Qualifier
    Description
    -async
    Run action in asynchronous mode.
    Example

    The following command initiates automatic pool configuration:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/auto set
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
                            

    View configuration settings for automatic pool creation

    View the settings for automatic pool creation that will be applied to the system. Initiate automatic pool configuration explains how to apply these settings to the system.

    The show action command explains how to change the output format.
    Format
    /stor/config/auto show
    Example (physical deployments only)

    The following command shows how pools and spares will be configured automatically on the system:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/auto show
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:     Target                   = Pool
           Name                     = ExtremePerformancePool
           Drives (current)         =
           Drives (new)             = 5 x 800.0G SAS Flash 2
           RAID Level               = 5
           Stripe Length            = 5
    
    2:     Target                   = Pool
           Name                     = PerformancePool
           Drives (current)         =
           Drives (new)             = 19 x 600.0G SAS
           RAID Level               = 5
           Stripe Length            = 5,9
    
    3:     Target                   = Pool
           Name                     = CapacityPool
           Drives (current)         =
           Drives (new)             = 8 x 6.0T NL-SAS
           RAID Level               = 6
           Stripe Length            = 8
    
    4:     Target                   = Spares
           Name                     = Unused / Hot Spare Candidates
           Drives (current)         =
           Drives (new)             = 1 x 600.0G SAS; 2 x 6.0T NL-SAS; 1 x 800.0G SAS Flash 2
           RAID Level               = N/A
           Stripe Length            = N/A
                            

    Configure custom pools

    Pools are the groups of disks 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 disk used to provide the storage.
    • (Physical deployments only) RAID level implemented for the storage.
    Before you create storage resources, you must configure at least one pool.

    Configure pools automatically explains how to have the system configure pools automatically.

    The following table lists the attributes for pools:

    Table 2. Custom pool attributes
    Attribute
    Description
    ID
    ID of the pool.
    Name
    Name of the pool.
    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.
    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.
    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 disks on the system, including the number of disks of each type, in the pool. If FAST VP is installed, you can mix different types of disks to make a tiered pool. However, SAS Flash 3 disks must be used in a homogeneous pool.
    Number of drives
    Total number of disks in the pool.
    Number of unused drives
    Number of disks in the pool that are not being used.
    RAID level (physical deployments only)
    RAID level of the disks in the pool.
    Stripe length (physical deployments only)
    Number of disks 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 disks 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
    Protection size used
    Quantity of storage used for data protection.
    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
      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.

    Configure pools

    Configure a pool.

    Format
    /stor/config/pool create [-async] –name <value> [-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.
    -name
    Type a name for the pool.
    -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 disk 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 disk groups to use in the pool. Specifying disk groups with different disks types causes the creation of a multi-tier pool. View disk groups explains how to view the IDs of the disk groups on the system.
    -drivesNumber (physical deployments only)
    Specify the disk numbers, separated by commas, from the selected disk 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 disk group.
    -disk (virtual deployments only)
    Specify the list of disk IDs, separated by commas, to use in the pool. Specified disks 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.
    Use the Change disk settings (virtual deployments only) command to change the assigned tiers for specific disks.
    Example 1 (physical deployments only)

    The following command creates a pool that uses storage profiles SP_1and SP_2, and seven disks from disk group DG_1 and five disks from disk group DG_2. The configured pool receives ID pool_4:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool create -name GlobalPool1 –descr “Oracle databases” –storProfile SP_1,SP_2 –diskGroup DG_1,DG_2 –drivesNumber 7,5
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    ID = pool_4
    Operation completed successfully.
                            
    Example 2 (virtual deployments only)

    The following command creates a pool with two virtual disks, vdisk_0 and vdisk_2 in the extreme 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.
    
                            

    View pools

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

    The show action command explains how to change the output format.
    Format
    /stor/config/pool [–id <value>] show
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of a pool.
    Example 1 (physical deployments only)

    The following command shows details about all pools on the 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                                              = TestPool
       Description                                       =
       Total space                                       = 6266625720320 (5.6T)
       Current allocation                                = 2684354560 (2.5G)
       Remaining space                                   = 6263941365760 (5.6T)
       Subscription                                      = 111967084544 (104.2G)
       Subscription percent                              = 1%
       Alert threshold                                   = 70%
       Drives                                            = 4 x 3.1T SAS Flash 3
       Number of drives                                  = 4
       RAID level                                        = 10
       Stripe length                                     = 2
       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                              = 32768 (32.0K)
       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%
    
    2: ID                                                = pool_2
       Name                                              = Test1
       Description                                       =
       Total space                                       = 43403328880640 (39.4T)
       Current allocation                                = 57982058496 (54.0G)
       Remaining space                                   = 43345346822144 (39.4T)
       Subscription                                      = 1627792605184 (1.4T)
       Subscription percent                              = 3%
       Alert threshold                                   = 70%
       Drives                                            = 15 x 600.0G SAS; 2 x 200.0G SAS Flash 2; 8 x 6.0T NL-SAS; 2 x 800.0G                                                        SAS Flash 2
       Number of drives                                  = 27
       RAID level                                        = Mixed
       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                                = yes
       Protection size used                              = 2147483648 (2.0G)
       Auto-delete state                                 = Idle
       Auto-delete paused                                = no
       Auto-delete pool full threshold enabled           = no
       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%
                            
    Example 2 (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)
           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."
           Protection 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%
    
                            

    Change pool settings

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

    Format
    /stor/config/pool -id <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 qualifier
    Qualifier
    Description
    -id
    Type the ID of the pool to change.
    Action qualifier
    Qualifier
    Description
    -async
    Run the operation in asynchronous mode.
    -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 85%.
    -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 disks to pools

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

    Format
    /stor/config/pool –id <value> extend [-async] {-diskGroup <value> -drivesNumber <value> [-storProfile <value>] |-disk <value>
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID 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 disk groups, separated by commas, to add to the pool.
    -drivesNumber (physical deployments only)
    Type the number of disks from the specified disk 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 disk 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 disk 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 disks, separated by commas, to add to the pool. Specified disks must be reliable storage objects which do not require additional protection.
    Example 1 (physical deployments only)

    The following command extends pool pool_1 with seven disks from disk 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.
    
                            

    Delete pools

    Delete a pool.

    Format
    /stor/config/pool –id <value> delete [-async]
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the pool to extend.
    Action qualifier
    Qualifier
    Description
    -async
    Run the operation in asynchronous mode.
    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 disks in a pool to maximize storage efficiency. Storage tiers are defined by the following characteristics:

    • Disk performance.
    • Disk capacity.

    The following table lists the attributes for storage profiles:

    Table 3. Storage tier attributes
    Attribute
    Description
    Name
    Storage tier name.
    Drives
    The list of disk types, and the number of disks 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 disks 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.

    The show action command explains how to change the output format.
    Format
    /stor/config/pool/tier –pool <value> show
    Object qualifier
    Qualifier
    Description
    -pool
    Type the ID 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 specified pool, and NAS servers that have file systems allocated in the pool.

    The following table lists the attributes for pool resources.

    Table 4. 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 used by the pool. This includes primary data used size, snapshot used size, and metadata size.
    Total pool snapshot space used
    Total spaced used by the pool for snapshots.
    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>] show
    Object qualifier
    Qualifier
    Description
    -pool
    Type the ID 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                           = FileSystem00
             Resource type                  = File system
             Pool                           = pool_1
             Total pool space used          = 23622320128 (220GB)
             Total pool snapshot space used = 2147483648 (2GB)
             Health state                   = OK (5)
             Health details                 = "The component is operating normally. No action is required."
    
    2:       ID                             = res_2
             Name                           = LUNGroup00
             Resource type                  = LUN group
             Pool                           = pool_1
             Total pool space used          = 57982058496 (54GB)
             Total pool snapshot space used = 4294967296 (4GB)
             Health state                   = OK (5)
             Health details                 = "The component is operating normally. No action is required."
    
    3:       ID                             = nas_1
             Name                           = NASServer00
             Resource type                  = NAS server
             Pool                           = pool_1
             Total pool space used          = 
             Total pool snapshot space used = 
             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.

    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 5. Storage profile attributes
    Attribute
    Description
    ID
    ID of the storage profile.
    Description
    Brief description of the storage profile.
    Drive type
    Types of disks 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 disks the data is striped across.
    For best fit profiles, this value is Best fit .
    The show action command explains how to change the output format.
    Format
    /stor/config/profile [–id <value> | -driveType <value> [-raidLevel <value>]] show
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of a storage profile.
    -driveType
    Specify the type of disk drive.
    -raidLevel
    Specify the RAID type of the profile.
    Example

    The following command shows details for all storage profiles on the system:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/profile show
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:     ID               = SP_1
           Description      = Best Performance
           Drive type       = SAS
           RAID level       = 5
           Maximum capacity = 1099511627776 (1TB)
           Stripe length    = 6
    
    2:     ID               = SP_2
           Description      = High Capacity
           Drive type       = FAT-SAS
           RAID level       = 6
           Maximum capacity = 21990232555520 (20TB)
           Stripe length    = 6
    
    3:     ID               = SP_3
           Name             = Performance
           Drive type       = SAS
           RAID level       = 5
           Maximum capacity = 5937362789990 (5.4TB)
           Stripe length    = 5
                        

    Manage disk groups (physical deployments only)

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

    Each disk group is identified by an ID.

    The following table lists the attributes for disk groups.

    Table 6. Disk group attributes
    Attribute
    Description
    ID
    ID of the disk group.
    Drive type
    Type of disks in the disk group.
    FAST Cache
    Indicates whether the disk group's disks can be added to FAST Cache.
    Drive size
    Capacity of one disk in the disk group.
    Rotational speed
    Rotational speed of the disks in the group.
    Number of drives
    Total number of disks in the disk group.
    Unconfigured drives
    Total number of disks in the disk group that are not in a pool.
    Capacity
    Total capacity of all disks in the disk group.
    Recommended number of spares
    Number of spares recommended for the disk group.

    View disk groups

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

    The show action command explains how to change the output format.
    Format
    /stor/config/dg [–id <value>] show
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of a disk group.
    Example

    The following command shows details about all disk groups:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/dg show
                              Storage system address: 10.64.75.201
    Storage system port: 443
    HTTPS connection
    
    1:     ID                           = dg_8
           Drive type                   = NL-SAS
           FAST Cache                   = no
           Drive size                   = 2199023255552 (2T)
           Rotational speed             = 10000 rpm
           Number of drives             = 21
           Unconfigured drives          = 7
           Capacity                     = 46179488366592 (42T)
           Recommended number of spares = 1
    
    2:     ID                           = dg_7
           Drive type                   = NL-SAS
           FAST Cache                   = no
           Drive size                   = 1099511627776 (1T)
           Rotational speed             = 7200 rpm
           Number of drives             = 14
           Unconfigured drives          = 0
           Capacity                     = 15393162788864 (14T)
           Recommended number of spares = 1
    
    3:     ID                           = dg_1
           Drive type                   = SAS
           FAST Cache                   = no
           Drive size                   = 322122547200 (300G)
           Rotational speed             = 10000 rpm
           Number of drives             = 10
           Unconfigured drives          = 3
           Capacity                     = 3221225472000 (3T)
           Recommended number of spares = 1
    
    4:     ID                           = dg_5
           Drive type                   = SAS Flash
           FAST Cache                   = yes
           Drive size                   = 107374182400 (100G)
           Rotational speed             = 0 rpm
           Number of drives             = 4
           Unconfigured drives          = 4
           Capacity                     = 429496729600 (400G)
           Recommended number of spares = 1
    
    5:     ID                           = dg_3
           Drive type                   = SAS Flash
           FAST Cache                   = no
           Drive size                   = 429496729600 (400G)
           Rotational speed             = 0 rpm
           Number of drives             = 2
           Unconfigured drives          = 2
           Capacity                     = 858993459200 (800G)
           Recommended number of spares = 1
    
                            

    View recommended disk group configurations

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

    The show action command explains how to change the output format.
    Format
    /stor/config/dg recom {–profile <value>|-pool <value>}
    Action qualifier
    Qualifier
    Description
    -profile
    Type the ID of a storage profile. The output will include the list of disk groups recommended for the specified storage profile.
    -pool
    Type the ID of a pool. The output will include the list of disk groups recommended for the specified pool.
    Example

    The following command shows the recommended disk 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)
                            

    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
    Disks without a tier cannot be used for pool provisioning.
    Example 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.

    Configure pools automatically

    In order to automatically create pools, the following criteria must be met:

    • A FAST VP/FAST Cache license is not installed.
    • No other pools have been created.
    • For virtual deployments, all virtual disks have been assigned a tier type.
    Retrieve default pools configuration
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /store/config/auto show
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:      Target           = Pool 
            Name             = Performance
            Drives (current) = 
            Drives (new)     = 6 x 600GB SAS; 6 x 300GB SAS
            RAID level       = 5
            Stripe length    = 5,9
    
    
    2:      Target           = Pool 
            Name             = Capacity
            Drives (current) = 
            Drives (new)     = 12 x 2TB NL SAS
            RAID level       = 5
            Stripe length    = 5,9
    
    
    3:      Target           = Pool 
            Name             = Extreme Performance
            Drives (current) = 
            Drives (new)     = 10 x 100GB EFD
            RAID level       = 1
            Stripe length    = 2
    
    
    4:      Target           = Spares
            Name             = Unused / Hot Spare Candidates
            Drives (current) = 
            Drives (new)     = 1 x 600GB SAS; 1 x 300GB SAS; 1 x 1TB NL-SAS; 1 x 100GB EFD
            RAID level       =
            Stripe length    =
    
                            
    Initiate auto configuration
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/auto set
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
    
                            
    Get the list of configured pools
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool show
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:     ID                        = SPL_1
           Name                      = High Performance
           Description               = 
           Total space               = 4947802324992 (4.5T)
           Current allocation        = 0
           Remaining space           = 4947802324992 (4.5T)
           Subscription              = 0
           Subscription percent      = 0%
           Alert threshold           = 70%
           Drives                    = 6 x 600GB SAS; 6 x 300GB SAS
           Number of drives          = 12
           RAID level                = 5
           Stripe length             = 5,9
           Health state              = OK (5)
           Recommended resource      =
           FAST Cache enabled        = no
           Data relocation           =
           Data to move up           =
           Data to move down         = 
           Data to move within       =
           Estimated relocation time =
    
    2:     ID                        = SPL_2
           Name                      = High Capacity
           Description               =
           Total space               = 24947802324992 (19.5T)
           Current allocation        = 0
           Remaining space           = 24947802324992 (19.5T)
           Subscription              = 0
           Subscription percent      = 0%
           Alert threshold           = 70%
           Drives                    = 12 x 2TB NL-SAS
           Number of drives          = 12
           RAID level                = 5
           Stripe length             = 5,9
           Health state              = OK (5)
           Recommended resource      = 
           FAST Cache enabled        = no
           Data relocation           = 
           Data to move up           = 
           Data to move down         = 
           Data to move within       = 
           Estimated relocation time =
    
    3:     ID                        = SPL_3
           Name                      = Best performance
           Description               =
           Total space               = 517802324992 (487.1G)
           Current allocation        = 0
           Remaining space           = 517802324992 (487.1G)
           Subscription              = 0
           Subscription percent      = 0%
           Alert threshold           = 70%
           Drives                    = 10  x 100GB EFD
           Number of drives          = 10
           RAID level                = 1
           Stripe length             = 2
           Health state              = OK (5)
           Recommended resource      = 
           FAST Cache enabled        = no
           Data relocation           = 
           Data to move up           = 
           Data to move down         = 
           Data to move within       = 
           Estimated relocation time =
    
                            

    Create a pool using drives with specific characteristics

    Retrieve the list of storage profiles
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/profile show
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:     ID               = profile_1
           Description      = Performance 
           Drive type       = SAS
           RAID level       = 5
           Maximum capacity = 838860800 (800G)
           Stripe length    = Best fit
    
    2:     ID               = profile_2
           Description      = Capacity
           Drive type       = NL-SAS
           RAID level       = 5
           Maximum capacity = 13194139533312 (12T)
           Stripe length    = 6
    
    3:     ID               = profile_3
           Description      = Performance
           Drive type       = SAS
           RAID level       = 5
           Maximum capacity = 7036874417766 (6.4T)
           Stripe length    = 5
    
                            
    Retrieve the list of recommended disk groups for the selected storage type
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/dg recom –profile profile_1
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:     ID                        = profile_1
           Description               = NL-SAS RAID10 (4+4)
           Drive type                = NL-SAS
           RAID level                = 10
           Maximum capacity          = 5717460464435 (5.2T)
           Stripe length             = 8
    
    
                            
    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_1 –diskGroup DG_1 –drivesNumber 19
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    ID = GP_4
    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