From 9270007df9639de2246e1772b4601b309fc8e6cd Mon Sep 17 00:00:00 2001 From: Andreas Zweili Date: Wed, 6 Mar 2019 21:06:57 +0100 Subject: [PATCH] add a section to describe which commands of borg were used --- general/bibliography.bib | 58 ++++++++++++++++++- projektdokumentation/projektdokumentation.org | 27 ++++++--- 2 files changed, 77 insertions(+), 8 deletions(-) diff --git a/general/bibliography.bib b/general/bibliography.bib index 87b731c..f9226ba 100644 --- a/general/bibliography.bib +++ b/general/bibliography.bib @@ -457,7 +457,7 @@ note = {[Online; accessed 9. Feb. 2019]}, url = {https://doc.qt.io/qt-5/qthread.html} } -@misc{borgmount, +@misc{borgmountissue, title = {{Please allow "borg create" while repo/archive is mounted}}, journal = {GitHub}, year = {2019}, @@ -478,4 +478,60 @@ month = {Feb}, note = {[Online; accessed 26. Feb. 2019]}, url = {https://jlk.fjfi.cvut.cz/arch/manpages/man/systemd.time.7} +} +@misc{borgcreate, + author = {The Borg Collective}, + title = {{borg create {\ifmmode---\else\textemdash\fi} Borg - Deduplicating Archiver 1.1.9 documentation}}, + year = {2019}, + month = {Feb}, + note = {[Online; accessed 4. Mar. 2019]}, + url = {https://borgbackup.readthedocs.io/en/stable/usage/create.html} +} +@misc{borgextract, + author = {The Borg Collective}, + title = {{borg extract {\ifmmode---\else\textemdash\fi} Borg - Deduplicating Archiver 1.1.9 documentation}}, + year = {2019}, + month = {Feb}, + note = {[Online; accessed 4. Mar. 2019]}, + url = {https://borgbackup.readthedocs.io/en/stable/usage/extract.html} +} +@misc{borginfo, + author = {The Borg Collective}, + title = {{borg info {\ifmmode---\else\textemdash\fi} Borg - Deduplicating Archiver 1.1.9 documentation}}, + year = {2019}, + month = {Feb}, + note = {[Online; accessed 4. Mar. 2019]}, + url = {https://borgbackup.readthedocs.io/en/stable/usage/info.html} +} +@misc{borgdelete, + author = {The Borg Collective}, + title = {{borg delete {\ifmmode---\else\textemdash\fi} Borg - Deduplicating Archiver 1.1.9 documentation}}, + year = {2019}, + month = {Feb}, + note = {[Online; accessed 4. Mar. 2019]}, + url = {https://borgbackup.readthedocs.io/en/stable/usage/delete.html} +} +@misc{borgmount, + author = {The Borg Collective}, + title = {{borg mount {\ifmmode---\else\textemdash\fi} Borg - Deduplicating Archiver 1.1.9 documentation}}, + year = {2019}, + month = {Feb}, + note = {[Online; accessed 4. Mar. 2019]}, + url = {https://borgbackup.readthedocs.io/en/stable/usage/mount.html#borg-umount} +} +@misc{borglist, + author = {The Borg Collective}, + title = {{borg list {\ifmmode---\else\textemdash\fi} Borg - Deduplicating Archiver 1.1.9 documentation}}, + year = {2019}, + month = {Feb}, + note = {[Online; accessed 4. Mar. 2019]}, + url = {https://borgbackup.readthedocs.io/en/stable/usage/list.html} +} +@misc{borgumount, + author = {The Borg Collective}, + title = {{borg umount {\ifmmode---\else\textemdash\fi} Borg - Deduplicating Archiver 1.1.9 documentation}}, + year = {2019}, + month = {Feb}, + note = {[Online; accessed 6. Mar. 2019]}, + url = {https://borgbackup.readthedocs.io/en/stable/usage/mount.html#borg-umount} } \ No newline at end of file diff --git a/projektdokumentation/projektdokumentation.org b/projektdokumentation/projektdokumentation.org index 748954d..19af9a5 100644 --- a/projektdokumentation/projektdokumentation.org +++ b/projektdokumentation/projektdokumentation.org @@ -920,7 +920,20 @@ Use Cases und zeigt einem gut die Zuständigkeiten der Aktoren auf. #+LATEX:\newpage -** TODO Funktionalität von gls:borg +** Benötigte Funktionalität von gls:borg + +Damit nachvollziehbar ist welche Funktionen von gls:borg verwendet wurden um +die Use Cases umsetzen zu können, werden diese hier in Beziehung zur +jeweiligen Funktion des gls:gui aufgelistet: +- Für das Erstellen von Archiven ~borg create~ footcite:borgcreate. +- Für das Anzeigen der Archiven ~borg list~ footcite:borginfo. +- Für das Wiederherstellen der Archive ~borg extract~ footcite:borgextract. +- Für das Löschen der Archive ~borg delete~ footcite:borgdelete. +- Zum Mounten der Archive ~borg mount~ footcite:borgmount. +- Zum Unmounten der Archive ~borg umount~ footcite:borgumount. +- Zum anzeigen der Repository Statistik ~borg info~footcite:borginfo. + +Die detaillierte Implementation wird in der Sektion [[Realisierung][Realisierung]] beschrieben. * Konzept @@ -2065,12 +2078,12 @@ Stackoverflow footcite:sizeformat übernommen. Beim Durchführen der Benutzerfreundlichkeitsstudie wurde noch ein Bug entdeckt. Der Bug, der entdeckt wurde, tritt immer dann auf, wenn ein Archiv gemountet ist während man ein Backup erstellen möchte. Dies ist jedoch offenbar eine -Funktion die von gls:borg nicht unterstützt wird footcite:borgmount. gls:borg -kann mehrere Archive gleichzeitig mounten. Der User müsste jedoch jedes der -Archive zuerst wieder unmounten bevor er eine neue Datensicherung erstellen -kann. Das Problem wurde dadurch gelöst das dem User ein Dialog angezeigt wird, -über welchen er vor einer Datensicherung zuerst die gemounteten Archive -aushängen kann. Anschliessend startet die Datensicherung wie, wenn kein +Funktion die von gls:borg nicht unterstützt wird footcite:borgmountissue. +gls:borg kann mehrere Archive gleichzeitig mounten. Der User müsste jedoch +jedes der Archive zuerst wieder unmounten bevor er eine neue Datensicherung +erstellen kann. Das Problem wurde dadurch gelöst das dem User ein Dialog +angezeigt wird, über welchen er vor einer Datensicherung zuerst die gemounteten +Archive aushängen kann. Anschliessend startet die Datensicherung wie, wenn kein Archiv gemountet gewesen wäre. #+caption: Screenshot der aktualisierten Archivliste und Repository Statistik.