Backup and restore MySQL¶
Backup and restore will be necessary when you are going to switch MySQL versions. Each version has its own data directory and is fully indepentend of other versions. In case you want to switch to a different version, but still want to have your MySQL databases present, you must first backup the databases of your current version and import them into the new version.
There are multiple ways to backup and restore. Chose the one which is most convenient for you.
Table of Contents
There are many different options to backup your MySQL database including some for the command line
and some for using the Web interface. The recommended and fastest method is to use
mysqldump-secure, as it will also add info files (*.info) to each database recording checksums,
dump date, dump options as well as the server version it came from.
is bundled, setup and ready to use in every PHP container.
You can run it without any arguments and it will dump each available database as a
separated compressed file. Backups will be located in
./backups/mysql/ inside the Devilbox
git directory or in
/shared/backups/mysql/ inside the PHP container.
To have your backups in place is just three commands away:
# Navigate to the Devilbox directory host> cd path/to/devilbox # Enter the PHP container host> ./shell.sh # Run mysqldump-secure firstname.lastname@example.org in /shared/httpd $ mysqldump-secure [INFO] (OPT): Logging enabled [INFO] (OPT): MySQL SSL connection disabled [INFO] (OPT): Compression enabled [INFO] (OPT): Encryption disabled [INFO] (OPT): Deletion disabled [INFO] (OPT): Nagios log disabled [INFO] (OPT): Info files enabled [INFO] (SQL): 1/3 Skipping: information_schema (DB is ignored) [INFO] (SQL): 2/3 Dumping: mysql (0.66 MB) 1 sec (0.13 MB) [INFO] (SQL): 3/3 Skipping: performance_schema (DB is ignored) [OK] Finished successfully
Let’s see where to find the backups inside the PHP container:
# Navigate to the Devilbox directory host> cd path/to/devilbox # Enter the PHP container host> ./shell.sh # Show directory output email@example.com in /shared/httpd $ ls -l /shared/backups/mysql/ -rw-r--r-- 1 devilbox 136751 Jun 17 13:31 2017-06-17_13-31__mysql.sql.gz -rw-r--r-- 1 devilbox 2269 Jun 17 13:31 2017-06-17_13-31__mysql.sql.gz.info
Let’s do the same again and see where to find the backups in the Devilbox git directory
# Navigate to the Devilbox directory host> cd path/to/devilbox # Show directory output host> ls -l backups/mysql/ -rw-r--r-- 1 cytopia 136751 Jun 17 13:31 2017-06-17_13-31__mysql.sql.gz -rw-r--r-- 1 cytopia 2269 Jun 17 13:31 2017-06-17_13-31__mysql.sql.gz.info
*.info file will hold many useful information in case you need to debug any problems
occured during backups. Let’s have a look at one of them:
host> cat ./backups/mysql/2017-06-17_13-31__mysql.sql.gz.info
; mysqldump-secure backup record ; Do not alter this file! ; Creation of this file can be turned off via config file. ; ============================================================ ; = Local system information ; ============================================================ [mysqldump-secure] version = /usr/local/bin/mysqldump-secure (0.16.3) vdate = 2016-08-18 config = /etc/mysqldump-secure.conf [system] uname = Linux 4.4.0-79-generic hostname = user = devilbox group = devilbox [tools] mysqldump = /usr/bin/mysqldump (10.14 Distrib 5.5.52-MariaDB) [for Linux (x86_64)] mysql = /usr/bin/mysql (15.1 Distrib 5.5.52-MariaDB) [for Linux (x86_64) using readline 5.1] compressor = /usr/bin/gzip (gzip 1.5) encryptor = Not used ; ============================================================ ; = Database / File information ; ============================================================ [database] db_name = mysql db_size = 687326 Bytes (0.66 MB) tbl_cnt = 30 [file] file_path = /shared/backups/mysql file_name = 2017-06-17_13-31__mysql.sql.gz file_size = 136751 Bytes (0.13 MB) file_chmod = 0644 file_owner = devilbox file_group = devilbox file_mtime = 1497699116 (2017-06-17 13:31:56 CEST [+0200]) file_md5 = 8d1a6c38f81c691bc4b490e7024a4f72 file_sha = 11fb85282ea866dfc69d29dc02a0418bebfea30e7e566c3c588a50987aceac2f ; ============================================================ ; = Dump procedure information ; ============================================================ [mysqldump] encrypted = 0 compressed = 1 arguments = --opt --default-character-set=utf8 --events --triggers --routines --hex-blob --complete-insert --extended-insert --compress --lock-tables --skip-quick duration = 1 sec [compression] compressor = gzip arguments = -9 --stdout [encryption] encryptor = algorithm = pubkey = ; ============================================================ ; = Server information ; ============================================================ [connection] protocol = mysql via TCP/IP secured = No SSL arguments = --defaults-file=/etc/mysqldump-secure.cnf [server] hostname = 001b3750b549 port = 3306 replica = master version = MariaDB 10.1.23-MariaDB MariaDB Server
is bundled with each PHP container and ready to use.
To backup a database named
my_db_name follow the below listed
example which shows you how to do that from within the PHP container:
# Navigate to the Devilbox directory host> cd path/to/devilbox # Enter the PHP container host> ./shell.sh # Start the backup firstname.lastname@example.org in /shared/httpd $ mysqldump -h mysql -u root -p my_db_name > /shared/backups/mysql/my_db_name.sql
To find out more about the configuration and options of mysqldump, visit its project page under: mysqldump
If you do not like to use the command line for backups, you can use phpMyAdmin . It comes bundled with the devilbox intranet.
In order to restore or import mysql databases on the command line, you need to use the
binary. Here are a few examples for different file types:
# Navigate to the Devilbox directory host> cd path/to/devilbox # Enter the PHP container host> ./shell.sh # Start the import email@example.com in /shared/httpd $ mysql -h mysql -u root -p my_db_name < /shared/backups/mysql/my_db_name.sql
# Navigate to the Devilbox directory host> cd path/to/devilbox # Enter the PHP container host> ./shell.sh # Start the import firstname.lastname@example.org in /shared/httpd $ zcat /shared/backups/mysql/my_db_name.sql.gz | mysql -h mysql -u root -p my_db_name
supports importing many different formats out-of-the-box.
Simply select the compressed or uncompressed file and press
Go in the import section of
the web interface.