mirror of
https://github.com/deajan/obackup.git
synced 2024-11-14 03:33:41 +01:00
183 lines
8.1 KiB
Bash
Executable File
183 lines
8.1 KiB
Bash
Executable File
#!/bin/bash
|
|
|
|
###### Remote (or local) backup script for files & databases
|
|
###### (L) 2013 by Ozy de Jong (www.netpower.fr)
|
|
###### Config file rev 0801201501
|
|
|
|
## ---------- GENERAL BACKUP OPTIONS
|
|
|
|
## Backup identification name.
|
|
BACKUP_ID="your backup name"
|
|
|
|
## Log file location. Leaving this empty will create log file at /var/log/obackup_version_BACKUP_ID.log (or current directory if /var/log doesn't exist)
|
|
LOGFILE=""
|
|
|
|
## Backup databases
|
|
BACKUP_SQL=no
|
|
## Backup files
|
|
BACKUP_FILES=yes
|
|
|
|
## ---------- LOCAL BACKUP STORAGE OPTIONS
|
|
|
|
## Local storage paths where to put backups
|
|
LOCAL_SQL_STORAGE="/home/storage/backup/sql"
|
|
LOCAL_FILE_STORAGE="/home/storage/backup/files"
|
|
|
|
## Create backup directories if they do not exist
|
|
CREATE_DIRS=yes
|
|
|
|
## Keep absolute source path in your backup, eg: /your/backup/storage/the/remote/server/files
|
|
## You should leave this enabled if you intend to use 'backup task division' functionality of OBackup, or everything will end up in the same directory.
|
|
LOCAL_STORAGE_KEEP_ABSOLUTE_PATHS=yes
|
|
|
|
## Generate an alert if backup size is lower than given value in Kb (this can also help identifying empty mount dirs)
|
|
BACKUP_SIZE_MINIMUM=1024
|
|
|
|
## Generate an alert if local storage free space is lower than given value in Kb.
|
|
LOCAL_STORAGE_WARN_MIN_SPACE=1048576
|
|
|
|
## ---------- MISC OPTIONS
|
|
|
|
## Bandwidth limit Kbytes / second for file backups. Leave 0 to disable limitation.
|
|
BANDWIDTH=0
|
|
|
|
## If enabled, file backups will be processed as superuser. See documentation for /etc/sudoers configuration ("find", "du" and "rsync" need to be allowed). Requiretty needs to be disabled.
|
|
SUDO_EXEC=no
|
|
## Paranoia option. Don't change this unless you read the documentation.
|
|
RSYNC_EXECUTABLE=rsync
|
|
|
|
## ---------- REMOTE BACKUP OPTIONS
|
|
|
|
## The following options allow this Obackup instance to connect to a remote system via an ssh tunnel.
|
|
## Needs public RSA key need to be put into ~/.ssh/authorized_keys in remote users home directory.
|
|
REMOTE_BACKUP=no
|
|
SSH_RSA_PRIVATE_KEY=~/.ssh/id_rsa
|
|
REMOTE_USER=backupuser
|
|
REMOTE_HOST=yourhost.local
|
|
REMOTE_PORT=22
|
|
## ssh compression should be used unless your remote connection is good enough (LAN)
|
|
SSH_COMPRESSION=yes
|
|
## Remote rsync executable path. Leave this empty in most cases
|
|
RSYNC_REMOTE_PATH=""
|
|
|
|
## Check for connectivity to remote host before launching remote backup tasks. Be sure the hosts responds to ping. Failing to ping will skip current task.
|
|
REMOTE_HOST_PING=yes
|
|
## Check for internet access by pinging one or more 3rd party hosts before remote backup tasks. Leave empty if you don't want this check to be be performed. Failing to ping will skip current task.
|
|
REMOTE_3RD_PARTY_HOSTS="www.kernel.org www.google.com"
|
|
|
|
## ---------- DATABASE BACKUP OPTIONS
|
|
|
|
## Database backup user
|
|
SQL_USER=backupuser
|
|
|
|
## Enabling the following option will save all databases on local or remote given SQL instance except the ones specified in the exlude list.
|
|
## Every found database will be backed up as separate backup task.
|
|
DATABASES_ALL=yes
|
|
DATABASES_ALL_EXCLUDE_LIST="test;mysql"
|
|
## Alternatively, if DATABASES_ALL=no, you can specifiy a list of databases to backup separated by spaces.
|
|
DATABASES_LIST=""
|
|
|
|
## Max backup execution time per Database task. Soft max exec time generates a warning only. Hard max ecec time generates a warning and stops current backup task.
|
|
## If a task gets stopped, next one in the task list gets executed. Time is specified in seconds.
|
|
SOFT_MAX_EXEC_TIME_DB_TASK=3600
|
|
HARD_MAX_EXEC_TIME_DB_TASK=7200
|
|
|
|
## Preferred SQL dump compression. Compression methods can be xz, lzma, pigz or gzip (will fallback from xz to gzip depending if available)
|
|
## Generally, level 5 is a good compromise between cpu, memory hunger and compress ratio. Gzipped files are set to be rsyncable.
|
|
COMPRESSION_LEVEL=3
|
|
|
|
## SQL Dump compression should be done on remote side but can also be done locally to lower remote system usage (will take more bandwidth, check for ssh compression)
|
|
COMPRESSION_REMOTE=yes
|
|
|
|
## ---------- FILES BACKUP OPTIONS
|
|
|
|
## Directories backup list. List of semicolon separated directories that will be backed up recursively. Every directory will be processed as one backup task.
|
|
DIRECTORIES_SIMPLE_LIST="/var/named;/var/lib"
|
|
|
|
## There's a special backup schema in Obackup called 'backup task division' which creates one backup task per level 1 subdirectory of a directory.
|
|
## This is VERY usefull to backup multiple virtualhosts as separate tasks without having to specifiy each one separately.
|
|
## This may also be usefull dividing big data directories in subdirectories tasks.
|
|
|
|
## Directories backup task division backup: Semicolon separated directories of which every level 1 subdirectory will be backed up recursively as a spearate backup task.
|
|
## Example: "/home;/var" will create tasks "/home/dir1", "/home/dir2", ... "/home/dirN", "/var/log", "/var/lib"... "/var/whatever"
|
|
DIRECTORIES_RECURSE_LIST="/home"
|
|
## You may optionally exclude subdirectories from task division. On the above example you could exclude /home/dir2 by adding it to DIRECTORIES_RECURSE_EXCLUDE_LIST
|
|
DIRECTORIES_RECURSE_EXCLUDE_LIST="/home/backupuser;/home/lost+found"
|
|
|
|
## Rsync exclude patterns, used by simple and division lists
|
|
RSYNC_EXCLUDE_PATTERN="*/tmp;*/ftp/www/cache/cachefs;*/sessions"
|
|
|
|
## File that contains the list of directories or files to exclude from sync on both sides. Leave this empty if you don't want to use an exclusion file.
|
|
## This file has to be in the same directory as the config file
|
|
## Paths are relative to sync dirs. One element per line.
|
|
RSYNC_EXCLUDE_FROM=""
|
|
#RSYNC_EXCLUDE_FROM="exclude.list"
|
|
|
|
## List separator char. You may set an alternative seperator char for your directories lists above.
|
|
PATH_SEPARATOR_CHAR=";"
|
|
|
|
## Preserve ACLS. Make sure source and target FS can hold same ACLs or you'll get loads of errors.
|
|
PRESERVE_ACL=no
|
|
## Preserve Xattr. MAke sure source and target FS can hold same Xattr or you'll get loads of errors.
|
|
PRESERVE_XATTR=no
|
|
|
|
## Transforms symlinks into referent files/dirs
|
|
COPY_SYMLINKS=yes
|
|
## Treat symlinked dirs as dirs. CAUTION: This also follows symlinks outside of the replica root.
|
|
KEEP_DIRLINKS=yes
|
|
## Preserve hard links. Make sure source and target FS can manage hard links or you will lose them.
|
|
PRESERVE_HARDLINKS=no
|
|
|
|
|
|
## Let RSYNC compress file transfers. Do not use this on local-local backup schemes. Also, this is not usefull if SSH compression is enabled.
|
|
RSYNC_COMPRESS=no
|
|
|
|
## Max execution time per file backup task. Soft is warning only. Hard is warning, stopping backup and processing next one one file list. Tilme is specified in seconds
|
|
SOFT_MAX_EXEC_TIME_FILE_TASK=3600
|
|
HARD_MAX_EXEC_TIME_FILE_TASK=7200
|
|
|
|
## Keep partial uploads that can be resumed on next run, experimantal feature
|
|
PARTIAL=no
|
|
|
|
## Delete files on destination that vanished from source. Do not turn this on unless you enabled backup rotation or a snapshotting FS like zfs to keep those vanished files on the destination.
|
|
DELETE_VANISHED_FILES=no
|
|
|
|
## ---------- ALERT OPTIONS
|
|
|
|
## Alert email adresses separated by a space character
|
|
DESTINATION_MAILS="your@mail.address"
|
|
|
|
## Windows (MSYS environment) only mail options (used by sendemail.exe)
|
|
SENDER_MAIL="alert@your.system"
|
|
SMTP_SERVER=smtp.your.isp.com
|
|
SMTP_USER=
|
|
SMTP_PASSWORD=
|
|
|
|
## ---------- GENERAL BACKUP OPTIONS
|
|
|
|
## Max execution time of whole backup process. Soft max exec time generates a warning only.
|
|
## Hard max exec time generates a warning and stops the whole backup execution.
|
|
SOFT_MAX_EXEC_TIME_TOTAL=30000
|
|
HARD_MAX_EXEC_TIME_TOTAL=36000
|
|
|
|
## Backup Rotation. You may rotate backups if you don't use snapshots on your backup server.
|
|
ROTATE_BACKUPS=no
|
|
ROTATE_COPIES=7
|
|
|
|
## ---------- EXECUTION HOOKS
|
|
|
|
## Commands can will be run before and / or after backup execution (remote execution will only happen if REMOTE_BACKUP is set).
|
|
## This is usefull to make a snapshot before backing up data, or even handle snapshots of backed up data.
|
|
LOCAL_RUN_BEFORE_CMD=""
|
|
LOCAL_RUN_AFTER_CMD=""
|
|
|
|
REMOTE_RUN_BEFORE_CMD=""
|
|
REMOTE_RUN_AFTER_CMD=""
|
|
|
|
## Max execution time of commands before they get force killed. Leave 0 if you don't wan't this to happen. Time is specified in seconds.
|
|
MAX_EXEC_TIME_PER_CMD_BEFORE=0
|
|
MAX_EXEC_TIME_PER_CMD_AFTER=0
|
|
|
|
## Stops whole backup execution if one of the above commands fail
|
|
STOP_ON_CMD_ERROR=no
|