summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAndrew Klychkov <aaklychkov@mail.ru>2020-01-30 19:44:47 +0300
committerGitHub <noreply@github.com>2020-01-30 11:44:47 -0500
commitc9a34ae33e13b189c589063a0aff923e444c96c6 (patch)
tree2b48980a0d47afc0f5da8c931adee8973ba488e3
parentc8568a5c9431b6d3770d555f865b2d88a294e3d8 (diff)
downloadansible-c9a34ae33e13b189c589063a0aff923e444c96c6.tar.gz
mysql modules: fix the module's documentation (#66848)
-rw-r--r--lib/ansible/plugins/doc_fragments/mysql.py7
1 files changed, 7 insertions, 0 deletions
diff --git a/lib/ansible/plugins/doc_fragments/mysql.py b/lib/ansible/plugins/doc_fragments/mysql.py
index 56ac8f404e..9c204cb276 100644
--- a/lib/ansible/plugins/doc_fragments/mysql.py
+++ b/lib/ansible/plugins/doc_fragments/mysql.py
@@ -20,6 +20,8 @@ options:
login_host:
description:
- Host running the database.
+ - In some cases for local connections the I(login_unix_socket=/path/to/mysqld/socket),
+ that is usually C(/var/run/mysqld/mysqld.sock), needs to be used instead of I(login_host=localhost).
type: str
default: localhost
login_port:
@@ -74,4 +76,9 @@ notes:
passing credentials. If none are present, the module will attempt to read
the credentials from C(~/.my.cnf), and finally fall back to using the MySQL
default login of 'root' with no password.
+ - If there are problems with local connections, using I(login_unix_socket=/path/to/mysqld/socket)
+ instead of I(login_host=localhost) might help. As an example, the default MariaDB installation of version 10.4
+ and later uses the unix_socket authentication plugin by default that
+ without using I(login_unix_socket=/var/run/mysqld/mysqld.sock) (the default path)
+ causes the error ``Host '127.0.0.1' is not allowed to connect to this MariaDB server``.
'''