I det forrige blogindlæg har vi dækket nogle introduktioner til MaxScale-installation, -opgradering og -implementering ved hjælp af MaxCtrl-kommandolinjeklient. I dette blogindlæg vil vi dække MaxScale-styringsaspekterne for vores MariaDB-klynge.
Der er en række MaxScale-komponenter, som vi kan administrere med MaxCtrl, nemlig:
- Serverstyring
- Servicestyring
- Overvåg administration
- Lytteradministration
- Filterstyring
- MaxScale-styring
- Logføringsstyring
I dette blogindlæg skal vi dække de første 4 komponenter, som er almindeligt brugt i MariaDB Cluster. Alle kommandoerne i dette blogindlæg er baseret på MaxScale 2.4.11.
Serverstyring
List/vis servere
List en oversigt over alle servere i 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 │
└────────────────┴────────────────┴──────┴─────────────┴─────────────────────────┴─────────────┘For MariaDB Cluster opsummerer serverlisten kun node- og klyngetilstanden med dets MariaDB GTID, hvis klyngen er indstillet til at replikere fra en anden klynge via standard MariaDB-replikering. Tilstanden bruges af MaxScale til at kontrollere opførselen af routingalgoritmen:
- Master – For en klynge betragtes dette som Write-Master.
- Slave - Hvis alle slaver er nede, men masteren stadig er tilgængelig, vil routeren bruge masteren.
- Synkroniseret - En klynge node, som er i en synkroniseret tilstand med klyngen.
- Kører - En server, der kører. Alle servere, som MariaDB MaxScale kan oprette forbindelse til, er mærket som kørende.
Selvom MariaDB Cluster er i stand til at håndtere multi-master-replikering, vil MaxScale altid vælge én node til at holde Master-rollen, som vil modtage alle skrivninger til readwritesplit-routing. Som standard vil Galera Monitor vælge noden med den laveste wsrep_local_index værdi som master. Dette vil betyde, at to MaxScales, der kører på forskellige servere, vil vælge den samme server som masteren.
Vis alle servere mere detaljeret:
maxctrl: show serversOpret servere
Dette er almindeligvis den første ting, du skal gøre, når du opsætter MaxScale som en belastningsbalancer. Det er almindeligt at tilføje alle MariaDB Cluster-noder i MaxScale og mærke det med et objektnavn. I dette eksempel mærker vi Galera-knuderne som i formatet "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 3306Servertilstanden vil først blive rapporteret korrekt, når vi har aktiveret overvågningsmodulet, som vist under afsnittet Monitor Management længere nede.
Slet en server
For at slette en server skal man på forhånd fjerne forbindelsen mellem serveren og eventuelle tjenester eller skærme. Som et eksempel, i den følgende serverliste, ønsker vi at slette mariadbgalera3 fra 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 │
└────────────────┴────────────────┴──────┴─────────────┴─────────────────────────┴─────────────┘Læs alle skærme og se, om serveren er en del af et skærmmodul:
maxctrl: list monitors
┌─────────────────┬─────────┬────────────────────────────────────────────────┐
│ Monitor │ State │ Servers │
├─────────────────┼─────────┼────────────────────────────────────────────────┤
│ MariaDB-Monitor │ Running │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
└─────────────────┴─────────┴────────────────────────────────────────────────┘Det ser ud til, at mariadbgalera3 er en del af MariaDB-Monitor, så vi skal først fjerne det ved at bruge kommandoen "unlink monitor":
maxctrl: unlink monitor MariaDB-Monitor mariadbgalera3
OKListe derefter alle tjenester for at kontrollere, om den tilsvarende server er en del af nogen MaxScale-tjenester:
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 │ │
└─────────────────────┴────────────────┴─────────────┴───────────────────┴────────────────────────────────────────────────┘Som du kan se, er mariadbgalera3 en del af Read-Write-Service og Round-Robin-Service. Fjern serveren fra disse tjenester ved at bruge kommandoen "unlink service":
maxctrl: unlink service Read-Write-Service mariadbgalera3
OK
maxctrl: unlink service Round-Robin-Service mariadbgalera3
OKEndelig kan vi fjerne serveren fra MaxScale ved at bruge kommandoen "destroy server":
maxctrl: destroy server mariadbgalera3
OKBekræft ved hjælp af "listeserverne", at vi har fjernet mariadbgalera3 fra 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 │ │
└────────────────┴────────────────┴──────┴─────────────┴─────────────────────────┴──────┘Rediger serverens parameter
For at ændre en servers parameter kan man bruge kommandoen "alter server", som kun tager én nøgle/værdi parameter ad gangen. For eksempel:
maxctrl: alter server mariadbgalera3 priority 10
OKBrug kommandoen "show server" og kig ind i Parameters sektionen for en liste over parametre, der kan ændres for "server"-objektet:
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" │
│ │ }Bemærk, at alter-kommando-effekten er øjeblikkelig, og parameterens værdi i kørselstiden vil blive ændret såvel som værdien i dens individuelle MaxScale-konfigurationsfil inde i /var/lib/maxscale/maxscale.cnf.d/ for at blive ved med at genstarte.
Indstil servertilstand
MaxScale tillader, at backend Galera-serverne midlertidigt udelukkes fra belastningsbalanceringssættet ved at aktivere vedligeholdelsestilstanden. Vi kan opnå dette ved at bruge kommandoen "set server":
maxctrl: set server mariadbgalera3 maintenance
OKNår vi ser på serverens tilstand, bør vi se dette:
maxctrl: show server mariadbgalera3
...
│ State │ Maintenance, Running
...Når en server er i vedligeholdelsestilstand, vil der ikke blive oprettet forbindelser til den, og eksisterende forbindelser vil blive lukket. For at rydde vedligeholdelsestilstanden fra værten skal du bruge kommandoen "clear server":
maxctrl: clear server mariadbgalera3 maintenance
OKBekræft med "vis server":
maxctrl: show server mariadbgalera3
...
│ State │ Slave, Synced, Running │
...Monitorstyring
Opret en skærm
MaxScale-monitormodulet til MariaDB Cluster kaldes galeramon. Det er nødvendigt at definere et korrekt overvågningsmodul, så MaxScale kan bestemme den bedste routing for forespørgsler afhængigt af nodernes tilstand. For eksempel, hvis en Galera-knude fungerer som donor for en joiner-knude, skal den så være en del af de sunde knudepunkter? I nogle tilfælde, f.eks. hvor databasestørrelsen er så lille, er det ikke en dårlig plan at markere en donornode som sund (ved at indstille parameteren available_when_donor=true i MaxScale), og nogle gange forbedrer forespørgselsdirigeringens ydeevne.
For at oprette en service (router) skal man oprette en overvågningsbruger på backend af MariaDB-servere. Almindeligvis ville man bruge den samme overvågningsbruger, som vi har defineret for overvågningsmodulet. For Galera Cluster, hvis overvågningsbrugeren ikke eksisterer, skal du bare oprette den på en af noderne med følgende privilegier:
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';Brug kommandoen "create monitor" og angiv et navn med galeramon som monitormodul:
maxctrl: create monitor MariaDB-Monitor galeramon servers=mariadbgalera1,mariadbgalera2,mariadbgalera3 user=maxscale_monitor password=MaXSc4LeP4ss
OKBemærk, at vi ikke konfigurerede MaxScale secret, hvilket betyder, at vi gemmer brugeradgangskoden i almindeligt tekstformat. For at aktivere kryptering, se eksemplet i dette blogindlæg, Introduktion til MaxScale Administration Brug af maxctrl til MariaDB Cluster under afsnittet Tilføjelse af overvågning til MaxScale.
List/vis skærme
Sådan viser du alle skærme:
maxctrl: list monitors
┌─────────────────┬─────────┬────────────────────────────────────────────────┐
│ Monitor │ State │ Servers │
├─────────────────┼─────────┼────────────────────────────────────────────────┤
│ MariaDB-Monitor │ Running │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
└─────────────────┴─────────┴────────────────────────────────────────────────┘For at få et mere detaljeret kig på skærmen skal du bruge kommandoen "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 │
│ │ } │
└─────────────────────┴───────────────────────────────────────────┘Stop/Start Monitor
Stopping af en skærm vil sætte overvågningen af serverne på pause. Dette bliver almindeligvis brugt sammen med kommandoen "set server" til manuelt at kontrollere servertilstande. Brug kommandoen "stop monitor" for at stoppe overvågningstjenesten:
maxctrl: stop monitor MariaDB-Monitor
OKBekræft tilstanden med "vis monitor":
maxctrl: show monitors MariaDB-Monitor
┌─────────────────────┬───────────────────────────────────────────┐
│ Monitor │ MariaDB-Monitor │
├─────────────────────┼───────────────────────────────────────────┤
│ State │ Stopped │
...For at starte den op igen, brug "startmonitoren":
maxctrl: start monitor MariaDB-Monitor
OKRediger monitorens parameter
For at ændre en parameter for denne monitor skal du bruge kommandoen "ændre monitor" og angive parameternøglen/værdien som nedenfor:
maxctrl: alter monitor MariaDB-Monitor available_when_donor true
OKBrug kommandoen "show monitor" og kig ind i Parameters-sektionen for en liste over parametre, der kan ændres for galeramon-modulet:
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 │
│ │ } │
Slet en skærm
For at slette en skærm, skal man først fjerne alle servere, der er forbundet med skærmen. Overvej f.eks. følgende skærm i MaxScale:
maxctrl: list monitors
┌─────────────────┬─────────┬────────────────────────────────────────────────┐
│ Monitor │ State │ Servers │
├─────────────────┼─────────┼────────────────────────────────────────────────┤
│ MariaDB-Monitor │ Running │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
└─────────────────┴─────────┴────────────────────────────────────────────────┘Fjern alle servere fra den pågældende tjeneste:
maxctrl: unlink monitor MariaDB-Monitor mariadbgalera1 mariadbgalera2 mariadbgalera3
OKVores skærm ser nu sådan ud:
maxctrl: list monitors
┌─────────────────┬─────────┬─────────┐
│ Monitor │ State │ Servers │
├─────────────────┼─────────┼─────────┤
│ MariaDB-Monitor │ Running │ │
└─────────────────┴─────────┴─────────┘Kun derefter kan vi slette monitoren:
maxctrl: destroy monitor MariaDB-Monitor
OKTilføj/fjern servere til skærm
Efter at have oprettet en skærm, kan vi bruge kommandoen "link monitor" til at tilføje Galera-serverne til skærmen. Brug serverens navn som oprettet i afsnittet Opret servere:
maxctrl: link monitor MariaDB-Monitor mariadbgalera1 mariadbgalera2 mariadbgalera3
OKPå samme måde, for at fjerne en server fra tjenesten, skal du bare bruge kommandoen "unlink monitor":
maxctrl: unlink monitor MariaDB-Monitor mariadbgalera3
OKBekræft med kommandoen "liste skærme" eller "vis skærme".
Servicestyring
Opret en tjeneste
For at oprette en service (router) skal man oprette en overvågningsbruger på backend af MariaDB-servere. Almindeligvis ville man bruge den samme overvågningsbruger, som vi har defineret for overvågningsmodulet. For Galera Cluster, hvis overvågningsbrugeren ikke eksisterer, skal du bare oprette den på en af noderne med følgende privilegier:
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';Hvor 192.168.0.220 er IP-adressen på MaxScale-værten.
Angiv derefter navnet på tjenesten, routingtypen sammen med en overvågningsbruger, så MaxScale kan oprette forbindelse til backend-serverne:
maxctrl: create service Round-Robin-Service readconnroute user=maxscale_monitor password=******
OKDu kan også angive yderligere parametre, når du opretter tjenesten. I dette eksempel vil vi gerne have "master"-knuden inkluderet i round-robin balanceringssættet til vores MariaDB Galera Cluster:
maxctrl: create service Round-Robin-Service readconnroute user=maxscale_monitor password=****** router_options=master,slave
OKBrug kommandoen "show service" for at se de understøttede parametre. For round-robin router, listen som følger:
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": 0For the read-write split router, the supported parameters are:
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 servicesOr if you want to show a particular service:
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.