Revision 4573511a docs/admin-guide.rst
b/docs/admin-guide.rst | ||
---|---|---|
690 | 690 |
* One Bridge corresponding to one physical VLAN which is required for networks of |
691 | 691 |
type `PRIVATE_MAC_PREFIX`. |
692 | 692 |
|
693 |
Cyclades allocates those resources from pools that are created by the |
|
694 |
administrator with the `snf-manage pool-create` management command. |
|
693 |
IPv4 addresses |
|
694 |
************** |
|
695 |
|
|
696 |
An allocation pool of IPv4 addresses is automatically created for every network |
|
697 |
that has the attribute `dhcp` set to True. The allocation pool contains the |
|
698 |
range of IP addresses that are included in the subnet. The gateway and the |
|
699 |
broadcast address of the network are excluded from the allocation pool. The |
|
700 |
admin can externally reserve IP addresses to exclude them from automatic |
|
701 |
allocation with the `--add-reserved-ips` option of `snf-manage network-modify` |
|
702 |
command. For example the following command will reserve two IP addresses |
|
703 |
from network with ID `42`: |
|
695 | 704 |
|
696 |
Pool Creation |
|
697 |
````````````` |
|
698 |
Pools are created using the `snf-manage pool-create` command: |
|
705 |
.. code-block:: console |
|
706 |
|
|
707 |
snf-manage network-modify --add-reserved-ips=10.0.0.21,10.0.0.22 42 |
|
708 |
|
|
709 |
.. warning:: Externally reserving IP addresses is also available at the Ganeti. |
|
710 |
However, when using Cyclades with multiple Ganeti backends, the handling of |
|
711 |
IP pools must be performed from Cyclades! |
|
712 |
|
|
713 |
Bridges |
|
714 |
******* |
|
715 |
|
|
716 |
As already mentioned Cyclades use a pool of Bridges that must correspond |
|
717 |
to Physical VLAN at the Ganeti level. A bridge from the pool is assigned to |
|
718 |
each network of flavor `PHYSICAL_VLAN`. Creation of this pool is done |
|
719 |
using `snf-manage pool-create` command. For example the following command |
|
720 |
will create a pool containing the brdiges from `prv1` to `prv21`. |
|
699 | 721 |
|
700 | 722 |
.. code-block:: console |
701 | 723 |
|
702 | 724 |
# snf-manage pool-create --type=bridge --base=prv --size=20 |
703 | 725 |
|
704 |
will create a pool of bridges, containing bridges prv1, prv2,..prv21. |
|
705 |
|
|
706 | 726 |
You can verify the creation of the pool, and check its contents by running: |
707 | 727 |
|
708 | 728 |
.. code-block:: console |
... | ... | |
710 | 730 |
# snf-manage pool-list |
711 | 731 |
# snf-manage pool-show --type=bridge 1 |
712 | 732 |
|
713 |
With the same commands you can handle a pool of MAC prefixes. For example: |
|
733 |
Finally you can use the `pool-modify` management command in order to externally |
|
734 |
reserve the values from pool, extend or shrink the pool if possible. |
|
735 |
|
|
736 |
MAC Prefixes |
|
737 |
************ |
|
738 |
|
|
739 |
Cyclades also use a pool of MAC prefixes to assign to networks of flavor |
|
740 |
`MAC_FILTERED`. Handling of this pool is done exactly as with pool of bridges, |
|
741 |
except that the type option must be set to mac-prefix: |
|
714 | 742 |
|
715 | 743 |
.. code-block:: console |
716 | 744 |
|
717 | 745 |
# snf-manage pool-create --type=mac-prefix --base=aa:00:0 --size=65536 |
718 | 746 |
|
719 |
will create a pool of MAC prefixes from ``aa:00:1`` to ``b9:ff:f``. The MAC |
|
720 |
prefix pool is responsible for providing only unicast and locally administered |
|
721 |
MAC addresses, so many of these prefixes will be externally reserved, to |
|
722 |
exclude from allocation. |
|
747 |
The above command will create a pool of MAC prefixes from ``aa:00:1`` to |
|
748 |
``b9:ff:f``. The MAC prefix pool is responsible for providing only unicast and |
|
749 |
locally administered MAC addresses, so many of these prefixes will be |
|
750 |
externally reserved, to exclude from allocation. |
|
751 |
|
|
752 |
Pool reconciliation |
|
753 |
******************* |
|
754 |
|
|
755 |
The management command `snf-manage reconcile-pools` can be used that all the |
|
756 |
above mentioned pools are consistent and that all values that come from the |
|
757 |
pool are not used more than once. |
|
723 | 758 |
|
724 | 759 |
|
725 | 760 |
Cyclades advanced operations |
Also available in: Unified diff