mkextpool

Edit online

The mkextpool command creates a fixed block or count key data (CKD) storage type extent pool.

Read syntax diagramSkip visual syntax diagrammkextpool  -dev  storage_image_ID  -rankgrp  0  1  -stgtype  fb  ckd  -extentlimit  enable  disable  -limit  extent_limit_percentage -threshold  extent_threshold_percentage -opratiolimit  overprovisioning_ratio_limit -virextentlimit  enable  disable  -virlimit  virtual_extent_limit_percentage -virthreshold  virtual_extent_threshold_percentage -keygrp key_group_ID extent_pool_name  "-"

Parameters

Notes:
  1. The storage system assigns the ID during extent pool creation based on the current configuration, past configuration changes, and other internal considerations. No algorithm is available to accurately predict the newly created extent pool ID in every case.
  2. An extent pool object is assigned to either rank group 0 or 1. This order allows the extent pool to be managed by storage system server 0 or 1, respectively.
  3. Create extent pool objects before creating array and rank objects.
  4. Create extent pools of a given type for both rank groups 0 and 1. This method means that volumes that are assigned to a volume group can be spread across both rank groups 0 and 1.
-dev storage_image_ID
(Optional) The storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified key group ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image.

Using the -dev parameter temporarily overrides any defined value for devid for the current command.

-rankgrp 0 | 1
(Required) Assigns the extent pool to either rank group 0 or 1. Rank group 0 is managed by server 0, and rank group 1 is managed by server 1.
Note: If an extent pool does not exist, you can issue the chrank command after an extent pool is created to assign the rank to the extent pool. In addition, you can create extent pools of a given type for both rank groups 0 and 1. This method means that volumes that are assigned to a volume group might be spread across both rank groups 0 and 1.
-stgtype fb | ckd
(Required) The volume storage type that is contained by this extent pool.
-extentlimit enable | disable
(Optional) Specifies that the extent limit function is enabled or disabled. The default is disable.
-limit extent_limit_percentage
(Optional) The maximum value of the percentage of allocated real extents that are allowed in this extent pool. This value defaults to 100 if not specified.
-threshold extent_threshold_percentage
(Optional) The minimum threshold percentage of the real extents available. When the percentage of the currently available real extents is less than this minimum percentage, notifications are reported. The real extent status is reported as exceeded.
-opratiolimit overprovisioning_ratio_limit
(Optional) Specifies whether overprovisioning is allowed on the extent pool. The default value is 0 (unlimited overprovisioning allowed), whereas 1 specifies that no overprovisioning is allowed (with no assumed production impact resulting from reaching storage capacity limits on the system).
-virextentlimit enable | disable
(Optional) Specifies that the virtual extent limit function be enabled or disabled. The default is disable.
-virlimit virtual_extent_limit_percentage
(Optional) The maximum value of the percentage of allocated virtual extents that are allowed in this extent pool.
-virthreshold virtual_extent_threshold_percentage
(Optional) The minimum threshold percentage of the virtual extents available. When the percentage of the currently available virtual extents is less than this minimum percentage, notifications are sent and the virtual extent status is reported as exceeded.
-keygrp key_group_ID
(Optional) The encryption key group that is associated with the specified extent pool. The default is zero, which means that no key group is assigned to the extent pool.
extent_pool_name | -
(Required) Your extent pool name, which is limited to 16 characters.
If you use the dash (-), the specified value is read from standard input.
Note: You cannot use the dash (-) while you are in the DS CLI interactive command mode.

Example: Creating an FB extent pool

dscli> mkextpool -dev IBM.2107-75FA120 -rankgrp 0 -stgtype fb my_extpool
Output
Extent pool P2 successfully created.

Example: Creating an FB extent pool with a virtual extent limit

dscli> mkextpool -dev IBM.2107-75FA120 
-rankgrp 0 -stgtype fb -virextentlimit enable -virlimit 30 
-virthreshold 10 my_extpool -keygrp 1
Output
   Extent pool P2 successfully created.