From 3853e8dd9389b0eda5b9563296cbc6e305d20cec Mon Sep 17 00:00:00 2001 From: Joshua Tauberer Date: Mon, 1 Sep 2014 13:06:38 +0000 Subject: [PATCH] show the status of backups in the control panel --- management/backup.py | 221 +++++++++++++++--------- management/daemon.py | 6 + management/templates/index.html | 9 +- management/templates/system-backup.html | 70 ++++++++ setup/management.sh | 2 +- 5 files changed, 224 insertions(+), 84 deletions(-) create mode 100644 management/templates/system-backup.html diff --git a/management/backup.py b/management/backup.py index 816de358..0201fe31 100755 --- a/management/backup.py +++ b/management/backup.py @@ -9,111 +9,168 @@ # backup/secret_key.txt) to STORAGE_ROOT/backup/encrypted. # 5) STORAGE_ROOT/backup/after-backup is executd if it exists. -import sys, os, os.path, shutil, glob +import os, os.path, shutil, glob, re, datetime +import dateutil.parser, dateutil.relativedelta, dateutil.tz from utils import exclusive_process, load_environment, shell # settings -full_backup = "--full" in sys.argv keep_backups_for = "31D" # destroy backups older than 31 days except the most recent full backup -env = load_environment() +def backup_status(env): + # What is the current status of backups? + # Loop through all of the files in STORAGE_ROOT/backup/duplicity to + # get a list of all of the backups taken and sum up file sizes to + # see how large the storage is. -exclusive_process("backup") + now = datetime.datetime.now(dateutil.tz.tzlocal()) + def reldate(date): + rd = dateutil.relativedelta.relativedelta(now, date) + if rd.days >= 7: return "%d days" % rd.days + if rd.days > 1: return "%d days, %d hours" % (rd.days, rd.hours) + if rd.days == 1: return "%d day, %d hours" % (rd.days, rd.hours) + return "%d hours, %d minutes" % (rd.hours, rd.minutes) -# Ensure the backup directory exists. -backup_dir = os.path.join(env["STORAGE_ROOT"], 'backup') -backup_duplicity_dir = os.path.join(backup_dir, 'duplicity') -os.makedirs(backup_duplicity_dir, exist_ok=True) + backups = { } + basedir = os.path.join(env['STORAGE_ROOT'], 'backup/duplicity/') + encdir = os.path.join(env['STORAGE_ROOT'], 'backup/encrypted/') + for fn in os.listdir(basedir): + m = re.match(r"duplicity-(full|full-signatures|(inc|new-signatures)\.(?P\d+T\d+Z)\.to)\.(?P\d+T\d+Z)\.", fn) + if not m: raise ValueError(fn) -# On the first run, always do a full backup. Incremental -# will fail. -if len(os.listdir(backup_duplicity_dir)) == 0: - full_backup = True -else: - # When the size of incremental backups exceeds the size of existing - # full backups, take a new full backup. We want to avoid full backups - # because they are costly to synchronize off-site. - full_sz = sum(os.path.getsize(f) for f in glob.glob(backup_duplicity_dir + '/*-full.*')) - inc_sz = sum(os.path.getsize(f) for f in glob.glob(backup_duplicity_dir + '/*-inc.*')) - # (n.b. not counting size of new-signatures files because they are relatively small) - if inc_sz > full_sz * 1.5: + key = m.group("date") + if key not in backups: + date = dateutil.parser.parse(m.group("date")) + backups[key] = { + "date": m.group("date"), + "date_str": date.strftime("%x %X"), + "date_delta": reldate(date), + "full": m.group("incbase") is None, + "previous": m.group("incbase") is None, + "size": 0, + "encsize": 0, + } + + backups[key]["size"] += os.path.getsize(os.path.join(basedir, fn)) + + # Also check encrypted size. + encfn = os.path.join(encdir, fn + ".enc") + if os.path.exists(encfn): + backups[key]["encsize"] += os.path.getsize(encfn) + + backups = sorted(backups.values(), key = lambda b : b["date"], reverse=True) + + return { + "directory": basedir, + "encpwfile": os.path.join(env['STORAGE_ROOT'], 'backup/secret_key.txt'), + "encdirectory": encdir, + "tz": now.tzname(), + "backups": backups, + } + +def perform_backup(full_backup): + env = load_environment() + + exclusive_process("backup") + + # Ensure the backup directory exists. + backup_dir = os.path.join(env["STORAGE_ROOT"], 'backup') + backup_duplicity_dir = os.path.join(backup_dir, 'duplicity') + os.makedirs(backup_duplicity_dir, exist_ok=True) + + # On the first run, always do a full backup. Incremental + # will fail. + if len(os.listdir(backup_duplicity_dir)) == 0: full_backup = True + else: + # When the size of incremental backups exceeds the size of existing + # full backups, take a new full backup. We want to avoid full backups + # because they are costly to synchronize off-site. + full_sz = sum(os.path.getsize(f) for f in glob.glob(backup_duplicity_dir + '/*-full.*')) + inc_sz = sum(os.path.getsize(f) for f in glob.glob(backup_duplicity_dir + '/*-inc.*')) + # (n.b. not counting size of new-signatures files because they are relatively small) + if inc_sz > full_sz * 1.5: + full_backup = True -# Stop services. -shell('check_call', ["/usr/sbin/service", "dovecot", "stop"]) -shell('check_call', ["/usr/sbin/service", "postfix", "stop"]) + # Stop services. + shell('check_call', ["/usr/sbin/service", "dovecot", "stop"]) + shell('check_call', ["/usr/sbin/service", "postfix", "stop"]) -# Update the backup mirror directory which mirrors the current -# STORAGE_ROOT (but excluding the backups themselves!). -try: + # Update the backup mirror directory which mirrors the current + # STORAGE_ROOT (but excluding the backups themselves!). + try: + shell('check_call', [ + "/usr/bin/duplicity", + "full" if full_backup else "incr", + "--no-encryption", + "--archive-dir", "/tmp/duplicity-archive-dir", + "--name", "mailinabox", + "--exclude", backup_dir, + "--volsize", "100", + "--verbosity", "warning", + env["STORAGE_ROOT"], + "file://" + backup_duplicity_dir + ]) + finally: + # Start services again. + shell('check_call', ["/usr/sbin/service", "dovecot", "start"]) + shell('check_call', ["/usr/sbin/service", "postfix", "start"]) + + # Remove old backups. This deletes all backup data no longer needed + # from more than 31 days ago. Must do this before destroying the + # cache directory or else this command will re-create it. shell('check_call', [ "/usr/bin/duplicity", - "full" if full_backup else "incr", - "--no-encryption", + "remove-older-than", + keep_backups_for, "--archive-dir", "/tmp/duplicity-archive-dir", "--name", "mailinabox", - "--exclude", backup_dir, - "--volsize", "100", + "--force", "--verbosity", "warning", - env["STORAGE_ROOT"], "file://" + backup_duplicity_dir ]) -finally: - # Start services again. - shell('check_call', ["/usr/sbin/service", "dovecot", "start"]) - shell('check_call', ["/usr/sbin/service", "postfix", "start"]) -# Remove old backups. This deletes all backup data no longer needed -# from more than 31 days ago. Must do this before destroying the -# cache directory or else this command will re-create it. -shell('check_call', [ - "/usr/bin/duplicity", - "remove-older-than", - keep_backups_for, - "--archive-dir", "/tmp/duplicity-archive-dir", - "--name", "mailinabox", - "--force", - "--verbosity", "warning", - "file://" + backup_duplicity_dir - ]) + # Remove duplicity's cache directory because it's redundant with our backup directory. + shutil.rmtree("/tmp/duplicity-archive-dir") -# Remove duplicity's cache directory because it's redundant with our backup directory. -shutil.rmtree("/tmp/duplicity-archive-dir") + # Encrypt all of the new files. + backup_encrypted_dir = os.path.join(backup_dir, 'encrypted') + os.makedirs(backup_encrypted_dir, exist_ok=True) + for fn in os.listdir(backup_duplicity_dir): + fn2 = os.path.join(backup_encrypted_dir, fn) + ".enc" + if os.path.exists(fn2): continue -# Encrypt all of the new files. -backup_encrypted_dir = os.path.join(backup_dir, 'encrypted') -os.makedirs(backup_encrypted_dir, exist_ok=True) -for fn in os.listdir(backup_duplicity_dir): - fn2 = os.path.join(backup_encrypted_dir, fn) + ".enc" - if os.path.exists(fn2): continue + # Encrypt the backup using the backup private key. + shell('check_call', [ + "/usr/bin/openssl", + "enc", + "-aes-256-cbc", + "-a", + "-salt", + "-in", os.path.join(backup_duplicity_dir, fn), + "-out", fn2, + "-pass", "file:%s" % os.path.join(backup_dir, "secret_key.txt"), + ]) - # Encrypt the backup using the backup private key. - shell('check_call', [ - "/usr/bin/openssl", - "enc", - "-aes-256-cbc", - "-a", - "-salt", - "-in", os.path.join(backup_duplicity_dir, fn), - "-out", fn2, - "-pass", "file:%s" % os.path.join(backup_dir, "secret_key.txt"), - ]) + # The backup can be decrypted with: + # openssl enc -d -aes-256-cbc -a -in latest.tgz.enc -out /dev/stdout -pass file:secret_key.txt | tar -z - # The backup can be decrypted with: - # openssl enc -d -aes-256-cbc -a -in latest.tgz.enc -out /dev/stdout -pass file:secret_key.txt | tar -z + # Remove encrypted backups that are no longer needed. + for fn in os.listdir(backup_encrypted_dir): + fn2 = os.path.join(backup_duplicity_dir, fn.replace(".enc", "")) + if os.path.exists(fn2): continue + os.unlink(os.path.join(backup_encrypted_dir, fn)) -# Remove encrypted backups that are no longer needed. -for fn in os.listdir(backup_encrypted_dir): - fn2 = os.path.join(backup_duplicity_dir, fn.replace(".enc", "")) - if os.path.exists(fn2): continue - os.unlink(os.path.join(backup_encrypted_dir, fn)) + # Execute a post-backup script that does the copying to a remote server. + # Run as the STORAGE_USER user, not as root. Pass our settings in + # environment variables so the script has access to STORAGE_ROOT. + post_script = os.path.join(backup_dir, 'after-backup') + if os.path.exists(post_script): + shell('check_call', + ['su', env['STORAGE_USER'], '-c', post_script], + env=env) -# Execute a post-backup script that does the copying to a remote server. -# Run as the STORAGE_USER user, not as root. Pass our settings in -# environment variables so the script has access to STORAGE_ROOT. -post_script = os.path.join(backup_dir, 'after-backup') -if os.path.exists(post_script): - shell('check_call', - ['su', env['STORAGE_USER'], '-c', post_script], - env=env) +if __name__ == "__main__": + import sys + full_backup = "--full" in sys.argv + perform_backup(full_backup) diff --git a/management/daemon.py b/management/daemon.py index aebd6e14..a3ee79a3 100755 --- a/management/daemon.py +++ b/management/daemon.py @@ -250,6 +250,12 @@ def do_updates(): "DEBIAN_FRONTEND": "noninteractive" }) +@app.route('/system/backup/status') +@authorized_personnel_only +def backup_status(): + from backup import backup_status + return json_response(backup_status(env)) + # APP if __name__ == '__main__': diff --git a/management/templates/index.html b/management/templates/index.html index 8eba0a70..a95c1c8e 100644 --- a/management/templates/index.html +++ b/management/templates/index.html @@ -85,7 +85,10 @@ System
  • @@ -115,6 +118,10 @@ {% include "system-status.html" %} +
    + {% include "system-backup.html" %} +
    +
    {% include "system-dns.html" %}
    diff --git a/management/templates/system-backup.html b/management/templates/system-backup.html new file mode 100644 index 00000000..7bbec01a --- /dev/null +++ b/management/templates/system-backup.html @@ -0,0 +1,70 @@ + + +

    Backup Status

    + +

    The box makes an incremental backup each night. The backup is stored on the machine itself. You are responsible for copying the backup files off of the machine. Many cloud providers make this easy by allowing you to take snapshots of the machine's disk.

    + +

    Copying Backup Files

    + +

    Use SFTP (FTP over SSH) to copy files from . These files are encrpyted, so they are safe to store anywhere. Copy the encryption password from also but keep it in a safe location.

    + +

    Current Backups

    + +

    The backup directory currently contains the backups listed below. The total size on disk of the backups is .

    + + + + + + + + + +
    WhenTypeSize
    + +

    The size column in the table indicates the size of the encrpyted backup, but the total size on disk shown above includes storage for unencrpyted intermediate files.

    + + diff --git a/setup/management.sh b/setup/management.sh index 7ea1332b..ce166ebd 100755 --- a/setup/management.sh +++ b/setup/management.sh @@ -2,7 +2,7 @@ source setup/functions.sh -apt_install python3-flask links duplicity libyaml-dev python3-dnspython +apt_install python3-flask links duplicity libyaml-dev python3-dnspython python3-dateutil hide_output pip3 install rtyaml # Create a backup directory and a random key for encrypting backups.