About 

To provision storage to the host, create a volume on a specific capacity pool and map it to the host.  

• Volumes can be provisioned using either Host PowerTools CLI or GUI. 
• You can map an existing volume, or create a new one.

InfiniBox pools

InfiniBox pools are virtual buckets for organizing the storage workload. Every volume, snapshot, and clone resides in a pool. The storage administrator defines each pool’s physical capacity (portion of the physical system capacity available for writes by the pool) and virtual capacity (soft limit on the total size of all volumes in the pool). The storage administrator can update a pool’s physical and virtual capacity, as well as move volumes between pools at any time.  Pool membership is pure metadata and does not affect data placement.

Creating pools on InfiniBox

Make sure that the InfiniBox user that is used with Host PowerTools has access to at least one pool with available capacity. 

Storage provisioning related attributes 

Determine the following attributes before provisioning storage:

• Size – the size of the volume.
  • For example, 10TB, 10GiB.
  • The minimum size is 1GB.
  • This attribute is required.
• Name – the name of the volume. 
  • If not specified, a name is automatically generated by Host PowerTools.
• Filesystem – the filesystem to be created over the volume.
  • If a value for this field is not provided, and "--no-filesystem" is not specified, a new filesystem is created by InfiniHost.
• Mount - an existing directory on which to mount the filesystem.
  • If a value for this field is not provided, and "--no-mount" is not specified, a mount point is selected by InfiniHost.
• Thin – the volume can be set to be thin provisioned.
• Pool – the pool that the volume belongs to.
• System – the InfiniBox system on which the volume is to be created.
  • This field is not required if the host is connected to only a single system.
• No filesystem – specify this if you do not want to create a filesystem for this volume.
• No mount – specify this if you do not want to mount this volume.
• Yes – Run the command without a preview. See below.

Viewing pools 

Type in the command line:

infinihost pool list

A list of the InfiniBox pools is displayed:

root@host-ci079 (Ubuntu 14.04) ➜  ~  infinihost pool list                                                    17-07-18 11:00
System      Pool       Physical Capacity (GB)    Virtual Capacity (GB)    Physical Free (GB)    Virtual Free (GB)    Volumes
box-ci05    first                       50.00                    50.00                 48.97                47.93          2
box-ci22    pool1                       77.00                    77.00                 74.00                74.00          3

Provisioning using the Host PowerTools CLI

Command syntax:

infinihost volume provision 
<size> 
[--yes] 
[--name=NAME] 
[--filesystem=FS] 
[--mount=PATH] 
[--thin=THIN] 
[--pool=POOL] 
[--system=SYSTEM] 
[--no-filesystem] 
[--no-mount]

Previewing the command prior to execution

Example

infinihost volume provision 10GB --pool=REST-pool

Output

When this command is run, Host PowerTools will:
* Create a thin 10 GB volume named "prod-linux1-vol-20140702-1335" on InfiniBox 1032.
* Map the new volume to this host on the next available LUN.
* Create an ext3 filesystem on this volume.
* Mount this filesystem to /mnt/prod-linux1-vol-20140702-1335.
* On the host, name this filesystem 'prod-linux1-vol-'. 

To perform these actions, add --yes to this command, and run it again.

Notes

• In this example, the InfiniBox named in the output is the only InfiniBox that is connected to the host, and so it was not included in the command.
• The filesystem and mount point were not included in the command, and so were selected by InfiniHost.

Running the command with no preview

Syntax

infinihost volume provision 10GB --pool=REST-pool --yes

Output

Creating the new 10 GB volume "prod-linux1-vol-20140702-1336" ... OK
Waiting for volume discovery, this might take a while ... OK
Creating filesystem ... OK
Mounting filesystem ... OK
==================================================================== 
All done.
The volume prod-linux1-vol-20140702-1336 is represented by dm-2, and it is mounted to /mnt/prod-linux1-vol-20140702-1336.

Running the command with no filesystem and no mount

Syntax

infinihost volume provision 10GB --pool=REST-pool --no-filesystem --no-mount --yes

Output

Creating the new 10 GB volume "prod-linux1-vol-20140702-1357" ... OK
Waiting for volume discovery, this might take a while ... OK
====================================================================
All done.
The volume prod-linux1-vol-20140702-1357 is represented by dm-4.

Provisioning using the Host PowerTools GUI

1. Open the Host PowerTools GUI.
2. If more than one InfiniBox system is connected, select the desired system.
3. Click the Create button.
   The Create Volume window opens.
   
   
4. Define the volume settings:
   
   • You can change the defaults volume name suggested by the Host PowerTools.
   • Set the volume size.
   • Select the pool.
     Note that the Pool Capacity indicator displays the relevant information for the selected pool.
   • Check the box If you want to create a file system.
     Then select the file system type and allocation unit size.
   • Check the box If you want to select a mount path.
     Then enter the path name.
5. Click Continue.
   An informative message specifies the volume’s details.
6. Click Start.
   The volume is created.
7. Click Done.
   The volume is available in the Volumes window.

Viewing the volumes

The Host PowerTools GUI displays the InfiniBox systems that the host is connected to.

• A list of volumes that are mapped to the host is available for each connected system.

Mapping an existing volume

Host PowerTools also allows mapping an existing volumes to the host. 

Using the CLI

Run the command with the following argument:

• Volume name

infinihost volume map vol-1 /mnt --yes

Output example:

Volume "vol-1" (id 82255) successfully mapped

To view the volume:

infinihost volume list

Using the GUI

1. Open the Host PowerTools GUI.
2. If more than one InfiniBox system is connected, select the desired system.
3. Click the Map button.
   The Map Volume window displays the system's volumes.
4. Select a volume, using either of the following methods:
   • Search
   • Browse
5. Select whether to include clones.
6. Click Done.

The volume is mapped and is visible in the Volumes table.

Volume tasks

The available tasks for each volume are listed under More Options icon at the right side of each volume in the Volumes table.

• For a description of each of the tasks, see: Volume related tasks