Revision c12adead
b/doc/design-resource-model.rst | ||
---|---|---|
702 | 702 |
At JSON level, since the object key has to be a string, the keys can be |
703 | 703 |
encoded via a separator (e.g. slash), or by having two dict levels. |
704 | 704 |
|
705 |
+--------+-------------+-------------------------+---------------------+------+ |
|
706 |
|Disk |Name |Description |Current status |Type | |
|
707 |
|template| | | | | |
|
708 |
+========+=============+=========================+=====================+======+ |
|
709 |
|plain |stripes |How many stripes to use |Configured at |int | |
|
710 |
| | |for newly created (plain)|./configure time, not| | |
|
711 |
| | |logical voumes |overridable at | | |
|
712 |
| | | |runtime | | |
|
713 |
+--------+-------------+-------------------------+---------------------+------+ |
|
714 |
|drbd |data-stripes |How many stripes to use |Same as for |int | |
|
715 |
| | |for data volumes |plain/stripes | | |
|
716 |
+--------+-------------+-------------------------+---------------------+------+ |
|
717 |
|drbd |metavg |Default volume group for |Same as the main |string| |
|
718 |
| | |the metadata LVs |volume group, | | |
|
719 |
| | | |overridable via | | |
|
720 |
| | | |'metavg' key | | |
|
721 |
+--------+-------------+-------------------------+---------------------+------+ |
|
722 |
|drbd |meta-stripes |How many stripes to use |Same as for lvm |int | |
|
723 |
| | |for meta volumes |'stripes', suboptimal| | |
|
724 |
| | | |as the meta LVs are | | |
|
725 |
| | | |small | | |
|
726 |
+--------+-------------+-------------------------+---------------------+------+ |
|
727 |
|drbd |disk-barriers|What kind of barriers to |Either all enabled or|string| |
|
728 |
| | |*disable* for disks; |all disabled, per | | |
|
729 |
| | |either "n" or a string |./configure time | | |
|
730 |
| | |containing a subset of |option | | |
|
731 |
| | |"bfd" | | | |
|
732 |
+--------+-------------+-------------------------+---------------------+------+ |
|
733 |
|drbd |meta-barriers|Whether to disable or not|Handled together with|bool | |
|
734 |
| | |the barriers for the meta|disk-barriers | | |
|
735 |
| | |volume | | | |
|
736 |
+--------+-------------+-------------------------+---------------------+------+ |
|
737 |
|drbd |resync-rate |The (static) resync rate |Hardcoded in |int | |
|
738 |
| | |for drbd, when using the |constants.py, not | | |
|
739 |
| | |static syncer, in MiB/s |changeable via Ganeti| | |
|
740 |
+--------+-------------+-------------------------+---------------------+------+ |
|
741 |
|drbd |disk-custom |Free-form string that |Not supported |string| |
|
742 |
| | |will be appended to the | | | |
|
743 |
| | |drbdsetup disk command | | | |
|
744 |
| | |line, for custom options | | | |
|
745 |
| | |not supported by Ganeti | | | |
|
746 |
| | |itself | | | |
|
747 |
+--------+-------------+-------------------------+---------------------+------+ |
|
748 |
|drbd |net-custom |Free-form string for |Not supported |string| |
|
749 |
| | |custom net setup options | | | |
|
750 |
+--------+-------------+-------------------------+---------------------+------+ |
|
751 |
|
|
752 |
Note that the DRBD parameters might change once Ganeti supports DRBD 8.4, in |
|
753 |
which the :command:`drbdsetup` syntax has changed significantly. |
|
754 |
Moreover, new parameters for the dynamic synchronization algorithm will |
|
755 |
be added for DRBD versions >= 8.3.9. |
|
705 |
When needed, the unit of measurement is expressed inside square |
|
706 |
brackets. |
|
707 |
|
|
708 |
+--------+--------------+-------------------------+---------------------+------+ |
|
709 |
|Disk |Name |Description |Current status |Type | |
|
710 |
|template| | | | | |
|
711 |
+========+==============+=========================+=====================+======+ |
|
712 |
|plain |stripes |How many stripes to use |Configured at |int | |
|
713 |
| | |for newly created (plain)|./configure time, not| | |
|
714 |
| | |logical voumes |overridable at | | |
|
715 |
| | | |runtime | | |
|
716 |
+--------+--------------+-------------------------+---------------------+------+ |
|
717 |
|drbd |data-stripes |How many stripes to use |Same as for |int | |
|
718 |
| | |for data volumes |plain/stripes | | |
|
719 |
+--------+--------------+-------------------------+---------------------+------+ |
|
720 |
|drbd |metavg |Default volume group for |Same as the main |string| |
|
721 |
| | |the metadata LVs |volume group, | | |
|
722 |
| | | |overridable via | | |
|
723 |
| | | |'metavg' key | | |
|
724 |
+--------+--------------+-------------------------+---------------------+------+ |
|
725 |
|drbd |meta-stripes |How many stripes to use |Same as for lvm |int | |
|
726 |
| | |for meta volumes |'stripes', suboptimal| | |
|
727 |
| | | |as the meta LVs are | | |
|
728 |
| | | |small | | |
|
729 |
+--------+--------------+-------------------------+---------------------+------+ |
|
730 |
|drbd |disk-barriers |What kind of barriers to |Either all enabled or|string| |
|
731 |
| | |*disable* for disks; |all disabled, per | | |
|
732 |
| | |either "n" or a string |./configure time | | |
|
733 |
| | |containing a subset of |option | | |
|
734 |
| | |"bfd" | | | |
|
735 |
+--------+--------------+-------------------------+---------------------+------+ |
|
736 |
|drbd |meta-barriers |Whether to disable or not|Handled together with|bool | |
|
737 |
| | |the barriers for the meta|disk-barriers | | |
|
738 |
| | |volume | | | |
|
739 |
+--------+--------------+-------------------------+---------------------+------+ |
|
740 |
|drbd |resync-rate |The (static) resync rate |Hardcoded in |int | |
|
741 |
| | |for drbd, when using the |constants.py, not | | |
|
742 |
| | |static syncer, in KiB/s |changeable via Ganeti| | |
|
743 |
+--------+--------------+-------------------------+---------------------+------+ |
|
744 |
|drbd |c-plan-ahead |Agility factor of the |Not supported. |int | |
|
745 |
| | |dynamic resync speed | | | |
|
746 |
| | |controller. (the higher, | | | |
|
747 |
| | |the slower the algorithm | | | |
|
748 |
| | |will adapt the resync | | | |
|
749 |
| | |speed). A value of 0 | | | |
|
750 |
| | |(that is the default) | | | |
|
751 |
| | |disables the controller | | | |
|
752 |
| | |[ds] | | | |
|
753 |
+--------+--------------+-------------------------+---------------------+------+ |
|
754 |
|drbd |c-fill-target |Maximum amount of |Not supported. |int | |
|
755 |
| | |in-flight resync data | | | |
|
756 |
| | |for the dynamic resync | | | |
|
757 |
| | |speed controller | | | |
|
758 |
| | |[sectors] | | | |
|
759 |
+--------+--------------+-------------------------+---------------------+------+ |
|
760 |
|drbd |c-delay-target|Maximum estimated peer |Not supported. |int | |
|
761 |
| | |response latency for the | | | |
|
762 |
| | |dynamic resync speed | | | |
|
763 |
| | |controller [ds] | | | |
|
764 |
+--------+--------------+-------------------------+---------------------+------+ |
|
765 |
|drbd |c-max-rate |Upper bound on resync |Not supported. |int | |
|
766 |
| | |speed for the dynamic | | | |
|
767 |
| | |resync speed controller | | | |
|
768 |
| | |[KiB/s] | | | |
|
769 |
+--------+--------------+-------------------------+---------------------+------+ |
|
770 |
|drbd |c-min-rate |Minimum resync speed for |Not supported. |int | |
|
771 |
| | |the dynamic resync speed | | | |
|
772 |
| | |controller [KiB/s] | | | |
|
773 |
+--------+--------------+-------------------------+---------------------+------+ |
|
774 |
|drbd |disk-custom |Free-form string that |Not supported |string| |
|
775 |
| | |will be appended to the | | | |
|
776 |
| | |drbdsetup disk command | | | |
|
777 |
| | |line, for custom options | | | |
|
778 |
| | |not supported by Ganeti | | | |
|
779 |
| | |itself | | | |
|
780 |
+--------+--------------+-------------------------+---------------------+------+ |
|
781 |
|drbd |net-custom |Free-form string for |Not supported |string| |
|
782 |
| | |custom net setup options | | | |
|
783 |
+--------+--------------+-------------------------+---------------------+------+ |
|
784 |
|
|
785 |
Currently Ganeti supports only DRBD 8.0.x, 8.2.x, 8.3.x. It will refuse |
|
786 |
to work with DRBD 8.4 since the :command:`drbdsetup` syntax has changed |
|
787 |
significantly. |
|
788 |
|
|
789 |
The barriers-related parameters have been introduced in different DRBD |
|
790 |
versions; please make sure that your version supports all the barrier |
|
791 |
parameters that you pass to Ganeti. Any version later than 8.3.0 |
|
792 |
implements all of them. |
|
793 |
|
|
794 |
The minimum DRBD version for using the dynamic resync speed controller |
|
795 |
is 8.3.9, since previous versions implement different parameters. |
|
796 |
|
|
797 |
A more detailed discussion of the dynamic resync speed controller |
|
798 |
parameters is outside the scope of the present document. Please refer to |
|
799 |
the ``drbdsetup`` man page |
|
800 |
(`8.3 <http://www.drbd.org/users-guide-8.3/re-drbdsetup.html>`_ and |
|
801 |
`8.4 <http://www.drbd.org/users-guide/re-drbdsetup.html>`_). An |
|
802 |
interesting discussion about them can also be found in a |
|
803 |
`drbd-user mailing list post |
|
804 |
<http://lists.linbit.com/pipermail/drbd-user/2011-August/016739.html>`_. |
|
756 | 805 |
|
757 | 806 |
All the above parameters are at cluster and node group level; as in |
758 | 807 |
other parts of the code, the intention is that all nodes in a node group |
Also available in: Unified diff