Use pigz for compression

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

diff --git a/NextcloudBackup.sh b/NextcloudBackup.sh
index dae6e7faf489533826c9573910186791254602d7..3e0d2a5df099298278ad8b6c629fda9c10f14e34 100644 (file)
--- a/NextcloudBackup.sh
+++ b/NextcloudBackup.sh
@@ -2,9 +2,14 @@
 
 #
 # Bash script for creating backups of Nextcloud.
 
 #
 # Bash script for creating backups of Nextcloud.

-# Usage: ./NextcloudBackup.sh
-# 
-# The script is based on an installation of Nextcloud using nginx and MariaDB, see https://decatec.de/home-server/nextcloud-auf-ubuntu-server-mit-nginx-mariadb-php-lets-encrypt-redis-und-fail2ban/
+#
+# Version 2.1.2
+#
+# Usage:
+#      - With backup directory specified in the script:  ./NextcloudBackup.sh
+#      - With backup directory specified by parameter: ./NextcloudBackup.sh <BackupDirectory> (e.g. ./NextcloudBackup.sh /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,38 +19,118 @@
 #
 
 # Variables
 #
 
 # Variables

+backupMainDir=$1
+
+if [ -z "$backupMainDir" ]; then
+       # TODO: The directory where you store the Nextcloud backups (when not specified by args)
+    backupMainDir='/media/hdd/nextcloud_backup'
+else
+       backupMainDir=$(echo $backupMainDir | sed 's:/*$::')
+fi
+

 currentDate=$(date +"%Y%m%d_%H%M%S")
 currentDate=$(date +"%Y%m%d_%H%M%S")

-# TODO: The directory where you store the Nextcloud backups
-backupMainDir="/mnt/Share/NextcloudBackups/"
-# The actual directory of the current backup - this is is subdirectory of the main directory above with a timestamp
+
+# The actual directory of the current backup - this is a subdirectory of the main directory above with a timestamp

 backupdir="${backupMainDir}/${currentDate}/"
 backupdir="${backupMainDir}/${currentDate}/"

+
+# TODO: Use compression for file/data dir
+# When this is the only script for backups, it's recommend to enable compression.
+# If the output of this script is used in another (compressing) backup (e.g. borg backup), 
+# you should probably disable compression here and only enable compression of your main backup script.
+useCompression=true
+

 # 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 a separate part of the backup
 # 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 a separate part of the backup

-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'
+

 # TODO: The maximum number of backups to keep (when set to 0, all backups are kept)
 maxNrOfBackups=0
 
 # TODO: The maximum number of backups to keep (when set to 0, all backups are kept)
 maxNrOfBackups=0
 

+# TODO: Ignore updater's backup directory in the data directory to save space
+# Set to true to ignore the backup directory
+ignoreUpdaterBackups=false
+

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

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

+function DisableMaintenanceMode() {
+       echo "Switching off maintenance mode..."
+       sudo -u "${webserverUser}" php ${nextcloudFileDir}/occ maintenance:mode --off
+       echo "Done"
+       echo
+}
+
+# Capture CTRL+C
+trap CtrlC INT
+
+function CtrlC() {
+       read -p "Backup cancelled. Keep maintenance mode? [y/n] " -n 1 -r
+       echo
+
+       if ! [[ $REPLY =~ ^[Yy]$ ]]
+       then
+               DisableMaintenanceMode
+       else
+               echo "Maintenance mode still enabled."
+       fi
+
+       echo "Starting web server..."
+       systemctl start "${webserverServiceName}"
+       echo "Done"
+       echo
+
+       exit 1
+}
+
+#
+# Print information
+#
+echo "Backup directory: ${backupMainDir}"
+

 #
 # Check for root
 #
 #
 # Check for root
 #


@@ -70,9 +155,7 @@ 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
 


@@ -80,65 +163,119 @@ 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
 
 #

-# Backup file and data directory
+# Backup file directory

 #
 echo "Creating backup of Nextcloud file directory..."
 #
 echo "Creating backup of Nextcloud file directory..."

-tar -cpzf "${backupdir}/${fileNameBackupFileDir}" -C "${nextcloudFileDir}" .
+
+if [ "$useCompression" = true ] ; then
+       tar -I pigz -cpf "${backupdir}/${fileNameBackupFileDir}" -C "${nextcloudFileDir}" .
+else
+       tar -cpf "${backupdir}/${fileNameBackupFileDir}" -C "${nextcloudFileDir}" .
+fi
+

 echo "Done"
 echo
 
 echo "Done"
 echo
 

+#
+# Backup data directory
+#

 echo "Creating backup of Nextcloud data directory..."
 echo "Creating backup of Nextcloud data directory..."

