From 46e9e6f4e7ea5341ed7ca4456171eb039b5eeb55 Mon Sep 17 00:00:00 2001 From: MassimilianoPinto Date: Wed, 18 Jan 2017 09:46:20 +0100 Subject: [PATCH] MXS-406: documentation update for Galera monitor The galera monitor has a new option: set_donor_nodes --- Documentation/Monitors/Galera-Monitor.md | 26 ++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/Documentation/Monitors/Galera-Monitor.md b/Documentation/Monitors/Galera-Monitor.md index dbaa73873..7d1c22142 100644 --- a/Documentation/Monitors/Galera-Monitor.md +++ b/Documentation/Monitors/Galera-Monitor.md @@ -76,6 +76,32 @@ If the `root_node_as_master` option is disabled for galeramon, the node with the lowest index will always be chosen as the master. If it is enabled, only the node with a a _wsrep_local_index_ value of 0 can be chosed as the master. +### `set_donor_nodes` + +This option controls whether the global variable _wsrep_sst_donor_ should be set +in each cluster node with _slave' status_. +The variable contains a list of slave servers, automatically sorted, with +possible master candidates at its end. + +The sorting is based either on _wsrep_local_index_ or node server _priority_ +depending on the value of _use_priority_ option. +If no server has _priority_ defined the sorting switches to _wsrep_local_index_. +Node names are collected by fetching the result of the variable _wsrep_node_name_. + +Example of variable being set in all slave nodes, assuming three nodes: +``` +SET GLOBAL wsrep_sst_donor = "galera001,galera000" +``` + +**Note**: +in order to set the global variable _wsrep_sst_donor_, proper privileges are +required for the monitor user that connects to cluster nodes. +This option is disabled by default and was introduced in MaxScale 2.1.0. + +``` +set_donor_nodes=true +``` + ## Interaction with Server Priorities If the `use_priority` option is set and a server is configured with the