LinuxGSM/lgsm/functions/command_backup.sh

#!/bin/bash
# LinuxGSM command_backup.sh function
# Author: Daniel Gibbs
# Contributor: UltimateByte
# Website: https://linuxgsm.com
# Description: Creates a .tar.gz file in the backup directory.

local modulename="BACKUP"
local commandaction="Backup"
local function_selfname=$(basename "$(readlink -f "${BASH_SOURCE[0]}")")

check.sh

# Trap to remove lockfile on quit.
fn_backup_trap(){
	echo -e ""
	echo -en "backup ${backupname}.tar.gz..."
	fn_print_canceled_eol_nl
	fn_script_log_info "Backup ${backupname}.tar.gz: CANCELED"
	rm -f "${backupdir:?}/${backupname}.tar.gz" | tee -a "${lgsmlog}"
	echo -en "backup ${backupname}.tar.gz..."
	fn_print_removed_eol_nl
	fn_script_log_info "Backup ${backupname}.tar.gz: REMOVED"
	# Remove lock file.
	rm -f "${tmpdir:?}/.backup.lock"
	core_exit.sh
}

# Check if a backup is pending or has been aborted using .backup.lock.
fn_backup_check_lockfile(){
	if [ -f "${tmpdir}/.backup.lock" ]; then
		fn_print_info_nl "Lock file found: Backup is currently running"
		fn_script_log_error "Lock file found: Backup is currently running: ${tmpdir}/.backup.lock"
		core_exit.sh
	fi
}

# Initialisation.
fn_backup_init(){
	# Backup file name with selfname and current date.
	backupname="${selfname}-$(date '+%Y-%m-%d-%H%M%S')"

	info_distro.sh
	fn_print_dots "Backup starting"
	fn_script_log_info "Backup starting"
	fn_print_ok "Backup starting"
	if [ ! -d "${backupdir}" ]||[ "${backupcount}" == "0" ]; then
		fn_print_info "There are no previous backups"
	else
		if [ "${lastbackupdaysago}" == "0" ]; then
			daysago="less than 1 day ago"
		elif [ "${lastbackupdaysago}" == "1" ]; then
			daysago="1 day ago"
		else
			daysago="${lastbackupdaysago} days ago"
		fi
		echo -en "\n"
		echo -e "* Previous backup was created ${daysago}, total size ${lastbackupsize}"
	fi
}

# Check if server is started and whether to stop it.
fn_backup_stop_server(){
	check_status.sh
	# Server is stopped.
	if [ "${status}" == "0" ]; then
		serverstopped="no"
	# Server is running and stoponbackup=off.
	elif [ "${stoponbackup}" == "off" ]; then
		serverstopped="no"
		fn_print_warn_nl "${selfname} is currently running"
		echo -e "* Although unlikely; creating a backup while ${selfname} is running might corrupt the backup."
		fn_script_log_warn "${selfname} is currently running"
		fn_script_log_warn "Although unlikely; creating a backup while ${selfname} is running might corrupt the backup"
	# Server is running and will be stopped if stoponbackup=on or unset.
	else
		fn_print_warn "${selfname} will be stopped during the backup"
		fn_script_log_warn "${selfname} will be stopped during the backup"
		serverstopped="yes"
		exitbypass=1
		command_stop.sh
	fi
}

# Create required folders.
fn_backup_dir(){
	# Create backupdir if it doesn't exist.
	if [ ! -d "${backupdir}" ]; then
		mkdir -p "${backupdir}"
	fi
}

# Migrate Backups from old dir before refactor
fn_backup_migrate_olddir(){
	# Check if old backup dir is there before the refactor and move the backups
	if [ -d "${rootdir}/backups" ]; then
		if [ "${rootdir}/backups" != "${backupdir}" ]; then
			fn_print_dots "Backup directory is being migrated"
			fn_script_log_info "Backup directory is being migrated"
			fn_script_log_info "${rootdir}/backups > ${backupdir}"
			mv "${rootdir}/backups/"* "${backupdir}" 2>/dev/null
			exitcode=$?
			if [ "${exitcode}" -eq 0 ]; then
				rmdir "${rootdir}/backups" 2>/dev/null
				exitcode=$?
			fi
			if [ "${exitcode}" -eq 0 ]; then
				fn_print_ok_nl "Backup directory is being migrated"
				fn_script_log_pass "Backup directory is being migrated"
			else
				fn_print_error_nl "Backup directory is being migrated"
				fn_script_log_error "Backup directory is being migrated"
			fi
		fi
	fi
}

