X-Git-Url: https://git.p6c8.net/nextcloud-backup-restore.git/blobdiff_plain/1575f860d04e5ef4213ab61c919c328ba9214c40..c15f80e37cd9c1a02fb3574d4950570f03d23fc5:/NextcloudRestore.sh diff --git a/NextcloudRestore.sh b/NextcloudRestore.sh index 69b4b00..cca2391 100644 --- a/NextcloudRestore.sh +++ b/NextcloudRestore.sh @@ -2,8 +2,13 @@ # # Bash script for restoring backups of Nextcloud. -# Usage: ./NextcloudRestore.sh (e.g. ./NextcloudRestore.sh 20170910_132703) -# +# +# Version 2.1.3 +# +# 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/ # @@ -14,42 +19,85 @@ # # Variables -# TODO: The directory where you store the Nextcloud backups -mainBackupDir="/mnt/Share/NextcloudBackups" restore=$1 -currentRestoreDir="${mainBackupDir}/${restore}" +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' +fi + +echo "Backup directory: $backupMainDir" + +# TODO: Set this to true, if the backup was created with compression enabled, otherwiese false. +useCompression=true + +currentRestoreDir="${backupMainDir}/${restore}" + # TODO: The directory of your Nextcloud installation (this is a directory under your web root) -nextcloudFileDir="/var/www/nextcloud" +nextcloudFileDir='/var/www/nextcloud' + # TODO: The directory of your Nextcloud data directory (outside the Nextcloud file directory) # If your data directory is located under Nextcloud's file directory (somewhere in the web root), the data directory should not be restored separately -nextcloudDataDir="/var/nextcloud_data" +nextcloudDataDir='/var/nextcloud_data' + +# TODO: The directory of your Nextcloud's local external storage. +# Uncomment if you use local external storage. +#nextcloudLocalExternalDataDir='/var/nextcloud_external_data' + # TODO: The service name of the web server. Used to start/stop web server (e.g. 'systemctl start ') -webserverServiceName="nginx" +webserverServiceName='nginx' + +# TODO: Your web server user +webserverUser='www-data' + +# TODO: The name of the database system (one of: mysql, mariadb, postgresql) +databaseSystem='mariadb' + # TODO: Your Nextcloud database name -nextcloudDatabase="nextcloud_db" +nextcloudDatabase='nextcloud_db' + # TODO: Your Nextcloud database user -dbUser="nextcloud_db_user" +dbUser='nextcloud_db_user' + # TODO: The password of the Nextcloud database user -dbPassword="mYpAsSw0rd" -# TODO: Your web server user -webserverUser="www-data" +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.gz" -fileNameBackupDataDir="nextcloud-datadir.tar.gz" -fileNameBackupDb="nextcloud-db.sql" +fileNameBackupFileDir='nextcloud-filedir.tar' +fileNameBackupDataDir='nextcloud-datadir.tar' + +if [ "$useCompression" = true ] ; then + fileNameBackupFileDir='nextcloud-filedir.tar.gz' + fileNameBackupDataDir='nextcloud-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' # Function for error messages errorecho() { cat <<< "$@" 1>&2; } # -# Check if parameter given +# Check if parameter(s) given # -if [ $# != "1" ] +if [ $# != "1" ] && [ $# != "2" ] then - errorecho "ERROR: No backup name to restore given!" - errorecho "Usage: NextcloudRestore.sh 'BackupDate'" + errorecho "ERROR: No backup name to restore given, or wrong number of parameters!" + errorecho "Usage: NextcloudRestore.sh 'BackupDate' ['BackupDirectory']" exit 1 fi @@ -67,93 +115,160 @@ fi # if [ ! -d "${currentRestoreDir}" ] then - errorecho "ERROR: Backup ${restore} not found!" + errorecho "ERROR: Backup ${restore} not found!" exit 1 fi +# +# Check if the commands for restoring the database are available +# +if [ "${databaseSystem,,}" = "mysql" ] || [ "${databaseSystem,,}" = "mariadb" ]; then + if ! [ -x "$(command -v mysql)" ]; then + errorecho "ERROR: MySQL/MariaDB not installed (command mysql not found)." + errorecho "ERROR: No restore of database possible!" + errorecho "Cancel restore" + exit 1 + fi +elif [ "${databaseSystem,,}" = "postgresql" ] || [ "${databaseSystem,,}" = "pgsql" ]; then + if ! [ -x "$(command -v psql)" ]; then + errorecho "ERROR: PostgreSQL not installed (command psql not found)." + errorecho "ERROR: No restore of database possible!" + errorecho "Cancel restore" + exit 1 + fi +fi + # # Set maintenance mode # -echo "Set maintenance mode for Nextcloud..." -cd "${nextcloudFileDir}" -sudo -u "${webserverUser}" php occ maintenance:mode --on -cd ~ +echo "$(date +"%H:%M:%S"): Set maintenance mode for Nextcloud..." +sudo -u "${webserverUser}" php ${nextcloudFileDir}/occ maintenance:mode --on echo "Done" echo # # Stop web server # -echo "Stopping web server..." +echo "$(date +"%H:%M:%S"): Stopping web server..." systemctl stop "${webserverServiceName}" echo "Done" echo # -# Delete old Nextcloud direcories +# Delete old Nextcloud directories # -echo "Deleting old Nextcloud file directory..." + +# File directory +echo "$(date +"%H:%M:%S"): Deleting old Nextcloud file directory..." rm -r "${nextcloudFileDir}" mkdir -p "${nextcloudFileDir}" echo "Done" echo -echo "Deleting old Nextcloud data directory..." +# Data directory +echo "$(date +"%H:%M:%S"): Deleting old Nextcloud data directory..." rm -r "${nextcloudDataDir}" mkdir -p "${nextcloudDataDir}" echo "Done" echo +# Local external storage +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 # -echo "Restoring Nextcloud file directory..." -tar -xmpzf "${currentRestoreDir}/${fileNameBackupFileDir}" -C "${nextcloudFileDir}" + +# File directory +echo "$(date +"%H:%M:%S"): Restoring Nextcloud file directory..." + +if [ "$useCompression" = true ] ; then + tar -I pigz -xmpf "${currentRestoreDir}/${fileNameBackupFileDir}" -C "${nextcloudFileDir}" +else + tar -xmpf "${currentRestoreDir}/${fileNameBackupFileDir}" -C "${nextcloudFileDir}" +fi + echo "Done" echo -echo "Restoring Nextcloud data directory..." -tar -xmpzf "${currentRestoreDir}/${fileNameBackupDataDir}" -C "${nextcloudDataDir}" +# Data directory +echo "$(date +"%H:%M:%S"): Restoring Nextcloud data directory..." + +if [ "$useCompression" = true ] ; then + tar -I pigz -xmpf "${currentRestoreDir}/${fileNameBackupDataDir}" -C "${nextcloudDataDir}" +else + tar -xmpf "${currentRestoreDir}/${fileNameBackupDataDir}" -C "${nextcloudDataDir}" +fi + echo "Done" echo +# Local external storage +if [ ! -z "${nextcloudLocalExternalDataDir+x}" ] ; then + echo "$(date +"%H:%M:%S"): Restoring Nextcloud local external storage directory..." + + if [ "$useCompression" = true ] ; then + tar -I pigz -xmpf "${currentRestoreDir}/${fileNameBackupExternalDataDir}" -C "${nextcloudLocalExternalDataDir}" + else + tar -xmpf "${currentRestoreDir}/${fileNameBackupExternalDataDir}" -C "${nextcloudLocalExternalDataDir}" + fi + + echo "Done" + echo +fi + # # Restore database # -echo "Dropping old Nextcloud DB..." -# MySQL/MariaDB: -mysql -h localhost -u "${dbUser}" -p"${dbPassword}" -e "DROP DATABASE ${nextcloudDatabase}" +echo "$(date +"%H:%M:%S"): Dropping old Nextcloud DB..." + +if [ "${databaseSystem,,}" = "mysql" ] || [ "${databaseSystem,,}" = "mariadb" ]; then + mysql -h localhost -u "${dbUser}" -p"${dbPassword}" -e "DROP DATABASE ${nextcloudDatabase}" +elif [ "${databaseSystem,,}" = "postgresql" ]; then + sudo -u postgres psql -c "DROP DATABASE ${nextcloudDatabase};" +fi -# PostgreSQL (uncomment if you are using PostgreSQL as Nextcloud database) -#PGPASSWORD="${dbPassword}" psql -h localhost -U "${dbUser}" -d nextcloud -c "DROP DATABASE \"${nextcloudDatabase}\";" echo "Done" echo -echo "Creating new DB for Nextcloud..." -# MySQL/MariaDB: -# 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" -# 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}" +echo "$(date +"%H:%M:%S"): Creating new DB for Nextcloud..." + +if [ "${databaseSystem,,}" = "mysql" ] || [ "${databaseSystem,,}" = "mariadb" ]; then + 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 -# PostgreSQL (uncomment if you are using PostgreSQL as Nextcloud database) -#PGPASSWORD="${dbPassword}" psql -h localhost -U "${dbUser}" -d "${nextcloudDatabase}" -c "CREATE DATABASE \"${nextcloudDatabase}\";" echo "Done" echo -echo "Restoring backup DB..." -# MySQL/MariaDB: -mysql -h localhost -u "${dbUser}" -p"${dbPassword}" "${nextcloudDatabase}" < "${currentRestoreDir}/${fileNameBackupDb}" +echo "$(date +"%H:%M:%S"): Restoring backup DB..." + +if [ "${databaseSystem,,}" = "mysql" ] || [ "${databaseSystem,,}" = "mariadb" ]; then + mysql -h localhost -u "${dbUser}" -p"${dbPassword}" "${nextcloudDatabase}" < "${currentRestoreDir}/${fileNameBackupDb}" +elif [ "${databaseSystem,,}" = "postgresql" ] || [ "${databaseSystem,,}" = "pgsql" ]; then + sudo -u postgres psql "${nextcloudDatabase}" < "${currentRestoreDir}/${fileNameBackupDb}" +fi -# PostgreSQL (uncomment if you are using PostgreSQL as Nextcloud database) -#PGPASSWORD="${dbPassword}" pg_restore -c -d "${nextcloudDatabase}" -h localhost -U "${dbUser}" "${currentRestoreDir}/${fileNameBackupDb}" echo "Done" echo # # Start web server # -echo "Starting web server..." +echo "$(date +"%H:%M:%S"): Starting web server..." systemctl start "${webserverServiceName}" echo "Done" echo @@ -161,16 +276,21 @@ echo # # Set directory permissions # -echo "Setting directory permissions..." +echo "$(date +"%H:%M:%S"): Setting directory permissions..." chown -R "${webserverUser}":"${webserverUser}" "${nextcloudFileDir}" chown -R "${webserverUser}":"${webserverUser}" "${nextcloudDataDir}" + +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/15/admin_manual/configuration_server/occ_command.html#maintenance-commands-label) +# Update the system data-fingerprint (see https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/occ_command.html#maintenance-commands-label) # -echo "Updating the system data-fingerprint..." +echo "$(date +"%H:%M:%S"): Updating the system data-fingerprint..." sudo -u "${webserverUser}" php ${nextcloudFileDir}/occ maintenance:data-fingerprint echo "Done" echo @@ -178,11 +298,11 @@ echo # # Disbale maintenance mode # -echo "Switching off maintenance mode..." +echo "$(date +"%H:%M:%S"): Switching off maintenance mode..." sudo -u "${webserverUser}" php ${nextcloudFileDir}/occ maintenance:mode --off echo "Done" echo echo echo "DONE!" -echo "Backup ${restore} successfully restored." +echo "$(date +"%H:%M:%S"): Backup ${restore} successfully restored." \ No newline at end of file