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/$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 db
cd db
cat ../databases.tar.gz.aescrypt | \
  ccrypt -cdk /etc/backup-encryption-key | \
  gunzip | \
  tar -xvzf -
}}}