Creating storage pools

Use the pool_create command to create a storage pool.


pool_create pool=PoolName < size=GB | < hard_size=GB soft_size=GB > > 
snapshot_size=GB [ lock_behavior=<read_only|no_io> ] [ perf_class=perfClassName ] [ domain=DomainName ]

Parameters

Name Type Description Mandatory Default
pool Object name Name of the storage pool. Y N/A
size Positive integer Size of the storage pool (in gigabytes). 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. Soft_size cannot be less than hard_size. N N/A
snapshot_
size
 Positive integer Space allocated for snapshots. Y N/A
lock_
behavior
 Enumeration Sets whether and how the pool is locked upon space depletion. N read_only
perf_class Object name Name of the performance class pool. N No performance class
domain Object name Add the pool to the given domain. N none

This command creates a storage pool. The name of the storage pool must be unique in the system. Upon creation, the storage pool is initially empty and does not contain volumes.

The 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. The Size parameter is used when hard size and soft size are identical (no thin provisioning). If only the size is specified, then hard_size and soft_size are identical to the size. Otherwise, a storage pool with thin provisioning is created.

The created pool has the following values:
  • create_last_consistent_snapshot=yes - meaning the volumes of this pool can be mirrored.
  • protected_snapshot_priority=2 - managing the way last_consistent snapshot are preserved.

When a storage pool is defined, the new storage pool's capacity is reduced from the system's free space (hard and soft). This operation fails if the system hard or soft free space does not have free capacity of at least the size of the new storage pool. The sum of the capacities of all the storage pools in the system, together with the free space, is always equal to the entire system capacity available for the user.

The system allows for the assignment of the entire available capacity to user created storage pools, while leaving the free space at zero size.

Both hard and soft sizes are subtracted from the free hard/soft space.

For thin provisioned storage pools, the lock_behavior parameter sets whether and how the pool is locked upon space depletion. The pool can be locked for write, or for both read and write.

Example: 

pool_create pool=DBPool size=1000

Output: 

Command completed 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_NAME_EXISTS

    Storage pool name already assigned to another storage pool.

  • PERF_CLASS_BAD_NAME

    Performance class does not exist.

  • MAX_POOLS_REACHED

    Maximum number of storage pools is already defined.

  • NO_HARD_SPACE

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

  • NO_SOFT_SPACE

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

  • NO_SPACE

    The system does not have enough free space for the requested storage pool 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.

  • REACHED_POOL_MAX_HARD_CAPACITY

    Reached max pool hard capacity.

  • DOMAIN_DOESNT_EXIST

    Domain does not exist.

  • USER_ASSOCIATED_TO_MORE_THAN_ONE_DOMAIN

    As the user that runs this command is attached to more than one domain, it is not clear in which domain the pool is created. Run the command again and specify a domain.

  • 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.

  • DOMAIN_MAX_POOLS_REACHED

    The maximum number of domain pools was reached.

  • PERF_CLASS_ASSOCIATED_WITH_HOSTS

    Performance class Performance Class is already in use by host.