X-Git-Url: https://git.p6c8.net/nextcloud-backup-restore.git/blobdiff_plain/371777ac913b6a7b3b499b7920629d927a1c590e..HEAD:/NextcloudRestore.sh?ds=inline diff --git a/NextcloudRestore.sh b/NextcloudRestore.sh index abc977d..5febde7 100644 --- a/NextcloudRestore.sh +++ b/NextcloudRestore.sh @@ -3,13 +3,20 @@ # # Bash script for restoring backups of Nextcloud. # -# Version 2.1.3 +# Version 2.3.3 +# +# Requirements: +# - pigz (https://zlib.net/pigz/) for using backup compression. If not available, you can use another compression algorithm (e.g. gzip) +# +# Supported database systems: +# - MySQL/MariaDB +# - PostgreSQL # # Usage: # - With backup directory specified in the script: ./NextcloudRestore.sh (e.g. ./NextcloudRestore.sh 20170910_132703) # - With backup directory specified by parameter: ./NextcloudRestore.sh (e.g. ./NextcloudRestore.sh 20170910_132703 /media/hdd/nextcloud_backup) # -# The script is based on an installation of Nextcloud using nginx and MariaDB, see https://decatec.de/home-server/nextcloud-auf-ubuntu-server-18-04-lts-mit-nginx-mariadb-php-lets-encrypt-redis-und-fail2ban/ +# The script is based on an installation of Nextcloud using nginx and MariaDB, see https://decatec.de/home-server/nextcloud-auf-ubuntu-server-20-04-lts-mit-nginx-mariadb-php-lets-encrypt-redis-und-fail2ban/ # # @@ -18,21 +25,28 @@ # All entries which need to be customized are tagged with "TODO". # +# Make sure the script exits when any command fails +set -Eeuo pipefail + # Variables -restore=$1 -backupMainDir=$2 +restore=${1:-} +backupMainDir=${2:-} if [ -z "$backupMainDir" ]; then # TODO: The directory where you store the Nextcloud backups (when not specified by args) - backupMainDir='/media/hdd/nextcloud_backup' + backupMainDir='/media/hdd/nextcloud_backup' fi echo "Backup directory: $backupMainDir" +currentRestoreDir="${backupMainDir}/${restore}" + # TODO: Set this to true, if the backup was created with compression enabled, otherwiese false. useCompression=true -currentRestoreDir="${backupMainDir}/${restore}" +# TOOD: The bare tar command for using compression. +# Use 'tar -xmpzf' if you want to use gzip compression. +compressionCommand="tar -I pigz -xmpf" # TODO: The directory of your Nextcloud installation (this is a directory under your web root) nextcloudFileDir='/var/www/nextcloud' @@ -63,6 +77,9 @@ dbUser='nextcloud_db_user' # TODO: The password of the Nextcloud database user dbPassword='mYpAsSw0rd' +# TODO: Uncomment this and set to true if the database from the backup DOES NOT use UTF8 with multibyte support (e.g. for emoijs in filenames) +#dbNoMultibyte=true + # File names for backup files # If you prefer other file names, you'll also have to change the NextcloudBackup.sh script. fileNameBackupFileDir='nextcloud-filedir.tar' @@ -73,12 +90,15 @@ if [ "$useCompression" = true ] ; then fileNameBackupDataDir='nextcloud-datadir.tar.gz' fi -# TODO: Uncomment if you use local external storage -#fileNameBackupExternalDataDir='nextcloud-external-datadir.tar' -# -#if [ "$useCompression" = true ] ; then -# fileNameBackupExternalDataDir='nextcloud-external-datadir.tar.gz' -#fi +fileNameBackupExternalDataDir='' + +if [ ! -z "${nextcloudLocalExternalDataDir+x}" ] ; then + fileNameBackupExternalDataDir='nextcloud-external-datadir.tar' + + if [ "$useCompression" = true ] ; then + fileNameBackupExternalDataDir='nextcloud-external-datadir.tar.gz' + fi +fi fileNameBackupDb='nextcloud-db.sql' @@ -167,12 +187,13 @@ echo "Done" echo # Local external storage -# TODO: Uncomment if you use local external storage -#echo "Deleting old Nextcloud local external storage directory..." -#rm -r "${nextcloudLocalExternalDataDir}" -#mkdir -p "${nextcloudLocalExternalDataDir}" -#echo "Done" -#echo +if [ ! -z "${nextcloudLocalExternalDataDir+x}" ] ; then + echo "Deleting old Nextcloud local external storage directory..." + rm -r "${nextcloudLocalExternalDataDir}" + mkdir -p "${nextcloudLocalExternalDataDir}" + echo "Done" + echo +fi # # Restore file and data directory @@ -182,7 +203,7 @@ echo echo "$(date +"%H:%M:%S"): Restoring Nextcloud file directory..." if [ "$useCompression" = true ] ; then - tar -I pigz -xmpf "${currentRestoreDir}/${fileNameBackupFileDir}" -C "${nextcloudFileDir}" + `$compressionCommand "${currentRestoreDir}/${fileNameBackupFileDir}" -C "${nextcloudFileDir}"` else tar -xmpf "${currentRestoreDir}/${fileNameBackupFileDir}" -C "${nextcloudFileDir}" fi @@ -194,7 +215,7 @@ echo echo "$(date +"%H:%M:%S"): Restoring Nextcloud data directory..." if [ "$useCompression" = true ] ; then - tar -I pigz -xmpf "${currentRestoreDir}/${fileNameBackupDataDir}" -C "${nextcloudDataDir}" + `$compressionCommand "${currentRestoreDir}/${fileNameBackupDataDir}" -C "${nextcloudDataDir}"` else tar -xmpf "${currentRestoreDir}/${fileNameBackupDataDir}" -C "${nextcloudDataDir}" fi @@ -203,17 +224,18 @@ echo "Done" echo # Local external storage -# TODO: Uncomment if you use local external storage -#echo "$(date +"%H:%M:%S"): Restoring Nextcloud data directory..." -# -#if [ "$useCompression" = true ] ; then -# tar -I pigz -xmpf "${currentRestoreDir}/${fileNameBackupExternalDataDir}" -C "${nextcloudLocalExternalDataDir}" -#else -# tar -xmpf "${currentRestoreDir}/${fileNameBackupExternalDataDir}" -C "${nextcloudLocalExternalDataDir}" -#fi -# -#echo "Done" -#echo +if [ ! -z "${nextcloudLocalExternalDataDir+x}" ] ; then + echo "$(date +"%H:%M:%S"): Restoring Nextcloud local external storage directory..." + + if [ "$useCompression" = true ] ; then + `$compressionCommand "${currentRestoreDir}/${fileNameBackupExternalDataDir}" -C "${nextcloudLocalExternalDataDir}"` + else + tar -xmpf "${currentRestoreDir}/${fileNameBackupExternalDataDir}" -C "${nextcloudLocalExternalDataDir}" + fi + + echo "Done" + echo +fi # # Restore database @@ -232,10 +254,13 @@ echo echo "$(date +"%H:%M:%S"): Creating new DB for Nextcloud..." if [ "${databaseSystem,,}" = "mysql" ] || [ "${databaseSystem,,}" = "mariadb" ]; then - # Use this if the databse from the backup uses UTF8 with multibyte support (e.g. for emoijs in filenames): - mysql -h localhost -u "${dbUser}" -p"${dbPassword}" -e "CREATE DATABASE ${nextcloudDatabase} CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci" - # TODO: Use this if the database from the backup DOES NOT use UTF8 with multibyte support (e.g. for emoijs in filenames): - #mysql -h localhost -u "${dbUser}" -p"${dbPassword}" -e "CREATE DATABASE ${nextcloudDatabase}" + if [ ! -z "${dbNoMultibyte+x}" ] && [ "${dbNoMultibyte}" = true ] ; then + # Database from the backup DOES NOT use UTF8 with multibyte support (e.g. for emoijs in filenames) + mysql -h localhost -u "${dbUser}" -p"${dbPassword}" -e "CREATE DATABASE ${nextcloudDatabase}" + else + # Database from the backup uses UTF8 with multibyte support (e.g. for emoijs in filenames) + mysql -h localhost -u "${dbUser}" -p"${dbPassword}" -e "CREATE DATABASE ${nextcloudDatabase} CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci" + fi elif [ "${databaseSystem,,}" = "postgresql" ] || [ "${databaseSystem,,}" = "pgsql" ]; then sudo -u postgres psql -c "CREATE DATABASE ${nextcloudDatabase} WITH OWNER ${dbUser} TEMPLATE template0 ENCODING \"UNICODE\";" fi @@ -268,24 +293,27 @@ echo echo "$(date +"%H:%M:%S"): Setting directory permissions..." chown -R "${webserverUser}":"${webserverUser}" "${nextcloudFileDir}" chown -R "${webserverUser}":"${webserverUser}" "${nextcloudDataDir}" -# TODO: Uncomment if you use local external storage -#chown -R "${webserverUser}":"${webserverUser}" "${nextcloudLocalExternalDataDir}" + +if [ ! -z "${nextcloudLocalExternalDataDir+x}" ] ; then + chown -R "${webserverUser}":"${webserverUser}" "${nextcloudLocalExternalDataDir}" +fi + echo "Done" echo # -# Update the system data-fingerprint (see https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/occ_command.html#maintenance-commands-label) +# Disbale maintenance mode # -echo "$(date +"%H:%M:%S"): Updating the system data-fingerprint..." -sudo -u "${webserverUser}" php ${nextcloudFileDir}/occ maintenance:data-fingerprint +echo "$(date +"%H:%M:%S"): Switching off maintenance mode..." +sudo -u "${webserverUser}" php ${nextcloudFileDir}/occ maintenance:mode --off echo "Done" echo # -# Disbale maintenance mode +# Update the system data-fingerprint (see https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/occ_command.html#maintenance-commands-label) # -echo "$(date +"%H:%M:%S"): Switching off maintenance mode..." -sudo -u "${webserverUser}" php ${nextcloudFileDir}/occ maintenance:mode --off +echo "$(date +"%H:%M:%S"): Updating the system data-fingerprint..." +sudo -u "${webserverUser}" php ${nextcloudFileDir}/occ maintenance:data-fingerprint echo "Done" echo