hcq/MaxScale
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Document the service users refresh interval

Browse Source 
The interval between refreshes of the database users list wasn't
documented.
This commit is contained in:
Markus Mäkelä
2017-04-26 09:47:59 +03:00
parent f1efe72f66
commit 5bf79637c6
1 changed files with 8 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
Documentation/Getting-Started/Configuration-Guide.md
View File

@ -642,26 +642,18 @@ The account used must be able to select from the mysql.user table, the following
is an example showing how to create this user. is an example showing how to create this user.
``` ```
MariaDB [mysql]> CREATE USER 'maxscale'@'maxscalehost' IDENTIFIED BY 'Mhu87p2D'; CREATE USER 'maxscale'@'maxscalehost' IDENTIFIED BY 'maxscale-password';
Query OK, 0 rows affected (0.01 sec)
MariaDB [mysql]> GRANT SELECT ON mysql.user TO 'maxscale'@'maxscalehost';
Query OK, 0 rows affected (0.00 sec)
``` ```
Additionally, `SELECT` privileges on the `mysql.db` and `mysql.tables_priv` Additionally, `SELECT` privileges on the `mysql.user`, `mysql.db` and `mysql.tables_priv`
tables and `SHOW DATABASES` privileges are required in order to load databases tables and `SHOW DATABASES` privileges are required in order to load databases
name and grants suitable for database name authorization. name and grants suitable for database name authorization.
``` ```
MariaDB [(none)]> GRANT SELECT ON mysql.db TO 'maxscale'@'maxscalehost'; GRANT SELECT ON mysql.user TO 'maxscale'@'maxscalehost';
Query OK, 0 rows affected (0.00 sec) GRANT SELECT ON mysql.db TO 'maxscale'@'maxscalehost';
GRANT SELECT ON mysql.tables_priv TO 'maxscale'@'maxscalehost';
MariaDB [(none)]> GRANT SELECT ON mysql.tables_priv TO 'maxscale'@'maxscalehost'; GRANT SHOW DATABASES ON *.* TO 'maxscale'@'maxscalehost';
Query OK, 0 rows affected (0.00 sec)
MariaDB [(none)]> GRANT SHOW DATABASES ON *.* TO 'maxscale'@'maxscalehost';
Query OK, 0 rows affected (0.00 sec)
``` ```
MariaDB MaxScale will execute the following query to retrieve the users. If you MariaDB MaxScale will execute the following query to retrieve the users. If you
@ -689,6 +681,8 @@ In versions of MySQL 5.7.6 and later, the `Password` column was replaced by
`authentication_string`. Change `user.password` above with `authentication_string`. Change `user.password` above with
`user.authentication_string`. `user.authentication_string`.
**Note**: If authentication fails, MaxScale will try to refresh the list of
database users used by the service up to 4 times every 30 seconds.
#### `passwd` #### `passwd`