From ef2ae1a9b205f6fd8e67f965cd73811d888014f1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9gis=20Behmo?= <regis@behmo.com>
Date: Thu, 27 Feb 2020 18:07:41 +0100
Subject: [PATCH] Clarify database dumps

---
 docs/local.rst | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/docs/local.rst b/docs/local.rst
index ca42f50..ca3718c 100644
--- a/docs/local.rst
+++ b/docs/local.rst
@@ -214,7 +214,6 @@ The default settings module loaded by ``edx-platform`` is ``tutor.production``.
 
 Of course, your settings should be compatible with the docker installation. You can get some inspiration from the ``production.py`` settings modules generated by Tutor, or just import it as a base by adding ``from .production import *`` at the top of ``mysettings.py``.
 
-
 Upgrading from earlier versions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -255,11 +254,13 @@ With Tutor, all data are stored in a single folder. This means that it's extreme
     
     tutor local start -d
 
-Database Dumps
-~~~~~~~~~~~~~~
-To dump all the data from the mysql and mongodb databases used on the platform, run the following command::
+Making database dumps
+~~~~~~~~~~~~~~~~~~~~~
 
-    tutor local exec mysql mysqldump --all-databases --password="$(tutor config printvalue MYSQL_ROOT_PASSWORD)" > "$(tutor config printroot)/data/mysql/dump.sql"
+To dump all data from the MySQL and Mongodb databases used on the platform, run the following commands::
+
+    tutor local exec -e MYSQL_ROOT_PASSWORD="$(tutor config printvalue MYSQL_ROOT_PASSWORD)" mysql \
+        sh -c 'mysqldump --all-databases --password=$MYSQL_ROOT_PASSWORD > /var/lib/mysql/dump.sql'
     tutor local exec mongodb mongodump --out=/data/db/dump.mongodb
 
-The dump files will be located in “$(tutor config printroot)/data/mysql” and “$(tutor config printroot)/data/mongodb”.
+The ``dump.sql`` and ``dump.mongodb`` files will be located in ``$(tutor config printroot)/data/mysql`` and ``$(tutor config printroot)/data/mongodb``.