Updated link to NC admin manual; typos

[nextcloud-backup-restore.git] / NextcloudRestore.sh

diff --git a/NextcloudRestore.sh b/NextcloudRestore.sh
index c9412b229fbe5413f9d2a905eefa96c0aad1abbd..6f983fb57b4c9236d5a917e8faa4b6228b39ebaa 100644 (file)
--- a/NextcloudRestore.sh
+++ b/NextcloudRestore.sh
@@ -2,8 +2,13 @@
 
 #
 # Bash script for restoring backups of Nextcloud.
 
 #
 # Bash script for restoring backups of Nextcloud.

-# Usage: ./NextcloudRestore.sh <BackupName> (e.g. ./NextcloudRestore.sh 20170910_132703)
-# 
+#
+# Version 1.1.1
+#
+# Usage:
+#   - With backup directory specified in the script: ./NextcloudRestore.sh <BackupName> (e.g. ./NextcloudRestore.sh 20170910_132703)
+#   - With backup directory specified by parameter: ./NextcloudRestore.sh <BackupName> <BackupDirectory> (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-18-04-lts-mit-nginx-mariadb-php-lets-encrypt-redis-und-fail2ban/
 #
 


@@ -14,42 +19,67 @@
 #
 
 # Variables
 #
 
 # Variables

-# TODO: The directory where you store the Nextcloud backups
-mainBackupDir="/mnt/Share/NextcloudBackups/"

 restore=$1
 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"
+
+currentRestoreDir="${backupMainDir}/${restore}"
+

 # TODO: The directory of your Nextcloud installation (this is a directory under your web root)
 # 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
 # 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"
-# TODO: The service name of the web server. Used to start/stop web server (e.g. 'service <webserverServiceName> start')
-webserverServiceName="nginx"
+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>')
+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
 # TODO: Your Nextcloud database name

-nextcloudDatabase="nextcloud_db"
+nextcloudDatabase='nextcloud_db'
+

 # TODO: Your Nextcloud database user
 # TODO: Your Nextcloud database user

-dbUser="nextcloud_db_user"
+dbUser='nextcloud_db_user'
+

 # TODO: The password of the Nextcloud database user
 # TODO: The password of the Nextcloud database user

-dbPassword="mYpAsSw0rd"
-# TODO: Your web server user
-webserverUser="www-data"
+dbPassword='mYpAsSw0rd'

 
 # File names for backup files
 # If you prefer other file names, you'll also have to change the NextcloudBackup.sh script.
 
 # 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.gz'
+fileNameBackupDataDir='nextcloud-datadir.tar.gz'
+
+# TODO: Uncomment if you use local external storage
+#fileNameBackupExternalDataDir='nextcloud-external-datadir.tar.gz'
+
+fileNameBackupDb='nextcloud-db.sql'

 
 # Function for error messages
 errorecho() { cat <<< "$@" 1>&2; }
 
 #
 
 # Function for error messages
 errorecho() { cat <<< "$@" 1>&2; }
 
 #

-# Check if parameter given
+# Check if parameter(s) given

 #
 #

