#!/bin/bash

####################################################################################################
#### author: SlickStack ############################################################################
#### link: https://slickstack.io ###################################################################
#### mirror: https://mirrors.slickstack.io/bash/ss-dump-database.txt ###############################
#### path: /var/www/ss-dump-database ###############################################################
#### destination: n/a (not a boilerplate) ##########################################################
#### purpose: Dumps the database(s) to /var/www/backups/mysql/ (SFTP user can access) ##############
#### module version: MySQL 8.0.x ###################################################################
#### sourced by: ss core cron jobs, ss core bash scripts ###########################################
#### bash aliases: ss dump database, ss dump db, ss dump mysql #####################################
####################################################################################################

## KEEP IN MIND SS-DUMP-DATABASE MIGHT ONLY FUNCTION PROPERLY ON LOCALHOST DATABASES ##
## REMOTE MYSQL SERVER SETTINGS (ETC) MIGHT PREVENT REMOTE DATABASE DUMPING ##

## source ss-config ##
source /var/www/ss-config

## source ss-functions ##
source /var/www/ss-functions

## BELOW THIS RELIES ON SS-CONFIG AND SS-FUNCTIONS

####################################################################################################
#### TABLE OF CONTENTS (SS-Dump-Database) ##########################################################
####################################################################################################

## this is a brief summary of the different code snippets you will find in this script ##
## each section should be commented so you understand what is being accomplished ##

## A. Touch Timestamp File
## B. Message (Begin Script)
## C. Dump MySQL Database(s)
## D. Reset Permissions (Database Dump Files)

####################################################################################################
#### A. SS-Dump-Database: Touch Timestamp File #####################################################
####################################################################################################

## this is a dummy timestamp file that will remember the last time this script was run ##
## it can be useful for developer reference and is sometimes used by SlickStack ##

## script timestamp ##
ss_touch "${TIMESTAMP_SS_DUMP_DATABASE}"

####################################################################################################
#### B. SS-Dump-Database: Message (Begin Script) ###################################################
####################################################################################################

## this is a simple message that announces to the shell the purpose of this bash script ##
## it will only be noticed by sudo users who manually call ss core bash scripts ##

## echo message ##
ss_echo "${COLOR_INFO}Running ss-dump-database: Dumps the database(s) to /var/www/backups/mysql/ (SFTP user can access)... ${COLOR_RESET}"

####################################################################################################
#### C. SS-Dump-Database: Dump MySQL Database(s) ###################################################
####################################################################################################

## here we use mysqldump to dump the various databases under /var/www/backups/mysql/ ##
## to support remote database servers we force the TCP protocol (not sockets) ##

## dump production database ##
if [[ "$SS_DUMP_DATABASE_PRODUCTION" != "false" ]]; then
    ss_mysqldump "$DB_NAME" > "$PATH_DUMP_DATABASE_PRODUCTION" 2> /dev/null
fi

## dump staging database ##
if [[ "$SS_DUMP_DATABASE_STAGING" == "true" ]]; then
    ss_mysqldump staging > "$PATH_DUMP_DATABASE_STAGING" 2> /dev/null
fi

## dump development database ##
if [[ "$SS_DUMP_DATABASE_DEVELOPMENT" == "true" ]]; then
    ss_mysqldump development > "$PATH_DUMP_DATABASE_DEVELOPMENT" 2> /dev/null
fi

## DO NOT ENABLE THIS IN SS-CONFIG UNLESS YOUR SERVER HAS A TON OF EXTRA DISK SPACE ##
## (also in future should stop mysql-server here before ss-dump to avoid corrupted mysql data files) ##
## also should check if enough disk space before doing this ##
if [[ "$SS_DUMP_DATABASE_FILES" == "true" ]]; then 
    cp "$PATH_DATABASE_FILES_01" "$PATH_DUMP_DATABASE_FILES_01"
    cp "$PATH_DATABASE_FILES_02" "$PATH_DUMP_DATABASE_FILES_02"
    cp "$PATH_DATABASE_FILES_03" "$PATH_DUMP_DATABASE_FILES_03"
    cp "$PATH_DATABASE_FILES_04" "$PATH_DUMP_DATABASE_FILES_04"
    cp "$PATH_DATABASE_FILES_05" "$PATH_DUMP_DATABASE_FILES_05"