fn_backup_create_lockfile(){
	# Create lockfile.
	date '+%s' > "${tmpdir}/.backup.lock"
	fn_script_log_info "Lockfile generated"
	fn_script_log_info "${tmpdir}/.backup.lock"
	# trap to remove lockfile on quit.
	trap fn_backup_trap INT
}

# Compressing files.
fn_backup_compression(){
	# Tells how much will be compressed using rootdirduexbackup value from info_distro and prompt for continue.
	fn_print_info "A total of ${rootdirduexbackup} will be compressed."
	fn_script_log_info "A total of ${rootdirduexbackup} will be compressed: ${backupdir}/${backupname}.tar.gz"
	fn_print_dots "Backup (${rootdirduexbackup}) ${backupname}.tar.gz, in progress..."
	fn_script_log_info "backup ${rootdirduexbackup} ${backupname}.tar.gz, in progress"
	excludedir=$(fn_backup_relpath)

	# Check that excludedir is a valid path.
	if [ ! -d "${excludedir}" ] ; then
		fn_print_fail "Problem identifying the previous backup directory for exclusion."
		fn_script_log_fatal "Problem identifying the previous backup directory for exclusion"
		core_exit.sh
	fi

	tar -czf "${backupdir}/${backupname}.tar.gz" -C "${rootdir}" --exclude "${excludedir}" --exclude "${tmpdir}/.backup.lock" ./.
	local exitcode=$?
	if [ ${exitcode} -ne 0 ]; then
		fn_print_fail_eol
		fn_script_log_fatal "Backup in progress: FAIL"
		echo -e "${tarcmd}" | tee -a "${lgsmlog}"
		fn_print_fail "Starting backup"
		fn_script_log_fatal "Starting backup"
	else
		fn_print_ok_eol
		fn_print_ok "Completed: ${backupname}.tar.gz, total size $(du -sh "${backupdir}/${backupname}.tar.gz" | awk '{print $1}')"
		fn_script_log_pass "Backup created: ${backupname}.tar.gz, total size $(du -sh "${backupdir}/${backupname}.tar.gz" | awk '{print $1}')"
	fi
	# Remove lock file
	rm -f "${tmpdir:?}/.backup.lock"
}

