diff --git a/site/source/_static/images/backups/backup-mount-ls.png b/site/source/_static/images/backups/backup-mount-ls.png new file mode 100644 index 0000000..6ef6b0e Binary files /dev/null and b/site/source/_static/images/backups/backup-mount-ls.png differ diff --git a/site/source/_static/images/backups/backup-mount.png b/site/source/_static/images/backups/backup-mount.png new file mode 100644 index 0000000..2671398 Binary files /dev/null and b/site/source/_static/images/backups/backup-mount.png differ diff --git a/site/source/_static/images/backups/backup-target-list.png b/site/source/_static/images/backups/backup-target-list.png new file mode 100644 index 0000000..738039a Binary files /dev/null and b/site/source/_static/images/backups/backup-target-list.png differ diff --git a/site/source/user-manual/backups/backup-mount.rst b/site/source/user-manual/backups/backup-mount.rst new file mode 100644 index 0000000..ab383e6 --- /dev/null +++ b/site/source/user-manual/backups/backup-mount.rst @@ -0,0 +1,47 @@ +.. _backup-advanced: + +===================== +Advanced Backup Tools +===================== + +.. contents:: + :depth: 2 + :local: + + .. warning:: The following are advanced tools and using them is only advised when under the instruction of a Start9 Support Technician. USE AT YOUR OWN RISK - these operations are not supported outside of the context of support. + +.. _backup-mount: + +Mount a Backup +-------------- + +#. :ref:`Setup SSH Access` and connect to your server via SSH. Elevate yourself to root once in: + + .. code-block:: bash + + sudo -i + +#. Any previously added Network Folder backup location (or physical drive) will be available. Enter the following command: + + .. code-block:: bash + + embassy-cli backup target list + + .. figure:: /_static/images/backups/backup-target-list.png + :width: 60% + +#. Select the backup target from the available list. In this example, we could use either ``disk-/dev/sdb1`` or ``cifs-1``: + + .. code-block:: bash + + embassy-cli backup target mount disk-/dev/sdb1 "YourMasterPasswordGoesHere" + + .. figure:: /_static/images/backups/backup-mount.png + :width: 60% + + The terminal will print the directory where your decrypted backup is now mounted. + +#. `ls` the directory to inspect it, and continue any other operations necessary: + + .. figure:: /_static/images/backups/backup-mount-ls.png + :width: 60% \ No newline at end of file diff --git a/site/source/user-manual/backups/index.rst b/site/source/user-manual/backups/index.rst index 9148941..6f5d92c 100644 --- a/site/source/user-manual/backups/index.rst +++ b/site/source/user-manual/backups/index.rst @@ -30,6 +30,15 @@ In addition to the safe-keeping of a good master password, maintaining good back Restore your server data from a previous backup. +.. topic-box:: + :title: Advanced Backup Tools + :link: backup-mount + :icon: scylla-icon scylla-icon--live-test + :class: large-5 + :anchor: View + + Tools for backups - use only at the direction of support, or at your own risk. + .. raw:: html @@ -40,3 +49,4 @@ In addition to the safe-keeping of a good master password, maintaining good back backup-create backup-restore + backup-advanced