519 lines
16 KiB
Bash
Executable File
519 lines
16 KiB
Bash
Executable File
#!/bin/bash
|
|
|
|
|
|
### Text formatting presets
|
|
normal="\e[0m"
|
|
bold="\e[1m"
|
|
default="\e[39m"
|
|
err="\e[1;31m"
|
|
warn="\e[1;93m"
|
|
ok="\e[32m"
|
|
lit="\e[93m"
|
|
op="\e[39m"
|
|
info="\e[96m"
|
|
stamp="[`date +%Y-%m-%d` `date +%H:%M:%S`]"
|
|
|
|
|
|
### Functions ###
|
|
|
|
### scriptHelp -- display usage information for this script
|
|
function scriptHelp {
|
|
echo "In the future, I will be something helpful!"
|
|
# exit with code 1 -- there is no use logging this
|
|
exit 1
|
|
}
|
|
|
|
### quit -- exit the script after logging any errors, warnings, etc.
|
|
function quit {
|
|
# list generated warnings, if any
|
|
if [ ${#exitWarn[@]} -gt 0 ]; then
|
|
echo -e "${warn}${scriptName} generated the following warnings:" \
|
|
"${normal}" >> "$logFile"
|
|
for warnCode in "${exitWarn[@]}"; do
|
|
echo -e "${warn}-- [WARNING] ${warningExplain[$warnCode]}" \
|
|
"(code: ${warnCode}) --${normal}" >> "$logFile"
|
|
done
|
|
fi
|
|
if [ -z "$1" ]; then
|
|
# exit cleanly
|
|
echo -e "\e[1;35m${stamp} -- ${scriptName} completed" \
|
|
"--${normal}" >> "$logFile"
|
|
exit 0
|
|
else
|
|
# log error code and exit with said code
|
|
echo -e "${err}${stamp} -- [ERROR] ${errorExplain[$1]}" \
|
|
"(code: $1) --$normal" >> "$logFile"
|
|
exit "$1"
|
|
fi
|
|
}
|
|
|
|
function checkExist {
|
|
if [ "$1" = "ff" ]; then
|
|
# find file
|
|
if [ -f "$2" ]; then
|
|
# found
|
|
return 0
|
|
else
|
|
# not found
|
|
return 1
|
|
fi
|
|
elif [ "$1" = "fd" ]; then
|
|
# find directory
|
|
if [ -d "$2" ]; then
|
|
# found
|
|
return 0
|
|
else
|
|
# not found
|
|
return 1
|
|
fi
|
|
fi
|
|
}
|
|
|
|
### ncMaint - pass requested mode change type to NextCloud occ
|
|
function ncMaint {
|
|
su -c "php ${ncRoot}/occ maintenance:mode --$1" - "${webUser}" \
|
|
>> "$logFile" 2>&1
|
|
maintResult="$?"
|
|
return "$maintResult"
|
|
}
|
|
|
|
### cleanup - cleanup files and directories created by this script
|
|
function cleanup {
|
|
## remove SQL dump file and directory
|
|
rm -rf "$sqlDumpDir" >> "$logFile" 2>&1
|
|
# verify directory is gone
|
|
checkExist fd "$sqlDumpDir"
|
|
checkResult="$?"
|
|
if [ "$checkResult" = "0" ]; then
|
|
# directory still exists
|
|
exitWarn+=('111')
|
|
else
|
|
# directory removed
|
|
echo -e "${op}${stamp} Removed SQL temp directory${normal}" \
|
|
>> "$logFile"
|
|
fi
|
|
|
|
## remove 503 error page
|
|
# check value of 'clean503' to see if this is necessary (=1) otherwise, skip
|
|
if [ "$clean503" -eq 1 ]; then
|
|
# proceed with cleanup
|
|
echo -e "${op}${stamp} Removing 503 error page..." >> "$logFile"
|
|
rm -f "$webroot/$err503File" >> "$logFile" 2>&1
|
|
# verify file is actually gone
|
|
checkExist ff "$webroot/$err503File"
|
|
checkResult="$?"
|
|
if [ "$checkResult" = "0" ]; then
|
|
# file still exists
|
|
exitWarn+=('5030')
|
|
else
|
|
# file removed
|
|
echo -e "${info}${stamp} -- [INFO] 503 page removed from webroot" \
|
|
"--${normal}" >> "$logFile"
|
|
fi
|
|
else
|
|
echo -e "${op}${stamp} 503 error page never copied to webroot," \
|
|
"nothing to cleanup" >> "$logFile"
|
|
fi
|
|
}
|
|
|
|
### End of Functions ###
|
|
|
|
|
|
### Default parameters
|
|
|
|
# store the logfile in the same directory as this script using the script's name
|
|
# with the extension .log
|
|
scriptPath="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
|
scriptName="$( basename ${0} )"
|
|
logFile="$scriptPath/${scriptName%.*}.log"
|
|
|
|
# set default 503 error page name and location in scriptPath
|
|
err503Path="$scriptPath/503.html"
|
|
err503File="${err503Path##*/}"
|
|
|
|
# set default sqlDetails path to scriptPath
|
|
sqlDetails="$scriptPath/nc_sql.details"
|
|
|
|
# set default borgDetails path to scriptPath
|
|
borgDetails=$"scriptPath/nc_borg.details"
|
|
|
|
# set borg parameters to 'normal' verbosity
|
|
borgCreateParams='--stats'
|
|
borgPruneParams='--list'
|
|
|
|
|
|
### Set script parameters to null and initialize array variables
|
|
unset PARAMS
|
|
unset sqlDumpDir
|
|
unset webroot
|
|
unset ncRoot
|
|
unset webUser
|
|
unset clean503
|
|
unset sqlParams
|
|
unset borgXtra
|
|
unset borgExclude
|
|
unset borgPrune
|
|
unset BORG_BASE_DIR
|
|
unset BORG_RSH
|
|
unset BORG_REPO
|
|
unset BORG_PASSPHRASE
|
|
unset BORG_REMOTE_PATH
|
|
errorExplain=()
|
|
exitWarn=()
|
|
warningExplain=()
|
|
borgConfig=()
|
|
xtraFiles=()
|
|
|
|
### Error codes
|
|
errorExplain[100]="Could not put NextCloud into maintenance mode"
|
|
errorExplain[101]="Could not exit NextCloud maintenance mode"
|
|
errorExplain[200]="Could not dump NextCloud SQL database"
|
|
errorExplain[210]="Invalid or non-existant borg base directory specified (borg backup details file)"
|
|
errorExplain[211]="Invalid or non-existant path to borg SSH keyfile (borg backup details file)"
|
|
errorExplain[212]="Name of borg repo was not specified (borg backup details file)"
|
|
|
|
### Warning codes & messages
|
|
warningExplain[111]="Could not remove SQL dump file and directory, please remove manually"
|
|
warningExplain[5030]="Could not remove 503 error page. This MUST be removed manually before NGINX will serve webclients!"
|
|
warningExplain[5031]="No webroot path was specified (-w parameter missing)"
|
|
warningExplain[5032]="The specified webroot (-w parameter) could not be found"
|
|
warningExplain[5033]="No 503 error page could be found. If not using the default located in the script directory, then check your -5 parameter"
|
|
warningExplain[5035]="Error copying 503 error page to webroot"
|
|
warn503="Web users will NOT be informed the server is down!"
|
|
warningExplain[borg111]="The specified file containing extra files for inclusion in borgbackup could not be found"
|
|
|
|
|
|
### Process script parameters
|
|
|
|
# If parameters are provided but don't start with '-' then show the help page
|
|
# and exit with an error
|
|
if [ -n "$1" ] && [[ ! "$1" =~ ^- ]]; then
|
|
# show script help page
|
|
scriptHelp
|
|
fi
|
|
|
|
# use GetOpts to process parameters
|
|
while getopts ':l:n:u:v5:w:s:b:' PARAMS; do
|
|
case "$PARAMS" in
|
|
l)
|
|
# use provided location for logFile
|
|
logFile="${OPTARG}"
|
|
;;
|
|
n)
|
|
# NextCloud webroot
|
|
ncRoot="${OPTARG%/}"
|
|
;;
|
|
u)
|
|
# webuser
|
|
webUser="${OPTARG}"
|
|
;;
|
|
v)
|
|
# verbose output from Borg
|
|
borgCreateParams='--list --stats'
|
|
borgPruneParams='--list'
|
|
;;
|
|
5)
|
|
# Full path to 503 error page
|
|
err503Path="${OPTARG%/}"
|
|
err503File="${err503Path##*/}"
|
|
;;
|
|
w)
|
|
# path to webserver webroot to copy 503 error page
|
|
webroot="${OPTARG%/}"
|
|
;;
|
|
s)
|
|
# path to file containing SQL login details
|
|
sqlDetails="${OPTARG%/}"
|
|
;;
|
|
b)
|
|
# path to file containing borgbackup settings and details
|
|
borgDetails="${OPTARG%/}"
|
|
;;
|
|
?)
|
|
# unrecognized parameters trigger scriptHelp
|
|
scriptHelp
|
|
;;
|
|
esac
|
|
done
|
|
|
|
|
|
### Verify script pre-requisties
|
|
|
|
## If not running as root, display error on console and exit
|
|
if [ $(id -u) -ne 0 ]; then
|
|
echo -e "\n${err}This script MUST be run as ROOT. Exiting.${normal}"
|
|
exit 2
|
|
fi
|
|
|
|
## Check NextCloud webroot
|
|
# Ensure NextCloud webroot is provided
|
|
if [ -z "$ncRoot" ]; then
|
|
echo -e "\n${err}The NextCloud webroot must be specified (-n parameter)" \
|
|
"${normal}\n"
|
|
exit 1
|
|
# Ensure NextCloud webroot directory exists
|
|
elif [ -n "$ncRoot" ]; then
|
|
checkExist fd "$ncRoot"
|
|
checkResult="$?"
|
|
if [ "$checkResult" = "1" ]; then
|
|
# Specified NextCloud webroot directory could not be found
|
|
echo -e "\n${err}The provided NextCloud webroot directory" \
|
|
"(-n parameter) does not exist.${normal}\n"
|
|
exit 1
|
|
fi
|
|
fi
|
|
|
|
## Check NextCloud webuser account
|
|
# Ensure NextCloud webuser account is provided
|
|
if [ -z "$webUser" ]; then
|
|
echo -e "\n${err}The webuser account running NextCloud must be provided" \
|
|
"(-u parameter)${normal}\n"
|
|
exit 1
|
|
# Check if supplied webUser account exists
|
|
elif [ -n "$webUser" ]; then
|
|
user_exists=$(id -u $webUser > /dev/null 2>&1; echo $?)
|
|
if [ $user_exists -ne 0 ]; then
|
|
echo -e "\n${err}The supplied webuser account (-u parameter) does not" \
|
|
"exist.${normal}\n"
|
|
exit 1
|
|
fi
|
|
fi
|
|
|
|
## Ensure sqlDetails file exists
|
|
checkExist ff "$sqlDetails"
|
|
checkResult="$?"
|
|
if [ "$checkResult" = "1" ]; then
|
|
# sqlDetails file cannot be found
|
|
echo -e "\n${err}The file containing your SQL details does not exist" \
|
|
"(-s parameter)${normal}\n"
|
|
exit 1
|
|
fi
|
|
|
|
## Ensure borgDetails file exists
|
|
checkExist ff "$borgDetails"
|
|
checkResult="$?"
|
|
if [ "$checkResult" = "1" ]; then
|
|
# sqlDetails file cannot be found
|
|
echo -e "\n${err}The file containing your borgbackup details does not" \
|
|
"exist (-b parameter)${normal}\n"
|
|
exit 1
|
|
fi
|
|
|
|
|
|
### Log start of script operations
|
|
echo -e "\e[1;35m${stamp}-- Start $scriptName execution ---${normal}" \
|
|
>> "$logFile"
|
|
|
|
|
|
### Export logFile variable for use by Borg
|
|
export logFile="$logFile"
|
|
|
|
|
|
### Create sqlDump temporary directory and sqlDumpFile name
|
|
sqlDumpDir=$( mktemp -d )
|
|
sqlDumpFile="backup-`date +%Y%m%d_%H%M%S`.sql"
|
|
echo -e "${info}${stamp} -- [INFO] mySQL dump file will be stored" \
|
|
"at: ${lit}${sqlDumpDir}/${sqlDumpFile}${normal}" >> "$logFile"
|
|
|
|
|
|
### 503 error page: If you dont' plan on using the auto-copied 503 then comment
|
|
### this entire section starting with '--- Begin 503 section ---' until
|
|
### '--- End 503 section ---' to suppress generated warnings
|
|
|
|
### --- Begin 503 section ---
|
|
|
|
## Check if webroot has been specified, if not, skip this entire section since there is nowhere to copy the 503 file.
|
|
if [ -z "$webroot" ]; then
|
|
# no webroot path provided
|
|
echo -e "${info}${stamp} -- [INFO] ${warn503} --${normal}" \
|
|
>> "$logFile"
|
|
exitWarn+=('5031')
|
|
clean503=0
|
|
else
|
|
# verify webroot actually exists
|
|
checkExist fd "$webroot"
|
|
checkResult="$?"
|
|
if [ "$checkResult" = "1" ]; then
|
|
# webroot directory specified could not be found
|
|
echo -e "${info}${stamp} -- [INFO] ${warn503} --${normal}" \
|
|
>> "$logFile"
|
|
exitWarn+=('5032')
|
|
clean503=0
|
|
else
|
|
# webroot exists
|
|
echo -e "${op}${stamp} Using webroot: ${lit}${webroot}${normal}" \
|
|
>> "$logFile"
|
|
# Verify 503 file existance at given path
|
|
checkExist ff "$err503Path"
|
|
checkResult="$?"
|
|
if [ "$checkResult" = "1" ]; then
|
|
# 503 file could not be found
|
|
echo -e "${info}${stamp} -- [INFO] ${warn503} --${normal}" \
|
|
>> "$logFile"
|
|
exitWarn+=('5033')
|
|
clean503=0
|
|
else
|
|
# 503 file exists and webroot is valid. Let's copy it!
|
|
echo -e "${op}${stamp} ${err503File} found at ${lit}${err503Path}" \
|
|
"${normal}" >> "$logFile"
|
|
echo -e "${op}${stamp} Copying 503 error page to webroot..." \
|
|
"${normal}" >> "$logFile"
|
|
cp "${err503Path}" "$webroot/" >> "$logFile" 2>&1
|
|
copyResult="$?"
|
|
# verify copy was successful
|
|
if [ "$copyResult" = "1" ]; then
|
|
# copy was unsuccessful
|
|
echo -e "${info}${stamp} -- [INFO] ${warn503} --${normal}" \
|
|
>> "$logFile"
|
|
exitWarn+=('5035')
|
|
clean503=0
|
|
else
|
|
# copy was successful
|
|
echo -e "${info}${stamp} -- [INFO] 503 error page" \
|
|
"successfully copied to webroot --${normal}" >> "$logFile"
|
|
clean503=1
|
|
fi
|
|
fi
|
|
fi
|
|
fi
|
|
|
|
### --- End 503 section ---
|
|
|
|
|
|
### Put NextCloud in maintenance mode
|
|
ncMaint on
|
|
# check if successful
|
|
if [ "$maintResult" = "0" ]; then
|
|
echo -e "${info}${stamp} -- [INFO] NextCloud now in maintenance mode --" \
|
|
"${normal}" >> "$logFile"
|
|
else
|
|
cleanup
|
|
quit 100
|
|
fi
|
|
|
|
|
|
### Get SQL info from sqlDetails
|
|
mapfile -t sqlParams < "$sqlDetails"
|
|
|
|
|
|
### Dump SQL
|
|
echo -e "${op}${stamp} Dumping NextCloud SQL database...${normal}" >> "$logFile"
|
|
mysqldump --single-transaction -h"${sqlParams[0]}" -u"${sqlParams[1]}" \
|
|
-p"${sqlParams[2]}" "${sqlParams[3]}" > "${sqlDumpDir}/${sqlDumpFile}" \
|
|
2>> "$logFile"
|
|
# verify
|
|
dumpResult="$?"
|
|
if [ "$dumpResult" = "0" ]; then
|
|
echo -e "${ok}${stamp} -- [SUCCESS] SQL dumped successfully --${normal}" \
|
|
>> "$logFile"
|
|
else
|
|
cleanup
|
|
quit 200;
|
|
fi
|
|
|
|
### Call borgbackup to copy actual files
|
|
echo -e "${op}${stamp} Pre-backup tasks completed, calling borgbackup..." \
|
|
"${normal}" >> "$logFile"
|
|
|
|
## Get borgbackup settings and repo details
|
|
# read definition file and map to array variable
|
|
mapfile -t borgConfig < "$borgDetails"
|
|
## check if any required borg configuration variables in defintion file are
|
|
## empty and exit with error, otherwise, map array items to variables
|
|
# check: borg base directory
|
|
echo -e "${op}${stamp} Verifying supplied borg configuration variables..."
|
|
if [ -z "${borgConfig[0]}" ]; then
|
|
cleanup
|
|
quit 210
|
|
else
|
|
export BORG_BASE_DIR="${borgConfig[0]}"
|
|
fi
|
|
# check: path to SSH keyfile
|
|
if [ -z "${borgConfig[1]}" ]; then
|
|
cleanup
|
|
quit 211
|
|
else
|
|
export BORG_RSH="ssh -i ${borgConfig[1]}"
|
|
fi
|
|
# check: name of borg repo
|
|
if [ -z "${borgConfig[2]}" ]; then
|
|
cleanup
|
|
quit 212
|
|
else
|
|
export BORG_REPO="{borgConfig[2]}"
|
|
fi
|
|
# repo password
|
|
if [ -n "${borgConfig[3]}" ]; then
|
|
export BORG_PASSPHRASE="{borgConfig[3]}"
|
|
else
|
|
echo -e "${info}${stamp} -- [INFO] No password will be used for SSH keys" \
|
|
"or when accessing remote borg repo --${normal}" >> "$logFile"
|
|
# if the password was omitted by mistake, export a dummy password so borg
|
|
# fails with an error instead of sitting and waiting for input
|
|
export BORG_PASSPHRASE="DummyPasswordSoBorgFails"
|
|
fi
|
|
# additional files to be backed up
|
|
borgXtra="${borgConfig[4]}"
|
|
# file with pattern definition for excluded files
|
|
borgExclude="${borgConfig[5]}"
|
|
# parameters for borg prune
|
|
borgPrune="${borgConfig[6]}"
|
|
# export: borg remote path (if not blank)
|
|
if [ -n "${borgConfig[7]}" ]; then
|
|
export BORG_REMOTE_PATH="${borgConfig[7]}"
|
|
else
|
|
echo -e "${info}${stamp} -- [INFO] No remote borg instance specified" \
|
|
"--${normal}" >> "$logFile"
|
|
fi
|
|
|
|
# map individual array items to variables and export where necessary
|
|
export BORG_BASE_DIR="${borgConfig[0]}"
|
|
export BORG_RSH="ssh -i ${borgConfig[1]}"
|
|
export BORG_REPO="${borgConfig[2]}"
|
|
export BORG_PASSPHRASE="${borgConfig[3]}"
|
|
borgXtra="${borgConfig[4]}"
|
|
borgExclude="${borgConfig[5]}"
|
|
borgPrune="${borgConfig[6]}"
|
|
export BORG_REMOTE_PATH="${borgConfig[7]}"
|
|
|
|
## If borgXtra exists, map contents to an array variable
|
|
if [ -n "$borgXtra" ]; then
|
|
echo -e "${op}${stamp} Processing referenced extra files list for" \
|
|
"borgbackup to include in backup${normal}" >> "$logFile"
|
|
checkExist ff "$borgXtra"
|
|
checkResult="$?"
|
|
if [ "$checkResult" = "0" ]; then
|
|
echo -e "${op}${stamp} Found ${lit}${borgXtra}${normal}" >> $"logFile"
|
|
mapfile -t xtraFiles < ${borgXtra}
|
|
echo -e "${info}${stamp} Processed extra files list for inclusion in" \
|
|
"borgbackup${normal}" >> "$logFile"
|
|
else
|
|
exitWarn+=('borg111')
|
|
fi
|
|
fi
|
|
|
|
|
|
|
|
|
|
### Exit NextCloud maintenance mode
|
|
ncMaint off
|
|
# check if successful
|
|
if [ "$maintResult" = "0" ]; then
|
|
echo -e "${info}${stamp} -- [INFO] NextCloud now in normal operating mode" \
|
|
"--${normal}" >> "$logFile"
|
|
else
|
|
cleanup
|
|
quit 101
|
|
fi
|
|
|
|
|
|
### Exit script
|
|
echo -e "${bold}${default}${stamp} ***Normal exit process***${normal}" \
|
|
>> "$logFile"
|
|
cleanup
|
|
quit
|
|
|
|
# This code should not be executed since the 'quit' function should terminate
|
|
# this script. Therefore, exit with code 99 if we get to this point.
|
|
exit 99
|