Skip to content

Commit e3d0143

Browse files
Addition/backup (#32)
* Add auto backup instructions for Duplicati
1 parent ce73b49 commit e3d0143

File tree

3 files changed

+64
-0
lines changed

3 files changed

+64
-0
lines changed
142 KB
Loading

docs/index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,7 @@ ERDA/SIF: User Guides
2828
sections/erda/archiving/index
2929
sections/erda/scheduletask/index
3030
sections/erda/dataimportexport/index
31+
sections/erda/backup/index
3132

3233
.. toctree::
3334
:maxdepth: 2

docs/sections/erda/backup/index.rst

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
.. _erda-backup-start:
2+
3+
Automatic Backup to ERDA
4+
========================
5+
6+
It is possible to combine Advanced Data Access with the free and open backup program `Duplicati <https://duplicati.com/>`_ to achieve automatic backup of your computer(s) to ERDA.
7+
Duplicati stores backup files in a special container form, which allows it to store e.g. special files and exotic file names, that may otherwise be problem to save directly on ERDA.
8+
It also means that it's easy to encrypt the entire backup, so that no one else can read it, even if they should illegitimately obtain access to the ERDA storage.
9+
10+
Duplicati exists in a user-friendly graphical flavor as well as a command-line flavor better suited for backup of e.g. servers and certain NAS-systems.
11+
On this page, we only cover the graphical flavor.
12+
13+
Setup Duplicati on ERDA
14+
-----------------------
15+
16+
In short setting up Duplicati requires two steps, namely creating the ERDA-specific configuration at your ERDA Duplicati Settings followed by import of the resulting configuration(s) in the Duplicati on your computer.
17+
18+
First you go to your ERDA **Setup** page and choose the Duplicati tab.
19+
20+
.. image:: /images/auto-backup/duplicati-tab.png
21+
22+
Enter one or more names you want to use for your backup(s) in the Backups field.
23+
E.g. the name of the computer or the folders you want to backup.
24+
25+
The remaining fields are optional and can just be left as is.
26+
Please note that you need to have configured password login for SFTP or whichever protocol you choose for Duplicati, however.
27+
Click **Save Duplicati Settings** when done and wait for the automatic page refresh where links to a .json file now appear for each backup name you entered in the Backups field.
28+
In this case where you enter enter *Documents* you'll get *Documents.json* as a result.
29+
You can download the json file(s) by right-clicking on the link(s) and then something like **Save link as** or **Save target as** depending on which web browser you use.
30+
31+
32+
Setting the program up
33+
----------------------
34+
35+
The second half of the setup is to import the resulting json file(s) directly in Duplicati.
36+
37+
Download and install the latest release from the linked website, and finish the install wizard.
38+
39+
When installed Duplicati should automatically start and show the status overview.
40+
However, you can always open Duplciati by right-clicking the status icon in the system tray next to the clock and choose Open there.
41+
Select **Add backup** from the menu in Duplicati, and for Configurataion file, browse to the json you downloaded earlier and click **Import**.
42+
43+
On the next page all ERDA settings are pre-filled from the configuration file - except the password field.
44+
This password is the one you previously configured for the selected protocol on ERDA I.e. with the default choices, it is the SFTP password you set on your ERDA SFTP Setup page, and so on.
45+
46+
At this point you can click **Test connection** to verify that the connection and login is correctly configured before proceeding with Next.
47+
48+
Select which local folders to include in the backup, like e.g. *My Documents* and click Next.
49+
Please note that by default Duplicati runs on behalf of your regular user, so it may not have access to all system files or to shadow copy facilities available on some platforms.
50+
In effect this meanas that you may see warnings or errors if you select folders outside your user space or e.g. folders with application data in active use.
51+
Either leave out any such folders from your backup selection, or follow the Duplicati documentation on running Duplicati as a privileged user.
52+
53+
Optionally further tune the frequency for automatic backup runs and click.
54+
You do not need to touch the **Allowed days**, as no specific days selected has the same effect as ticking them all.
55+
56+
On the last page **Options** you can specify how long backups should be kept and click **Save**.
57+
58+
When set up, you can click **Run now** next to it saying that it has never run.
59+
60+
61+
You need to repeat the procedure in Duplicati for all backup .json files you have created in ERDA Duplicati setup.
62+
63+
After a successful backup run you can always recover selected files or folders from backup with the **Restore** entry in Duplicati or by folding out the backup entry and selecting **Restore files...**.

0 commit comments

Comments
 (0)