mirror of
https://github.com/MariaDB/server.git
synced 2025-01-16 12:02:42 +01:00
89fb295b1b
Some users and some scripts (for example, mysqld_multi.sh) use special option groups with names like [mysqld1], [mysqld2], ..., [mysqldN]. But SST scripts can't currently fully support these option groups. The only option group-related value it gets from the server is --defaults-group-suffix, if that option was set for mysqld when the server was started. However, the SST scripts does not get told by the server to read these option groups, so this means that the SST script will fail to read options like innodb-data-home-dir when it is in a option group like [mysqld1]...[mysqldN]. Moreover, SST scripts ignore many parameters that can be passed to them explicitly and cannot transfer them further, for example, to the input of mariabackup utility. Ideally, we want to transfer all the parameters of the original mysqld call to utilities such as mariabackup, however the SST script does not receive these parameters from the server and therefore cannot transfer them to mariabackup. To correct these shortcomings, we need to transfer to the scripts all of the parameters of the original mysqld call, and in the SST scripts themselves provide for the transfer all of these parameters to utilities such as mariabackup. To prevent these parameters from mixing with the script's own parameters, they should be transferred to SST script after the special option "--mysqld-args", followed by the string argument with the original parameters, as it received by the mysqld call at the time of launch (further all these parameters will be passed to mariabackup, for example). In addition, the SST scripts themselves must be refined so that they can read the parameters from the user-selected group, not just from the global mysqld configuration group. And also so that they can receive the parameters (which important for their work) as command-line arguments.
106 lines
3.8 KiB
C++
106 lines
3.8 KiB
C++
/* Copyright (C) 2013-2018 Codership Oy <info@codership.com>
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; version 2 of the License.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License along
|
|
with this program; if not, write to the Free Software Foundation, Inc.,
|
|
51 Franklin Street, Fifth Floor, Boston, MA 02110-1335 USA. */
|
|
|
|
#ifndef WSREP_SST_H
|
|
#define WSREP_SST_H
|
|
|
|
#include <my_config.h>
|
|
|
|
#include "wsrep/gtid.hpp"
|
|
#include <my_global.h>
|
|
#include <string>
|
|
|
|
#define WSREP_SST_OPT_ROLE "--role"
|
|
#define WSREP_SST_OPT_ADDR "--address"
|
|
#define WSREP_SST_OPT_AUTH "--auth"
|
|
#define WSREP_SST_OPT_DATA "--datadir"
|
|
#define WSREP_SST_OPT_CONF "--defaults-file"
|
|
#define WSREP_SST_OPT_CONF_SUFFIX "--defaults-group-suffix"
|
|
#define WSREP_SST_OPT_CONF_EXTRA "--defaults-extra-file"
|
|
#define WSREP_SST_OPT_PARENT "--parent"
|
|
#define WSREP_SST_OPT_BINLOG "--binlog"
|
|
#define WSREP_SST_OPT_BINLOG_INDEX "--binlog-index"
|
|
#define WSREP_SST_OPT_MYSQLD "--mysqld-args"
|
|
|
|
// mysqldump-specific options
|
|
#define WSREP_SST_OPT_USER "--user"
|
|
#define WSREP_SST_OPT_PSWD "--password"
|
|
#define WSREP_SST_OPT_HOST "--host"
|
|
#define WSREP_SST_OPT_PORT "--port"
|
|
#define WSREP_SST_OPT_LPORT "--local-port"
|
|
|
|
// donor-specific
|
|
#define WSREP_SST_OPT_SOCKET "--socket"
|
|
#define WSREP_SST_OPT_GTID "--gtid"
|
|
#define WSREP_SST_OPT_BYPASS "--bypass"
|
|
#define WSREP_SST_OPT_GTID_DOMAIN_ID "--gtid-domain-id"
|
|
|
|
#define WSREP_SST_MYSQLDUMP "mysqldump"
|
|
#define WSREP_SST_RSYNC "rsync"
|
|
#define WSREP_SST_SKIP "skip"
|
|
#define WSREP_SST_MARIABACKUP "mariabackup"
|
|
#define WSREP_SST_XTRABACKUP "xtrabackup"
|
|
#define WSREP_SST_XTRABACKUPV2 "xtrabackupv2"
|
|
#define WSREP_SST_DEFAULT WSREP_SST_RSYNC
|
|
#define WSREP_SST_ADDRESS_AUTO "AUTO"
|
|
#define WSREP_SST_AUTH_MASK "********"
|
|
|
|
/* system variables */
|
|
extern const char* wsrep_sst_method;
|
|
extern const char* wsrep_sst_receive_address;
|
|
extern const char* wsrep_sst_donor;
|
|
extern const char* wsrep_sst_auth;
|
|
extern my_bool wsrep_sst_donor_rejects_queries;
|
|
|
|
/*! Synchronizes applier thread start with init thread */
|
|
extern void wsrep_sst_grab();
|
|
/*! Init thread waits for SST completion */
|
|
extern bool wsrep_sst_wait();
|
|
/*! Signals wsrep that initialization is complete, writesets can be applied */
|
|
extern bool wsrep_sst_continue();
|
|
extern void wsrep_sst_auth_init();
|
|
extern void wsrep_sst_auth_free();
|
|
|
|
extern void wsrep_SE_init_grab(); /*! grab init critical section */
|
|
extern void wsrep_SE_init_wait(); /*! wait for SE init to complete */
|
|
extern void wsrep_SE_init_done(); /*! signal that SE init is complte */
|
|
extern void wsrep_SE_initialized(); /*! mark SE initialization complete */
|
|
|
|
/**
|
|
Return a string containing the state transfer request string.
|
|
Note that the string may contain a '\0' in the middle.
|
|
*/
|
|
std::string wsrep_sst_prepare();
|
|
|
|
/**
|
|
Donate a SST.
|
|
|
|
@param request SST request string received from the joiner. Note that
|
|
the string may contain a '\0' in the middle.
|
|
@param gtid Current position of the donor
|
|
@param bypass If true, full SST is not needed. Joiner needs to be
|
|
notified that it can continue starting from gtid.
|
|
*/
|
|
int wsrep_sst_donate(const std::string& request,
|
|
const wsrep::gtid& gtid,
|
|
bool bypass);
|
|
|
|
#else
|
|
#define wsrep_SE_initialized() do { } while(0)
|
|
#define wsrep_SE_init_grab() do { } while(0)
|
|
#define wsrep_SE_init_done() do { } while(0)
|
|
#define wsrep_sst_continue() (0)
|
|
|
|
#endif /* WSREP_SST_H */
|