В предишната публикация в блога разгледахме някои въведения в инсталирането, надстройката и внедряването на MaxScale с помощта на MaxCtrl клиент от командния ред. В тази публикация в блога ще покрием аспектите на управлението на MaxScale за нашия MariaDB клъстер.
Има редица компоненти на MaxScale, които можем да управляваме с MaxCtrl, а именно:
- Управление на сървъра
- Управление на услугите
- Управление на монитора
- Управление на слушателите
- Управление на филтри
- Управление на MaxScale
- Управление на регистриране
В тази публикация в блога ще покрием първите 4 компонента, които обикновено се използват в MariaDB Cluster. Всички команди в тази публикация в блога са базирани на MaxScale 2.4.11.
Управление на сървъра
Списък/показване на сървъри
Избройте обобщение на всички сървъри в MaxScale:
maxctrl: list servers
┌────────────────┬────────────────┬──────┬─────────────┬─────────────────────────┬─────────────┐
│ Server │ Address │ Port │ Connections │ State │ GTID │
├────────────────┼────────────────┼──────┼─────────────┼─────────────────────────┼─────────────┤
│ mariadbgalera1 │ 192.168.10.201 │ 3306 │ 0 │ Slave, Synced, Running │ 100-100-203 │
├────────────────┼────────────────┼──────┼─────────────┼─────────────────────────┼─────────────┤
│ mariadbgalera2 │ 192.168.10.202 │ 3306 │ 0 │ Slave, Synced, Running │ 100-100-203 │
├────────────────┼────────────────┼──────┼─────────────┼─────────────────────────┼─────────────┤
│ mariadbgalera3 │ 192.168.10.203 │ 3306 │ 0 │ Master, Synced, Running │ 100-100-203 │
└────────────────┴────────────────┴──────┴─────────────┴─────────────────────────┴─────────────┘За MariaDB Cluster списъкът със сървъри обобщава състоянието на възела и клъстера с неговия MariaDB GTID, само ако клъстерът е настроен да се репликира от друг клъстер чрез стандартната репликация на MariaDB. Състоянието се използва от MaxScale за контрол на поведението на алгоритъма за маршрутизиране:
- Master – За клъстер това се счита за Write-Master.
- Slave – Ако всички подчинени устройства са изключени, но главният все още е наличен, тогава рутерът ще използва главния.
- Синхронизиран – възел на клъстера, който е в синхронизирано състояние с клъстера.
- Работно – Сървър, който работи и работи. Всички сървъри, към които MariaDB MaxScale може да се свърже, са обозначени като работещи.
Въпреки че MariaDB Cluster е в състояние да обработва репликация с множество главни, MaxScale винаги ще избира един възел, който да държи ролята на главен, който ще получава всички записи за маршрутизиране на readwritesplit. По подразбиране Galera Monitor ще избере възела с най-ниската стойност на wsrep_local_index като главен. Това ще означава, че две MaxScales, работещи на различни сървъри, ще изберат същия сървър като главния.
Покажете всички сървъри по-подробно:
maxctrl: show serversСъздаване на сървъри
Това обикновено е първото нещо, което трябва да направите, когато настройвате MaxScale като балансьор на натоварване. Обичайно е да добавяте всички възли на MariaDB Cluster в MaxScale и да го етикетирате с име на обект. В този пример ние обозначаваме възлите на Galera като във формат "mariadbgalera#":
maxctrl: create server mariadbgalera1 192.168.0.221 3306
maxctrl: create server mariadbgalera2 192.168.0.222 3306
maxctrl: create server mariadbgalera3 192.168.0.222 3306Състоянието на сървъра ще бъде отчетено правилно само след като сме активирали модула за наблюдение, както е показано в раздела Управление на монитора по-долу.
Изтриване на сървър
За да изтриете сървър, трябва предварително да прекратите връзката на сървъра с всякакви услуги или монитори. Като пример, в следния списък със сървъри бихме искали да изтрием mariadbgalera3 от MaxScale:
maxctrl: list servers
┌────────────────┬────────────────┬──────┬─────────────┬─────────────────────────┬─────────────┐
│ Server │ Address │ Port │ Connections │ State │ GTID │
├────────────────┼────────────────┼──────┼─────────────┼─────────────────────────┼─────────────┤
│ mariadbgalera1 │ 192.168.10.201 │ 3306 │ 0 │ Slave, Synced, Running │ 100-100-203 │
├────────────────┼────────────────┼──────┼─────────────┼─────────────────────────┼─────────────┤
│ mariadbgalera2 │ 192.168.10.202 │ 3306 │ 0 │ Slave, Synced, Running │ 100-100-203 │
├────────────────┼────────────────┼──────┼─────────────┼─────────────────────────┼─────────────┤
│ mariadbgalera3 │ 192.168.10.203 │ 3306 │ 0 │ Master, Synced, Running │ 100-100-203 │
└────────────────┴────────────────┴──────┴─────────────┴─────────────────────────┴─────────────┘Избройте всички монитори и вижте дали сървърът е част от някой мониторен модул:
maxctrl: list monitors
┌─────────────────┬─────────┬────────────────────────────────────────────────┐
│ Monitor │ State │ Servers │
├─────────────────┼─────────┼────────────────────────────────────────────────┤
│ MariaDB-Monitor │ Running │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
└─────────────────┴─────────┴────────────────────────────────────────────────┘Изглежда, че mariadbgalera3 е част от MariaDB-Monitor, така че първо трябва да го премахнем, като използваме командата „unlink monitor“:
maxctrl: unlink monitor MariaDB-Monitor mariadbgalera3
OKСлед това избройте всички услуги, за да проверите дали съответният сървър е част от услуги на MaxScale:
maxctrl: list services
┌─────────────────────┬────────────────┬─────────────┬───────────────────┬────────────────────────────────────────────────┐
│ Service │ Router │ Connections │ Total Connections │ Servers │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Read-Write-Service │ readwritesplit │ 1 │ 1 │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Round-Robin-Service │ readconnroute │ 1 │ 1 │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Replication-Service │ binlogrouter │ 1 │ 1 │ │
└─────────────────────┴────────────────┴─────────────┴───────────────────┴────────────────────────────────────────────────┘Както можете да видите, mariadbgalera3 е част от услугата Read-Write и Round-Robin. Премахнете сървъра от тези услуги, като използвате командата „прекратяване на връзката на услугата“:
maxctrl: unlink service Read-Write-Service mariadbgalera3
OK
maxctrl: unlink service Round-Robin-Service mariadbgalera3
OKНакрая можем да премахнем сървъра от MaxScale, като използваме командата "destroy server":
maxctrl: destroy server mariadbgalera3
OKПроверете с помощта на "списък сървъри", че сме премахнали mariadbgalera3 от MaxScale.:
maxctrl: list servers
┌────────────────┬────────────────┬──────┬─────────────┬─────────────────────────┬──────┐
│ Server │ Address │ Port │ Connections │ State │ GTID │
├────────────────┼────────────────┼──────┼─────────────┼─────────────────────────┼──────┤
│ mariadbgalera1 │ 192.168.10.201 │ 3306 │ 0 │ Master, Synced, Running │ │
├────────────────┼────────────────┼──────┼─────────────┼─────────────────────────┼──────┤
│ mariadbgalera2 │ 192.168.10.202 │ 3306 │ 0 │ Slave, Synced, Running │ │
└────────────────┴────────────────┴──────┴─────────────┴─────────────────────────┴──────┘Промяна на параметъра на сървъра
За да промените параметъра на сървъра, можете да използвате командата "alter server", която приема само един параметър ключ/стойност в даден момент. Например:
maxctrl: alter server mariadbgalera3 priority 10
OKИзползвайте командата "show server" и погледнете в секцията "Параметри" за списък с параметри, които могат да бъдат променени за обекта "server":
maxctrl: show server mariadbgalera3
...
│ Parameters │ { │
│ │ "address": "192.168.10.203", │
│ │ "protocol": "mariadbbackend", │
│ │ "port": 3306, │
│ │ "extra_port": 0, │
│ │ "authenticator": null, │
│ │ "monitoruser": null, │
│ │ "monitorpw": null, │
│ │ "persistpoolmax": 0, │
│ │ "persistmaxtime": 0, │
│ │ "proxy_protocol": false, │
│ │ "ssl": "false", │
│ │ "ssl_cert": null, │
│ │ "ssl_key": null, │
│ │ "ssl_ca_cert": null, │
│ │ "ssl_version": "MAX", │
│ │ "ssl_cert_verify_depth": 9, │
│ │ "ssl_verify_peer_certificate": false, │
│ │ "disk_space_threshold": null, │
│ │ "priority": "10" │
│ │ }Обърнете внимание, че ефектът на командата alter е незабавен и стойността на параметъра по време на изпълнение ще бъде променена, както и стойността в неговия отделен конфигурационен файл MaxScale в /var/lib/maxscale/maxscale.cnf.d/ за постоянство при рестартиране.
Задаване на състояние на сървъра
MaxScale позволява на бекенд сървърите на Galera да бъдат временно изключени от настройката за балансиране на натоварването чрез активиране на режима на поддръжка. Можем да постигнем това, като използваме командата "set server":
maxctrl: set server mariadbgalera3 maintenance
OKКогато разглеждаме състоянието на сървъра, трябва да видим това:
maxctrl: show server mariadbgalera3
...
│ State │ Maintenance, Running
...Когато сървърът е в режим на поддръжка, няма да се създават връзки към него и съществуващите връзки ще бъдат затворени. За да изчистите състоянието на поддръжка от хоста, използвайте командата "clear server":
maxctrl: clear server mariadbgalera3 maintenance
OKПроверете с "show server":
maxctrl: show server mariadbgalera3
...
│ State │ Slave, Synced, Running │
...Управление на монитора
Създаване на монитор
Мониторният модул MaxScale за MariaDB Cluster се нарича galeramon. Дефинирането на правилен модул за наблюдение е необходимо, така че MaxScale да може да определи най-доброто маршрутизиране за заявки в зависимост от състоянието на възлите. Например, ако възел на Galera служи като донор за възел за сглобяване, трябва ли той да бъде част от здравите възли? В някои случаи, като например когато размерът на базата данни е толкова малък, маркирането на донорски възел като здрав (чрез задаване на параметъра available_when_donor=true в MaxScale) не е лош план и понякога подобрява ефективността на маршрутизирането на заявките.
За да създадете услуга (рутер), трябва да създадете потребител за наблюдение в бекенда на сървърите на MariaDB. Обикновено се използва същият потребител за наблюдение, който сме дефинирали за мониторния модул. За Galera Cluster, ако потребителят за наблюдение не съществува, просто го създайте на един от възлите със следните привилегии:
MariaDB> CREATE USER [email protected]'192.168.0.220' IDENTIFIED BY 'MaXSc4LeP4ss';
MariaDB> GRANT SELECT ON mysql.* TO 'maxscale_monitor'@'192.168.0.220';
MariaDB> GRANT SHOW DATABASES ON *.* TO 'maxscale_monitor'@'192.168.0.220';Използвайте командата "create monitor" и посочете име с galeramon като мониторен модул:
maxctrl: create monitor MariaDB-Monitor galeramon servers=mariadbgalera1,mariadbgalera2,mariadbgalera3 user=maxscale_monitor password=MaXSc4LeP4ss
OKОбърнете внимание, че не сме конфигурирали MaxScale secret, което означава, че съхраняваме потребителската парола в обикновен текстов формат. За да активирате криптирането, вижте примера в тази публикация в блога, Въведение в администрирането на MaxScale с помощта на maxctrl за MariaDB клъстер под Добавяне на мониторинг в секцията MaxScale.
Списък/показване на монитори
За да изброите всички монитори:
maxctrl: list monitors
┌─────────────────┬─────────┬────────────────────────────────────────────────┐
│ Monitor │ State │ Servers │
├─────────────────┼─────────┼────────────────────────────────────────────────┤
│ MariaDB-Monitor │ Running │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
└─────────────────┴─────────┴────────────────────────────────────────────────┘За да получите по-подробен поглед върху монитора, използвайте командата "show monitor":
maxctrl: show monitor MariaDB-Monitor
┌─────────────────────┬───────────────────────────────────────────┐
│ Monitor │ MariaDB-Monitor │
├─────────────────────┼───────────────────────────────────────────┤
│ State │ Running │
├─────────────────────┼───────────────────────────────────────────┤
│ Servers │ mariadbgalera1 │
│ │ mariadbgalera2 │
│ │ mariadbgalera3 │
├─────────────────────┼───────────────────────────────────────────┤
│ Parameters │ { │
│ │ "user": "maxscale_monitor", │
│ │ "password": "*****", │
│ │ "passwd": null, │
│ │ "monitor_interval": 2000, │
│ │ "backend_connect_timeout": 3, │
│ │ "backend_read_timeout": 1, │
│ │ "backend_write_timeout": 2, │
│ │ "backend_connect_attempts": 1, │
│ │ "journal_max_age": 28800, │
│ │ "disk_space_threshold": null, │
│ │ "disk_space_check_interval": 0, │
│ │ "script": null, │
│ │ "script_timeout": 90, │
│ │ "events": "all", │
│ │ "disable_master_failback": false, │
│ │ "available_when_donor": true, │
│ │ "disable_master_role_setting": false, │
│ │ "root_node_as_master": false, │
│ │ "use_priority": false, │
│ │ "set_donor_nodes": false │
│ │ } │
├─────────────────────┼───────────────────────────────────────────┤
│ Monitor Diagnostics │ { │
│ │ "disable_master_failback": false, │
│ │ "disable_master_role_setting": false, │
│ │ "root_node_as_master": false, │
│ │ "use_priority": false, │
│ │ "set_donor_nodes": false │
│ │ } │
└─────────────────────┴───────────────────────────────────────────┘Стоп/Стартиране на монитор
Спирането на монитор ще постави на пауза наблюдението на сървърите. Това обикновено се използва във връзка с командата "set server" за ръчно управление на състоянията на сървъра. За да спрете услугата за наблюдение, използвайте командата "стоп монитор":
maxctrl: stop monitor MariaDB-Monitor
OKПроверете състоянието с "show monitor":
maxctrl: show monitors MariaDB-Monitor
┌─────────────────────┬───────────────────────────────────────────┐
│ Monitor │ MariaDB-Monitor │
├─────────────────────┼───────────────────────────────────────────┤
│ State │ Stopped │
...За да го стартирате отново, използвайте "стартовия монитор":
maxctrl: start monitor MariaDB-Monitor
OKПромяна на параметъра на монитора
За да промените параметър за този монитор, използвайте командата "alter monitor" и посочете ключа/стойността на параметъра, както следва:
maxctrl: alter monitor MariaDB-Monitor available_when_donor true
OKИзползвайте командата "show monitor" и погледнете в секцията Параметри, за списък с параметри, които могат да се променят за модула galeramon:
maxctrl: show server mariadbgalera3
...
│ Parameters │ { │
│ │ "user": "maxscale_monitor", │
│ │ "password": "*****", │
│ │ "monitor_interval": 2000, │
│ │ "backend_connect_timeout": 3, │
│ │ "backend_read_timeout": 1, │
│ │ "backend_write_timeout": 2, │
│ │ "backend_connect_attempts": 1, │
│ │ "journal_max_age": 28800, │
│ │ "disk_space_threshold": null, │
│ │ "disk_space_check_interval": 0, │
│ │ "script": null, │
│ │ "script_timeout": 90, │
│ │ "events": "all", │
│ │ "disable_master_failback": false, │
│ │ "available_when_donor": true, │
│ │ "disable_master_role_setting": false, │
│ │ "root_node_as_master": false, │
│ │ "use_priority": false, │
│ │ "set_donor_nodes": false │
│ │ } │
Изтриване на монитор
За да изтриете монитор, първо трябва да премахнете всички сървъри, свързани с монитора. Например, помислете за следния монитор в MaxScale:
maxctrl: list monitors
┌─────────────────┬─────────┬────────────────────────────────────────────────┐
│ Monitor │ State │ Servers │
├─────────────────┼─────────┼────────────────────────────────────────────────┤
│ MariaDB-Monitor │ Running │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
└─────────────────┴─────────┴────────────────────────────────────────────────┘Премахнете всички сървъри от тази конкретна услуга:
maxctrl: unlink monitor MariaDB-Monitor mariadbgalera1 mariadbgalera2 mariadbgalera3
OKМониторът ни сега изглежда така:
maxctrl: list monitors
┌─────────────────┬─────────┬─────────┐
│ Monitor │ State │ Servers │
├─────────────────┼─────────┼─────────┤
│ MariaDB-Monitor │ Running │ │
└─────────────────┴─────────┴─────────┘Само тогава можем да изтрием монитора:
maxctrl: destroy monitor MariaDB-Monitor
OKДобавяне/премахване на сървъри в монитор
След като създадем монитор, можем да използваме командата "link monitor", за да добавим сървърите на Galera към монитора. Използвайте името на сървъра, както е създадено в секцията Създаване на сървъри:
maxctrl: link monitor MariaDB-Monitor mariadbgalera1 mariadbgalera2 mariadbgalera3
OKПо същия начин, за да премахнете сървър от услугата, просто използвайте командата "прекратяване на връзката на монитора":
maxctrl: unlink monitor MariaDB-Monitor mariadbgalera3
OKПроверете с командата „списък монитори“ или „покажи монитори“.
Управление на услугите
Създайте услуга
За да създадете услуга (рутер), трябва да създадете потребител за наблюдение в бекенда на сървърите на MariaDB. Обикновено се използва същият потребител за наблюдение, който сме дефинирали за мониторния модул. За Galera Cluster, ако потребителят за наблюдение не съществува, просто го създайте на един от възлите със следните привилегии:
MariaDB> CREATE USER [email protected]'192.168.0.220' IDENTIFIED BY 'MaXSc4LeP4ss';
MariaDB> GRANT SELECT ON mysql.* TO 'maxscale_monitor'@'192.168.0.220';
MariaDB> GRANT SHOW DATABASES ON *.* TO 'maxscale_monitor'@'192.168.0.220';Където 192.168.0.220 е IP адресът на хоста MaxScale.
След това посочете името на услугата, типа на маршрутизацията заедно с потребител за наблюдение за MaxScale, за да се свърже с бекенд сървърите:
maxctrl: create service Round-Robin-Service readconnroute user=maxscale_monitor password=******
OKСъщо така можете да зададете допълнителни параметри при създаване на услугата. В този пример бихме искали „главният“ възел да бъде включен в кръговия балансиращ набор за нашия MariaDB Galera Cluster:
maxctrl: create service Round-Robin-Service readconnroute user=maxscale_monitor password=****** router_options=master,slave
OKИзползвайте командата "show service", за да видите поддържаните параметри. За кръгов рутер списъкът е както следва:
maxctrl: show service Round-Robin-Service
...
│ Parameters │ { │
│ │ "router_options": null, │
│ │ "user": "maxscale_monitor", │
│ │ "password": "*****", │
│ │ "passwd": null, │
│ │ "enable_root_user": false, │
│ │ "max_retry_interval": 3600, │
│ │ "max_connections": 0, │
│ │ "connection_timeout": 0, │
│ │ "auth_all_servers": false, │
│ │ "strip_db_esc": true, │
│ │ "localhost_match_wildcard_host": true, │
│ │ "version_string": null, │
│ │ "weightby": null, │
│ │ "log_auth_warnings": true, │
│ │ "retry_on_failure": true, │
│ │ "session_track_trx_state": false, │
│ │ "retain_last_statements": -1, │
│ │ "session_trace": 0За разделения рутер за четене-запис поддържаните параметри са:
maxctrl: show service Read-Write-Service
...
│ Parameters │ { │
│ │ "router_options": null, │
│ │ "user": "maxscale_monitor", │
│ │ "password": "*****", │
│ │ "passwd": null, │
│ │ "enable_root_user": false, │
│ │ "max_retry_interval": 3600, │
│ │ "max_connections": 0, │
│ │ "connection_timeout": 0, │
│ │ "auth_all_servers": false, │
│ │ "strip_db_esc": true, │
│ │ "localhost_match_wildcard_host": true, │
│ │ "version_string": null, │
│ │ "weightby": null, │
│ │ "log_auth_warnings": true, │
│ │ "retry_on_failure": true, │
│ │ "session_track_trx_state": false, │
│ │ "retain_last_statements": -1, │
│ │ "session_trace": 0, │
│ │ "use_sql_variables_in": "all", │
│ │ "slave_selection_criteria": "LEAST_CURRENT_OPERATIONS", │
│ │ "master_failure_mode": "fail_instantly", │
│ │ "max_slave_replication_lag": -1, │
│ │ "max_slave_connections": "255", │
│ │ "retry_failed_reads": true, │
│ │ "prune_sescmd_history": false, │
│ │ "disable_sescmd_history": false, │
│ │ "max_sescmd_history": 50, │
│ │ "strict_multi_stmt": false, │
│ │ "strict_sp_calls": false, │
│ │ "master_accept_reads": false, │
│ │ "connection_keepalive": 300, │
│ │ "causal_reads": false, │
│ │ "causal_reads_timeout": "10", │
│ │ "master_reconnection": false, │
│ │ "delayed_retry": false, │
│ │ "delayed_retry_timeout": 10, │
│ │ "transaction_replay": false, │
│ │ "transaction_replay_max_size": "1Mi", │
│ │ "optimistic_trx": false │
│ │ }List/Show Services
To list out all created services (routers), use the "list services" command:
maxctrl: list services
┌─────────────────────┬────────────────┬─────────────┬───────────────────┬────────────────────────────────────────────────┐
│ Service │ Router │ Connections │ Total Connections │ Servers │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Read-Write-Service │ readwritesplit │ 1 │ 1 │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Round-Robin-Service │ readconnroute │ 1 │ 1 │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Binlog-Repl-Service │ binlogrouter │ 1 │ 1 │ │
└─────────────────────┴────────────────┴─────────────┴───────────────────┴────────────────────────────────────────────────┘In the above examples, we have created 3 services, with 3 different routers. However, the Binlog-Repl-Service for our binlog server is not linked with any servers yet.
To show all services in details:
maxctrl: show servicesИли ако искате да покажете конкретна услуга:
maxctrl: show service Round-Robin-ServiceStop/Start Services
Stopping a service will prevent all the listeners for that service from accepting new connections. Existing connections will still be handled normally until they are closed. To stop and start all services, use the "stop services":
maxctrl: stop services
maxctrl: show services
maxctrl: start services
maxctrl: show servicesOr we can use the "stop service" to stop only one particular service:
maxctrl: stop services Round-Robin-ServiceDelete a Service
In order to delete a service, one has to remove all servers and destroy the listeners associated with the service first. For example, consider the following services in MaxScale:
maxctrl: list services
┌─────────────────────┬────────────────┬─────────────┬───────────────────┬────────────────────────────────────────────────┐
│ Service │ Router │ Connections │ Total Connections │ Servers │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Read-Write-Service │ readwritesplit │ 1 │ 1 │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Round-Robin-Service │ readconnroute │ 1 │ 1 │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Replication-Service │ binlogrouter │ 1 │ 1 │ │
└─────────────────────┴────────────────┴─────────────┴───────────────────┴────────────────────────────────────────────────┘Let's remove Round-Robin-Service from the setup. Remove all servers from this particular service:
maxctrl: unlink service Round-Robin-Service mariadbgalera1 mariadbgalera2 mariadbgalera3
OKOur services are now looking like this:
maxctrl: list services
┌─────────────────────┬────────────────┬─────────────┬───────────────────┬────────────────────────────────────────────────┐
│ Service │ Router │ Connections │ Total Connections │ Servers │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Read-Write-Service │ readwritesplit │ 1 │ 1 │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Round-Robin-Service │ readconnroute │ 1 │ 1 │ │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Replication-Service │ binlogrouter │ 1 │ 1 │ │
└─────────────────────┴────────────────┴─────────────┴───────────────────┴────────────────────────────────────────────────┘If the service is tied with a listener, we have to remove it as well. Use "list listeners" and specify the service name to look for it:
maxctrl: list listeners Round-Robin-Service
┌──────────────────────┬──────┬─────────┬─────────┐
│ Name │ Port │ Host │ State │
├──────────────────────┼──────┼─────────┼─────────┤
│ Round-Robin-Listener │ 3307 │ 0.0.0.0 │ Running │
└──────────────────────┴──────┴─────────┴─────────┘And then remove the listener:
maxctrl: destroy listener Round-Robin-Service Round-Robin-Listener
OKFinally, we can remove the service:
maxctrl: destroy service Round-Robin-Service
OKModify Service's Parameter
Similar to the other object, one can modify a service parameter by using the "alter service" command:
maxctrl: alter service Read-Write-Service master_accept_reads true
OKSome routers support runtime configuration changes to all parameters. Currently all readconnroute, readwritesplit and schemarouter parameters can be changed at runtime. In addition to module specific parameters, the following list of common service parameters can be altered at runtime:
- user
- passwd
- enable_root_user
- max_connections
- connection_timeout
- auth_all_servers
- optimize_wildcard
- strip_db_esc
- localhost_match_wildcard_host
- max_slave_connections
- max_slave_replication_lag
- retain_last_statements
Note that alter command effect is immediate and the parameter's value in the runtime will be modified as well as the value in its individual MaxScale configuration file inside /var/lib/maxscale/maxscale.cnf.d/ for persistence across restart.
Add/Remove Servers into Service
After creating a service, we can use the link command to add our servers into the service. Use the server's name as created under Create Servers section:
maxctrl: link service Round-Robin-Service mariadbgalera1 mariadbgalera2 mariadbgalera3
OKSimilarly, to remove a server from the service, just use "unlink service" command:
maxctrl: unlink service Round-Robin-Service mariadbgalera3
OKWe can only remove one server from a service at a time, so repeat it for other nodes to delete them. Verify with "list services" or "show services" command.
Listener Management
List Listeners
To list all listeners, we need to know the service name in advanced:
maxctrl: list services
┌──────────────────────┬────────────────┬─────────────┬───────────────────┬────────────────────────────────────────────────┐
│ Service │ Router │ Connections │ Total Connections │ Servers │
├──────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Read-Write-Service │ readwritesplit │ 0 │ 0 │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
├──────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Round-Robin-Service │ readconnroute │ 0 │ 0 │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
├──────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤In the above example, we have two services, Read-Write-Service and Round-Robin-Service. Then, we can list out the listener for that particular service. For Read-Write-Service:
maxctrl: list listeners Read-Write-Service
┌─────────────────────┬──────┬─────────┬─────────┐
│ Name │ Port │ Host │ State │
├─────────────────────┼──────┼─────────┼─────────┤
│ Read-Write-Listener │ 3306 │ 0.0.0.0 │ Running │
└─────────────────────┴──────┴─────────┴─────────┘And for Round-Robin-Service:
maxctrl: list listeners Round-Robin-Service
┌──────────────────────┬──────┬─────────┬─────────┐
│ Name │ Port │ Host │ State │
├──────────────────────┼──────┼─────────┼─────────┤
│ Round-Robin-Listener │ 3307 │ 0.0.0.0 │ Running │
└──────────────────────┴──────┴─────────┴─────────┘Unlike other objects in MaxScale, the listener does not have a "show" and "alter" commands since it is a fairly simple object.
Create a Listener
Make sure a service has been created. In this example, taken from the Create Service section above, we will create a listener so MaxScale will listen on port 3307 to process the MariaDB connections in a round-robin fashion:
maxctrl: create listener Round-Robin-Service Round-Robin-Listener 3307
OKDelete a Listener
To delete a listener, use the "destroy listener" command with the respective service name and listener name:
maxctrl: destroy listener Round-Robin-Service Round-Robin-Listener
OKThis concludes this episode of basic MaxScale management tasks for MariaDB Cluster. In the next series, we are going to cover the MaxScale advanced management tasks like service filters, MaxScale user management and so on.
