diff --git a/doc/manual/en/modules/advanced.xml b/doc/manual/en/modules/advanced.xml index b92f5c53746..43a8dcfe443 100644 --- a/doc/manual/en/modules/advanced.xml +++ b/doc/manual/en/modules/advanced.xml @@ -2028,6 +2028,23 @@ On view change V: site master of LON. If the site master changes, messages will get relayed to a different node, which took over the role of the site master from the old (perhaps crashed) site master. + + Sometimes only certain members of a site should become site masters; e.g. the more powerful boxes + (as routing needs some additional CPU power), or multi-homed hosts which are connected to the external + network (over which the sites are connected with each other). + + + To do this, RELAY2 can generate special addresses which contain the knowledge about whether a member + should be skipped when selecting a site master from a view, or not. If can_become_site_master is + set to false in RELAY2, then the selection process will skip that member. However, if all members in + a given view are marked with can_become_site_master=false, then the first member of the view will + get picked. + + + When we have all members in a view marked with can_become_site_master=false, e.g. {B,C,D}, then B + is the site master. If we now start a member A with can_become_site_master=true, then B will stop + being the site master and A will become the new site master. +