chmdiskgrp
Use the chmdiskgrp command to modify properties of an existing storage pool.
Syntax
Parameters
- -name new_name_arg
- (Optional) Specifies the new name of the storage pool.
- -warning disk_size | disk_size_percentage %
- (Optional) Sets a threshold at which a warning is generated. The warning is generated the first time that the threshold is exceeded by the used-disk capacity in the storage pool. 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_percentage %, which is a percentage of the storage pool size. To disable warnings, specify 0 or 0%. This parameter is not applicable for data reduction child pools.
- -size new_size
- (Optional) Specifies the new size of a child pool. This parameter is not applicable for
data reduction child pools.Note: This parameter cannot be used with parent pools. Use addmdisk or rmmdisk to change storage pool capacity.
- -unit b | kb | mb | gb | tb | pb
- (Optional) Specifies the data units for the -warning parameter.
- -vdiskprotectionenabled yes | no
- (Optional) Specifies whether volume protection in enabled for this storage pool.
- -easytier auto | on | off | measure
- (Optional) Specifies whether the Easy Tier®
function is on or off for this storage pool, or if it is automatically determined.
-easytier is
activein storage pools with multiple tiers and isbalancewith single tiers.Note: -easytier must be followed by one of the following:- If -easytier is set to auto, system automatically enables Easy Tier functions when the storage pool contains MDisks from more than one tier, and enables automatic rebalancing when the storage pool contains MDisks 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.
-easytier onenables Easy Tier:- Management of both single-tier and multi-tier pools
- Auto rebalance
- -provisioningpolicy policy_id | policy_name
- (Optional) The name or ID of the provisioning policy that the pool uses to manage capacity savings for volumes in the pool.
- -noprovisioningpolicy
- (Optional) If specified, the provisioning policy is removed from the pool.
- -ownershipgroup owner_id | owner_name
- (Optional) The name or ID of the ownership group to which the object is being added. This parameter can be specified on child pools only.
- -noownershipgroup
- (Optional) If specified, the object is removed from the ownership group to which it belongs. This parameter can be specified on child pools only.
- mdisk_group_id | mdisk_group_name
- (Required) Specifies the ID or name of the storage pool to modify.
- -etfcmoverallocationmax percentage | off
- (Optional) Sets the maximum over allocation which Easy Tier can migrate onto FlashCore Module arrays, when the array is used as the top tier in a multitier pool. The value acts as a multiplier of the physically available space. The allowed values are a percentage in the range of 100% (default) to 400% or off. Setting the value to off disables this feature.
- -replicationpoollinkuid replication_pool_link_uid
- (Optional) Specifies the new replication pool link unique identifier (UID) value to assign to the pool. Pools are linked between partnered systems, for use with policy-based replication, when the same pool link UID value is assigned to the pools on each system.
- -movepoollink
- (Optional) Specifies that the replication pool link UID value, specified with the -replicationpoollinkuid parameter, is to be moved from an existing pool to the specified pool. This parameter is required to move an existing pool link to a different pool. The pool that is currently linked gets unlinked and the specified pool is linked.
- -resetreplicationpoollinkuid
- (Optional) If specified, the existing replication pool link UID for the pool is reset and a new pool link UID value is generated. This action removes any links that exist between the local pool and pools on partnered systems.
Description
Specifies the ID or name of the storage pool to Parameter |
Child pool usage | Storage pool usage |
|---|---|---|
| -name | Optional | Optional |
| -easytier | Cannot be used with child pools | Optional |
| -size | Optional | Cannot be used with parent pools |
| -unit | Optional | Optional |
| -warning | Optional | Optional |
This command modifies the name, or label, assigned to a given storage pool. You can use the new name to refer to the storage pool.
The command can also be used to set the warning threshold for the storage pool. The warning threshold is the threshold which a warning is generated when it is exceeded by the used-disk capacity in the storage pool.
You can also use this command to change other settings for parent pools and child pools.
Note: Only a user with the Security Admin or superuser role is allowed to use
the -size parameter to shrink the space of a Safeguarded backup location. If
the specified pool is a Safeguarded backup location, -ownershipgroup parameter
is not allowed.
An invocation example
chmdiskgrp -name testmdiskgrp -easytier on Group0The resulting output:
No feedback