PDFConfiguring pools using the CLI
Configure pools automatically
Pools are the groups of physical drives 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 drives 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.
All disks on the system will be used for storage pools.
The following table lists the attributes for automatic pool configuration.
|
Attribute
|
Description
|
|---|---|
|
Target
|
Type of drive configuration. Value is one of the following:
|
|
Name
|
Name of the pool. The system allocates drives to one or more of the following pools based on the types and characteristics of the disks on the system:
|
|
Drives (current)
|
List of drives currently in the pool.
|
|
Drives (new)
|
List of drives to be added to the pool.
|
|
RAID level
(physical deployments only)
|
RAID level applied.
|
|
Stripe length
(physical deployments only)
|
Comma-separated list of drives 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.
All disks on the system will be used to configure storage pools automatically. You must explicitly confirm this operation to proceed.
Format
/stor/config/auto setAction 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
All disks in the system will be used to configure pools. Do you want to proceed?
yes / no: yes
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 showExample (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 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.
- (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:
|
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 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:
|
|
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:
|
|
Health state
|
Health state of the pool. The health state code appears in parentheses. Valid values are:
|
|
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:
|
|
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:
|
|
Auto-delete paused
|
Indicates whether an auto-delete operation is paused. Valid values are:
|
|
Auto-delete pool full threshold enabled
|
Indicates whether the system will check the pool full high water mark for auto-delete. Valid values are:
|
|
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:
|
|
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.
|
|
Compression space saved
(physical deployments only)
|
Storage size saved on the pool by using compression.
Compression is available for thin LUNs in an all-Flash pool only.
|
|
Compression percent
(physical deployments only)
|
Storage percentage saved on the pool by using compression.
Compression is available for thin LUNs in an all-Flash pool only.
|
|
Compression ratio
(physical deployments only)
|
Ratio between data without compression and data after compression savings.
Compression is available for thin LUNs in an all-Flash pool only.
|
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:
|
|
-snapPoolFullThresholdEnabled
|
Indicate whether the system should check the pool full high water mark for auto-delete. Value is one of the following:
|
|
-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:
|
|
-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>] showObject 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 = All Flash Pool
Description =
Total space = 12601434046464 (11.4T)
Current allocation = 1125281431552 (1.0T)
Remaining space = 11476152614912 (10.4T)
Subscription = 3263101403136 (2.9T)
Subscription percent = 25%
Alert threshold = 70%
Drives = 9 x 1.6T SAS Flash 2
Number of drives = 9
RAID level = 5
Stripe length = 9
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
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 = 771215065088 (718.2G)
Compression Percent = 53%
Compression Ratio = 2.1:1
2: ID = pool_2
Name = Hybrid Flash Pool
Description =
Total space = 29142158409728 (26.5T)
Current allocation = 1785632653312 (1.6T)
Remaining space = 27356525756416 (24.8T)
Subscription = 2202244481024 (2.0T)
Subscription percent = 7%
Alert threshold = 70%
Drives = 10 x 1.8T SAS; 5 x 800.0G SAS Flash 3; 8 x 2.0T NL-SAS
Number of drives = 23
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 = no
Protection 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
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.
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:
|
|
-snapPoolFullThresholdEnabled
|
Indicate whether the system should check the pool full high water mark for auto-delete. Value is one of the following:
|
|
-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:
|
|
-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 drives 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 drives 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 drives, separated by commas, to add to the pool. Specified drives 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 drives 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.
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:
|
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.
The show action command explains how to change the output format.
Format
/stor/config/pool/tier –pool <value> showObject 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.
|
Attribute
|
Description
|
|---|---|
|
ID
|
Storage resource identifier.
|
|
Name
|
Name of the storage resource.
|
|
Resource type
|
Type of the resource. Valid values are:
|
|
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>] showObject 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.
|
Attribute
|
Description
|
|---|---|
|
ID
|
ID of the storage profile.
|
|
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:
|
|
Maximum capacity
|
Maximum storage capacity for the storage profile.
|
|
Stripe length
|
Number of drives the data is striped across.
For best fit profiles, this value is
Best fit .
|
|
Disk group
|
List of disk 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 disk 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 disks available to configure for the storage profile in the recommended disk groups. This is calculated only when the
-configurable option is specified.
|
The show action command explains how to change the output format.
Format
/stor/config/profile [–id <value> | -driveType <value> [-raidLevel <value>]] [-configurable {yes | no}] showObject 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.
|
|
-configurable
|
Show only profiles that can be configured. If specified, calculates the following disk group information for each profile:
|
Example 1
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 = profile_22
Description = SAS RAID5
Drive type = SAS
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
Description = SAS RAID10 (1+1)
Drive type = SAS
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
Description = SAS RAID10 (2+2)
Drive type = SAS
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 all storage profiles on the system:
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)
Manage disk groups (physical deployments only)
Disk groups are the groups of drives 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 drives 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.
|
Attribute
|
Description
|
|---|---|
|
ID
|
ID of the disk group.
|
|
Drive type
|
Type of drives in the disk group.
|
|
FAST Cache
|
Indicates whether the disk group's drives can be added to FAST Cache.
|
|
Drive size
|
Capacity of one drive in the disk group.
|
|
Rotational speed
|
Rotational speed of the drives in the group.
|
|
Number of drives
|
Total number of drives in the disk group.
|
|
Unconfigured drives
|
Total number of drives in the disk group that are not in a pool.
|
|
Capacity
|
Total capacity of all drives 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>] showObject 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_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 = 1
5: ID = dg_2
Drive type = SAS Flash 2
FAST Cache = no
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 = 1
View recommended disk group configurations
View the recommended disk groups from which to add drives 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:
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.
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:
|
|
-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