Documentation: #212 MySQL configuration files on Docker Toolbox

This commit is contained in:
cytopia 2018-04-07 09:48:20 +02:00
parent 63fa5e6811
commit 86b4247b81
No known key found for this signature in database
GPG Key ID: 6D56EDB8695128A2
2 changed files with 34 additions and 1 deletions

View File

@ -9,6 +9,13 @@ my.cnf
MySQL version.
.. important::
When using :ref:`docker_toolbox` on Windows, ``*.cnf`` files must have read-only file
permissions, otherwise they are not sourced by the MySQL server.
Make sure to ``chmod 0444 *.cnf`` after adding your values.
**Table of Contents**
.. contents:: :local:
@ -42,7 +49,7 @@ The file must end by ``.cnf`` in order to be sourced by the MySQL server.
Each of the MySQL cnf configuration directories already contain an example file:
``devilbox-custom.cnf-example``, that can simply be renamed to ``devilbox-custom.cnf``.
This file holds same example values that can be adjusted or commented out.
This file holds some example values that can be adjusted or commented out.
In order for the changes to be applied, you will have to restart the Devilbox.

View File

@ -37,3 +37,29 @@ In order to remove the container do the following:
host> docker-compose rm -f
.. seealso:: :ref:`remove_stopped_container`
[Warning] World-writable config file '/etc/mysql/docker-default.d/my.cnf' is ignored
------------------------------------------------------------------------------------
This warning might occur when using :ref:`docker_toolbox` on Windows and trying to apply custom
MySQL configuration files. This will also result in the configuration file not being source
by the MySQL server.
To fix this issue, you will have to change the file permission of your custom configuration files
to read-only by applying the following ``chmod`` command.
.. code-block:: bash
# Nagivate to devilbox git directory
host> cd path/to/devilbox
# Navigate to the MySQL config directory (e.g.: MySQL 5.5)
host> cd cfg/mysql-5.5
# Make cnf files read only
host> chmod 0444 *.cnf
.. seealso::
* :ref:`my_cnf`
* https://github.com/cytopia/devilbox/issues/212