fi

####################################################################################################
#### D. SS-Dump-Database: Reset Permissions (Database Dump Files) ##################################
####################################################################################################

## here we do a quick permissions reset to ensure SFTP users can access the dump file ##
## keep in mind that root/sudo users will have access to this file regardless ##

## reset permissions (production) ##
chown -R $SFTP_USER:www-data "$PATH_DUMP_DATABASE_PRODUCTION"
chmod 0440 "$PATH_DUMP_DATABASE_PRODUCTION"

## reset permissions (staging) ##
if [[ "$SS_DUMP_DATABASE_STAGING" == "true" ]]; then
    chown -R $SFTP_USER:www-data "$PATH_DUMP_DATABASE_STAGING"
    chmod 0440 "$PATH_DUMP_DATABASE_STAGING"
fi

## reset permissions (development) ##
if [[ "$SS_DUMP_DATABASE_DEVELOPMENT" == "true" ]]; then
    chown -R $SFTP_USER:www-data "$PATH_DUMP_DATABASE_DEVELOPMENT"
    chmod 0440 "$PATH_DUMP_DATABASE_DEVELOPMENT"
fi

####################################################################################################
#### SS-Dump-Database: fail message if dump file is null or empty ###################################################
####################################################################################################

##

####################################################################################################
#### SlickStack: External References Used To Improve This Script (Thanks, Interwebz) ###############
####################################################################################################

## Ref: https://dev.mysql.com/doc/refman/5.7/en/mysqldump.html
## Ref: https://unix.stackexchange.com/questions/293966/suppress-warning-messages-from-mysql-in-shell-script-but-allow-errors
## Ref: https://github.com/cytopia/devilbox/issues/212
## Ref: https://stackoverflow.com/questions/32133353/unable-to-connect-to-mysql-database-in-ubuntu
## Ref: https://dba.stackexchange.com/questions/35847/mysqldump-flush-privileges-option
## Ref: https://www.sqlshack.com/how-to-install-mysql-on-ubuntu-18-04/
## Ref: https://stackoverflow.com/questions/2989724/how-to-mysqldump-remote-db-from-local-machine
## Ref: https://dev.mysql.com/doc/refman/8.0/en/transport-protocols.html
## Ref: https://dev.mysql.com/doc/refman/8.0/en/mysqldump.html
## Ref: https://snapshooter.io/learn/mysqldump-ultimate-guide
## Ref: https://www.interserver.net/tips/kb/ultimate-guide-mysqldump-database-backup-program/
## Ref: https://serverfault.com/questions/547438/mysqldump-has-a-quick-option-why-isnt-this-enabled-by-default
## Ref: https://bugs.mysql.com/bug.php?id=100219
## Ref: https://serversforhackers.com/c/mysqldump-with-modern-mysql
## Ref: https://dan.langille.org/2020/07/21/mysqldump-error-access-denied-you-need-at-least-one-of-the-process-privileges-for-this-operation-when-trying-to-dump-tablespaces/
## Ref: https://forums.cpanel.net/threads/cpanel-33473-mysql-dump-process-privilege-error-after-5-7-31-update.675657/
## Ref: https://dba.stackexchange.com/questions/271981/access-denied-you-need-at-least-one-of-the-process-privileges-for-this-ope
## Ref: https://stackoverflow.com/questions/37805316/what-is-a-tablespace-and-why-is-it-used
## Ref: https://stackoverflow.com/questions/2482491/is-copying-var-lib-mysql-a-good-alterntive-to-mysqldump
## Ref: https://serverfault.com/questions/659048/can-i-copy-the-entire-var-lib-mysql-folder-to-a-different-server-mysql-vs-mar/659049
## Ref: https://serverfault.com/questions/81241/making-backup-by-copying-mysql-data-folder-is-ok-as-long-as-both-source-and-tar
## Ref: https://stackoverflow.com/questions/30835874/how-to-avoid-use-database-statement-on-mysqldump-backups
## Ref: https://forums.asp.net/t/1534483.aspx?mysql+dump+don+t+generate+USE+database+

## SS_EOF