-if [ $# != "1" ]
+if [ $# != "1" ] && [ $# != "2" ]

 then
 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
 
     exit 1
 fi
 


@@ -67,17 +97,34 @@ fi
 #
 if [ ! -d "${currentRestoreDir}" ]
 then
 #
 if [ ! -d "${currentRestoreDir}" ]
 then

-        errorecho "ERROR: Backup ${restore} not found!"
+       errorecho "ERROR: Backup ${restore} not found!"

     exit 1
 fi
 
     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" ]; 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..."
 #
 # Set maintenance mode
 #
 echo "Set maintenance mode for Nextcloud..."

-cd "${nextcloudFileDir}"
-sudo -u "${webserverUser}" php occ maintenance:mode --on
-cd ~
+sudo -u "${webserverUser}" php ${nextcloudFileDir}/occ maintenance:mode --on

 echo "Done"
 echo
 
 echo "Done"
 echo
 


@@ -85,53 +132,95 @@ echo
 # Stop web server
 #
 echo "Stopping web server..."
 # Stop web server
 #
 echo "Stopping web server..."

-service "${webserverServiceName}" stop
+systemctl stop "${webserverServiceName}"

 echo "Done"
 echo
 
 #
 echo "Done"
 echo
 
 #

-# Delete old Nextcloud direcories
+# Delete old Nextcloud directories

 #
 #

+
+# File directory

 echo "Deleting old Nextcloud file directory..."
 rm -r "${nextcloudFileDir}"
 mkdir -p "${nextcloudFileDir}"
 echo "Done"
 echo
 
 echo "Deleting old Nextcloud file directory..."
 rm -r "${nextcloudFileDir}"
 mkdir -p "${nextcloudFileDir}"
 echo "Done"
 echo
 

+# Data directory

 echo "Deleting old Nextcloud data directory..."
 rm -r "${nextcloudDataDir}"
 mkdir -p "${nextcloudDataDir}"
 echo "Done"
 echo
 
 echo "Deleting old Nextcloud data directory..."
 rm -r "${nextcloudDataDir}"
 mkdir -p "${nextcloudDataDir}"
 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
+

 #
 # Restore file and data directory
 #
 #
 # Restore file and data directory
 #

+
+# File directory

 echo "Restoring Nextcloud file directory..."
 echo "Restoring Nextcloud file directory..."

-tar -xpzf "${currentRestoreDir}/${fileNameBackupFileDir}" -C "${nextcloudFileDir}"
+tar -xmpzf "${currentRestoreDir}/${fileNameBackupFileDir}" -C "${nextcloudFileDir}"

 echo "Done"
 echo
 
 echo "Done"
 echo
 

+# Data directory

 echo "Restoring Nextcloud data directory..."
 echo "Restoring Nextcloud data directory..."

-tar -xpzf "${currentRestoreDir}/${fileNameBackupDataDir}" -C "${nextcloudDataDir}"
+tar -xmpzf "${currentRestoreDir}/${fileNameBackupDataDir}" -C "${nextcloudDataDir}"

 echo "Done"
 echo
 
 echo "Done"
 echo
 

+# Local external storage
+# TODO: Uncomment if you use local external storage
+#echo "Restoring Nextcloud data directory..."
+#tar -xmpzf "${currentRestoreDir}/${fileNameBackupExternalDataDir}" -C "${nextcloudLocalExternalDataDir}"
+#echo "Done"
+#echo
+

 #
 # Restore database
 #
 echo "Dropping old Nextcloud DB..."
 #
 # Restore database
 #
 echo "Dropping old Nextcloud DB..."

-mysql -h localhost -u "${dbUser}" -p"${dbPassword}" -e "DROP DATABASE ${nextcloudDatabase}"
+
+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
+

 echo "Done"
 echo
 
 echo "Creating new DB for Nextcloud..."
 echo "Done"
 echo
 
 echo "Creating new DB for Nextcloud..."

-mysql -h localhost -u "${dbUser}" -p"${dbPassword}" -e "CREATE DATABASE ${nextcloudDatabase}"
+
+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}"
+elif [ "${databaseSystem,,}" = "postgresql" ]; then
+    sudo -u postgres psql -c "CREATE DATABASE ${nextcloudDatabase} WITH OWNER ${dbUser} TEMPLATE template0 ENCODING \"UTF8\";"
+fi
+

 echo "Done"
 echo
 
 echo "Restoring backup DB..."
 echo "Done"
 echo
 
 echo "Restoring backup DB..."

-mysql -h localhost -u "${dbUser}" -p"${dbPassword}" "${nextcloudDatabase}" < "${currentRestoreDir}/${fileNameBackupDb}"
+
+if [ "${databaseSystem,,}" = "mysql" ] || [ "${databaseSystem,,}" = "mariadb" ]; then
+       mysql -h localhost -u "${dbUser}" -p"${dbPassword}" "${nextcloudDatabase}" < "${currentRestoreDir}/${fileNameBackupDb}"
+elif [ "${databaseSystem,,}" = "postgresql" ]; then
+       sudo -u postgres psql "${nextcloudDatabase}" < "${currentRestoreDir}/${fileNameBackupDb}"
+fi
+

 echo "Done"
 echo
 
 echo "Done"
 echo
 


@@ -139,7 +228,7 @@ echo
 # Start web server
 #
 echo "Starting web server..."
 # Start web server
 #
 echo "Starting web server..."

-service "${webserverServiceName}" start
+systemctl start "${webserverServiceName}"

 echo "Done"
 echo
 
 echo "Done"
 echo
 


@@ -149,16 +238,16 @@ echo
 echo "Setting directory permissions..."
 chown -R "${webserverUser}":"${webserverUser}" "${nextcloudFileDir}"
 chown -R "${webserverUser}":"${webserverUser}" "${nextcloudDataDir}"
 echo "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}"

 echo "Done"
 echo
 
 #
 echo "Done"
 echo
 
 #

-# Update the system data-fingerprint (see https://docs.nextcloud.com/server/14/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 "Updating the system data-fingerprint..."

-cd "${nextcloudFileDir}"
-sudo -u "${webserverUser}" php occ maintenance:data-fingerprint
-cd ~
+sudo -u "${webserverUser}" php ${nextcloudFileDir}/occ maintenance:data-fingerprint

 echo "Done"
 echo
 
 echo "Done"
 echo
 


@@ -166,12 +255,10 @@ echo
 # Disbale maintenance mode
 #
 echo "Switching off maintenance mode..."
 # Disbale maintenance mode
 #
 echo "Switching off maintenance mode..."

-cd "${nextcloudFileDir}"
-sudo -u "${webserverUser}" php occ maintenance:mode --off
-cd ~
+sudo -u "${webserverUser}" php ${nextcloudFileDir}/occ maintenance:mode --off

 echo "Done"
 echo
 
 echo
 echo "DONE!"
 echo "Done"
 echo
 
 echo
 echo "DONE!"

-echo "Backup ${restore} successfully restored."
+echo "Backup ${restore} successfully restored."
\ No newline at end of file