-tar -cpzf "${backupdir}/${fileNameBackupDataDir}"  -C "${nextcloudDataDir}" .
+
+if [ "$ignoreUpdaterBackups" = true ] ; then
+       echo "Ignoring updater backup directory"
+
+       if [ "$useCompression" = true ] ; then
+               tar -I pigz -cpf "${backupdir}/${fileNameBackupDataDir}"  --exclude="updater-*/backups/*" -C "${nextcloudDataDir}" .
+       else
+               tar -cpf "${backupdir}/${fileNameBackupDataDir}"  --exclude="updater-*/backups/*" -C "${nextcloudDataDir}" .
+       fi
+else
+       if [ "$useCompression" = true ] ; then
+        tar -I pigz -cpf "${backupdir}/${fileNameBackupDataDir}"  -C "${nextcloudDataDir}" .
+       else
+               tar -cpf "${backupdir}/${fileNameBackupDataDir}"  -C "${nextcloudDataDir}" .
+       fi
+fi
+

 echo "Done"
 echo
 
 echo "Done"
 echo
 

+# Backup local external storage.
+# Uncomment if you use local external storage
+#echo "Creating backup of Nextcloud local external storage directory..."
+
+#if [ "$useCompression" = true ] ; then
+#      tar -I pigz -cpf "${backupdir}/${fileNameBackupExternalDataDir}"  -C "${nextcloudLocalExternalDataDir}" .
+#else
+#      tar -cpf "${backupdir}/${fileNameBackupExternalDataDir}"  -C "${nextcloudLocalExternalDataDir}" .
+#fi
+
+#echo "Done"
+#echo
+

 #
 # Backup DB
 #
 #
 # Backup DB
 #

-echo "Backup Nextcloud database..."
-mysqldump --single-transaction -h localhost -u "${dbUser}" -p"${dbPassword}" "${nextcloudDatabase}" > "${backupdir}/${fileNameBackupDb}"
-echo "Done"
-echo
+if [ "${databaseSystem,,}" = "mysql" ] || [ "${databaseSystem,,}" = "mariadb" ]; then
+       echo "Backup Nextcloud database (MySQL/MariaDB)..."
+
+       if ! [ -x "$(command -v mysqldump)" ]; then
+               errorecho "ERROR: MySQL/MariaDB not installed (command mysqldump not found)."
+               errorecho "ERROR: No backup of database possible!"
+       else
+               mysqldump --single-transaction -h localhost -u "${dbUser}" -p"${dbPassword}" "${nextcloudDatabase}" > "${backupdir}/${fileNameBackupDb}"
+       fi
+
+       echo "Done"
+       echo
+elif [ "${databaseSystem,,}" = "postgresql" ] || [ "${databaseSystem,,}" = "pgsql" ]; then
+       echo "Backup Nextcloud database (PostgreSQL)..."
+
+       if ! [ -x "$(command -v pg_dump)" ]; then
+               errorecho "ERROR: PostgreSQL not installed (command pg_dump not found)."
+               errorecho "ERROR: No backup of database possible!"
+       else
+               PGPASSWORD="${dbPassword}" pg_dump "${nextcloudDatabase}" -h localhost -U "${dbUser}" -f "${backupdir}/${fileNameBackupDb}"
+       fi
+       
+       echo "Done"
+       echo
+fi

 
 #
 # Start web server
 #
 echo "Starting web server..."
 
 #
 # Start web server
 #
 echo "Starting web server..."

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

 echo "Done"
 echo
 
 #
 # Disable maintenance mode
 #
 echo "Done"
 echo
 
 #
 # Disable maintenance mode
 #

-echo "Switching off maintenance mode..."
-cd "${nextcloudFileDir}"
-sudo -u "${webserverUser}" php occ maintenance:mode --off
-cd ~
-echo "Done"
-echo
+DisableMaintenanceMode

 
 #
 # Delete old backups
 #
 
 #
 # Delete old backups
 #

-if (( ${maxNrOfBackups} != 0 ))
-then   
+if [ ${maxNrOfBackups} != 0 ]
+then

        nrOfBackups=$(ls -l ${backupMainDir} | grep -c ^d)
        nrOfBackups=$(ls -l ${backupMainDir} | grep -c ^d)

-       
-       if (( ${nrOfBackups} > ${maxNrOfBackups} ))
+
+       if [ ${nrOfBackups} -gt ${maxNrOfBackups} ]

        then
                echo "Removing old backups..."
        then
                echo "Removing old backups..."

-               ls -t ${backupMainDir} | tail -$(( nrOfBackups - maxNrOfBackups )) | while read dirToRemove; do
-               echo "${dirToRemove}"
-               rm -r ${backupMainDir}/${dirToRemove}
-               echo "Done"
-               echo
-    done
+               ls -t ${backupMainDir} | tail -$(( nrOfBackups - maxNrOfBackups )) | while read -r dirToRemove; do
+                       echo "${dirToRemove}"
+                       rm -r "${backupMainDir}/${dirToRemove:?}"
+                       echo "Done"
+                       echo
+               done

        fi
 fi
 
        fi
 fi