Page History

Introduction:

This document describes the multiple vlan range feature.
Presetntly in cloudstack we can only extend the vlan range but cannot add multiple non contiguous vlan ranges. This feature provides this flexibility to add multiple vlan ranges.

...

currently the api updatePhysicalNetwork has the vlan parameter this will be used to add a vlan range .
we will add the removevlan parameter. This will be used to remove as well as for deleting a vlan range.

vlan parameter will add a new vlan range to the existing vlan range (new behavior)all the vlan ranges specified and will also delete the vlans that are not specified if they are present in the db. if the new vlan range overlaps the existing vlan range it will extend that vlan (This is the existing behavior.).
removevlan parameter will remove the mentioned vlan. The removevlan and vlan parameters can be used together. If the vlan range we are trying to remove is in use, the operation will not succeed. In other words the user needs to specify all the vlans that he wants to keep.

The changes will be atomic.
before removing any range we need to check if any of the vlans in the range are in use. The operation will fail if some vlans in the remove range are in use.
i.e. if E=100-200 (existing) U(used)=101,121,131
and remove=100-201 we do not remove this range as 101,121, and 131 are being used.
if the admin wants to remove the reset of the range leaving the used ones he can say
remove 100-100, 102-120, etc

...