Resizing a storage pool

Use the pool_resize command to resize a storage pool.


pool_resize pool=PoolName [ size=GB | < hard_size=GB soft_size=GB > ] 
[ snapshot_size=GB ]

Parameters

Name Type Description Mandatory Default
pool Object name Name of the storage pool to resize. Y N/A
size Positive integer New size of the storage pool (in gigabytes). Using this option specifies that the hard_size and the soft_size are identical. N N/A
hard_size Positive integer Hard size of the storage pool (actual physical capacity). N N/A
soft_size Positive integer Soft size of the storage pool (maximal size of capacity seen by the hosts, used for thin provisioning). N N/A
snapshot_
size
 Integer Sets a new value for the limit on snapshot capacity usage of the storage pool. N Leave unchanged.

The command can either increase or decrease the storage pool size.

The new size of the storage pool is specified as an integer multiple of 109 bytes, but the actual size of the created storage pool is rounded up to the nearest integer multiple of 16x230 bytes.

Capacity accounting is performed in respect to the free space.

You can either specify both hard_size and soft_size or to only specify size (which specifies that the hard_size and the soft_size are identical).

  • When increasing a storage pool size, the command succeeds only if the free space holds enough free capacity to allow such an increase in size.
  • When decreasing a storage pool size, the command succeeds only if the storage pool itself holds enough free capacity to allow such a reduction in size.
  • If the new size equals the current size, the command succeeds without changes to the storage pool.

This command fails if either the current storage pool's size (hard or soft) cannot be decreased or if free space (hard or soft) cannot be decreased.

Resizing a pool that stores asynchronous-mirrored volumes or consistency groups:
  • The pool's hard and soft size have to be identical.

Example: 

pool_resize pool=DBPool size=1300

Output: 

Command Executed Successfully.

Access control

User Category Permission
Storage administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Operations administrator Disallowed
Host side accelerator client Disallowed

Warnings

  • POOL_SNAPSHOT_SIZE_TOO_SMALL

    Snapshot size is very small. It will only allow snapshots of volumes which do no change. All other snapshots will be deleted immediately. Are you sure?

Return codes

  • POOL_DOES_NOT_EXIST

    Storage pool does not exist.

  • NO_SOFT_SPACE

    The system does not have enough free soft space for the requested storage pool soft size.

  • SOFT_SIZE_SMALLER_THAN_HARD_SIZE

    Soft size must be equal or larger than hard size.

  • HARD_SIZE_SMALLER_THAN_SNAPSHOT_SIZE

    Snapshot size must be equal or smaller than hard size.

  • POOL_SOFT_TOO_SMALL

    Requested soft size is smaller than the sum of sizes of volumes in the storage pool.

  • POOL_TOO_SMALL

    Storage pool usage exceeds requested size.

  • POOL_HARD_TOO_SMALL

    Storage pool usage exceeds requested hard size.

  • NO_SPACE

    The system does not have enough free space for the requested storage pool size.

  • NO_HARD_SPACE

    The system does not have enough free hard space for the requested storage pool hard size.

  • REACHED_POOL_MAX_HARD_CAPACITY

    Reached max pool hard capacity.

  • POOL_MUST_BE_THIN

    This pool has a golden snapshot and therefore must be thin provisioned.

  • OPERATION_DENIED_OBJECT_MANAGED

    This is a managed object. Only the managing software and xiv_maintenance / xiv_development may complete this operation on this object.

  • GROUPED_POOL_THIN_MUST_BE_THIN

    Thin pool must be thin provisioned.

  • NO_FREE_HARD_CAPACITY_IN_DOMAIN

    There is not enough free hard space in the domain.

  • NO_FREE_SOFT_CAPACITY_IN_DOMAIN

    There is not enough free soft space in the domain.

  • NO_FREE_CAPACITY_IN_DOMAIN

    There is not enough free space in the domain.