# Clear old backups according to maxbackups and maxbackupdays variables.
fn_backup_prune(){
	# Clear if backup variables are set.
	if [ "${maxbackups}" ]&&[ -n "${maxbackupdays}" ]; then
		# How many backups there are.
		info_distro.sh
		# How many backups exceed maxbackups.
		backupquotadiff=$((backupcount-maxbackups))
		# How many backups exceed maxbackupdays.
		backupsoudatedcount=$(find "${backupdir}"/ -type f -name "*.tar.gz" -mtime +"${maxbackupdays}"|wc -l)
		# If anything can be cleared.
		if [ "${backupquotadiff}" -gt "0" ]||[ "${backupsoudatedcount}" -gt "0" ]; then
			fn_print_dots "Pruning"
			fn_script_log_info "Backup pruning activated"
			fn_print_ok "Pruning"
			# If maxbackups greater or equal to backupsoutdatedcount, then it is over maxbackupdays.
			if [ "${backupquotadiff}" -ge "${backupsoudatedcount}" ]; then
				# Display how many backups will be cleared.
				echo -e "* Pruning: ${backupquotadiff} backup(s) has exceeded the ${maxbackups} backups limit"
				fn_script_log_info "Pruning: ${backupquotadiff} backup(s) has exceeded the ${maxbackups} backups limit"
				fn_sleep_time
				fn_print_dots "Pruning: Clearing ${backupquotadiff} backup(s)"
				fn_script_log_info "Pruning: Clearing ${backupquotadiff} backup(s)"
				# Clear backups over quota.
				find "${backupdir}"/ -type f -name "*.tar.gz" -printf '%T@ %p\n' | sort -rn | tail -${backupquotadiff} | cut -f2- -d" " | xargs rm
				fn_print_ok "Pruning: Clearing ${backupquotadiff} backup(s)"
				fn_script_log_pass "Pruning: Cleared ${backupquotadiff} backup(s)"
			# If maxbackupdays is used over maxbackups.
			elif [ "${backupquotadiff}" -lt "${backupsoudatedcount}" ]; then
				# Display how many backups will be cleared.
				echo -e "* Pruning: ${backupsoudatedcount} backup(s) are older than ${maxbackupdays} days."
				fn_script_log_info "Pruning: ${backupsoudatedcount} backup(s) older than ${maxbackupdays} days."
				fn_sleep_time
				fn_print_dots "Pruning: Clearing ${backupquotadiff} backup(s)."
				fn_script_log_info "Pruning: Clearing ${backupquotadiff} backup(s)"
				# Clear backups over quota
				find "${backupdir}"/ -type f -mtime +"${maxbackupdays}" -exec rm -f {} \;
				fn_print_ok "Pruning: Clearing ${backupquotadiff} backup(s)"
				fn_script_log_pass "Pruning: Cleared ${backupquotadiff} backup(s)"
			fi
		fi
	fi
}

fn_backup_relpath() {
		# Written by CedarLUG as a "realpath --relative-to" alternative in bash.

	# Populate an array of tokens initialized from the rootdir components.
		declare -a rdirtoks=($(readlink -f "${rootdir}" | sed "s/\// /g"))

	if [ ${#rdirtoks[@]} -eq 0 ]; then
		fn_print_fail_nl "Problem assessing rootdir during relative path assessment"
		fn_script_log_fatal "Problem assessing rootdir during relative path assessment: ${rootdir}"
		core_exit.sh
	fi

	# Populate an array of tokens initialized from the backupdir components.
		declare -a bdirtoks=($(readlink -f "${backupdir}" | sed "s/\// /g"))
	if [ ${#bdirtoks[@]} -eq 0 ]; then
		fn_print_fail_nl "Problem assessing backupdir during relative path assessment"
		fn_script_log_fatal "Problem assessing backupdir during relative path assessment: ${rootdir}"
		core_exit.sh
	fi

	# Compare the leading entries of each array.  These common elements will be clipped off.
	# for the relative path output.
		for ((base=0; base<${#rdirtoks[@]}; base++))
		do
			[[ "${rdirtoks[$base]}" != "${bdirtoks[$base]}" ]] && break
		done

	# Next, climb out of the remaining rootdir location with updir references.
		for ((x=base;x<${#rdirtoks[@]};x++))
		do
			echo -n "../"
		done

	# Climb down the remaining components of the backupdir location.
		for ((x=base;x<$(( ${#bdirtoks[@]} - 1 ));x++))
		do
					echo -n "${bdirtoks[$x]}/"
		done

	# In the event there were no directories left in the backupdir above to
	# traverse down, just add a newline. Otherwise at this point, there is
	# one remaining directory component in the backupdir to navigate.
		if (( "$base" < "${#bdirtoks[@]}" )) ; then
			echo -e "${bdirtoks[ $(( ${#bdirtoks[@]} - 1)) ]}"
		else
			echo
		fi
}

# Restart the server if it was stopped for the backup.
fn_backup_start_server(){
	if [ "${serverstopped}" == "yes" ]; then
		exitbypass=1
		command_start.sh
	fi
}

# Run functions.
fn_backup_check_lockfile
fn_backup_create_lockfile
fn_backup_init
fn_backup_stop_server
fn_backup_dir
fn_backup_migrate_olddir
fn_backup_compression
fn_backup_prune
fn_backup_start_server

core_exit.sh