Create mini-tutorials for monitor and server configuration
The tutorials combine the Galera and MariaDB monitor configuration as well as the server configuration sections that were duplicated for all tutorials. This should make the documentation easier to maintain.
This commit is contained in:
56
Documentation/Tutorials/Configuring-MariaDB-Monitor.md
Normal file
56
Documentation/Tutorials/Configuring-MariaDB-Monitor.md
Normal file
@ -0,0 +1,56 @@
|
||||
# Configuring the MariaDB Monitor
|
||||
|
||||
This document describes how to configure a MariaDB master-slave cluster monitor to be used with MaxScale.
|
||||
|
||||
## Configuring the Servers
|
||||
|
||||
The first step is to define the servers that make up the cluster. These servers will be used by the services and are monitored by the monitor.
|
||||
|
||||
```
|
||||
[dbserv1]
|
||||
type=server
|
||||
address=192.168.2.1
|
||||
port=3306
|
||||
protocol=MariaDBBackend
|
||||
|
||||
[dbserv2]
|
||||
type=server
|
||||
address=192.168.2.2
|
||||
port=3306
|
||||
protocol=MariaDBBackend
|
||||
|
||||
[dbserv3]
|
||||
type=server
|
||||
address=192.168.2.3
|
||||
port=3306
|
||||
protocol=MariaDBBackend
|
||||
```
|
||||
|
||||
## Configuring the Monitor
|
||||
|
||||
The next step is to define the monitor that monitors the servers.
|
||||
|
||||
```
|
||||
[Replication-Monitor]
|
||||
type=monitor
|
||||
module=mariadbmon
|
||||
servers=dbserv1, dbserv2, dbserv3
|
||||
user=monitor_user
|
||||
password=my_password
|
||||
monitor_interval=2000
|
||||
```
|
||||
|
||||
The mandatory parameters are the object type, the monitor module to use, the
|
||||
list of servers to monitor and the username and password to use when connecting
|
||||
to the servers. The `monitor_interval` parameter controls how many milliseconds
|
||||
the monitor waits between each monitoring loop.
|
||||
|
||||
## Monitor User
|
||||
|
||||
The monitor user requires the REPLICATION CLIENT privileges to do basic
|
||||
monitoring. To create a user with the proper grants, execute the following SQL.
|
||||
|
||||
```
|
||||
CREATE USER 'monitor_user'@'%' IDENTIFIED BY 'my_password';
|
||||
GRANT REPLICATION CLIENT on *.* to 'monitor_user'@'%';
|
||||
```
|
||||
Reference in New Issue
Block a user