From 12f18b8456f9e90c565e7da6f1de0a81fb3493da Mon Sep 17 00:00:00 2001 From: Antonio Ospite Date: Sat, 10 Mar 2018 15:44:40 +0100 Subject: [PATCH] drin.rst: add some notes about administrative database access --- drin.rst | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/drin.rst b/drin.rst index ba65042..59101f1 100644 --- a/drin.rst +++ b/drin.rst @@ -86,6 +86,41 @@ Clean and rebuild the whole project to verify that installing from scratch works drin clean drin bootstrap +NOTES +===== + +The `bootstrap` command in `drupal-init-tools` uses `drush` for the site +installation, and `drush` requires MySQL super-user access to create new MySQL +users and databases. + +On some Linux distributions, like Debian, the MariaDB server is configured by +default to only allow access to the `root` user via the `unix_socket` plugin, +making it unusable by `drush`. In these cases it's recommended to create e new +MySQL super-user. + +For password-less access create a MySQL admin user correspondent to the system +user which will excute `drush` (e.g. the current user): + +:: + + sudo /usr/bin/mysql -e "GRANT ALL ON *.* TO '$USER'@'localhost' IDENTIFIED VIA unix_socket WITH GRANT OPTION" + + +For password regulated access create a user with a password: + +:: + + sudo /usr/bin/mysql -e "GRANT ALL ON *.* TO 'USERNAME'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION" + + +For details see also the **PASSWORDS** section in the README.Debian file +provided by the mariadb-server Debian package, either in +`/usr/share/doc/mariadb-server-10.1/README.Debian.gz` or at +https://salsa.debian.org/mariadb-team/mariadb-10.1/blob/stretch/debian/mariadb-server-10.1.README.Debian#L73 + +The settings in the `bootstrap.conf` file have to be adjusted according to how +super-user access has been configured. + SEE ALSO ======== -- 2.1.4