Configuring pools using the CLI
Configure custom pools
Pools are the groups of drives on which you create storage resources. Configure pools based on the type of storage resource and usage that will be associated with the pool, such as file system storage optimized for database usage. The storage characteristics differ according to the following:
- Type of drive used to provide the storage.
- (dual-SP virtual deployments only) RAID level implemented for the storage.
|
Note:
Before you create storage resources, you must configure at least one pool.
|
The following table lists the attributes for pools:
Attribute
|
Description
|
||
---|---|---|---|
ID
|
ID of the pool.
|
||
Name
|
Name of the pool.
|
||
Type
|
Pool type. Valid values are:
|
||
Description
|
Brief description of the pool.
|
||
Total space
|
Total storage capacity of the pool.
|
||
Current allocation
|
Amount of storage in the pool allocated to storage resources.
|
||
Preallocated space
|
Amount of storage space reserved in the pool by storage resources for future needs to make writes more efficient. The pool may be able to reclaim some of this space if total pool space is running low. This value equals the sum of the
sizePreallocated values of each storage resource in the pool.
|
||
Remaining space
|
Amount of storage in the pool not allocated to storage resources.
|
||
Subscription
|
For thin provisioning, the total storage space subscribed to the pool. All pools support both standard and thin provisioned storage resources. For standard storage resources, the entire requested size is allocated from the pool when the resource is created, for thin provisioned storage resources only incremental portions of the size are allocated based on usage. Because thin provisioned storage resources can subscribe to more storage than is actually allocated to them, pools can be over provisioned to support more storage capacity than they actually possess.
|
||
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:
|
||
Non-base size used
|
Quantity of storage used for thin clone and snapshot data.
|
||
Auto-delete state
|
Indicates the state of an auto-delete operation on the pool. Valid values are:
|
||
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.
|
||
Data Reduction space saved
(physical deployments only)
|
Storage size saved on the pool by using data reduction.
|
||
Data Reduction percent
(physical deployments only)
|
Storage percentage saved on the pool by using data reduction.
|
||
Data Reduction ratio
(physical deployments only)
|
Ratio between data without data reduction and data after data reduction savings.
|
||
All flash pool
|
Indicates whether the pool contains only Flash drives. Valid values are:
|
Create pools
Create a dynamic or traditional pool:
- Both traditional pools and dynamic pools are supported in the CLI and REST API for Unity All-Flash models running OE version 4.2.x or later. The default pool type is dynamic.
- Traditional pools are supported in all Unity hybrid and virtual models. They are also supported in Unity All-Flash models running OE version 4.1.x or earlier.
Format
/stor/config/pool create [-async] -name <value> [-type {dynamic | traditional}] [-descr <value>] {-diskGroup <value> -drivesNumber <value> [-storProfile <value>] | -disk <value>} [-alertThreshold <value>] [-snapPoolFullThresholdEnabled {yes|no}] [-snapPoolFullHWM <value>] [-snapPoolFullLWM <value>] [-snapSpaceUsedThresholdEnabled {yes|no}] [-snapSpaceUsedHWM <value>] [-snapSpaceUsedLWM <value>]Action qualifier
Qualifier
|
Description
|
||
---|---|---|---|
-async
|
Run the operation in asynchronous mode.
|
||
-name
|
Type a name for the pool.
|
||
-type
|
(Available only for systems that support dynamic pools) Specify the type of pool to create. Value is one of the following:
Default value is dynamic. |
||
-descr
|
Type a brief description of the pool.
|
||
-storProfile
(physical deployments only)
|
Type the ID of the storage profiles, separated by commas, to apply to the pool, based on the type of storage resource that will use the pool and the intended usage of the pool.
View storage profiles (physical deployments only) explains how to view the IDs of available storage profiles on the system. If this option is not specified, a default RAID configuration is selected for each particular drive type in the selected drive group: NL-SAS (RAID 6 with a stripe length of 8), SAS (RAID 5 with a stripe length of 5), or Flash (RAID 5 with a stripe length of 5).
|
||
-diskGroup
(physical deployments only)
|
Type a comma-separated list of IDs of the drive groups to use in the pool. Specifying drive groups with different drive types causes the creation of a multi-tier pool.
View drive groups explains how to view the IDs of the drive groups on the system.
|
||
-drivesNumber
(physical deployments only)
|
Specify the drive numbers, separated by commas, from the selected drive groups to use in the pool. If this option is specified when
-storProfile is not specified, the operation may fail when the
-drivesNumber value does not match the default RAID configuration for each drive type in the selected drive group.
|
||
-disk
(virtual deployments only)
|
Specify the list of drive IDs, separated by commas, to use in the pool. Specified drives must be reliable storage objects that do not require additional protection.
|
||
-alertThreshold
|
For thin provisioning, specify the threshold, as a percentage, when the system will alert on the amount of subscription space used. When hosts consume the specified percentage of subscription space, the system sends an alert. Value range is 50% to 85%.
|
||
-FASTCacheEnabled
(physical deployments only)
|
Specify whether to enable FAST Cache on the pool. Value is one of the following:
|
||
-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.
|
|
Note:
Use the
Change disk settings (virtual deployments only) command to change the assigned tiers for specific drives.
|
Example 1 (physical deployments only)
The following command creates a dynamic pool. This example uses storage profiles profile_1 and profile_2, six drives from drive group dg_2, and ten drives from drive group dg_28. The configured pool receives ID pool_2.
|
Note:
Before using the
stor/config/pool create command, use the
/stor/config/profile show command to display the dynamic pool profiles and the
/stor/config/dg show command to display the drive groups.
|
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
ID = pool_2
Operation completed successfully.
Example 2 (physical deployments only)
The following command creates a traditional pool in models that support dynamic pools. This example uses storage profiles tprofile_1 and tprofile_2, five drives from drive group dg_3, and nine drives from drive group dg_28. The configured pool receives ID pool_6.
|
Note:
Before using the
stor/config/pool create command, use the
/stor/config/profile -traditional show command to display the traditional pool profiles (which start with "t") and the
/stor/config/dg show command to display the drive groups.
|
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
ID = pool_6
Operation completed successfully.
Example 3 (physical deployments only)
The following command creates a traditional pool in models that do not support dynamic pools. This example uses storage profiles profile_19 and profile_20, five drives from drive group dg_15, and nine drives from drive group dg_16. The configured pool receives ID pool_5.
|
Note:
Before using the
stor/config/pool create command, use the
/stor/config/profile show command to display the traditional pool profiles and the
/stor/config/dg show command to display the drive groups.
|
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
ID = pool_5
Operation completed successfully.
Example 4 (virtual deployments only)
The following command creates a traditional pool with two virtual disks, vdisk_0 and vdisk_2 in the Extreme Performance tier. The configured pool receives ID pool_4.
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool create -name vPool -descr "my virtual pool" -disk vdisk_0,vdisk_2
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
ID = pool_4
Operation completed successfully.
Change pool settings
Change the subscription alert threshold, FAST Cache, and snapshot threshold settings for a pool.
Format
/stor/config/pool {-id <value> | -name <value>} set [-async] –name <value> [-descr <value>] [-alertThreshold <value>] [-snapPoolFullThresholdEnabled {yes|no}] [-snapPoolFullHWM <value>] [-snapPoolFullLWM <value>] [-snapSpaceUsedThresholdEnabled {yes|no}] [-snapSpaceUsedHWM <value>] [-snapSpaceUsedLWM <value>] [-snapAutoDeletePaused no]Object qualifiers
Qualifier
|
Description
|
---|---|
-id
|
Type the ID of the pool to change.
|
-name
|
Type the name of the pool to change.
|
Action qualifier
Qualifier
|
Description
|
||
---|---|---|---|
-async
|
Run the operation in asynchronous mode.
|
||
-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 drives to pools
Add new drives to a pool to increase its storage capacity.
Format
/stor/config/pool {-id <value> | -name <value>} extend [-async] {-diskGroup <value> -drivesNumber <value> [-storProfile <value>] |-disk <value>}Object qualifiers
Qualifier
|
Description
|
---|---|
-id
|
Type the ID of the pool to extend.
|
-name
|
Type the name of the pool to extend.
|
Action qualifier
Qualifier
|
Description
|
---|---|
-async
|
Run the operation in asynchronous mode.
|
-diskGroup
(physical deployments only)
|
Type the IDs of the drive groups, separated by commas, to add to the pool.
|
-drivesNumber
(physical deployments only)
|
Type the number of drives from the specified drive groups, separated by commas, to add to the pool. If this option is specified when
-storProfile is not specified, the operation may fail when the
-drivesNumber value does not match the default RAID configuration for each drive type in the selected drive group.
|
-storProfile
(physical deployments only)
|
Type the IDs of the storage profiles, separated by commas, to apply to the pool. If this option is not specified, a default RAID configuration is selected for each particular drive type in the selected drive group: NL-SAS (RAID 6 with a stripe length of 8), SAS (RAID 5 with a stripe length of 5), or Flash (RAID 5 with a stripe length of 5).
|
-disk
(virtual deployments only)
|
Specify the list of drives, separated by commas, to add to the pool. Specified drives must be reliable storage objects that do not require additional protection.
|
Example 1 (physical deployments only)
The following command extends pool pool_1 with seven drives from drive group DG_1:
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool –id pool_1 extend –diskGroup dg_1 –drivesNumber 7 -storProfile profile_12
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
ID = pool_1
Operation completed successfully.
Example 2 (virtual deployments only)
The following command extends pool pool_1 by adding two virtual disks, vdisk_1 and vdisk_5.
uemcli -d 10.0.0.2 -u Local/joe -p MyPassword456! /stor/config/pool –id pool_1 extend –disk vdisk_1,vdisk_5
Storage system address: 10.0.0.2
Storage system port: 443
HTTPS connection
ID = pool_1
Operation completed successfully.
View pools
View a list of pools. You can filter on the pool ID.
|
Format
/stor/config/pool {-id <value> | -name <value>}] showObject qualifiers
Qualifier
|
Description
|
---|---|
-id
|
Type the ID of a pool.
|
-name
|
Type the name of a pool.
|
Example 1 (physical deployments only)
The following command shows details about all pools on a hybrid system:
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool show -detail
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
1: ID = pool_1
Name = Performance
Description = Multi-tier pool
Total space = 8663754342400 (7.8T)
Current allocation = 0
Preallocated space = 38310387712 (35.6G)
Remaining space = 8663754342400 (7.8T)
Subscription = 0
Subscription percent = 0%
Alert threshold = 70%
Drives = 5 x 600.0G SAS; 5 x 1.6T SAS Flash 3
Number of drives = 10
RAID level = 5
Stripe length = 5
Rebalancing = no
Rebalancing progress =
Health state = OK (5)
Health details = "The component is operating normally. No action is required."
FAST Cache enabled = no
Protection size used = 0
Non-base size used = 0
Auto-delete state = Idle
Auto-delete paused = no
Auto-delete pool full threshold enabled = yes
Auto-delete pool full high water mark = 95%
Auto-delete pool full low water mark = 85%
Auto-delete snapshot space used threshold enabled = no
Auto-delete snapshot space used high water mark = 25%
Auto-delete snapshot space used low water mark = 20%
Compression space saved = 0
Compression Percent = 0%
Compression Ratio = 1:1
Data Reduction space saved = 0
Data Reduction percent = 0%
Data Reduction ratio = 1:1
All flash pool = no
2: ID = pool_2
Name = Capacity
Description =
Total space = 4947802324992 (4.5T)
Current allocation = 3298534883328 (3T)
Preallocated space = 22194823168 (20.6G)
Remaining space = 4947802324992 (1.5T)
Subscription = 10995116277760 (10T)
Subscription percent = 222%
Alert threshold = 70%
Drives = 12 x 2TB NL-SAS
Number of drives = 12
Unused drives = 7
RAID level = 6
Stripe length = 6
Rebalancing = yes
Rebalancing progress = 46%
Health state = OK (5)
Health details = "The component is operating normally. No action is required."
FAST Cache enabled = yes
Protection size used = 10995116238 (10G)
Non-base size used = 10995116238 (10G)
Auto-delete state = Running
Auto-delete paused = no
Auto-delete pool full threshold enabled = yes
Auto-delete pool full high water mark = 95%
Auto-delete pool full low water mark = 85%
Auto-delete snapshot space used threshold enabled = yes
Auto-delete snapshot space used high water mark = 25%
Auto-delete snapshot space used low water mark = 20%
Compression space saved = 4947802324992 (1.5T)
Compression percent = 23%
Compression ratio = 1.3:1
Data Reduction space saved = 4947802324992 (1.5T)
Data Reduction percent = 23%
Data Reduction ratio = 1.3:1
All flash pool = no
3: ID = pool_3
Name = Extreme Performance
Description =
Total space = 14177955479552 (12.8T)
Current allocation = 0
Preallocated space = 14177955479552 (12.8T)
Remaining space = 14177955479552 (12.8T)
Subscription = 0
Subscription percent = 0%
Alert threshold = 70%
Drives = 9 x 1.6T SAS Flash 3; 5 x 400.0G SAS Flash 2
Number of drives = 14
RAID level = 5
Stripe length = Mixed
Rebalancing = no
Rebalancing progress =
Health state = OK (5)
Health details = "The component is operating normally. No action is required."
FAST Cache enabled = no
Protection size used = 0
Non-base size used = 0
Auto-delete state = Idle
Auto-delete paused = no
Auto-delete pool full threshold enabled = yes
Auto-delete pool full high water mark = 95%
Auto-delete pool full low water mark = 85%
Auto-delete snapshot space used threshold enabled = no
Auto-delete snapshot space used high water mark = 25%
Auto-delete snapshot space used low water mark = 20%
Compression space saved = 0
Compression Percent = 0%
Compression Ratio = 1:1
Data Reduction space saved = 0
Data Reduction percent = 0%
Data Reduction ratio = 1:1
All flash pool = yes
Example 2
The following example shows all pools for a model that supports dynamic pools.
uemcli -d 10.0.0.2 -u Local/joe -p MyPassword456! /stor/config/pool show -detail
[Response]
Storage system address: 10.64.75.201
Storage system port: 443
HTTPS connection
1: ID = pool_3
Type = Traditional
Name = MyPool
Description = traditional pool
Total space = 14177955479552 (12.8T)
Current allocation = 0
Preallocated space = 38310387712 (35.6G)
Remaining space = 14177955479552 (12.8T)
Subscription = 0
Subscription percent = 0%
Alert threshold = 70%
Drives = 9 x 1.6T SAS Flash 3; 5 x 400.0G SAS Flash 2
Number of drives = 14
RAID level = 5
Stripe length = Mixed
Rebalancing = no
Rebalancing progress =
Health state = OK (5)
Health details = "The component is operating normally. No action is required."
FAST Cache enabled = no
Protection size used = 0
Non-base size used = 0
Auto-delete state = Idle
Auto-delete paused = no
Auto-delete pool full threshold enabled = yes
Auto-delete pool full high water mark = 95%
Auto-delete pool full low water mark = 85%
Auto-delete snapshot space used threshold enabled = no
Auto-delete snapshot space used high water mark = 25%
Auto-delete snapshot space used low water mark = 20%
Compression space saved = 0
Compression Percent = 0%
Compression Ratio = 1:1
Data Reduction space saved = 0
Data Reduction percent = 0%
Data Reduction ratio = 1:1
All flash pool = yes
2: ID = pool_4
Type = Dynamic
Name = dynamicPool
Description =
Total space = 1544309178368 (1.4T)
Current allocation = 0
Preallocated space = 38310387712 (35.6G)
Remaining space = 1544309178368 (1.4T)
Subscription = 0
Subscription percent = 0%
Alert threshold = 70%
Drives = 6 x 400.0G SAS Flash 2
Number of drives = 6
RAID level = 5
Stripe length = 5
Rebalancing = no
Rebalancing progress =
Health state = OK (5)
Health details = "The component is operating normally. No action is required."
Protection size used = 0
Non-base size used = 0
Auto-delete state = Idle
Auto-delete paused = no
Auto-delete pool full threshold enabled = yes
Auto-delete pool full high water mark = 95%
Auto-delete pool full low water mark = 85%
Auto-delete snapshot space used threshold enabled = no
Auto-delete snapshot space used high water mark = 25%
Auto-delete snapshot space used low water mark = 20%
Compression space saved = 0
Compression Percent = 0%
Compression Ratio = 1:1
Data Reduction space saved = 0
Data Reduction percent = 0%
Data Reduction ratio = 1:1
All flash pool = yes
Example 3 (virtual deployments only)
The following command shows details for all pools on a virtual system.
uemcli -d 10.0.0.2 -u Local/joe -p MyPassword456! /stor/config/pool show -detail
Storage system address: 10.0.0.2
Storage system port: 443
HTTPS connection
1: ID = pool_1
Name = Capacity
Description =
Total space = 4947802324992 (4.5T)
Current allocation = 3298534883328 (3T)
Preallocated space = 38310387712 (35.6G)
Remaining space = 4947802324992 (1.5T)
Subscription = 10995116277760 (10T)
Subscription percent = 222%
Alert threshold = 70%
Drives = 1 x 120GB Virtual; 1 x 300GB Virtual
Number of drives = 2
Health state = OK (5)
Health details = "The component is operating normally. No action is required."
Non-base size used = 1099511625 (1G)
Auto-delete state = Running
Auto-delete paused = no
Auto-delete pool full threshold enabled = yes
Auto-delete pool full high water mark = 95%
Auto-delete pool full low water mark = 85%
Auto-delete snapshot space used threshold enabled = yes
Auto-delete snapshot space used high water mark = 25%
Auto-delete snapshot space used low water mark = 20%
Delete pools
Delete a pool.
Format
/stor/config/pool {-id <value> | -name <value>} delete [-async]Object qualifiers
Qualifier
|
Description
|
---|---|
-id
|
Type the ID of the pool to delete.
|
-name
|
Type the name of the pool to delete.
|
Action qualifier
Qualifier
|
Description
|
||
---|---|---|---|
-async
|
Run the operation in asynchronous mode.
|
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.
|
Format
/stor/config/pool/tier {-pool <value> | -poolName <value>} showObject qualifiers
Qualifier
|
Description
|
---|---|
-pool
|
Type the ID of a pool.
|
-poolName
|
Type the name of a pool.
|
Example 1 (physical deployments only)
The following command shows tier details about the specified pool:
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool/tier -pool pool_1 show -detail
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
1: Name = Extreme Performance
Drives = 2 x 200.0G SAS Flash 2; 2 x 800.0G SAS Flash 2
Drive type = SAS Flash
RAID level = 10
Stripe length = 2
Total space = 868120264704 (808.5G)
Current allocation = 56371445760 (52.5G)
Remaining space = 811748818944 (756.0G)
2: Name = Performance
Drives = 15 x 600.0G SAS
Drive type = SAS
RAID level = 5
Stripe length = 5
Total space = 7087501344768 (6.4T)
Current allocation = 0
Remaining space = 7087501344768 (6.4T)
3: Name = Capacity
Drives = 8 x 6.0T NL-SAS
Drive type = NL-SAS
RAID level = 6
Stripe length = 8
Total space = 35447707271168 (32.2T)
Current allocation = 1610612736 (1.5G)
Remaining space = 35446096658432 (32.2T)
Example 2 (virtual deployments only)
The following command shows details about pool pool_1 on a virtual system.
uemcli -d 10.0.0.2 -u Local/joe -p MyPassword456! /stor/config/pool/tier –pool pool_1 show -detail
Storage system address: 10.0.0.2
Storage system port: 443
HTTPS connection
1: Name = Extreme Performance
Drives =
Total space = 0
Current allocation = 0
Remaining space = 0
2: Name = Performance
Drives = 1 x 500GB Virtual
Total space = 631242752000 (500.0G)
Current allocation = 12624855040 (10.0G)
Remaining space = 618617896960 (490.0G)
3: Name = Capacity
Drives =
Total space = 0
Current allocation = 0
Remaining space = 0
View pool resources
This command displays a list of storage resources allocated in a pool. This can be storage resources provisioned on the specified pool and NAS servers that have file systems allocated in the pool.
The following table lists the attributes for pool resources.
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 in the pool used by a storage resource. This includes primary data used size, snapshot used size, and metadata size. Space in the pool can be freed if snapshots and thin clones for storage resources are deleted, or have expired.
|
Total pool space preallocated
|
Total space reserved from the pool by the storage resource for future needs to make writes more efficient. The pool may be able to reclaim some of this if space is running low. Additional pool space can be freed if snapshots or thin clones are deleted or expire, and also if Data Reduction is applied.
|
Total pool non-base space used
|
Total pool space used by snapshots and thin clones.
|
Health state
|
Health state of the file system. The health state code appears in parentheses.
|
Health details
|
Additional health information. See Appendix A, Reference, for health information details.
|
Format
/stor/config/pool/sr [{-pool <value> | -poolName <value>}] showObject qualifiers
Qualifier
|
Description
|
---|---|
-pool
|
Type the ID of the pool.
|
-poolName
|
Type the name of the pool.
|
Example
The following command shows details for all storage resources associated with the pool pool_1:
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool/sr -pool pool_1 show -detail
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
1: ID = res_1
Name = File_System_1
Resource type = File System
Pool = pool_1
Total pool space used = 53024473088 (49.3G)
Total pool preallocated = 15695003648 (14.6G)
Total pool snapshot space used = 7179124736 (6.6G)
Total pool non-base space used = 7179124736 (6.6G)
Health state = OK (5)
Health details = "The component is operating normally. No action is required."
2: ID = sv_1
Name = AF LUN 1
Resource type = LUN
Pool = pool_1
Total pool space used = 14448566272 (13.4G)
Total pool preallocated = 4610351104 (4.2G)
Total pool snapshot space used = 4593991680 (4.2G)
Total pool non-base space used = 4593991680 (4.2G)
Health state = OK (5)
Health details = "The LUN is operating normally. No action is required."
3: ID = res_2
Name = File_System_2
Resource type = File System
Pool = pool_1
Total pool space used = 117361025024 (109.3G)
Total pool preallocated = 3166494720 (2.9G)
Total pool snapshot space used = 41022308352 (38.2G)
Total pool non-base space used = 41022308352 (38.2G)
Health state = OK (5)
Health details = "The component is operating normally. No action is required."
4: ID = sv_2
Name = AF LUN 2
Resource type = LUN
Pool = pool_1
Total pool space used = 9500246016 (8.8G)
Total pool preallocated = 2579349504 (2.4G)
Total pool snapshot space used = 0
Total pool non-base space used = 0
Health state = OK (5)
Health details = "The LUN is operating normally. No action is required."
5: ID = res_3
Name = CG1
Resource type = LUN group
Pool = pool_1
Total pool space used = 892542287872 (831.2G)
Total pool preallocated = 8863973376 (8.2G)
Total pool snapshot space used = 231799308288 (215.8G)
Total pool non-base space used = 231799308288 (215.8G)
Health state = OK (5)
Health details = "The component is operating normally. No action is required."
View storage profiles (physical deployments only)
Storage profiles are preconfigured settings for configuring pools based on the following:
- Types of storage resources that will use the pools.
- Intended usage of the pool.
For example, create a pool for file system storage resources intended for general use. When configuring a pool, specify the ID of the storage profile to apply to the pool.
|
Note:
Storage profiles are not restrictive with regard to storage provisioning. For example, you can provision file systems from an FC or iSCSI database pool. However, the characteristics of the storage will be best suited to the indicated storage resource type and use.
|
Each storage profile is identified by an ID.
The following table lists the attributes for storage profiles.
Attribute
|
Description
|
||
---|---|---|---|
ID
|
ID of the storage profile.
|
||
Type
|
(Available only for systems that support dynamic pools) Type of pool the profile can create. Value is one of the following:
|
||
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.
|
||
Disk group
|
List of drive groups recommended for the storage pool configurations of the specified storage profile. This is calculated only when the
-configurable option is specified.
|
||
Maximum drives to configure
|
List of the maximum number of drives allowed for the specified storage profile in the recommended drive groups. This is calculated only when the
-configurable option is specified.
|
||
Maximum capacity to configure
|
List of the maximum number of free capacity of the drives available to configure for the storage profile in the recommended drive groups. This is calculated only when the
-configurable option is specified.
|
|
Format
/stor/config/profile [-id <value> | -driveType <value> [-raidLevel <value>] | -traditional] [-configurable] 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.
|
-traditional
|
(Available only for systems that support dynamic pools) Specify this option to view the profiles that you can use for creating traditional pools. To view the profiles you can use for creating dynamic pools, omit this option.
|
-configurable
|
Show only profiles that can be configured, that is, those with non-empty drive group information. If specified, calculates the following drive group information for each profile:
If the profile is for a dynamic pool, the calculated information indicates whether the drive group has enough drives for pool creation. The calculation assumes that the pool will be created with the drives in the specified drive group only. |
Example 1
The following command shows details for storage profiles that can be used to create dynamic pools:
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/profile -configurable show
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
1: ID = profile_22
Type = Dynamic
Description = SAS Flash 2 RAID5 (4+1)
Drive type = SAS Flash 2
RAID level = 5
Maximum capacity = 4611148087296 (4.1T)
Stripe length = Maximum capacity
Disk group =
Maximum drives to configure =
Maximum capacity to configure =
2: ID = profile_30
Type = Dynamic
Description = SAS Flash 2 RAID10 (1+1)
Drive type = SAS Flash 2
RAID level = 10
Maximum capacity = 9749818597376 (8.8T)
Stripe length = 2
Disk group =
Maximum drives to configure =
Maximum capacity to configure =
3: ID = profile_31
Type = Dynamic
Description = SAS Flash 2 RAID10 (2+2)
Drive type = SAS Flash 2
RAID level = 10
Maximum capacity = 9749818597376 (8.8T)
Stripe length = 4
Disk group =
Maximum drives to configure =
Maximum capacity to configure =
Example 2
The following command shows details for storage profiles that can be used to create traditional pools in models that support dynamic pools:
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/profile -traditional -configurable show
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
1: ID = tprofile_22
Type = Traditional
Description = SAS Flash 3 RAID5 (4+1)
Drive type = SAS Flash 3
RAID level = 5
Maximum capacity = 4611148087296 (4.1T)
Stripe length = Maximum capacity
Disk group = dg_16
Maximum drives to configure = 5
Maximum capacity to configure = 1884243623936 (1.7T)
2: ID = tprofile_30
Type = Traditional
Description = SAS Flash 3 RAID10 (1+1)
Drive type = SAS Flash 3
RAID level = 10
Maximum capacity = 9749818597376 (8.8T)
Stripe length = 2
Disk group = dg_13, dg_15
Maximum drives to configure = 10, 10
Maximum capacity to configure = 1247522127872 (1.1T), 2954304921600 (2.6T)
3: ID = tprofile_31
Type = Traditional
Description = SAS Flash 3 RAID10 (2+2)
Drive type = SAS Flsh 3
RAID level = 10
Maximum capacity = 9749818597376 (8.8T)
Stripe length = 4
Disk group = dg_13, dg_15
Maximum drives to configure = 8, 8
Maximum capacity to configure = 2363443937280 (2.1T), 952103075840 (886.7G)
Manage drive groups (physical deployments only)
Drive groups are the groups of drives on the system with similar characteristics, including type, capacity, and spindle speed. When configuring pools, you select the drove group to use and the number of drives from the group to add to the pool.
Each drive group is identified by an ID.
The following table lists the attributes for drive groups.
Attribute
|
Description
|
---|---|
ID
|
ID of the drive group.
|
Drive type
|
Type of drives in the drive group.
|
FAST Cache
|
Indicates whether the drive group's drives can be added to FAST Cache.
|
Drive size
|
Capacity of one drive in the drive group.
|
Rotational speed
|
Rotational speed of the drives in the group.
|
Number of drives
|
Total number of drives in the drive group.
|
Unconfigured drives
|
Total number of drives in the drive group that are not in a pool.
|
Capacity
|
Total capacity of all drives in the drive group.
|
Recommended number of spares
|
Number of spares recommended for the drive group.
|
Drives past EOL
|
Number of drives past EOL (End of Life) in the group.
|
Drives approaching EOL
|
Number of drives that will reach EOL in 0-30 days, 0-60 days, 0-90 days and 0-180 days.
|
View drive groups
View details about drive groups on the system. You can filter on the drive group ID.
|
Format
/stor/config/dg [-id <value>] [-traditional] showObject qualifier
Qualifier
|
Description
|
---|---|
-id
|
Type the ID of a drive group.
|
-traditional
|
(Available only for systems that support dynamic pools) Specify this qualifier to have the system assume that the pools to be created are traditional pools.
|
Example 1
The following command shows details about all drive groups that can be used to configure dynamic pools:
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/dg show -detail
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
1: ID = dg_3
Drive type = SAS Flash 2
FAST Cache = yes
Drive size = 393846128640 (366.7G)
Vendor size = 400.0G
Rotational speed = 0 rpm
Number of drives = 3
Unconfigured drives = 3
Capacity = 1181538385920 (1.1T)
Recommended number of spares = 0
Drives past EOL = 0
Drives approaching EOL = 0 (0-30 days), 0 (0-60 days), 0 (0-90 days), 0 (0-180 days)
2: ID = dg_2
Drive type = SAS Flash 2
FAST Cache = yes
Drive size = 196971960832 (183.4G)
Vendor size = 200.0G
Rotational speed = 0 rpm
Number of drives = 7
Unconfigured drives = 7
Capacity = 1378803725824 (1.2T)
Recommended number of spares = 0
Drives past EOL = 0
Drives approaching EOL = 1 (0-30 days), 2 (0-60 days), 2 (0-90 days), 3 (0-180 days)
Example 2
The following command shows details about all drive groups that can be used to configure traditional pools in models that support dynamic pools:
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/dg -traditional show
[Response]
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
[Response]
Storage system address: 10.244.223.141
Storage system port: 443
HTTPS connection
1: ID = dg_8
Drive type = NL-SAS
FAST Cache = no
Drive size = 1969623564288 (1.7T)
Vendor size = 2.0T
Rotational speed = 7200 rpm
Number of drives = 7
Unconfigured drives = 7
Capacity = 13787364950016 (12.5T)
Recommended number of spares = 1
2: ID = dg_15
Drive type = SAS
FAST Cache = no
Drive size = 590894538752 (550.3G)
Vendor size = 600.0G
Rotational speed = 15000 rpm
Number of drives = 16
Unconfigured drives = 4
Capacity = 9454312620032 (8.5T)
Recommended number of spares = 1
View recommended drive group configurations
View the recommended drive groups from which to add drives to a pool based on a specified storage profile or pool type.
|
Format
/stor/config/dg recom {–profile <value>| -pool <value> | -poolName <value>}Action qualifier
Qualifier
|
Description
|
---|---|
-profile
|
Type the ID of a storage profile. The output will include the list of drive groups recommended for the specified storage profile.
|
-pool
|
Type the ID of a pool. The output will include the list of drive groups recommended for the specified pool.
|
-poolName
|
Type the name of a pool. The output will include the list of drive groups recommended for the specified pool.
|
Example
The following command shows the recommended drive groups for pool pool_1:
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/dg recom -pool pool_1
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
1: ID = DG_1
Drive type = SAS
Drive size = 536870912000 (500GB)
Number of drives = 8
Allowed numbers of drives = 4,8
Capacity = 4398046511104 (4TB)
2: ID = DG_2
Drive type = SAS
Drive size = 268435456000 (250GB)
Number of drives = 4
Allowed numbers of drives = 4
Capacity = 1099511627776 (1TB)
Manage storage system capacity settings
The following table lists the general storage system capacity attributes:
Attributes
|
Description
|
||
---|---|---|---|
Free space
|
Specifies the amount of space that is free (available to be used) in all storage pools on the storage system.
|
||
Used space
|
Specifies the amount of space that is used in all storage pools on the storage system.
|
||
Preallocated space
|
Space reserved across all of the pools on the storage system. This space is reserved for future needs of storage resources, which can make writes more efficient. Each pool may be able to reclaim preallocated space from storage resources if the storage resources are not using the space, and the pool space is running low.
|
||
Total space
|
Specifies the total amount of space, both free and used, in all storage pools on the storage system.
|
||
Data Reduction space saved
|
Specifies the storage size saved on the entire system when using data reduction.
|
||
Data Reduction percent
|
Specifies the storage percentage saved on the entire system when using data reduction.
|
||
Data Reduction ratio
|
Specifies the ratio between data without data reduction and data after data reduction savings.
|
View system capacity settings
View the current storage system capacity settings.
Format
/stor/general/system showExample
The following command displays details about the storage capacity on the system:
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/general/system show
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
1: Free space = 4947802324992 (1.5T)
Used space = 4947802324992 (1.5T)
Total space = 9895604649984 (3.0T)
Preallocated space = 60505210880 (56.3G)
Compression space saved = 4947802324992 (1.5T)
Compression percent = 50%
Compression ratio = 1
Data Reduction space saved = 4947802324992 (1.5T)
Data Reduction percent = 50%
Data Reduction ratio = 1
Manage system tier capacity settings
The following table lists the general system tier capacity attributes:
Attributes
|
Description
|
---|---|
Name
|
Name of the tier. One of the following:
|
Free space
|
Specifies the amount of space that is free (available to be used) in the tier.
|
Used space
|
Specifies the amount of space that is used in the tier.
|
Total space
|
Specifies the total amount of space, both free and used, in the tier.
|
View system tier capacity
View the current system tier capacity settings.
Format
/stor/general/tier showExample
The following command displays details about the storage tier capacity on the system:
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/general/tier show
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
1: Name = Extreme Performance Tier
Free space = 4947802324992 (1.5T)
Used space = 4947802324992 (1.5T)
Total space = 9895604649984 (3.0T)
2: Name = Capacity Tier
Free space = 4947802324992 (1.5T)
Used space = 4947802324992 (1.5T)
Total space = 9895604649984 (3.0T)
Change disk settings (virtual deployments only)
Change settings of an existing disk.
Format
/env/disk -id <value> set [-async] [-name <value>] [-tier <value>]Object qualifier
Qualifier
|
Description
|
---|---|
-id
|
Disk identifier.
|
Action qualifier
Qualifier
|
Description
|
||
---|---|---|---|
-async
|
Run the operation in asynchronous mode.
|
||
-name
|
Specify the new name for the disk.
|
||
-tier
|
Specify the new tier. Valid values are:
|
Example
The following command changes the name of the virtual disk with the ID "vdisk_1".
uemcli -d 10.0.0.2 -u Local/joe -p MyPassword456! /env/disk -id vdisk_1 set -name "High-performance storage"
Storage system address: 10.0.0.2
Storage system port: 443
HTTPS connection
Operation completed successfully.
Pool use cases
This section describes different CLI use cases for pools.
Create a pool using drives with specific characteristics
This example applies to hybrid Flash arrays, which only support traditional pools.
Retrieve the list of storage profiles
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/profile -configurable show
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
1: ID = profile_22
Description = SAS RAID5
Drive type = SAS
RAID level = 5
Maximum capacity = 4611148087296 (4.1T)
Stripe length = Maximum capacity
Disk group = dg_16
Maximum drives to configure = 5
Maximum capacity to configure = 1884243623936 (1.7T)
2: ID = profile_30
Description = SAS RAID10 (1+1)
Drive type = SAS
RAID level = 10
Maximum capacity = 9749818597376 (8.8T)
Stripe length = 2
Disk group = dg_13, dg_15
Maximum drives to configure = 10, 10
Maximum capacity to configure = 1247522127872 (1.1T), 2954304921600 (2.6T)
3: ID = profile_31
Description = SAS RAID10 (2+2)
Drive type = SAS
RAID level = 10
Maximum capacity = 9749818597376 (8.8T)
Stripe length = 4
Disk group = dg_13, dg_15
Maximum drives to configure = 8, 8
Maximum capacity to configure = 2363443937280 (2.1T), 952103075840 (886.7G)
Configure a new pool
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool create -name MyPool -description "My custom pool" -storProfile profile_22 -diskGroup dg_16 -drivesNumber 5
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
ID = GP_4
Operation completed successfully.
Configure a dynamic pool
You can configure dynamic pools for all-Flash models of Unity running OE version 4.2.x or later. New pools created for these models are dynamic pools by default. Dynamic pools implement advanced RAID technology. In dynamic pools, a RAID group is spread across drive extents in multiple drives. The required spare space is also spread across drive extents in multiple drives. When a drive fails, the extents on the failed drive are rebuilt to spare space extents within the pool.
When you configure dynamic pools, you can select different capacity drives from different drive groups with the same Flash drive types to create a tier. The total drive count of the drive type must be at least the stripe width plus one. For example, the total drive count for a RAID 4 + 1 group must be at least 6.
Step 1: View the list of available drive groups
View the list of available drive groups, as shown in the following example:
[Request]
Uemcli /stor/config/dg show
[Response]
Storage system address: 127.0.0.1
Storage system port: 443
HTTPS connection
1: ID = dg_2
Drive type = SAS Flash 2
FAST Cache = yes
Drive size = 196971960832 (183.4G)
Vendor size = 200.0G
Rotational speed = 0 rpm
Number of drives = 12
Unconfigured drives = 12
Capacity = 2363663529984 (2.1T)
Recommended number of spares = 0
2: ID = dg_3
Drive type = SAS Flash 2
FAST Cache = yes
Drive size = 393846128640 (366.7G)
Vendor size = 400.0G
Rotational speed = 0 rpm
Number of drives = 12
Unconfigured drives = 6
Capacity = 4726153543680 (4.2T)
Recommended number of spares = 0
Step 2: View the list of storage profiles
View the list of storage profiles, as shown in the following example:
[Request]
Uemcli /stor/config/profile show
[Response]
Storage system address: 127.0.0.1
Storage system port: 443
HTTPS connection
1: ID = profile_1
Type = Dynamic
Description = SAS Flash 2 RAID5 (4+1)
Drive type = SAS Flash 2
RAID level = 5
Maximum capacity = 97373737844736 (88.5T)
Stripe length = 5
Disk group =
Maximum drives to configure =
Maximum capacity to configure =
Step 3: Configure the dynamic pool
Configure the dynamic pool with the specified drive groups and profiles. Optionally set -type to dynamic and make sure that the -drivesNumber value for each drive type is not less than the drive group's RAID group width plus one:
uemcli /stor/config/pool create –name mypool -diskGroup dg_2,dg_3 -drivesNumber 4,2
-storProfile profile_1 -type dynamic
Storage system address: 127.0.0.1
Storage system port: 443
HTTPS connection
ID = pool_13
Operation completed successfully.[Request]
Configure a traditional pool for an all-Flash model
You can configure traditional pools for all-Flash models of Unity running OE version 4.2.x by explicitly setting the Type attribute to traditional. If you do not set Type to traditional when you create a pool in the Unisphere CLI, a dynamic pool is created.
Step 1: View the list of storage profiles
View the list of storage profiles, as shown in the following example:
[Request]
uemcli /stor/config/profile -traditional -configurable show
[Response]
Storage system address: 127.0.0.1
Storage system port: 443
HTTPS connection
1: ID = tprofile_2
Type = Traditional
Description = SAS Flash 2 RAID5 (8+1)
Drive type = SAS Flash 2
RAID level = 5
Maximum capacity = 95010661072896 (86.4T)
Stripe length = 9
Disk group = dg_34, dg_26
Maximum drives to configure = 9, 9
Maximum capacity to configure = 60189403250688 (54.7T), 2232208064512 (2.0T)
2: ID = tprofile_4
Type = Traditional
Description = SAS Flash 2 RAID5
Drive type = SAS Flash 2
RAID level = 5
Maximum capacity = 95010661072896 (86.4T)
Stripe length = Maximum capacity
Disk group = dg_34, dg_26
Maximum drives to configure = 9, 10
Maximum capacity to configure = 60189403250688 (54.7T), 2691354329088 (2.4T)
Step 2: Configure the traditional pool
Configure a traditional pool with the specified profile. Make sure you set -type to traditional and that the -drivesNumber is a multiple of the RAID group width.
uemcli /stor/config/pool create -name test -diskGroup dg_34 -drivesNumber 9
-storProfile tprofile_2 -type traditional
[Response]
Storage system address: 127.0.0.1
Storage system port: 443
HTTPS connection
ID = pool_6
Operation completed successfully.
Add drives to an existing pool
Retrieve the list of existing pools
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /store/config/pool show
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
1: ID = SPL_1
Name = Performance
Description =
Free space = 408944640 (390G)
Capacity = 1099511627776 (1T)
Drives = 6 x 250GB SAS
Number of drives = 6
Unused drives = 1
RAID level = 5
System pool = yes
2: ID = SPL_2
Name = Capacity
Description =
Free space = 1319413953331 (1.2T)
Capacity = 13194139533312 (12T)
Drives = 8 x 2GB NL-SAS
Number of drives = 8
Unused drives = 0
RAID level = 6
System pool = yes
3: ID = SPL_3
Name = Extreme Performance
Description =
Free space = 209715200 (200M)
Capacity = 322122547200 (300G)
Drive type = EFD
Number of drives = 4
Unused drives = 0
RAID level = 5
System pool = yes
Retrieve the list of recommended disk groups for the selected pool
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/dg recom –pool SPL_3
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
1: ID = DG_4
Drive type = EFD
Drive size = 107374182400 (100G)
Number of drives = 4
Allowed numbers of drives = 4
Capacity = 419430400 (400G)
Extend the existing pool
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool –id SPL_3 extend –diskGroup DG_4 –drivesNumber 4
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
ID = SPL_3
Operation completed successfully.
The show action command
The show action command displays a list of objects that exist on the system and the attributes of those objects. You can specify an object qualifier to view the attributes for a single object. The show action command provides qualifiers for changing the display of the output, including the format and the attributes to include. The available output formats are name-value pair (NVP), table, and comma-separated values (CSV).
Format
uemcli [<switches>] <object> [<object qualifier>] show [{-detail | -brief | -filter <value>] [-output {nvp | table [-wrap] | csv}]Action qualifier
Qualifier
|
Description
|
---|---|
-output|-o
|
Specify the output format. Value is one of the following:
|
-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