mkmdiskgrp
Use the mkmdiskgrp command to create a new storage pool.
Syntax
>>- mkmdiskgrp -- --+----------------------+-- -----------------> '- -pool -- pool_name -' >--+---------------------------------+--------------------------> '- -mdisk --+- mdisk_id_list ---+-' '- mdisk_name_list -' >--+---------------------------+-- -----------------------------> '- -tier --+- ssd --------+-' +- enterprise -+ '- nearline ---' >--+- -ext -- extent_size --------------------------------------------+--> '- -size -- mdiskgrp_size -- -parentmdiskgrp --+- mdiskgrp_id ---+-' '- mdiskgrp_name -' >--+----------------------------------------------------------------+--> '- -warning --+-disk_size---------------+--+-------------------+-' '-disk_size_percentage--%-' '- -unit --+- b --+-' +- kb -+ +- mb -+ +- gb -+ +- tb -+ '- pb -' >--+----------------------------+--+------------------------+-->< '- -easytier --+- auto ----+-' '- -owner -- owner_type -' +- on ------+ +- off -----+ '- measure -'
Parameters
- -name pool_name
- (Optional) Specifies a name to assign to the new pool.
- -mdisk mdisk_id_list | mdisk_name_list
- (Optional) Specifies a colon-separated list of managed disk IDs or names to add to the storage pool. You can create an empty storage pool by not specifying the -mdisk parameter.
- -tier ssd | enterprise | nearline
- (Optional) Specifies the tier of the MDisk or MDisks being added.
- ssd
- Specifies an SSD (or flash drive) hard disk drive or an external MDisk for the newly discovered or external volume.
- nearline
- Specifies an nearline hard disk drive or an external MDisk for the newly discovered or external volume.
- enterprise
- Specifies an enterprise hard disk drive or an external MDisk for the newly discovered or external volume.
If you do not specify a tier, the current tier value of the MDisk is retained. The default value for an external MDisk is enterprise.
- -ext extent_size
- (Required) Specifies the size of the extents for this group in MB. The ext parameter must have one of the following values: 16, 32, 64, 128, 256, 512, 1024, 2048, 4096, or 8192 (MB).
- -size mdiskgrp_size
- (Optional) Specifies the child pool capacity. The value must be a numeric value (and an integer multiple of the extent size).
- -parentmdiskgrp mdiskgrp_id | mdiskgrp_name
- (Optional) Specifies the parent pool from which the volume extents of the child pool are allocated when creating a child pool. The value must be an mdiskgrp_id or mdiskgrp_name.
- -warning disk_size | disk_size_percentage%
- (Optional) Generates a warning when the used disk capacity in the storage pool first exceeds the specified threshold. You can specify a disk_size integer, which defaults to megabytes (MB) unless the -unit parameter is specified; or you can specify a disk_size%, which is a percentage of the storage pool size. To disable warnings, specify 0 or 0%. The default value is 0.
- -unit b | kb | mb | gb | tb | pb
- (Optional) Specifies the data units for the -warning parameter.
- -easytier on | off | auto | measure
- (Optional) Specifies if the Easy Tier® function is
active for this storage pool, or if it is automatically determined. auto is the
default value. -easytier is active in storage pools with
multiple tiers and is balance with single tiers.Note:
- If -easytier is set to auto, the system automatically enables Easy Tier functions when the storage pool contains MDisk from more than one tier, and enables automatic rebalancing when the storage pool contains an MDisk from only one tier.
- If -easytier is set to on, then Easy Tier functions are active.
- If -easytier is set to off, then Easy Tier functions are inactive.
- If -easytier is set to measure Easy Tier statistics are collected but Easy Tier management is disabled. (No extents are moved by Easy Tier.)
auto equates to:- on if Easy Tier is licensed or no license is required
- off if Easy Tier is not licensed and a license is required
- Management of both single-tier and multi-tier pools
- Auto rebalance
- -owner owner_type
- (Optional) Specifies the owner type. The value must be vvol_child_pool.
Description
Parameter | Child pool usage | Storage pool usage |
---|---|---|
-name | Optional | Optional |
-mdisk | Cannot be used with child pools | Optional |
-tier | Cannot be used with child pools. | Optional |
-easytier | Cannot be used with child pools | Optional |
-size | Mandatory | Cannot be used with parent pools |
-parentmdiskgrp | Mandatory | Cannot be used with parent pools |
-ext | Cannot be used for child pools | Mandatory |
-unit | Optional | Optional |
-warning | Optional | Optional |
-encrypt | Optional | Optional for both parent pools and child pools |
The mkmdiskgrp command creates a new storage pool and assigns the storage pool name if specified. The ID of the new storage pool is returned if the command is successful. Storage pools are collections of managed disks. Each storage pool is divided into chunks, called extents, which are used to create volumes.
Optionally, you can specify a list of managed disks that will be added to this storage pool. These managed disks cannot belong to another storage pool, and they must have a mode of unmanaged. Use the lsmdiskcandidate command to get a list of suitable candidates. If -tier is specified, it will apply to all of the MDisks.
Each managed disk that is a member of this group is split into extents. The storage that is available on these disks is added to a pool of extents that is available in this group. When a volume is created from this group, free extents from the pool are used, in accordance with the policy used when the volume was first created.
All managed disks subsequently added to this group are split into extents of the same size as the size that is assigned to the group.
- 64 TB – if all storage pools have extent sizes of 16 MB.
- 2 PB – if all storage pools have extent sizes of 512 MB.
- 32 PB – if all storage pools have extent sizes of 8192 MB.
When specifying -name pool_name if you do not also specify -parentmdiskgrp, you create a parent pool where pool_name is the name of the new storage pool. When specifying -name pool_name, if you also specify -parentmdiskgrp and a size for it, you create a child pool where pool_name is the name of the new storage pool.
An invocation example
This example adds a list of MDisks to the storage pool.
mkmdiskgrp -mdisk mdisk0:mdisk1:mdisk2:mdisk3 -ext 32
The resulting output:
MDisk Group, id [0], successfully created
An invocation example
This example specifies tier and Easy Tier information when adding a list of MDisks to the storage pool.
mkmdiskgrp -mdisk mdisk13:mdisk16 -ext 512 -tier nearline -easytier measure
The resulting output:
MDisk Group, id [13], successfully created
An invocation example
This example creates a child pool from a parent pool.
mkmdiskgrp -size 100 -unit tb -parentmdiskgrp phypool
The resulting output:
MDisk Group, id [3], successfully created
An invocation example
This example creates a child pool from a parent pool and specifies an owner type.
mkmdiskgrp -parentmdiskgrp p0 -size 100 -unit gb -owner vvol_child_pool
The resulting output:
MDisk Group, id [3], successfully created