26#ifndef ROUTER_CONFIG_GENERATOR_INCLUDED
27#define ROUTER_CONFIG_GENERATOR_INCLUDED
47#include "unique_ptr.h"
56class SysUserOperationsBase;
57class SysUserOperations;
65 std::ostream &out_stream = std::cout, std::ostream &err_stream = std::cerr
80 void init(
const std::map<std::string, std::string> &bootstrap_options,
84 void check_target(
const std::map<std::string, std::string> &bootstrap_options,
85 bool allow_no_metadata =
false);
103 const std::string &program_name,
const std::string &config_file_path,
104 const std::string &state_file_path,
105 const std::map<std::string, std::string> &
options,
106 const std::map<std::string, std::vector<std::string>> &multivalue_options,
107 const std::map<std::string, std::string> &config_cmdline_options,
111 const std::string &program_name,
const std::string &directory,
112 const std::map<std::string, std::string> &
options,
113 const std::map<std::string, std::vector<std::string>> &multivalue_options,
114 const std::map<std::string, std::string> &config_cmdline_options,
133 operator bool()
const {
return port > 0 || !
socket.empty(); }
190 const std::map<std::string, std::string> &
options,
191 const std::string &owner)
const;
203 const std::map<std::string, std::string> &bootstrap_options);
220 const std::string &bootstrap_socket);
247 const std::string &directory,
248 bool interactive_master_key,
249 const std::map<std::string, std::string> &
options);
252 const std::map<std::string, std::string> &
options);
256 const std::string &script_path,
257 const std::map<std::string, std::string> &
options);
261 const std::string &program_name, std::ofstream &config_file,
264 const std::map<std::string, std::string> &
options,
265 const std::map<std::string, std::vector<std::string>> &multivalue_options,
266 const std::map<std::string, std::string> &config_cmdline_options,
268 bool directory_deployment,
AutoCleaner &auto_clean);
271 uint32_t &router_id, std::string &username, std::string &
password,
272 const std::string &router_name,
const ClusterInfo &cluster_info,
273 const std::map<std::string, std::string> &user_options,
274 const std::map<std::string, std::vector<std::string>> &multivalue_options,
278 std::ostream &config_file, std::ostream &state_file, uint32_t router_id,
279 const std::string &router_name,
const std::string &system_username,
280 const ClusterInfo &cluster_info,
const std::string &username,
283 const std::map<std::string, std::string> &config_overwrites,
284 const std::string &state_file_name,
const bool full,
292 const std::string &router_name,
const std::string &metadata_cluster,
293 const std::string &cluster_type_name,
const std::string &hostname,
298 const std::map<std::string, std::string> &user_options,
323 &multivalue_options) noexcept;
350 const
std::
set<
std::
string> &hostnames, const
std::
string &username,
351 const
std::
string &
password,
bool password_change_ok);
382 const
std::
string &username, const
std::
set<
std::
string> &hostnames,
383 const
std::
string &
password,
bool password_change_ok,
bool if_not_exists);
403 const
std::
string &
password,
bool if_not_exists = false);
410 const
std::
string &username);
413 const
std::
string &username, const
std::
set<
std::
string> &hostnames,
422 const
std::
string &config_file_path,
438 uint32_t router_id, const
std::
string &username,
452 const
std::
string &hostname_override);
455 const
std::
string &hostname_override,
bool force);
Class representing an error.
Definition: error.h:48
KeyringInfo class encapsulates loading and storing master key using master-key-reader and master-key-...
Definition: keyring_info.h:76
A helper class for handling file paths.
Definition: path.h:38
Class representing a path in a file system.
Definition: filesystem.h:63
Automatic cleanup on scope exit utility class.
Definition: auto_cleaner.h:62
Definition: config_generator.h:60
std::string bootstrap_socket_
Definition: config_generator.h:497
std::string plugin_folder_
Definition: config_generator.h:542
void give_grants_to_users(const std::string &new_accounts)
Definition: config_generator.cc:2926
std::optional< mysqlrouter::MetadataSchemaVersion > schema_version_
Definition: config_generator.h:540
std::string fetch_password_from_keyring(const std::string &username, uint32_t router_id)
Definition: config_generator.cc:1737
std::string cluster_initial_password_
Definition: config_generator.h:510
SysUserOperationsBase * sys_user_operations_
Definition: config_generator.h:536
std::string cluster_initial_username_
Definition: config_generator.h:509
MySQLSession * mysql_
Definition: config_generator.h:499
std::string config_file_path_for_directory(const std::string &directory)
Definition: config_generator.cc:477
void create_users(const std::string &username, const std::set< std::string > &hostnames, const std::string &password, bool if_not_exists)
Definition: config_generator.cc:2759
std::string cluster_initial_socket_
Definition: config_generator.h:511
void create_stop_script(const std::string &directory, const std::map< std::string, std::string > &options)
Definition: config_generator.cc:3396
void check_target(const std::map< std::string, std::string > &bootstrap_options, bool allow_no_metadata=false)
Definition: config_generator.cc:384
bool keyring_initialized_
Definition: config_generator.h:514
bool datadir_contains_allowed_files(const mysql_harness::Directory &dir) const
Check if datadir directory contains only files that are allowed before the bootstrap.
Definition: config_generator.cc:596
void set_keyring_info_real_paths(std::map< std::string, std::string > &options, const mysql_harness::Path &path)
Definition: config_generator.cc:1724
void set_file_owner(const std::map< std::string, std::string > &options, const std::string &owner) const
Definition: config_generator.cc:3500
ExistingConfigOptions get_options_from_config_if_it_exists(const std::string &config_file_path, const mysqlrouter::ClusterInfo &cluster_info, bool forcing_overwrite)
Get selected configuration options from the existing Router configuration file.
Definition: config_generator.cc:3180
void init_keyring_and_master_key(AutoCleaner &auto_clean, const std::map< std::string, std::string > &user_options, uint32_t router_id)
Definition: config_generator.cc:1788
std::ostream & out_stream_
Definition: config_generator.h:516
void throw_account_exists(const MySQLSession::Error &e, const std::string &username)
Definition: config_generator.cc:2705
std::string create_router_accounts(const std::map< std::string, std::string > &user_options, const std::set< std::string > &hostnames, const std::string &username, const std::string &password, bool password_change_ok)
Creates Router accounts.
Definition: config_generator.cc:2606
std::unique_ptr< ClusterMetadata > metadata_
Definition: config_generator.h:500
std::string get_bootstrap_report_text(const std::string &program_name, const std::string &config_file_name, const std::string &router_name, const std::string &metadata_cluster, const std::string &cluster_type_name, const std::string &hostname, bool is_system_deployment, const Options &options)
Definition: config_generator.cc:2476
int connect_timeout_
Definition: config_generator.h:501
void print_bootstrap_start_msg(uint32_t router_id, bool directory_deployment, const mysql_harness::Path &config_file_path)
Definition: config_generator.cc:2453
void init_gr_data(const URI &u, const std::string &bootstrap_socket)
init() calls this to set GR-related member fields.
Definition: config_generator.cc:359
URI target_uri_
Definition: config_generator.h:496
std::string make_account_list(const std::string username, const std::set< std::string > &hostnames)
Definition: config_generator.cc:2957
std::string bootstrap_deployment(const std::string &program_name, std::ofstream &config_file, std::ofstream &state_file, const mysql_harness::Path &config_file_path, const mysql_harness::Path &state_file_path, const std::string &name, const std::map< std::string, std::string > &options, const std::map< std::string, std::vector< std::string > > &multivalue_options, const std::map< std::string, std::string > &config_cmdline_options, const std::map< std::string, std::string > &default_paths, bool directory_deployment, AutoCleaner &auto_clean)
Definition: config_generator.cc:1186
void undo_create_user_for_new_accounts() noexcept
Deletes Router accounts just created.
Definition: config_generator.cc:3026
std::string cluster_specific_id_
Definition: config_generator.h:506
void update_router_info(uint32_t router_id, const Options &options)
std::ostream & err_stream_
Definition: config_generator.h:517
bool warn_on_no_ssl(const std::map< std::string, std::string > &options)
logs warning and returns false if SSL mode is set to PREFERRED and SSL is not being used,...
Definition: config_generator.cc:213
ConfigGenerator(std::ostream &out_stream=std::cout, std::ostream &err_stream=std::cerr, SysUserOperationsBase *sys_user_operations=SysUserOperations::instance())
Definition: config_generator.cc:193
void create_config(std::ostream &config_file, std::ostream &state_file, uint32_t router_id, const std::string &router_name, const std::string &system_username, const ClusterInfo &cluster_info, const std::string &username, const Options &options, const std::map< std::string, std::string > &default_paths, const std::map< std::string, std::string > &config_overwrites, const std::string &state_file_name, const bool full, AutoCleaner &auto_clean)
Definition: config_generator.cc:2198
void init(const std::map< std::string, std::string > &bootstrap_options, const mysqlrouter::URI &uri, mysqlrouter::MySQLSession *session, int connect_timeout, int read_timeout)
first part of the bootstrap process
Definition: config_generator.cc:371
int read_timeout_
Definition: config_generator.h:502
void bootstrap_system_deployment(const std::string &program_name, const std::string &config_file_path, const std::string &state_file_path, const std::map< std::string, std::string > &options, const std::map< std::string, std::vector< std::string > > &multivalue_options, const std::map< std::string, std::string > &config_cmdline_options, const std::map< std::string, std::string > &default_paths)
Definition: config_generator.cc:502
void verify_router_account(const std::string &username, const std::string &password, bool strict)
Definition: config_generator.cc:1433
URI parse_server_uri(const std::string &server_uri, const std::string &bootstrap_socket)
init() calls this to validate and extract metadata server info from server URI, including user creden...
Definition: config_generator.cc:302
struct mysqlrouter::ConfigGenerator::UndoCreateAccountList undo_create_account_list_
void set_log_file_permissions(const std::map< std::string, std::string > &default_paths, const std::map< std::string, std::string > &user_options, const Options &options)
Definition: config_generator.cc:1096
bool is_standalone_target() const
Definition: config_generator.h:123
void set_plugin_folder(const std::string &val)
Definition: config_generator.h:121
void init_keyring_file(uint32_t router_id, bool create_if_needed=true)
Definition: config_generator.cc:1816
std::set< std::string > get_hostnames_of_created_accounts(const std::string &username, const std::set< std::string > &hostnames, bool if_not_exists)
Definition: config_generator.cc:2816
void parse_bootstrap_options(const std::map< std::string, std::string > &bootstrap_options)
init() calls this to read and validate several command-line options; results are stored in member fie...
Definition: config_generator.cc:257
const struct mysqlrouter::ConfigGenerator::TLS_filenames tls_filenames_
void bootstrap_directory_deployment(const std::string &program_name, const std::string &directory, const std::map< std::string, std::string > &options, const std::map< std::string, std::vector< std::string > > &multivalue_options, const std::map< std::string, std::string > &config_cmdline_options, const std::map< std::string, std::string > &default_paths)
Create a self-contained deployment of the Router in a directory.
Definition: config_generator.cc:613
void create_start_script(const std::string &program_name, const std::string &directory, bool interactive_master_key, const std::map< std::string, std::string > &options)
Definition: config_generator.cc:3295
std::string cluster_initial_hostname_
Definition: config_generator.h:507
bool needs_bootstrap(const std::string &config_file_path)
Definition: config_generator.cc:484
Options fill_options(const std::map< std::string, std::string > &user_options, const std::map< std::string, std::string > &default_paths, const ExistingConfigOptions &existing_config_options)
Definition: config_generator.cc:844
void prepare_ssl_certificate_files(const std::map< std::string, std::string > &user_options, const std::map< std::string, std::string > &default_paths, AutoCleaner *auto_cleaner) const
Prepare X.509 certificates for the Router.
Definition: config_generator.cc:1130
KeyringInfo keyring_info_
Definition: config_generator.h:513
virtual void set_script_permissions(const std::string &script_path, const std::map< std::string, std::string > &options)
Definition: config_generator.cc:3277
unsigned int cluster_initial_port_
Definition: config_generator.h:508
uint32_t register_router(const std::string &router_name, const std::string &hostname_override, bool force)
Definition: config_generator.cc:1374
void create_accounts(const std::string &username, const std::set< std::string > &hostnames, const std::string &password, bool if_not_exists=false)
Creates Router account (low-level function)
Definition: config_generator.cc:2977
void ensure_router_id_is_ours(uint32_t &router_id, const std::string &hostname_override)
Definition: config_generator.cc:1351
void store_credentials_in_keyring(AutoCleaner &auto_clean, const std::map< std::string, std::string > &user_options, uint32_t router_id, const std::string &username, const std::string &password, Options &options)
Definition: config_generator.cc:1765
static std::set< std::string > get_account_host_args(const std::map< std::string, std::vector< std::string > > &multivalue_options) noexcept
Finds all hostnames given on command-line.
Definition: config_generator.cc:1415
TargetType
Definition: config_generator.h:62
std::tuple< std::string > try_bootstrap_deployment(uint32_t &router_id, std::string &username, std::string &password, const std::string &router_name, const ClusterInfo &cluster_info, const std::map< std::string, std::string > &user_options, const std::map< std::string, std::vector< std::string > > &multivalue_options, const Options &options)
Definition: config_generator.cc:1637
bool backup_config_file_if_different(const mysql_harness::Path &config_path, const std::string &new_file_path, const std::map< std::string, std::string > &options, AutoCleaner *auto_cleaner=nullptr)
Definition: config_generator.cc:3469
virtual ~ConfigGenerator()
std::string create_accounts_with_compliant_password(const std::map< std::string, std::string > &user_options, const std::string &username, const std::set< std::string > &hostnames, const std::string &password, bool password_change_ok, bool if_not_exists)
Creates Router account with compliant password.
Definition: config_generator.cc:2656
void set_keyring_info(const KeyringInfo &keyring_info)
Definition: config_generator.h:117
Definition: mysql_session.h:157
Base class to allow multiple SysUserOperations implementations.
Definition: sys_user_operations.h:45
static SysUserOperations * instance()
Definition: sys_user_operations.cc:49
Parse and create URIs according to RFC3986.
Definition: uri.h:66
static std::map< string, enum_variable_source > default_paths
Defines mapping between config files names and its corresponding enum values.
Definition: my_default.cc:120
static char * password
Definition: mysql_secure_installation.cc:58
ulong connect_timeout
Definition: mysqld.cc:1354
static char * path
Definition: mysqldump.cc:150
std::string dir
Double write files location.
Definition: buf0dblwr.cc:77
const std::string config_file_name
Definition: config.cc:60
std::chrono::milliseconds milliseconds
Definition: authorize_manager.cc:68
Definition: options.cc:57
Definition: gcs_xcom_synode.h:64
std::vector< T, ut::allocator< T > > vector
Specialization of vector which uses allocator.
Definition: ut0new.h:2876
std::set< Key, Compare, ut::allocator< Key > > set
Specialization of set which uses ut_allocator.
Definition: ut0new.h:2884
std::map< Key, Value, Compare, ut::allocator< std::pair< const Key, Value > > > map
Specialization of map which uses ut_allocator.
Definition: ut0new.h:2894
std::conditional_t< !std::is_array< T >::value, std::unique_ptr< T, detail::Deleter< T > >, std::conditional_t< detail::is_unbounded_array_v< T >, std::unique_ptr< T, detail::Array_deleter< std::remove_extent_t< T > > >, void > > unique_ptr
The following is a common type that is returned by all the ut::make_unique (non-aligned) specializati...
Definition: ut0new.h:2440
required string type
Definition: replication_group_member_actions.proto:34
Definition: cluster_metadata.h:235
Definition: config_generator.h:233
uint32_t router_id
Definition: config_generator.h:235
std::string local_cluster_name
Definition: config_generator.h:239
bool valid
Definition: config_generator.h:234
uint16_t ro_x_port
Definition: config_generator.h:238
std::string username
Definition: config_generator.h:236
uint16_t rw_x_port
Definition: config_generator.h:237
Definition: config_generator.h:126
std::string socket
Definition: config_generator.h:128
int port
Definition: config_generator.h:127
Endpoint(const std::string &path)
Definition: config_generator.h:130
Endpoint()
Definition: config_generator.h:129
Endpoint(int port_)
Definition: config_generator.h:131
Definition: config_generator.h:125
std::string target_cluster_by_name
Definition: config_generator.h:185
Endpoint ro_x_endpoint
Definition: config_generator.h:141
std::string server_ssl_curves
Definition: config_generator.h:175
std::string client_ssl_dh_params
Definition: config_generator.h:172
std::string server_ssl_verify
Definition: config_generator.h:181
std::string target_cluster
Definition: config_generator.h:184
std::string keyring_master_key_file_path
Definition: config_generator.h:152
std::string override_logfilename
Definition: config_generator.h:145
Endpoint rw_split_endpoint
Definition: config_generator.h:139
std::string local_cluster
Definition: config_generator.h:186
std::string client_ssl_mode
Definition: config_generator.h:170
std::string keyring_master_key
Definition: config_generator.h:151
Endpoint ro_endpoint
Definition: config_generator.h:138
std::string bind_address
Definition: config_generator.h:154
mysqlrouter::SSLOptions ssl_options
Definition: config_generator.h:159
int connect_timeout
Definition: config_generator.h:156
bool disable_rw_split_endpoint
Definition: config_generator.h:142
std::string client_ssl_curves
Definition: config_generator.h:169
bool disable_rest
Definition: config_generator.h:164
std::string client_ssl_key
Definition: config_generator.h:171
std::string override_datadir
Definition: config_generator.h:147
std::string override_logdir
Definition: config_generator.h:144
Endpoint rw_x_endpoint
Definition: config_generator.h:140
std::string server_ssl_mode
Definition: config_generator.h:176
Endpoint rw_endpoint
Definition: config_generator.h:137
std::string server_ssl_cipher
Definition: config_generator.h:174
std::string client_ssl_cert
Definition: config_generator.h:167
int read_timeout
Definition: config_generator.h:157
std::string server_ssl_capath
Definition: config_generator.h:178
std::string https_port_str
Definition: config_generator.h:165
std::string keyring_file_path
Definition: config_generator.h:150
std::chrono::milliseconds ttl
Definition: config_generator.h:161
std::string socketsdir
Definition: config_generator.h:148
bool use_gr_notifications
Definition: config_generator.h:162
std::string override_rundir
Definition: config_generator.h:146
std::string client_ssl_cipher
Definition: config_generator.h:168
std::string server_ssl_crlpath
Definition: config_generator.h:180
std::string server_ssl_crl
Definition: config_generator.h:179
std::string server_ssl_ca
Definition: config_generator.h:177
Definition: config_generator.h:528
std::string router_key
Definition: config_generator.h:531
std::string router_cert
Definition: config_generator.h:532
std::string ca_key
Definition: config_generator.h:529
std::string ca_cert
Definition: config_generator.h:530
Definition: config_generator.h:519
std::string accounts
Definition: config_generator.h:525
@ kAllAccounts
Definition: config_generator.h:522
SSL connection related options.
Definition: datatypes.h:34