1. INFINIDAT Support
2. InfiniShell
3. InfiniBox Commands

Pool commands

Grant pool provisioning privileges to a pool administrator.

pool.add_admin pool=POOL user=POOLADMIN[,POOLADMIN,...]

Name of an existing local user or ldap group, with PoolAdmin role (multiple values, separated by commas)

Name of an existing pool

pool.add_admin name=pool1 admin=pool-admin-may-17

Granted provisioning privileges on pool pool1 to pool admins: local user pool-admin-may-17

Assign pool to policy.

pool.assign_qos pool=POOL[,POOL,...] policy=QOSPOOLVOLUMESPOLICY

QoS policy

Name of an existing pool (multiple values, separated by commas)

pool.assign_qos pool=p1 policy=q3

Pool 'p1' was assigned to policy 'q3'

Create a new pool.

Set the pool physical capacity, virtual capacity and emergency buffer. The emergency buffer determines whether the pool is allowed to extend without limitation, to extend within a predefined limitation, or not allowed to extend at all. The pool will extend into the emergency buffer once it passes its physical size. Then, the pool enters a Limited state where no new volumes can be created, but the existing volumes can be written into. If the pool can no longer expand, it enters a Locked state and its entities can no longer accept writes. When the pool is locked, no entity can be created and volumes cannot be resized. Release the Locked state (unlock the pool) using the pool.unlock command.

pool.create name=NAME physical_capacity=SIZE [virtual_capacity=SIZE] [emergency_buffer={UNLIMITED|DISABLED|SIZE}] [ssd_cache=YES|NO|Y|N] [compression=YES|NO|Y|N] [type=STANDARD|VVOL]

pool.create name=pool1 physical_capacity=20t

Creating an overprovisioned pool.

• The specific attributes that are relevant to the pool's physical and virtual capacity are visible through the pool.query command.

Delete pool.

Prior to the deletion of the pool, it has to be emptied.

• All of its entities - volumes, filesystems and their snapshots - need to be moved to other pools.

pool.delete pool=POOL[,POOL,...]

Name of an existing pool (multiple values separated by commas)

pool.delete name=pool1

Pool pool1 deleted

Lock pool, revoking write access to its volumes.

When the pool is locked, no entity can be created and volumes cannot be resized. Release the Locked state (unlock the pool) using the pool.unlock command

pool.lock pool=POOL

Name of an existing pool 

pool.lock name=pool1

Pool pool1 Locked

List existing pools.

Run the command with no arguments in order to list all of the pools on the InfiniBox. Run the command with a pool name as an input, in order to list only this pool.
Run the command with names of several pools, separated with a comma and no space, in order to list these pools. Entering a name of a pool
that does not exist fails the command even if other names are entered correctly. Use the unit argument to specify the units of the capacity fields of the output. 

pool.query [pool=POOL[,POOL,...]] [unit=CAPACITYUNIT] 

NAME   STATE   PHYSICAL  PHYSICAL  VIRTUAL  VIRTUAL    EMERGENCY COMPRESSED  DATA
               TOTAL     ALLOCATED TOTAL    ALLOCATED  BUFFER                REDUCTION

pool1  NORMAL  3.23 TB   1.97 TB   3.23 TB  1.97 TB    DISABLED  yes         1.00:1 

To set the capacity units, run the command with the unit argument. 

NAME   STATE   PHYSICAL           PHYSICAL           VIRTUAL            VIRTUAL  
               TOTAL              ALLOCATED TOTAL    TOTAL              ALLOCATED 
  EMERGENCY COMPRESSED DATA
  BUFFER               REDUCTION

pool-1 NORMAL  6314441472 blocks  3848399360 blocks  6314441472 blocks  3848399360 blocks 
  DISABLED  yes        1.00:1 

NAME  VOLUMES     FILESYSTEMS 
      QoS POLICY  QoS POLICY

p1    q3          q4   

Revoke pool provisioning privileges from a pool administrator.

pool.remove_admin pool=POOL user=POOLADMIN[,POOLADMIN,...]

Name of an existing local user or ldap group, with PoolAdmin role (multiple values, separated by commas)

Name of an existing pool 

pool.remove_admin name=pool1 admin=pool-admin-may-17

Revoked provisioning privileges on pool pool1 from pool admins: local user pool-admin-may-17

Rename pool.

pool.rename pool=POOL new_name=NAME

A maximum of 65 Latin characters, numbers, spaces, and the following symbols: "^&'@()[]$=!-#{}%.+~_" (excluding quotation marks). Leading and trailing whitespace characters are stripped.

Name of an existing pool 

pool.rename name=pool1 new_name=pool2

Pool pool1 renamed to pool2

Resize pool.

Change the pool physical capacity, virtual capacity or emergency buffer. See the documentation of pool.create for the way the emergency buffer can be configured.

pool.resize pool=POOL [physical_capacity=SIZEDELTA] [virtual_capacity=SIZEDELTA] [emergency_buffer={UNLIMITED|DISABLED|SIZE}]

A maximum of 65 Latin characters, numbers, spaces, and the following symbols: "^&'@()[]$=!-#{}%.+~_" (excluding quotation marks). Leading and trailing whitespace characters are stripped.

Name of an existing pool 

Resizing the pool's physical capacity.

pool.resize name=pool1 physical_capacity=2t

pool.set_compression pool=POOL compression=YESNO

Name of an existing pool 

Either yes or no

Set the pool to compress its capacity.

pool.set_compression name=p1 compression=yes

Set pool capacity notification thresholds.

Set the InfiniBox to issue events whenever the pool exceeds a capacity threshold. You may set two thresholds for each pool: Warning and Critical. The size of the Warning threshold cannot exceed the size of the Critical threshold.

pool.set_thresholds pool=POOL warning=PERCENT critical=PERCENT

An integer between 0 and 100, optionally followed by a percent symbol

Name of an existing pool 

pool.set_thresholds name=pool1 warning=70% critical=80%

Pool pool1 updated

Remove pool from policy. 

pool.unassign_qos pool=POOL [policy=QOSPOOLVOLUMESPOLICY]

QoS policy

Name of an existing pool 

pool.unassign_qos pool=p1

Pool 'p1' was unassigned from policies 'q4', 'q3'

Unlock pool, granting write access to its volumes.

pool.unlock pool=POOL

Name of an existing pool 

pool.unlock name=pool1

Pool pool1 unlocked

List existing pools with respective administrators.

pool.user_query [pool=POOL]

Name of an existing pool 

pool.user_query

NAME  ADMINS
pool1  admin.pooladmin_1
pool2  admin.pooladmin_2