This page describes the procedure for accessing and using our off-site backups.  Only admins can do this -- if you want to get some file or directory back from the dead and are not an admin, please contact the hcoop-sysadmin list for assistance.

<<TableOfContents>>

= Backups of AFS Volumes =

== Navigating the available backups ==

Using backup-manager:

{{{
backup-manager list
backup-manager list YYYY.MM.DD
}}}

== Retrieving a backup ==

Using backup-manager:

{{{
backup-manager get YYYY.MM.DD $VOLNAME.dump.gz.aescrypt
}}}

== Restoring the volume dump to a volume with a new name ==

Using backup-manager:

{{{
backup-manager restore YYYY.MM.DD VOLNAME.dump.gz.aescrypt $VOLNAME.restored
}}}

Manually:

{{{
cat /vicepa/hcoop-backups/restored/YYYY.MM.DD-$VOLNAME.dump.gz.aescrypt | \
  ccrypt -cdk /etc/backup-encryption-key | \
  gunzip | \
  vos restore deleuze /vicepa $VOLNAME.restored
}}}

== Mounting the newly restored volume onto the filesystem ==

{{{
fs mkm /afs/hcoop.net/.old/tmp-mount $VOLNAME.restored
vos release old
}}}

== Restoring a particular file ==

{{{
# examine /afs/hcoop.net/.old/tmp-mount
}}}

== Unmounting the restored volume ==

{{{
fs rm /afs/hcoop.net/.old/tmp-mount
vos release old
}}}

== Renaming the restored volume so it takes the place of the damaged/corrupted/erased volume ==

Do this if you want to restore an entire volume.  This deletes the old volume and replaces it with the backup.

{{{
vos remove $VOLNAME
vos rename $VOLNAME.restored $VOLNAME
}}}

== Removing the restored volume ==

If you only wanted to restore a few files from the volume, you should remove the local copy of the backup volume when done.

{{{
vos remove -id $VOLNAME.restored
}}}

= Database Backups =

{{{
cd /vicepa/hcoop-backups/restored
mkdir YYYY.MM.DD-db
cd YYYY.MM.DD-db
cat ../YYYY.MM.DD-databases.tar.gz.aescrypt | \
  ccrypt -cdk /etc/backup-encryption-key | \
  gunzip | \
  tar -xvzf -
}}}