This optional new feature will enable our customers to overcome a limitation of using NetApp storage with ESXi.
A NetApp storage device has a single, fixed IQN. An ESXi host can access a maximum of 256 LUNs (volumes). This limit extends to an ESXi cluster because hosts in the same cluster need to access the same volumes, for example, to perform vMotion of virtual machines. NetApp only allows a host to access the volumes of the NetApp igroup that the host is in.
By default, the Abiquo NetApp plugin works with only one igroup (by default AbiGroup). This feature enables you to use multiple igroups to restrict the number of volumes that are accessible to each ESXi host by organising the volumes into multiple igroups. By allowing ESXi hosts to only see the volumes they need to use, you can increase the total number of volumes available on the platform.
Abiquo recommends that you start using this feature with new hosts. For existing hosts, you will need to power off the virtual machines to perform an upgrade on both the hypervisor and Abiquo database to move existing LUNs out of the default igroup.
Before you add a host to Abiquo, add a line containing the machine's iSCSI name to an initiatorGroupName property line in the abiquo.properties file for the datacenter. This will identify the machine and the igroup it will belong to. See NetApp Storage Configuration for information about how to find or set the ESXi iSCSI name.
For example, if the host has initiatorIQN = iqn.1998-01.com.vmware:thunder05-1d72395a, add the part after the colon:
Add one line in the abiquo.properties file for each ESX host.
If there is no property defined for a host, Abiquo will use the default igroup (usually abiGroup), so Abiquo can keep adding KVM volumes into the default igroup.
In the following example, the 6 hosts are added to two igroups:
After a LUN is mapped to an igroup (making it visible to hosts), it is never removed, so, for example:
Even though igroupA no longer needs vol1, it is still visible and counting in the 256-LUN limit.
The workaround is to manually detach unused LUNs from the igroups. Abiquo will provide a script to do this that can be run periodically.
We will change two flows in the plugin:
The hypervisor -> igroup relation has not been added to the GUI, API or a hypervisor table in the database. This relation will be added in a future release including an igroup database column in the hypervisor database table. At this time, the abiquo.properties solution will be deprecated and it will be necessary to add the igroup information currently stored in abiquo.properties to the API and Database. Abiquo will support this upgrade.