thesis

Archived

This repository has been archived on 2020-04-03. You can view files and clone it, but cannot push or open issues or pull requests.

279 KiB

Raw Blame History

Projekthandbuch

Über dieses Dokument
Initialisierung
Analyse
Konzept
- Varianten
  - Bewertung
  - Backend
    - C#
    - C++
    - Python
  - Frontend
    - Qt
    - Gtk
    - Electron
  - Ergebnis
- Applikationsname
- Testing
- Klassendiagramm
- Usability-Studie
  - Aufgaben
  - Resultate
  - Auswertung
Realisierung
Ausblick/Fazit
Anhang

Über dieses Dokument

Beschreibung

Diese Arbeit hat zum Ziel, die Planung und Erstellung einer grafischen Oberfläche zum einfachen Bedienen der Software gls:borg footcite:borgbackup, durchzuführen sowie zu dokumentieren.

Zweck und Inhalt

Zweck dieses Dokumentes ist die vollständige und nachvollziehbare Dokumentation zur Diplomarbeit von Andreas Zweili.

Aufbau

Inhalte sind in der Regel chronologisch sortiert, vom ältesten zum jüngsten Ereignis, und nach Kapiteln getrennt. An gewissen Stellen kann die chronologische Reihenfolge allenfalls nicht gewährleistet werden.

Lizenz

Dieses Dokument wurde von Andreas Zweili im Rahmen der Diplomarbeit an der IBZ Schule erstellt und steht unter der gls:cc BY-SA 4.0 footcite:cc Lizenz. Dadurch darf die Arbeit unter Beibehalten der Lizenz kopiert und weiterverarbeitet werden. Zusätzlich muss der Urheber genannt werden.

Initialisierung

Vision

Die Software soll gls:borg für den durchschnittlichen Computer User zugänglich machen. Backups sollen dabei schnell und unkompliziert erstellt werden können. Auch die Möglichkeit automatischer im Hintergrund laufender Backups soll dem User gegeben sein, damit die Hürde für Backups so tief wie möglich gehalten wird.

Die besten Backups sind solche, bei denen man gar nicht mehr weiss, dass man sie hat bis man sie braucht.

Ausgangslage

gls:borg ist deshalb interessant, weil es während einem Backup relativ wenig Ressource im Vergleich zu anderen Systemen benötigt und schon relativ lange aktiv entwickelt wird. Dadurch ist es im Alltag geprüft worden. Des Weiteren bietet gls:borg die Funktion für Verschlüsselung, was es einem User ermöglicht die Daten auf einem unsicheren Cloud Speicher abzulegen.

Des Weiteren speichert gls:borg die Daten mit Block basierter gls:dedup ab. Dies hat den riesigen Vorteil, dass bei einem Backup nur die Änderungen auf Block-Ebene gespeichert werden und nicht jedes Mal die ganze Datei kopiert werden muss.

Damit ermöglicht die Software auch Backups von sehr grossen Dateien, wie Videos oder Disk Images von virtuellen Maschinen, in mehreren Versionen. Ohne dabei jedoch signifikant mehr an Speicher zu benötigen. Zusätzlich werden die Backups dadurch rasend schnell ausgeführt. Gerade dieses Feature macht gls:borg in den Augen des Autors besonders interessant, da sich der durchschnittliche User möglichst wenig mit Dingen wie Backups auseinandersetzen möchte. Umso besser also, wenn sie schnell gehen und so wenig Speicherplatz wie möglich verbrauchen.

gls:borg wird jedoch komplett über die Kommandozeile bedient. Somit ist es für normale Benutzer eher schwierig den Zugang zu der Software zu finden, geschweige denn sie zu bedienen.

gls:borg bietet Entwicklern eine gls:json, gls:api, mit welcher sie, von gls:borg ausgegebenen Dateien einfach weiterverarbeiten können.

gls:borg steht unter einer gls:bsd footcite:bsd Lizenz zur Verfügung und ist somit gemäss den Richtlinien der Free Software Foundation gls:libre footcite:fsflicenses.

Das Projekt muss dabei vom Studenten in Eigenarbeit und einer Zeit von 250 Stunden bis zum 18. März 2019 erarbeitet werden.

Projektziele

gls:borg ist eine Kommandozeilen basierte Backup Software. Hauptziel dieser Arbeit ist, ein gls:gui für die Software gls:borg zu entwickeln um die Nutzung zu vereinfachen. Da gls:borg selber freie Software ist und mit freier Software viel gute Erfahrungen gemacht wurden, soll das Projekt selber auch wieder gls:libre sein. Zum einen, um der Community etwas zurückzugeben, des weiteren, um anderen Entwicklern die Möglichkeit zu geben die Software zu verbessern und weiter zu entwickeln.

Als Nebenziel soll mit dieser Arbeit auch die Verbreitung von freier Software gefördert werden. Dies wird insbesondere dadurch erreicht, dass die Software selbst unter der gls:gpl Version 3 footcite:gplv3 veröffentlicht wird. Wenn möglich soll während der Entwicklung auch hauptsächlich freie Software verwendet werden, um aufzuzeigen das ein solches Projekte nicht zwingend von proprietärer Software abhängig ist. Die gesamte Arbeit wird zudem zu jedem Zeitpunkt öffentlich einsehbar sein. Der Quelltext der Dokumentation ist unter diesem Link erreichbar: https://git.2li.ch/Nebucatnetzer/thesis

Die Entwicklung wird hauptsächlich auf einem Linux System stattfinden. Da gls:borg einerseits hauptsächlich auf Unix Systeme ausgelegt ist und anderseits die Hauptzielgruppe des Projektes auch auf Linux Usern liegt. Trotzdem sollen im Projekt cross-plattform fähige Technologien eingesetzt werden, damit es in der Zukunft möglich ist das Projekt auf andere Plattformen auszuweiten.

Ziele inklusive Gewichtung

Im Projektantrag wurden vorgängig folgende Ziele definiert und entsprechend gewichtet. Die Gewichtung wurde dabei so vorgenommen, dass Ziele mit einer Muss-Gewichtung den Minimalanforderungen der zu entwickelnden Software entsprechen. Die weiteren Ziele wurden von 5 bis 1 gewichtet. Die Bewertung 5 bedeutet, dass die Umsetzung sehr nützlich und oder wichtig für die Software ist und daher in naher Zukunft zu implementieren ist. Ein Ziel mit einer tiefen Bewertung sollte, wenn möglich, auch einmal in die Software integriert werden und ist nicht unwichtig.

Ziel-Nr.\cellcolor[HTML]{C0C0C0}	Zielsetzung\cellcolor[HTML]{C0C0C0}	Muss\cellcolor[HTML]{C0C0C0}	Wunsch≠wline (1-5, 5=sehr wichtig)\cellcolor[HTML]{C0C0C0}
1.	Die Anwendung setzt auf cross-plattform (Linux, Windows, OS X) fähige Technologien.	x
2.	Die Anwendung steht unter der gls:gpl v3 der Öffentlichkeit zur Verfügung.	x
3.	Der User kann mit weniger als 3 Klicks ein Backup ausführen.	x
4.	Der User kann ein Archiv mit 3 Klicks löschen.	x
5.	Der User kann unter Linux ein Archiv mit zwei Klicks "read-only" als Laufwerk mounten.	x
6.	Der User kann ein Archiv wieder herstellen.	x
7.	Der User kann den zu sichernden Pfad manuell in der Anwendung definieren.	x
8.	Die Applikation holt ihre Konfiguration aus einer Plain-Text Datei.	x
9.	Der User kann sein Repository auf einer Harddisk ablegen.	x
10.	Die Anwendung exkludiert für einen Linux Computer sinnvolle Pfade bereits zu Beginn.	x
11.	Die Archivliste wird nach einer Aktion automatisch aktualisiert.	x
12.	Der User kann sein Repository auf einem über gls:ssh erreichbaren Server ablegen.		5
13.	Der User kann den Namen eines Archivs selbst bestimmen.		5
14.	Die Anwendung meldet transparent, wenn das Repository nicht erreichbar ist.		5
15.	Die Anwendung meldet dem User, wenn noch ein gls:hypervisor am Laufen ist.		5
16.	Die Anwendung leitet Meldungen von gls:borg transparent weiter.		5
17.	Die Anwendung zeigt transparent an das gls:borg im Hintergrund bereits läuft.		5
18.	Das Repository wird nach jedem Backup bereinigt.		4
19.	Der User kann automatische Hintergrundbackups in der Anwendung konfigurieren.		4
20.	Die Anwendung gibt dem User die Möglichkeit ein passendes Repository zu erstellen, wenn keines gefunden wird, die Anwendung jedoch bereits konfiguriert ist.		4
21.	Die Applikation verwendet, wann immer möglich allgemeingültige Umgebungsvariablen.		4
22.	Die Anwendung cached/speichert (evtl. zusätzliche) Informationen in einer Datenbank.		3
23.	Die Anwendung zeigt beim ersten Starten einen Setup Wizard.		3
24.	Der User kann sich mit 3 Klicks das Log eines Archivs anschauen. Nur möglich mit einer zusätzlichen DB.		3
25.	Die Anwendung kann Systembenachrichtigungen auslösen.		3
26.	Der User kann die Anwendung grafisch konfigurieren.		3
27.	Der User kann entscheiden, ob ein gemountetes Archiv nach dem Schliessen der Applikation noch weiter verfügbar ist.		2
28.	Der User kann das Repository wechseln.		2
29.	Der User kann ein Archiv nach einer Datei oder einem Ordner durchsuchen.		2
30.	Der User kann die "Retention Policy" konfigurieren.		2
31.	Die Anwendung kann mit allen Features von gls:borg umgehen.		2
32.	Die Applikation prüft, ob sie sich im richtigen Netzwerk befindet bevor sie eine Verbindung zum Server aufbaut.		2

#+LATEX:≠wpage

Projektabgrenzung

Die Anwendung beschränkt sich darauf Funktionen von gls:borg grafisch darzustellen oder nützlich zu erweitern, soweit dies über die gls:api möglich ist. Wie in Abbildung:(fig:kontext) zu sehen ist, werden die Aktionen effektiv immer vom Borg Binary ausgeführt und nicht von der grafischen Oberfläche. Eine Erweiterung von gls:borg ist nicht vorgesehen. Dies aus dem Grund das Backups, Deduplikation und Verschlüsselung sowie deren korrekte Implementation komplexe Themen sind und unbedingt nur von Experten angegangen werden sollten. Die Auswirkungen von Fehlern sind sind schlicht zu gross.

Des Weiteren wird die Grundlage für eine kollaborative Entwicklung geschaffen. Während der Laufzeit der Diplomarbeit werden jedoch keine Inputs aus der Borg Community im Bezug auf die Entwicklung entgegengenommen.

Bugs von gls:borg welche während der Dauer der Diplomarbeit vom Studenten entdeckt werden, wird dieser dem Projekt melden, jedoch nicht selber beheben.

/Nebucatnetzer/thesis/src/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/kontextdiagramm.pdf

Projektmethode

Für das Projekt wurde die gls:wasserfall gewählt. Da nur eine einzige Person am Projekt arbeitet, kann nur ein Task nach dem anderen abgearbeitet werden und viele Aufgaben stehen in Abhängigkeit zueinander. Somit macht das iterative Vorgehen der gls:wasserfall für dieses Projekt am meisten Sinn.

Konfigurationsmanagement

Versionskontrolle

Die komplette Dokumentation, der Quellcode der Applikation sowie jegliche zusätzlichen Dokumente, wie etwa die Zeitplanung, werden mittels der Software gls:git versioniert. Thematisch zusammengehörende Änderungen werden in einem gls:commit zusammengefasst. Somit ist jederzeit nachvollziehbar, was wann geändert hat. Ein gls:commit sollte dabei gemäss dem Artikel von Chris Beams "How to write a Git gls:commit Message" footcite:commit und in englischer Sprache geschrieben sein.

Versionsnummern sind für die Applikation zum jetzigen Zeitpunkt noch nicht vorgesehen. Sollten sie zukünftig einmal verwendet werden, soll eine semantische Versionierung footcite:semver verwendet werden. Dabei ist eine Versionsnummer immer nach diesem Schema aufgebaut, MAJOR.MINOR.PATCH. Bei Änderungen wird die:

MAJOR Version erhöht, wenn man inkompatible Änderungen an der gls:api macht.
MINOR Version erhöht, wenn man Funktionalität hinzufügt, die abwärtskompatibel ist.
PATCH Version erhöht, wenn man abwärtskompatibel Bug-Fixes hinzufügt.

Eine Versionsnummer würde dann so aussehen Version 1.2.3.

Auf jeden Fall sollte, sofern möglich, immer nur lauffähiger Code im Master Branch eingecheckt sein, damit der Master Branch immer eine funktionierende Software repräsentiert. Dies gilt auch für das Repository der Dokumentation. Der Master Branch der Dokumentation sollte maximal mit zwei Befehlen make clean und make "kompilierbar" sein.

Als Software für die Versionskontrolle wurde gls:git footcite:git aus den folgenden Gründen ausgewählt:

Ist der de facto Standard bei Versionskontrollsoftware
Läuft auf allen gängigen Betriebssystemen
Es gibt gratis Services, die man nutzen kann (Github, Gitlab)
Ermöglicht es offline zu arbeiten und glspl:commit erstellen
Es steht bereits ein eigener gls:git Server zur Verfügung
gls:git ist aus vorhergehenden Projekten vertraut, dadurch muss kein Aufwand betrieben werden, eine neue Software zu lernen. Zusätzlich hat sich gls:git in den vorhergehenden Projekten als robuste und schnelle Software erwiesen.
gls:git ist gls:libre unter der gls:gpl v2.

Editor

Sowohl bei der Dokumentation wie auch bei der Programmierung wurde hauptsächlich der Editor GNU Emacs footcite:emacs verwendet. GNU Emacs ist mit 32 Jahren (seine Wurzeln reichen bis ins Jahre 1976 zurück) wohl eines der ältesten noch aktiven Software Projekte. Emacs ist gls:libre unter der gls:gpl v3. Emacs wurde gewählt, da es ein schneller, schlanker und sehr flexibler Texteditor ist. Von normaler Textmanipulation über Taskmanagement bis zu Emails schreiben ist alles möglich.

Dokumentation

Diese Dokumentation wurde in Org-mode footcite:orgmode, einer Erweiterung für den Text Editor Emacs, geschrieben. Die Syntax von Org-mode erinnert an Markdown. Org-mode bietet einem eine Vielzahl an Hilfen, inklusive dem Erstellen von Tabellen und Spreadsheet Funktionen. Für die finale Version des Dokuments kann Org-mode die ursprünglich Textdatei über LaTeX in eine PDF Datei exportieren.

LaTeX footcite:latex ist eine Software, welche einem die Benutzung des Textsatzsystems TeXs vereinfacht. LaTeX wurde gegenüber einem "What You See Is What You Get" (z.Bsp. MS. Word) Editor gewählt, weil es einem mit seiner Markup Sprache erlaubt das Dokument in Textdateien zu erstellen, gerade für Programmierer ist dies eine sehr interessante Lösung. Dadurch, dass LaTeX auch nur aus reinen Textdateien besteht, können die Dokumente auch ohne weiteres in die Versionskontrollsoftware einchecken und die Entwicklung im Log zurückverfolgen. LaTeX ist gls:libre unter der LaTeX Project Public License.

Die Grafiken in diesem Dokument wurden hauptsächlich mit dem Vektor Grafik Editor Inkscape footcite:inkscape erstellt. Inkscape ist gls:libre unter der GNU Public License v3.

Die Diagramme wurden mit Draw.io footcite:draw erstellt. Draw.io ist gls:libre unter Apache Lizenz Version 2.0 footcite:apache und kann sowohl als Desktop Applikation wie auch als Webanwendung genutzt werden.

Beim Design der Arbeit wurden soweit als möglich die typographischen Regeln aus dem Buch "Practical Typography" von Matthew Butterick footcite:typo angewandt. Bei den Diagrammen wurden ausschliesslich Farben aus der von Google entwickelten Design Sprache "Material" footcite:material eingesetzt.

Zeitplanung

Die detaillierte Zeitplanung ist dem Ganttchart in der Datei 02_Zeitplanung_Andreas_Zweili.html zu entnehmen. Bei der Zeitplanung wurde darauf geachtet, dass die Arbeit soweit als möglich nicht mit dem Berufsleben kollidiert. An einem normalen Arbeitstag wurde dabei damit gerechnet das ca. 2 Stunden Arbeit am Abend möglich sein sollten. An einem arbeitsfreien Tag wurde mit 6 Stunden Arbeit gerechnet. Über die Festtage wurden diverse Tage von der Planung ausgenommen, da es nicht realistisch schien, dass an diesen Tagen die Arbeit signifikant vorwärts gehen würde. Auch Schultage wurde nicht als Arbeitstage gerechnet.

Um die Arbeitslast zu verteilen, wurde vom 14. Januar bis zum 11. März auf der Arbeitsstelle jeder Montag als frei eingegeben. Dadurch steht während des Projektes etwas mehr Zeit zur Verfügung, als mit einer 100 Prozent Arbeitsstelle möglich wäre.

Controlling

Mit dem Controlling wird die Planung mit den effektiv verwendeten Ressourcen verglichen und ausgewertet. Somit können für zukünftige Projekte Lehren gezogen werden.

Zeitaufwand

Um den geschätzten Zeitaufwand mit dem effektiv geleisteten Aufwand zu vergleichen wurde die Tabelle:(tab:zeitcontr) erstellt. Darin werden die beiden Aufwände einander gegenübergestellt und grössere Abweichungen begründet. Die Nummer vor jeder Aufgabe in der Tabelle korreliert dabei mit den Aufgabennummern im Ganttchart.

Ressourcen

In der Tabelle:(tab:ressources) wurden die für die Arbeit benötigten Materialen erfasst. Da es sich beim Projekt um ein reines Software Projekt handelt ist der Material Aufwand entsprechend gering. Im Abschluss des Projektes werden die geplanten Ressourcen den effektiv verwendeten gegenübergestellt.

Kosten

Werden die internen Lohnkosten des Projektleiters auf ca. 60 CHF pro Stunde geschätzt (dies entspricht in etwa dem doppelten reelen Stundenlohn des Projektleiters), ergeben sich gemäss der Berechnung in der Tabelle:(tab:kosten), theoretische Kosten von 19080 CHF für die Umsetzung dieser Arbeit. Die Kosten für die Entwicklung werden im Projekt jedoch nicht berücksichtigt. Somit sind diese nur ein rein theoretischer Faktor.

Projektrisiken

Das Risikomanagement dient dazu Risiken im Projekt zu erkennen und Massnahmen zur Vermeidung zu definieren. Dadurch steht man Risiken nicht unvorbereitet gegenüber, sollten sie eintreffen.

Risikobeschreibung

In der Tabelle: (tab:risikobeschreibung) sind die Risiken des Projektes gemeinsam mit ihren Gegenmassnahmen aufgelistet. Somit können gewisse Risiken bereits vorher vermieden werden.

Beschreibung\cellcolor[HTML]{C0C0C0}	Massnahmen\cellcolor[HTML]{C0C0C0}
Ein grösseres Problem in der Programmierung blockiert den Fortschritt.	Immer nur eine Sache auf einmal in der Code-Basis ändern, alle Fehler beheben und erst dann zur nächsten Aufgabe weitergehen.
Viel Arbeit an der Arbeitsstelle, dabei bleibt weniger Zeit für die Diplomarbeit.	Auf der Arbeit Freitage eingeben um die Last etwas zu verteilen. Projektplanung machen.
Know-How zur Umsetzung ist nicht vollständig vorhanden.	Gute Informationsbeschaffung im Internet, Büchern, etc.
Manuelle Tests brauchen zu viel Zeit.	Soviel wie möglich automatisieren. Dabei jedoch nicht den Fokus auf die eigentliche Entwicklung verlieren.
Die Programmierung des Programms benötigt zu viel Zeit.	Bei der Projektplanung genau definieren was die GUI Applikation beinhalten muss. Ziele definieren, Abgrenzungen treffen.
User haben keine Zeit für Benuterfreundlichkeitsstudie.	Vor gängig einen Termin abmachen.
gls:borg ändert fundamental seine gls:api.	Gegen eine fixe Version von gls:borg entwickeln.

Analyse

SWOT-Analyse

Die SWOT-Analyse ist eine Methode die Stärken, Schwächen, Chancen und Gefahren zu erkennen, indem eine 4-Felder-Matrix ausgefüllt wird.

Grundlage einer guten SWOT Analyse ist eine klare Zieldefinition und Fragestellung.. Die ausgefüllte SWOT-Analyse für dieses Projekt ist in der Abbildung:(fig:swot) zu sehen.

/Nebucatnetzer/thesis/src/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/swot_analyse.pdf

Umweltanalyse

Die Projektumwelt-Analyse ist eine Methode die Beziehungen, Erwartungshaltungen und Einflüsse auf das Projekt durch interne und externe soziale Umwelt zu betrachten und zu bewerten. Auf Grundlage der Analyseergebnisse werden erforderliche Massnahmen zur Gestaltung der Umweltbeziehungen abgeleitet. Die Gestaltung der Projektumweltbeziehungen ist eine Projektmanagementaufgabe. In der Tabelle:(tab:umweltanalyse) wurden die Anforderungen und Wünsche mit Einschätzung der Wahrscheinlichkeit und der Einflussnahme aufgenommen. Zusätzlich ist die Beziehung der Stakeholder zum Projekt noch in der Abbildung:(fig:umweltgrafik) grafisch dargestellt.

Da das Projekt so ausgelegt ist, dass der Projektleiter es in Eigenarbeit verwirklichen kann, ist der Einfluss der Stakeholder während der Umsetzung sehr gering. Die User werden bei der Entwicklung mittels einer Usability-Studie miteinbezogen und die gls:borg Community wird mit regelmässigen Posts auf dem offiziellen Github Repository auf dem Laufenden gehalten. Nach Ende der Diplomarbeit soll das Projekt für interessierte Entwickler jedoch offen sein. Der Quellcode wird bereits während der Arbeit öffentlich zur Verfügung gestellt.

/Nebucatnetzer/thesis/src/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/stakeholder_diagramm.pdf

#+LATEX:≠wpage #+LATEX:\begin{landscape}

Nr.\cellcolor[HTML]{C0C0C0}	Stakeholder\cellcolor[HTML]{C0C0C0}	Einfluss\cellcolor[HTML]{C0C0C0}	Anforderung/Wünsche\cellcolor[HTML]{C0C0C0}	Wahrscheinlichkeit\cellcolor[HTML]{C0C0C0}
1.	gls:borg Community	gering	Eine Applikation, die den Umfang von gls:borg abdeckt	mittel
			Open-Source	hoch
			Mitspracherecht bei der Entwicklung	niedrig
2.	User	gering	Einfache Bedienbarkeit	hoch
			Einmal einrichten und vergessen	mittel
3.	Interessenten	gering	Einfach verständliches Projekt Repository	hoch
			Einfaches Setup zum Testen	hoch
4.	Projektleiter	hoch	Stabile Anwendung erstellen	mittel
			Ein nachhaltiges Projekt starten	mittel
			Anerkennung im fachlichen Umfeld	niedrig

#+LATEX:\end{landscape}

Risiko-Analyse

Bei der Risiko-Analyse wird von einem durchschnittlichen Benutzer ausgegangen, der zur Zeit noch keine Backups macht und beginnen möchte gls:borg zu nutzen, um auf einer externen Harddisk seine Backups zu speichern.

Es wird eine Ist/Soll Analyse gemacht. Jedes Risiko wurde entsprechend der Tabelle: (tab:wahrscheinlichkeit) nach der Wahrscheinlichkeit des Eintreffens bewertet und entsprechend der Tabelle: (tab:auswirkung) nach seiner Auswirkung im Bezug auf die Nützlichkeit der gemachten Backups.

In der Tabelle: (tab:risikobeschreibung) sind dabei die Risiken für das Szenario aufgelistet und nummeriert. In der Abbildung:(fig:istrisiko) ist die Bewertung des Ist-Risikos grafisch dargestellt und in der Abbildung:(fig:sollrisiko) ist das Soll-Risiko, welches mit dieser Arbeit angestrebt wird, ebenfalls grafisch dargestellt.

Es sollte im Rahmen der Arbeit möglich sein die meisten Risiken zu verringern. Da automatische Hintergrundbackups jedoch ein Kann-Ziel sind wir in dieser Analyse nicht davon ausgegangen, dass man das Risiko Nr. 5 im Rahmen dieser Arbeit reduzieren kann.

Bewertung	Beschreibung: Wahrscheinlichkeit (W)
1 = gering	Unwahrscheinlich, <20%
2 = mittel	Mässig wahrscheinlich, 20-50%
3 = hoch	Hohe Wahrscheinlichkeit > 50%

Bewertung	Beschreibung: Auswirkung (A)
1 = gering	Geringe Auswirkungen auf Nützlichkeit
2 = mittel	Mittlere Auswirkung auf die Nützlichkeit
3 = hoch	Hohe Auswirkung auf die Nützlichkeit

Nr.\cellcolor[HTML]{C0C0C0}	Beschreibung\cellcolor[HTML]{C0C0C0}
1.	Der Benutzer hat noch nie die Kommandozeile verwendet und scheitert bereits an der Installation von gls:borg.
2.	Der Benutzer verwendet keine Verschlüsselung und verliert seine Harddisk.
3.	Der Benutzer speichert die Backups auf der internen statt der externen Harddisk.
4.	Der Benutzer löscht aus Versehen ein Backup.
5.	Der Anwender vergisst die Backups zu machen.

/Nebucatnetzer/thesis/src/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/istrisiko.pdf

/Nebucatnetzer/thesis/src/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/sollrisiko.pdf

#+LATEX:≠wpage

Anforderungskatalog

Der Anforderungskatalog entspricht 1:1 den Zielen, welche in der Tabelle tab:projektziele definiert wurden. Im Zeitplan wurde der Fokus hauptsächlich auf die Muss-Ziele gelegt. Ein paar der Kann-Ziele sind im Konzept jedoch auch abgebildet.

Use Cases

Ein Use Case sammelt alle möglichen Szenarien, die eintreten können, wenn ein Akteur versucht, mithilfe des betrachteten Systems ein bestimmtes Ziel zu erreichen. Dabei beschreibt er, was beim Versuch der Zielerreichung passieren kann. Je nach Ablauf kann auch ein Fehlschlag ein Ergebnis eines Anwendungsfalls sein (e.g. falsches Passwort beim Login). Dabei wird die technische Lösung nicht konkret beschrieben. Die Detailstufe kann dabei sehr unterschiedlich sein.footcite:usecase

Anwendungsfalldiagramm

"Ein Anwendungsfalldiagramm … ist eine der 14 Diagrammarten der Unified Modelling Language (UML), einer Sprache für die Modellierung der Strukturen und des Verhaltens von Software- und anderen Systemen. Es stellt Anwendungsfälle und Akteure mit ihren jeweiligen Abhängigkeiten und Beziehungen dar."\footcite{usecasediagramm}

#+LATEX:{\footnotesize

#+ATTR_LATEX::environment longtable :align |>{\columncolor[HTML]{EFEFEF}}p{.235\textwidth}|p{.7\textwidth}| :placement [H]

Use Case 4.1 Backup mounten

Identifier + Name	4.1 Backup mounten
Description	Ein Backup wird als gls:fuse gemountet.
Actors	Borg GUI, gls:borg
Status	Freigegeben
Includes	-
Trigger	Das Borg GUI gibt an gls:borg den Input zum mounten weiter.
Preconditions	Use Case 1.0 wurde ausgeführt.
Postconditions	Das Backup wurde gemountet.
Normal Flow	1. Borg GUI sammelt die Backup ID in Use Case 4.0.
	2. Borg GUI übergibt die Backup ID an gls:borg zusammen mit einem Zielpfad.
	3. gls:borg hängt das Backup als gls:fuse Laufwerk am Zielpfad ein.
	4. gls:borg meldet Erfolg an Borg GUI.
Alternative Flow	1. Borg GUI sammelt die Backup ID in Use Case 4.0.
	2. Borg GUI übergibt die Backup ID an gls:borg zusammen mit einem Zielpfad.
	3. gls:borg hängt das Backup als gls:fuse Laufwerk am Zielpfad ein.
	4. gls:borg meldet einen Fehler an Borg GUI.
Notes	-
UC History	1.0 Draft erstellt durch AZ
Author	A. Zweili
Date	30.12.2018

#+LATEX:}

#+LATEX:≠wpage

Use Case 5.0 Konfiguration ändern

#+LATEX:{\footnotesize

#+ATTR_LATEX::environment longtable :align |>{\columncolor[HTML]{EFEFEF}}p{.235\textwidth}|p{.7\textwidth}| :placement [H]

Use Case 5.0 Konfiguration ändern

Identifier + Name	5.0 Konfiguration ändern
Description	Das Verändern und Speichern der Konfiguration der Applikation.
Actors	User
Status	Freigegeben
Includes	-
Trigger	Ein User möchte die Einstellungen der Applikation anpassen.
Preconditions	Applikation gestartet.
Postconditions	-
Normal Flow	1. Auf den Button "Settings" klicken.
	2. Ein neues Fenster mit den Einstellungen öffnet sich.
	3. Der Benutzer ändert mindestens eine Einstellung.
	4. Der Button "OK" wird angeklickt.
	5. Die Konfiguration wird in die Konfigurationsdatei geschrieben und in der Applikation geladen.
Alternative Flow	1. Auf den Button "Settings" klicken.
	2. Ein neues Fenster mit den Einstellungen öffnet sich.
	3. Der Benutzer kann Einstellungen ändern.
	4. Der Button "Cancel" wird angeklickt.
	5. Jegliche Änderungen werden verworfen und die Konfigurationsdatei bleibt im aktuellen Zustand.
Notes	-
UC History	1.0 Draft erstellt durch AZ
Author	A. Zweili
Date	30.12.2018

#+LATEX:}

/Nebucatnetzer/thesis/src/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/activity_settings.pdf

#+LATEX:≠wpage

Use Case 6.0 automatische Backups aktivieren

#+LATEX:{\footnotesize

#+ATTR_LATEX::environment longtable :align |>{\columncolor[HTML]{EFEFEF}}p{.235\textwidth}|p{.7\textwidth}| :placement [H]

Use Case 6.0 automatische Backups aktivieren

Identifier + Name	6.0 automatische Backups aktivieren
Description	Ein Systemdienst wird hinterlegt zum Ausführen automatischer Backups.
Actors	User
Status	Freigegeben
Includes	-
Trigger	Ein User möchte automatisierte Backups haben.
Preconditions	Eine funktionierende Konfiguration muss hinterlegt sein.
	Applikation gestartet.
Postconditions	Ein Systemdienst wurde erstellt welcher jeden Tag ein Backup macht.
Normal Flow	1. Auf den Button "Settings" klicken.
	2. Bei der Option "Automatic Backups" den Hacken setzen.
	3. Die Settings mit klick auf "Ok" schliessen und speichern.
Alternative Flow	1. Auf den Button "Settings" klicken.
	2. Bei der Option "Automatic Backups" den Hacken setzen.
	3. Die Aktion mit klick auf "Cancel" abbrechen
Notes	-
UC History	1.0 Draft erstellt durch AZ
Author	A. Zweili
Date	30.12.2018

#+LATEX:}

/Nebucatnetzer/thesis/src/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/activity_automatic.pdf

#+LATEX:≠wpage

Benötigte Funktionalität von 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 beschrieben.

Konzept

Varianten

Mit der gls:json gls:api von gls:borg stehen einem diverse Möglichkeiten zur Verfügung, um das Programm anzubinden. Da das Ziel ist, das Programm normalen Nutzern zugänglicher zu machen, bietet sich ein normales Desktop Programm am ehesten an. Desktop Programme werden von allen Computer Usern täglich genutzt und sind somit etwas was sie kennen. Zudem ist es für die User auch viel einfacher zu verstehen, als wenn sie vor der Nutzung einen lokalen Webserver starten und diesen im Anschluss zur Nutzung wieder beenden müssten.

Bewertung

Mit der Idee aus der "Einleitung zu den Varianten" wurde dann eine Tabelle, mit Anforderungen an die Technologien, erstellt. Die Bewertungspunkte setzen sich einerseits aus Projektzielen anderseits aus für das Projekt sinnvollen Punkten zusammen. Dadurch ergeben sich dann die Bewertungen, welche in der Tabelle:(tab:muster) aufgenommen wurden. Die möglichen Varianten wurden danach bewertet. Die effektive Berechnung des Resultats wird nach folgender Formel durchgeführt.

\begin{equation} G * EP = KE \end{equation}

Also die Gewichtung(G) multipliziert mit der erreichten Punktzahl(EP) ergibt das Kriteriumsergebnis(KE). Für das Endresultat wird dann die Summe über alle Kriterien gebildet. Die Variante mit der höchsten Summe wurde für das Projekt ausgewählt.

Mussziele erhalten dabei eine Gewichtung von 10 und Wunschziele eine Gewichtung entsprechend der Bewertung in der Tabelle Projektziele (tab:projektziele).

Kriterium\cellcolor[HTML]{C0C0C0}	Gewichtung\cellcolor[HTML]{C0C0C0}	max. Punktzahl\cellcolor[HTML]{C0C0C0}	erreichte Punktzahl\cellcolor[HTML]{C0C0C0}	Kriteriums- ergebnis\cellcolor[HTML]{C0C0C0}
1. Cross Plattform nutzbar	10	10	10	100
2. Freie Software	5	10	10	50
3. Vorkenntnisse	5	10	10	50
4. Integriert sich gut ins System	5	10	10	50
5. Ohne spezielle Tools nutzbar	5	10	10	50
6. Lesbarkeit des Codes	5	5	5	25
7. Einfachheit des Setups	5	5	5	25
8. Lernfaktor	5	5	5	25
9. Verbreitung bei der gls:borg Community	5	5	5	25
10. Geschwindigkeit der Entwicklung	3	5	5	15
Total				415

Backend

Für die Backend Programmierung bieten sich die folgende drei Sprachen an: C#, C++ und Python. Dies vor allem, weil alle drei Allrounder Sprachen sind und sich gut für Desktop Applikationen eignen.

C#

C# ist eine von Microsoft entwickelte Programmiersprache, welche viele Frameworks zur Verfügung stellt. Insbesondere aufgrund der grossen kommerziellen Nutzung und der guten Integration mit Microsoft Windows hat C# eine relative grosse Verbreitung. Bei Linux und OS X ist es jedoch schwieriger C# zu integrieren und zu nutzen da es nicht standardmässig installiert ist und der Fokus von C# hauptsächlich auf Microsoft Windows liegt.

Sie ist zu Teilen gls:libre. Die Common Language Runtime, welche für das Ausführen von Software zuständig ist, ist unter der MIT Lizenz lizenziert footcite:csharp, der aktuelle Compiler Roslyn ist unter der Apache Lizenz verfügbar footcite:roslyn. Da es sehr viele offizielle Teile um die Sprache C# gibt, kann im Rahmen des Projektes nicht direkt abgeschätzt werden, ob alle benötigten Teile gls:libre sind. Für die Bewertung wird deshalb ein kleinerer Wert als bei C++ und Python genommen.

C# ist die Programmiersprache, welche an der IBZ hauptsächlich gelehrt wird. Dadurch sind die Kenntnisse der Sprache und ihrer Anwendung bereits vorhanden. Ausserhalb der Schule wurde die Sprache jedoch noch nie eingesetzt.

Entwickelt wird C# hauptsächlich mit der gls:ide Microsoft Visual Studio. Dies ist eine sehr umfangreiche und komplexe Software. Visual Studio ist dabei nur für Windows und OS X erhältlich. Es ist auch möglich C# Projekte ausserhalb von Visual Studio zu erstellen, dies ist jedoch nicht sehr einfach.

Der Code ist gut lesbar und es gibt offizielle Styleguides von Microsoft was den Code über Projekte hinaus einheitlich aussehen lässt. Zudem hilft hier auch Visual Studio stark den Code entsprechend zu formatieren. Besonders angenehm sind die Klassen- und Methodennamen der offiziellen Frameworks. Insgesamt sehr gut gelöst aber in Sachen Lesbarkeit noch etwas hinter Python.

Unter Windows ist das Setup von C# relativ einfach. Allerdings ist es auch dort im Vergleich zu Python eine umfangreiche Angelegenheit Visual Studio sauber zu installieren und nutzbar zu machen. Auf anderen Plattform wird dies leider nicht einfacher und unter Linux ist es bereits schwierig eine funktionierende Umgebung in Gang zu bringen.

Da C# bereits an der IBZ gelehrt wird, ist der Lernfaktor hier, im Vergleich zu den anderen Sprachen, sicher am kleinsten. Allerdings gibt es noch keinerlei Kenntnisse beim Einbinden eines der unten aufgeführten gls:gui Frameworks. Daher gibt es auf jeden Fall noch genügend zu lernen.

Die gls:borg Community hat vor relativ kurzer Zeit die offizielle Unterstützung von Windows zurückgezogen. Da C# eine sehr Windows lastige Sprache ist, wird daher davon ausgegangen, dass die Sprache innerhalb der gls:borg Community nicht sehr verbreitet ist.

C# ist eine stark typisiert Sprache und kompilierte Sprache. Des Weiteren ist Visual Studio der Erfahrung nach nicht die schnellste Software. Dies alles führt dazu das C# nicht gerade die schnellste Sprache zum Programmieren ist. Jedoch aufgrund des moderneren Unterbaus ist sie sicher schneller als C++.

Kriterium\cellcolor[HTML]{C0C0C0}	Gewichtung\cellcolor[HTML]{C0C0C0}	max. Punktzahl\cellcolor[HTML]{C0C0C0}	erreichte Punktzahl\cellcolor[HTML]{C0C0C0}	Kriteriums- ergebnis\cellcolor[HTML]{C0C0C0}
1. Cross Plattform nutzbar	10	10	8	80
2. Freie Software	5	10	8	40
3. Vorkenntnisse	5	10	6	30
4. Integriert sich gut ins System	5	10	8	40
5. Ohne spezielle Tools nutzbar	5	10	6	30
6. Lesbarkeit des Codes	5	5	4	20
7. Einfachheit des Setups	5	5	2	10
8. Lernfaktor	5	5	3	15
9. Verbreitung bei der gls:borg Community	5	5	1	5
10. Geschwindigkeit der Entwicklung	3	5	3	9
Total				279

C++

C++ ist eine stark typisierte und kompilierte Programmiersprache. Sie ist seit 1998 Teil des ISO Standards footcite:cpp98. ISO/IEC 14882:2017 footcite:cpp17 ist zurzeit die aktuellste Variante. Die Sprache existiert seit ca. 33 Jahren und hat eine weitreichende Verbreitung gefunden. C++ ist auf allen Betriebssystemen gut unterstützt muss jedoch für jedes System separat kompiliert werden.

Von C++ sind innerhalb des Projektes keinerlei Vorkenntnisse vorhanden. Dies ist ein sehr hoher Risikofaktor.

C++ kompiliert direkt zu Maschinensprache und ist dadurch sehr performant und läuft sehr gut auf jedem System. C++ ist im Vergleich zu modernen Sprachen jedoch relativ komplex und bietet diverse Stolpersteine für Programmierer.

Zum Entwickeln braucht es verhältnismässig wenig Werkzeuge. Da die Sprache bereits sehr alt ist, stammt sie noch aus einer Zeit, wo man noch etwas rudimentärer programmierte. Allerdings braucht man in jedem Fall einen gls:compiler, um ein Programm zu erzeugen. Bei komplexeren Programmen wird man, um mindestens so etwas wie glspl:makefile auch nicht herumkommen

Im Vergleich zu Python oder C# ist C++ wohl die am schwersten lesbare Sprache. Zudem gibt es auch keinen zentralen Styleguide, welcher einem vorgeben würde wie der Code am besten ausschauen sollte. Somit haben sich über die Jahre mehrere Standards etabliert.

Der Lernfaktor wäre aufgrund der mangelnden Vorkenntnisse hier ganz klar am Grössten.

Da C++ eine alte Sprache ist, geniesst sie auch eine dementsprechende Verbreitung. Daher ist anzunehmens dass sicher mindestens ein grösserer Teil der älteren gls:borg Entwickler C++ oder C gelernt haben.

Da C++ auch heute noch zu den meistgenutzten Sprachen gehört, gibt es entsprechend viele Ressourcen dazu und Beispielprojekte, von denen man ableiten kann. Auch hilfreiche Libraries gibt es sehr viele, welche den Programmierer unterstützen können. Die Sprache selber ist jedoch eher umständlich zu schreiben. Hinzu kommt noch, dass man, während der Entwicklung immer wieder den Code kompilieren muss. In einem Projekt mit dieser begrenzten Zeitspanne eher ungeeignet.

Kriterium\cellcolor[HTML]{C0C0C0}	Gewichtung\cellcolor[HTML]{C0C0C0}	max. Punktzahl\cellcolor[HTML]{C0C0C0}	erreichte Punktzahl\cellcolor[HTML]{C0C0C0}	Kriteriums- -ergebnis\cellcolor[HTML]{C0C0C0}
1. Cross Plattform nutzbar	10	10	8	80
2. Freie Software	5	10	10	50
3. Vorkenntnisse	5	10	0	0
4. Integriert sich gut ins System	5	10	8	40
5. Ohne spezielle Tools nutzbar	5	10	6	30
6. Lesbarkeit des Codes	5	5	2	10
7. Einfachheit des Setups	5	5	3	15
8. Lernfaktor	5	5	5	25
9. Verbreitung bei der gls:borg Community	5	5	3	15
10. Geschwindigkeit der Entwicklung	3	5	2	6
Total				271

#+latex:≠wpage

Python

Der Python Interpreter ist für eine Vielzahl an Betriebssystemen erhältlich, inklusive Windows, OS X und Linux. Nahezu jedes Desktop Linux System kommt mit Python vor installiert. Auch OS X kommt bereits ab Werk mit Python Version 2. Version 3 lässt sich sehr einfach nachinstallieren und ist einfach nutzbar. Unter Windows gestaltetet sich die Installation etwas aufwendiger aber auch nicht sehr kompliziert. Python integriert sich in Windows jedoch etwas weniger elegant als C#.

Python ist freie Software unter der Python Software Foundation License footcite:python und wird durch die Python Software Foundation in einem Community basierten Modell entwickelt.

Die Vorkenntnisse sind im Vergleich zu C++ relativ gross und zu C# etwas weniger ausgeprägt. Es wurden damit im Rahmen der Ausbildung schon ein grösseres Projekt realisiert und ansonsten mehrere kleine Projekte im Privaten erstellen.

Für Python gibt es ein paar glspl:ide welchen den Programmierer bei seiner Arbeit unterstützen können. Keine davon ist allerdings ein Muss, um Python programmieren zu können. Im einfachsten Fall wäre dies mit Notepad möglich. Ein Editor mit etwas fortgeschritteneren Features wäre jedoch empfehlenswert.

Python unterstützt mehrere Programmierungsparadigmen wie etwa objektorientiert, funktionale oder prozedurale Paradigmen. Bei der Entwicklung von Python wurde sehr grossen Wert auf die Lesbarkeit der Sprache gelegt. Dies mit dem Hintergedanken das eine Programmiersprache viel häufiger gelesen als effektiv geschrieben wird footcite:pep8.

Um ein Python Programm zu starten, braucht es eigentlich kein grosses Setup. Solange die Abhängigkeiten vorhanden sind, kann man ein Skript mit einem einfachen Befehl, Code Snippet (code:minimal_python) starten.

python3 example.py

Da Python schon eine etwas bekanntere Sprache ist, ist der Lernfaktor der Sprache selber nicht mehr so hoch. Allerdings gibt es noch viele interessante Konzepte, die man im Zusammenhang mit der Sprache lernen kann. Wie etwa zum Beispiel multiple Vererbung von Klassen.

gls:borg selber wurde in Python geschrieben. Daher ist davon auszugehen, dass Python innerhalb dieser Community eine sehr hohe Verbreitung geniesst.

Python ist eine dynamisch typisierte und interpretierte Sprache. Dies bedeutet, dass man bei Variablen nicht explizit den Typ angeben muss und die Programme zur Laufzeit für den Computer übersetzt werden. Interpretierte Sprachen haben den Vorteil, dass man mit ihnen in der Regel sehr schnell und unkompliziert entwickeln kann, dies jedoch zulasten der Performance.

Kriterium\cellcolor[HTML]{C0C0C0}	Gewichtung\cellcolor[HTML]{C0C0C0}	max. Punktzahl\cellcolor[HTML]{C0C0C0}	erreichte Punktzahl\cellcolor[HTML]{C0C0C0}	Kriteriums- -ergebnis\cellcolor[HTML]{C0C0C0}
1. Cross Plattform nutzbar	10	8	8	80
2. Freie Software	5	10	10	50
3. Vorkenntnisse	5	10	5	25
4. Integriert sich gut ins System	5	10	8	40
5. Ohne spezielle Tools nutzbar	5	10	7	35
6. Lesbarkeit des Codes	5	5	4	20
7. Einfachheit des Setups	5	5	4	20
8. Lernfaktor	5	5	3	15
9. Verbreitung in der gls:borg Community	5	5	5	25
10. Geschwindigkeit der Entwicklung	3	5	4	12
Total				322

Frontend

Fürs Frontend sind folgende Projekte interessant: Qt, Gtk und Electron. Alle drei sind cross-plattform fähige gls:gui Frameworks und nicht von einer spezifischen Sprache abhängig. Da nahezu keine Erfahrung mit den aufgeführten Frameworks vorhanden ist, werden bei den Frontend Frameworks die Punkte der Verbreitung in der Community und Geschwindigkeit der Entwicklung ausgeschlossen. In beiden Fällen wäre nicht mal eine ungenaue Schätzung wirklich möglich.

Qt

Qt footcite:qt, "cute" ausgesprochen, ist ein Framework zum Entwickeln von grafischen Oberflächen, welche auf verschiedenen Systemen ohne grosse Änderungen laufen sollen und sich dabei soweit als möglich wie eine native Applikation verhalten und "anfühlen" soll.

Die Rechte an Qt hält die Firma "The Qt Company". Das Framework Qt wird jedoch offen entwickelt und die Community hat ein Mitspracherecht. Die Linux gls:desktopumgebung KDE nutzt das Qt Framework intensiv. Qt ist gls:libre und der gls:gpl v3 footcite:qtlicense oder mit einer kostenpflichtigen proprietären Lizenz erhältlich, falls die gls:gpl nicht genutzt werden kann.

Vorkenntnisse zu Qt sind nur sehr wenig vorhanden. Mehr als ein paar Tests wurden damit noch nicht gemacht.

Eine Qt Oberfläche kann direkt in der jeweiligen Sprache des Backends geschrieben werden oder Mittels des Qt Designers als gls:xml Datei gespeichert und dann in die eigentliche Applikation importiert werden. Somit ist keine spezielle Software nötig.

gls:xml ist nicht übermässig gut lesbar, allerdings kann man Qt in der verwendeten Sprache programmiert werden, somit ist es hauptsächlich von der Sprache im Backend abhängig. Die Dokumentation ist in C++ geschrieben, was für einen Entwickler ohne C++ Kenntnisse die Software etwas unzugänglich macht.

Qt scheint, soweit dies bis jetzt abgeschätzt werden kann, sehr leicht in ein Projekt integrierbar zu sein.

Da noch sehr wenig Kenntnisse vorhanden sind, ist der Lernfaktor entsprechend gross.

Kriterium\cellcolor[HTML]{C0C0C0}	Gewichtung\cellcolor[HTML]{C0C0C0}	max. Punktzahl\cellcolor[HTML]{C0C0C0}	erreichte Punktzahl\cellcolor[HTML]{C0C0C0}	Kriteriums- ergebnis\cellcolor[HTML]{C0C0C0}
1. Cross Plattform nutzbar	10	10	10	100
2. Freie Software	5	10	10	50
3. Vorkenntnisse	5	10	2	10
4. Integriert sich gut ins System	5	10	8	40
5. Ohne spezielle Tools nutzbar	5	10	8	40
6. Lesbarkeit des Codes	5	5	3	15
7. Einfachheit des Setups	5	5	4	20
8. Lernfaktor	5	5	4	20
Total				295

Gtk

Gtk ist sowohl für Linux wie auch für Windows und OS X erhältlich. Gtk hat als Projekt der Gnome Foundation seine Wurzeln jedoch ganz klar in der Linux Welt. Gtk ist gls:libre unter der Lesser General Public Lizenz footcite:gtklicense. Gtk ist ein Projekt der GNOME Foundation einer nicht für Profit Organisation, welche die Entwicklung diverser freier Software Projekte koordiniert.

Zu Gtk gibt es keinerlei Vorkenntnisse als Programmierer. Gtk wurde bis jetzt nur intensiv als User verwendet.

Gtk integriert sich nur unter Linux wirklich gut ins System. Unter Windows und OS X können die Applikationen schnell etwas fremd wirken. Dies ist gut bei der Applikation Meld footcite:meld zu sehen, wenn man eine Datei auswählen möchte, Abbildung (fig:meld).

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/meld.png

Die Gtk Dokumentation empfiehlt footcite:gtk_setup, dass man unter Microsoft Windows das Programm MSYS2 installiert, um Gtk einzurichten. Zum Programmieren an sich braucht es nicht zwingend weitere Tools aus einem Editor. Wie auch bei Qt hat man jedoch die Möglichkeit das gls:gui mit einem gls:gui Designer grafisch zu erstellen.

Wie auch Qt kann man Gtk entweder direkt in der Backend Sprache programmieren oder aus dem gls:gui Designer, dann als gls:xml exportieren. Der Code in der Dokumentation ist in C geschrieben, welches auch nicht die zugänglichste Sprache ist.

Die Verwendung von Gtk innerhalb des Programms scheint ähnlich einfach zu sein wie bei Qt. Die Installation ist allerdings unter Windows eher das Gegenteil von einfach.

Da die Kenntnisse gleich null sind, ist der Lernfaktor auf dem Maximum.

Kriterium\cellcolor[HTML]{C0C0C0}	Gewichtung\cellcolor[HTML]{C0C0C0}	max. Punktzahl\cellcolor[HTML]{C0C0C0}	erreichte Punktzahl\cellcolor[HTML]{C0C0C0}	Kriteriums- ergebnis\cellcolor[HTML]{C0C0C0}
1. Cross Plattform nutzbar	10	10	10	100
2. Freie Software	5	10	10	50
3. Vorkenntnisse	5	10	0	0
4. Integriert sich gut ins System	5	10	6	30
5. Ohne spezielle Tools nutzbar	5	10	8	40
6. Lesbarkeit des Codes	5	5	3	15
7. Einfachheit des Setups	5	5	3	15
8. Lernfaktor	5	5	5	25
Total				275

Electron

Electron ist ein cross-plattform Framework zum Entwickeln von glspl:gui, welches dabei jedoch auf Technologien aus der Webentwicklung benutzt. Entwickelt wird Electron von der Firma Github und ist gls:libre unter der MIT Lizenz footcite:electronlicense.

Da Electron auf Technologien aus der Webentwicklung setzt, sind hier im Vergleich zu den anderen Frameworks bereit gute Kenntnisse vorhanden. Über die genau Funktion und Implementierung sind noch keine Kenntnisse vorhanden.

Die Verwendung von Webtechnologien macht Electron zwar sehr kompatibel auf den unterstützten Systemen, oftmals sehen die Applikationen jedoch eher wie eine Webseite als wie eine Desktop Applikation aus. Ein weiterer Nachteil ist der hohe Ressourcenverbrauch, da jede Applikation nahezu einer eigenen Instanz des Google Chrome Browsers gleich kommt.

Bei der Installation muss Node.js und der Paket Manager von Node.js, NPM, vorhanden sein. Zum Programmieren selber braucht es keine speziellen Tools. Ein Editor und ein Webbrowser sollten ausreichend sein.

Electron Applikationen bestehen hauptsächlich aus gls:html, gls:css und JavaScript Code. Wenn man sich die komplette Applikation in Node.js programmieren möchte, kommt dann noch eine zusätzliche Sprache hinzu. gls:html ist ähnlich mühsam zu lesen wie gls:xml. gls:css und JavaScript sind relativ angenehm zu lesen, wobei es für beide keine offiziellen Styleguides gibt. Was bei Webanwendungen jedoch immer das schwierigste ist, ist der Wechsel zwischen verschiedenen Sprachen und Konzepten. Dieses Problem hat man bei Electron leider auch.

Das Setup von Electron ist etwa ähnlich kompliziert wie das Setup von Gtk und ist sehr ähnlich dem Entwickeln einer normalen Webapplikation.

Da an der IBZ Webtechnologien bereits intensiv behandelt worden sind und man in diesem Rahmen bereits ein paar Webapplikationen erstellt hat, wäre der Lernfaktor bei Electron wohl nicht so gross wie etwa bei Qt oder Gtk.

Kriterium\cellcolor[HTML]{C0C0C0}	Gewichtung\cellcolor[HTML]{C0C0C0}	max. Punktzahl\cellcolor[HTML]{C0C0C0}	erreichte Punktzahl\cellcolor[HTML]{C0C0C0}	Kriteriums- ergebnis\cellcolor[HTML]{C0C0C0}
1. Cross Plattform nutzbar	10	10	10	100
2. Freie Software	5	10	10	50
3. Vorkenntnisse	5	10	5	25
4. Integriert sich gut ins System	5	10	4	20
5. Ohne spezielle Tools nutzbar	5	10	7	35
6. Lesbarkeit des Codes	5	5	3	15
7. Einfachheit des Setups	5	5	3	15
8. Lernfaktor	5	5	3	15
Total				275

Ergebnis

Aufgrund der erreichten Punktzahl, Tabelle:(tab:result), bei den vorhergehenden Variantenbewertungen, wurde entschieden für das Backend der Applikation auf Python zu setzen und fürs Frontend Qt zu benutzen.

Variante\cellcolor[HTML]{C0C0C0}	Erreichte Punktzahl\cellcolor[HTML]{C0C0C0}
Backend
C#	279
C++	271
Python	322
Frontend
Qt	295
Gtk	275
Electron	275

Applikationsname

Da die einzusetzende Technologie nun feststeht lässt sich auch gut ein Name für die Applikation ableiten. Oftmals werden die grafischen Applikationen gleich benannt wie die Kommandozeilen Applikation aber mit dem Namen des gls:gui Frameworks als Suffix. Somit wird das zu erstellende gls:gui für gls:borg im weiteren Verlauf der Arbeit nun Borg-Qt genannt

Testing

Die Anwendung wird während der Realisierung soweit als möglich mit automatischen glspl:unittest und glspl:funktionstest überprüft. Dies hauptsächlich, um die Erfahrung in diesem Bereich zu erweitern um ein gutes Fundament für die Zukunft des Projektes zu bauen.

Aufgrund der Unerfahrenheit im Bereich des automatisierten Testings wurden noch die Testfälle in der Tabelle:(tab:testcases), erstellt. Diese werden final von Hand überprüft. Somit kann vermieden werden, dass nicht funktionierende automatische Tests den Abschluss des Projektes verhindern. Da die Testfälle sich hauptsächlich an den Use Cases orientieren, gibt es ein paar Ziele die, dadurch nicht getestet werden können. Zudem sind zurzeit nur ca. 20 der Ziele durch die Use Cases abgedeckt. Die weiteren Ziele lassen sich erst sinnvoll integrieren, wenn die Basis für das Programm geschaffen wurde. Somit werden diese Ziele erst im Anschluss zur Diplomarbeit umgesetzt.

Getestet wird die Applikation jeweils auf dem Computer des Projektleiters. Auf diesem läuft die aktuelle Langzeitsupport Version (18.04) von Ubuntu footcite:ubuntu Linux, mit der GNOME Desktop Umgebung footcite:gnome, als Betriebssystem. Die Tests werden jeweils gegen eine von PyInstaller generierte Binärdatei ausgeführt. Der genaue Vorgang der Erstellung dieser Datei wird in der Sektion: Releases beschrieben. Somit werden die Tests immer gegen eine veröffentlichbare Version gemacht.

Als Testdateien wird jeweils das Code Repository von Borg-Qt selber verwendet. Der Pfad des gls:borg Repository für lokale Backups soll /tmp/test-borgqt sein, in den Testfällen "Lokales Repository" genannt und das Passwort foo. Im Makefile des Repository wird dieses Setup definiert. Somit kann man als Entwickler nur make init ausführen und hat eine funktionsfähige Testumgebung.

Um Backups über gls:ssh testen zu können, wird eine virtuelle Maschine mit Ubuntu 18.04 verwendet. Die Konfiguration der virtuellen Maschine sieht dabei wie folgt aus:

2 CPU Kerne
1024 MB RAM
IP: 10.7.89.117
Ein User borg mit Passwort borg
gls:borg Repository unter /home/borg/backup/diplom mit Passwort foo, in den Testfällen "Server Repository" genannt
Der gls:ssh Key des Entwicklers wird in den User borg importiert. Dies ermöglicht Passwort freie Logins.

Die Testfälle werden während der Entwicklung kontinuierlich durchgeführt. Am Ende der Diplomarbeit wird das finale Ergebnis des jeweiligen Testfalles erfasst. Allfällige Besonderheiten werden im Kapitel Realisierung beschrieben.

Klassendiagramm

Um die Abhängigkeiten zwischen den einzelnen Klassen der Anwendung aufzuzeigen, wurde ein Klassendiagramm, Abbildung:(fig:class_diagramm), erstellt. Das Klassendiagramm basiert auf dem UML Standard. Im Diagramm wurden nicht alle "Properties" und Methoden alles Klassen aufgezeichnet, sondern nur solche, die auf eine andere Klasse verweisen. Dadurch bleibt das Diagramm übersichtlicher. Die Klassennamen, welche in fetter Schrift gehalten sind, wurden dabei vom Projektleiter erstellt. Die Klassennamen, welche kursiv sind, sind Klassen, welche entweder von Python oder Qt bereitgestellt werden.

Usability-Studie

Um Borg-Qt auf seine Nutzerfreundlichkeit zu testen, wird im Rahmen der Diplomarbeit noch eine kleine Usability-Studie gemacht. Bei einer solchen Studie erhalten die Probanden, Tabelle:(tab:probanden), ein paar Aufgaben, Sektion /Nebucatnetzer/thesis/src/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/Aufgaben, welche sie in einer begrenzten Zeit zu erledigen haben. Die Aufsichtsperson gibt ihnen dabei keinerlei Hilfestellungen. Die Probanden sollen die Aufgaben alleine mithilfe der Tipps und Hinweisen in der Anwendung lösen. Im Anschluss bewerten die Probanden dann die einzelnen Aufgaben nach ihrer Schwierigkeit, Tabelle:(tab:usability_colours). Daraus lässt sich dann eine sogenannte Heatmap erstellen. Aus der Heatmap kann man anschaulich herauslesen, welche Bereiche für die User noch zu kompliziert sind und Nacharbeit benötigen.

Die Probanden wurden aus dem Umfeld des Projektleiters ausgewählt. Es wurde dabei versucht ein einigermassen breites Spektrum an Computerkenntnissen abzudecken. Da die Anwendung allen Erfahrungsstufen behilflich sein soll. Die Angaben in der Tabelle:(tab:probanden) sind jedoch die Selbsteinschätzung der Probanden und nicht die des Projektleiters.

Nr.\cellcolor[HTML]{C0C0C0}	Geschlecht\cellcolor[HTML]{C0C0C0}	Alter\cellcolor[HTML]{C0C0C0}	Englischkenntnisse\cellcolor[HTML]{C0C0C0}	Computerkenntnisse\cellcolor[HTML]{C0C0C0}
1	Männlich	30	Sehr gut	Sehr gut
2	Männlich	26	Gut	Sehr gut
3	Männlich	26	Gut	Mittel
4	Männlich	34	Mässig	Mittel
5	Weiblich	26	Gut	Mittel

Grün\cellcolor[HTML]{4CAF50}	Die Aufgabe war sehr einfach.
Gelb\cellcolor[HTML]{FFEB3B}	Die Aufgabe war etwas herausfordernd.
Orange\cellcolor[HTML]{FF9800}	Die Aufgabe war schwierig.
Rot\cellcolor[HTML]{f44336}	Die Aufgabe war sehr schwierig.
Schwarz\cellcolor[HTML]{424242}	Die Aufgabe war unlösbar.

Aufgaben

Du möchtest deine Dateien sichern. Erstelle dazu eine Datensicherung des Ordners /home/testuser/Downloads.
Du hast aus Versehen die Datei /home/testuser/Downloads/Example.pdf gelöscht. Stelle die Datei wieder her. Am Ende soll sie unter /home/testuser/Documents/Example.pdf zu finden sein.
Stelle ein beliebiges Archiv wieder her. Der Zielpfad ist /home/testuser/Documents/.
Lösche ein Archiv deiner Wahl.
Du möchtest, dass der Ordner /home/testuser/Pictures/ nicht mehr gesichert wird. Konfiguriere die Applikation entsprechend.

Resultate

Test\cellcolor[HTML]{C0C0C0}	Proband 1\cellcolor[HTML]{C0C0C0}	Proband 2\cellcolor[HTML]{C0C0C0}	Proband 3\cellcolor[HTML]{C0C0C0}	Proband 4\cellcolor[HTML]{C0C0C0}	Probandin 5\cellcolor[HTML]{C0C0C0}
1.	\cellcolor[HTML]{4CAF50}	\cellcolor[HTML]{4CAF50}	\cellcolor[HTML]{FFEB3B}	\cellcolor[HTML]{4CAF50}	\cellcolor[HTML]{4CAF50}
2.	\cellcolor[HTML]{FFEB3B}	\cellcolor[HTML]{FFEB3B}	\cellcolor[HTML]{FF9800}	\cellcolor[HTML]{FF9800}	\cellcolor[HTML]{FF9800}
3.	\cellcolor[HTML]{4CAF50}	\cellcolor[HTML]{FFEB3B}	\cellcolor[HTML]{4CAF50}	\cellcolor[HTML]{4CAF50}	\cellcolor[HTML]{4CAF50}
4.	\cellcolor[HTML]{4CAF50}	\cellcolor[HTML]{4CAF50}	\cellcolor[HTML]{4CAF50}	\cellcolor[HTML]{4CAF50}	\cellcolor[HTML]{4CAF50}
5.	\cellcolor[HTML]{4CAF50}	\cellcolor[HTML]{FFEB3B}	\cellcolor[HTML]{FF9800}	\cellcolor[HTML]{FFEB3B}	\cellcolor[HTML]{FFEB3B}

Proband 1

Der Proband fand die Aufgaben grundsätzlich einfach zu lösen. Dass die "Mount" Funktion zum Wiederherstellen einzelner Dateien gedacht war, hat er nicht erkannt.

Proband 2

Der Proband kam mit den Aufgaben insgesamt gut klar. Bei der ersten Aufgabe hätte er sich eine Meldung gewünscht, wenn das Backup erfolgreich durchgelaufen ist. Wie Proband 1 hat auch er die "Mount" Funktion nicht genutzt zum Wiederherstellen einer einzelnen Datei. Text Hinweise wurden nur bedingt wahrgenommen.

Proband 3

Proband 3 kam mit der Anwendung an sich gut klar. Die Aufgabe Zwei fand er über alles gesehen auch am schwierigsten, da er mit der Materie nahezu nicht vertraut ist. Als zusätzlichen Input gab er an, dass ein Kontextmenü, welches sich mit Rechtsklick auf ein Element öffnet, etwas sei was er gerne hätte, da er andere Anwendungen oft so steuert. Aufgabe 5 war auch etwas herausfordernder als 1,3 und 4, insbesondere war unklar wie der Ordner zu der Liste hinzugefügt werden sollte.

Während des Tests ist in der Anwendung noch ein Bug aufgetaucht, welcher unter gewissen Umständen Probleme beim Erstellen von Archiven machte. Die detaillierte Lösung dafür ist im Kapitel /Nebucatnetzer/thesis/src/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/Realisierung beschrieben.

Proband 4

Bei Proband 4 war die grösste Hürde, dass das Interface nur in Englisch verfügbar war. Bei Aufgabe Zwei hatte er sich nach eigenen Angaben etwas verloren gefühlt und hätte sich auch ein Kontextmenü auf dem Rechtsklick gewünscht. Mit etwas Hilfe bei der Übersetzung waren die restlichen Aufgaben jedoch gut zu meistern.

Probandin 5

Probandin 5 mit der Anwendung insgesamt sehr gut klar und hat auch als Einzige die Tooltips auf den Buttons entdeckt und dann genutzt. Aufgabe 2 war jedoch auch schwierig zu lösen, danach ging es jedoch ohne Probleme.

Auswertung

Alle Testpersonen konnten die Applikation nach anfänglichen Bedienungsschwierigkeiten sehr gut bedienen. Um Hilfestellung zu leisten, wird im Rahmen der Diplomarbeit noch ein Hilfefenster eingebaut, welches den Benutzern beim ersten Starten der Anwendung angezeigt wird und kurz die jeweiligen Elemente des Interfaces anzeigt. Somit sollte auch das Problem bei der Aufgabe Zwei etwas abgeschwächt werden. Eines der Hauptprobleme war dort, dass die Probanden nicht herausgefunden haben, dass der schnellste Weg eine einzelne Datei wieder herzustellen über die "Mount" Funktion ginge. Die Einarbeitung in die Thematik von Backups würde sich jedoch wohl nur sehr schwer über das gls:gui realisieren lassen. Hier müsste auf jeden Fall eine Dokumentation oder im Idealfall eine Schulung Abhilfe schaffen.

Der von zwei Usern geäusserte wertvolle Hinweis, ein Kontextmenü anzubieten, wird in die künftige Weiterentwicklung der Applikation eingepflegt. Aus Ressourcengründen allerdings erst nach der Diplomarbeit.

Ein Pop-Up, welches ein erfolgreiches Erstellen eines Archivs bestätigt, wird nicht eingebaut. Bei erfolgreicher Durchführung verschwindet der Fortschrittsdialog und in der Archivlist erscheint ein weiterer Eintrag. Das sind zwar nicht die offensichtlichsten Hinweise im Falle eines Fehlers, erscheint jedoch sofort ein Dialog, der darauf hinweist. Somit sollten die beiden Vorgänge genügend unterschieden sein und es hat auch kein anderer Proband das Bedürfnis nach einer Bestätigung.

Eine Deutschübersetzung, eine weitere Anforderung der Usability Tester, wird auch für zukünftige Entwicklungen aufgenommen und nicht im Rahmen der Diplomarbeit umgesetzt.

Im Rahmen der Diplomarbeit werden noch einige Texte angepasst. An gewissen Stellen war die Rede von "Backups" und an anderen von "Archives". Da gls:borg sie selber "Archives" nennt, sollte Borg-Qt noch so angepasst werden das überall von "Archives" die Rede ist. Zudem wird bei den "Include" und "Exclude" Optionen über der Liste noch ein Label hinzugefügt, um die Elemente zu beschreiben. Schlussendlich werden die Buttons "Add file" und "Add folder" zu "Exclude file" und "Exclude folder" sowie "Include file" und "Include folder" umbenannt. Somit zeigen die Buttons dann auch direkt, dass sie Dateien respektive Ordner ein-/ausschliessen. Ein paar der Probanden hatten es zuerst über den "Remove" Button versucht.

Realisierung

Cross-plattform Kompatibilität

Um sicherzugehen, dass die gewählten Technologien auch den Anforderungen entsprechen wurde ein kleines "Hello World" Programm mit Python3 und Qt geschrieben. Dieses läuft ohne jegliche Probleme und Anpassung auf Windows, Linux und OS X. Wie in den Screenshots in Abbildung:(fig:hello_world) zu sehen ist.

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/hello_world.png

Benutzerinterface

Inspiration

In der Vorstudie zur Diplomarbeit wurde gls:borg mit der Software "Back in Time"footcite:backintime verglichen. "Back in Time" setzt auf Rsync zum Kopieren der Dateien. Dies erlaubt es "Back in Time" auch schnelle Backups über gls:ssh zu machen allerdings ohne gls:dedup.

Das übersichtliche Userinterface in Abbildung:(fig:bit_main), wurde für Borg-Qt als Vorlage genommen. Insbesondere die einfache und direkte Art ein Backup eines spezifischen Pfades zu machen ist sehr gelungen. Da sie es dem User so einfach wie möglich macht ein Backup zu erstellen.

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/bit_main.png

Erste Umsetzung

Qt bietet einem mehrere Möglichkeiten zum Erstellen der grafischen Oberfläche. Zum einen kann die ganze Oberfläche programmatisch erstellt werden. Dies gibt dem Entwickler ein grosses Mass an Kontrolle, ist allerdings nicht sehr intuitiv.

Die angenehmere Variante ist es den Qt Designer, Abbildung:(fig:qt_designer), zu nutzen. Mit diesem lassen sich die Oberflächen in einer grafischen Oberfläche designen und auch gleich starten. Damit ist direkt zu sehen wie sich die Oberflächen auf dem System verhalten.

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/qt_designer.png

Mit der ersten gls:gui Version wurden die ersten Basisziele der Projektarbeit umgesetzt. Im Hauptfenster, Abbildung:(fig:borgqt_main_v1), befinden sich wie auch bei "Back in Time" in der einen Hälfte eine Liste der vorhandenen Archive und in der anderen Hälfte ein Dateimanager. Dieser dient zur Auswahl des zu sichernden Pfades. Im oberen Bereich findet sich die Toolbar mit den Aktionen, die der User ausführen kann. Gemäss den Use Cases sind dies "Backup, Restore, Mount, Delete und Settings".

Bei den Icons wurde zuerst versucht diese nach der "Icon Naming Specification"footcite:iconnamespec auszuwählen. Diese Spezifikationen würden es erlauben einfach den definierten Namen des Icons anzugeben. Qt würde dann jeweils das passende Icon basierend auf dem System anzeigen. Somit wären die Icons passend zum jeweiligen Betriebssystem. Allerdings gab es für die Aktionen keine passenden Icons in der Spezifikation. Deshalb wurden schlussendlich das "Feather" Icon Theme Set footcite:feathericons ausgewählt. Dabei handelt es sich um ein freies Icon Theme unter der MIT Lizenz, welches die Icons als gls:svg Dateien bereitstellt. Dadurch können die Icons frei skalieren und funktionieren auch auf Geräten mit einer hohen Auflösung.

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/borgqt_main_v1.png

Im Einstellungsfenster gibt es drei Tabs zur Auswahl. Einmal den "General" Tab, Abbildung:(fig:borgqt_settings_general_v1), dieser zeigt allgemeine Optionen an. Im zweiten Tab "Include", Abbildung:(fig:borgqt_settings_include_v1), kann der User die Ordner und Dateien auswählen, die er sichern will. Der dritte Tab "Exclude", Abbildung:(fig:borgqt_settings_exclude_v1), gibt dem User die Möglichkeit einzelne Ordner oder Dateien von den Backups auszuschliessen.

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/borgqt_settings_general_v1.png

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/borgqt_settings_include_v1.png

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/borgqt_settings_exclude_v1.png

Das "Progress" Dialogfenster, Abbildung:(fig:borgqt_progress_v1), zeigt dem User einen Fortschrittsbalken und einen "Cancel" Button zum Abbrechen der Aktion an. Das Fenster ist generisch gehalten, damit es von verschiedenen Tasks gleichermassen genutzt werden kann.

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/borgqt_progress_v1.png

Einstellungen

Die Einstellungen werden von der Applikation benötigt, um die vom User definierten Vorgaben auszuführen, das Backup Repository zu finden, etc. Diese Einstellungen sollen in einer Klar-Text Datei gespeichert werden. Dies hat zum einen den Vorteil, dass man die Einstellungen sehr einfach sichern kann. Zum anderen kann man die Einstellungen der Applikation auch anpassen, ohne dass man die Applikation selber starten muss.

Backend

Zum Erstellen und Auslesen der Konfigurationsdatei wurde das Python Standard Modul configparser footcite:configparser verwendet. Dieses macht es einem sehr einfach eine Datei im "INI" Stil zu erstellen und parsen.

"INI" Stil bedeutet dabei das die Einstellungen in "Key/Value" Paaren gespeichert werden. Somit kann man einfach auf den benötigten Wert zugreifen, in dem man seinen Schlüssel angibt. Ein Beispiel ist im Code Snippet: (code:ini_file) zu sehen.

# docs/borg_qt.conf.example
[borgqt]
includes = [
	    "/home/username/",
        "/home/otheruser/Downloads"
	]
repository_path = /tmp/test-borgqt
password = foo
prefix = muster

Das Auslesen und Schreiben der Konfigurationsdatei liess sicher relativ einfach realisieren. Die grösste Herausforderung dabei war, dass Configparser keinen Support für eine Liste von Werten hat. Die wurde insbesondere für include und exclude Pfade benötigt. Also für die Pfade, welche gesichert werden oder von einem Backup ausgeschlossen werden sollen.

Abhilfe schaffte hier ein Stackexchange Post footcite:configlist. Dieser schlug vor, dass man die Liste im gls:json Format speichern soll. Da Configparser alle Werte im Format "String" zurückgibt, können dann die gls:json Listen sehr einfach von einem gls:json Parser umgewandelt werden. Im Projekt wurde dies dann unter anderem als Methode der Config Klasse, Code Snippet:(code:json_config), implementiert. Somit muss man jeweils nur die _return_list_option() Methode mit der benötigten Option als Argument aufrufen und bekommt als Resultat eine funktionierende Python Liste zurück.

Beim Schreiben der Konfigurationsdatei macht man dann einfach das Umgekehrte. Man konvertiert eine Python Liste in einen gls:json String.

# borg_qt/config.py

def _return_list_option(self, option):
    """Reads the provided option from the configparser object and returns
    it as a list."""
    if option in self.config['borgqt']:
        return json.loads(self.config['borgqt'][option])
    else:
        return []

Die Datei wird jeweils beim Start der Applikation gelesen und angewendet. Somit weiss die Applikation bereits nach dem Start wo das Repository liegen sollte und wie die Login Daten dafür sind. Dies geschieht mittels der Methode _get_path, Codesnippet:(code:config_path). Es gibt dabei zwei mögliche Pfade, wo die Konfigurationsdatei liegen könnte. Befindet sich die Datei nicht am vorgegeben Pfad ~/.config/borg_qt/borg_qt.conf oder direkt "neben" dem Binary, gibt die Applikation eine entsprechende Meldung, Abbildung:(fig:borgqt_missing_config), aus. Der Hauptpfad unter ~/.config/borg_qt/borg_qt.conf wird dabei gemäss dem Ziel Nr. 21 über die Umgebungsvariable HOME zusammengesetzt

# borg_qt/config.py

def _get_path(self):
    """searches for the configuration file and returns its full path."""
    home = os.environ['HOME']
    dir_path = os.path.dirname(os.path.realpath(__file__))

    if os.path.exists(os.path.join(home, '.config/borg_qt/borg_qt.conf')):
        return os.path.join(home, '.config/borg_qt/borg_qt.conf')
    elif os.path.exists(os.path.join(dir_path, 'borg_qt.conf')):
        return os.path.join(dir_path, 'borg_qt.conf')
    else:
        raise BorgException("Configuration file not found!")

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/borgqt_missing_config.png

Frontend

Zur Vereinfachung der Bedienbarkeit wurde die Applikation, um eine grafische Konfigurationsmöglichkeit erweitert. Diese stellt dabei hauptsächlich die Werte aus der Konfigurationsdatei grafisch dar und übergibt allenfalls geänderte Werte ans Backend, welches die Konfiguration, dann wieder in der Datei speichert.

Qt kennt keinen Mechanismus zum Auslesen aller Elemente aus einem sogenannten QListWidget, einem gls:gui Element, welches Listen darstellt. Die Elemente müssen somit zuerst in einer Zwischenliste gespeichert werden, bevor sie zurück in das Configparser Objekt geschrieben. Im Code sieht dies dann wie in Codesnippet:(code:qlistwidgets_items) aus. Dabei wird jedes Element einzeln aus dem QListWidget geholt und in die Zwischenliste geschoben. Im zweiten Teil wird die Liste dann wieder zu einem gls:json String konvertiert und im Configparser Objekt gespeichert. Die Option indent=4 dient dabei der Lesbarkeit, damit nicht der ganze gls:json String auf ein Zeile in der Konfigurationsdatei gespeichert wird, sondern jedes Listenelement seine eigene Zeile erhält.

# borg_qt/config.py

# Workaraound to get all items of a QListWidget as a list
includes = []
for index in range(self.list_include.count()):
    includes.append(self.list_include.item(index).text())

# Configparser doesn't know about list therefore we store them as json
# strings
self.config['borgqt']['includes'] = json.dumps(includes,
                                               indent=4,
                                               sort_keys=True)

Borg Interface

Zuerst erschien es sinnvoll die Kommunikation zwischen gls:borg und Borg-Qt über einfache Funktionen laufen zu lassen. Dieser Ansatz hatte allerdings zwei Probleme. Zum einen wurde es relativ umständlich Informationen zu verarbeiten und weiterzugeben, zum anderen führte es zu dem unschönen Nebeneffekt, dass das gls:gui eingefroren ist. Eine Recherche ergab, dass Threads hier Abhilfe schaffen könnten.

Python liefert für Threads das Modul threading.Thread footcite:threading, mit. In der Praxis lies sich der Fortschrittsdialog und der Thread jedoch nicht so verknüpfen das sich der Dialog schliesst, wenn das Backup durchgelaufen ist und der Thread wieder entfernt wird. Aus diesem Grund wurde dann ein erfolgreicher Test mit dem PyQt Modul QThread footcite:qthread gemacht. Nach Beendigung des Backups wird der Fortschrittsdialog automatisch geschlossen. Auch das Stoppen des Threads mit einem Klick auf den "Cancel" Button funktioniert einwandfrei.

Damit gls:borg aus der Anwendung angesteuert werden kann wird das Python Modul subprocess footcite:subprocess verwendet. Dieses erlaubt einem neue Prozesse zu erstellen, welche man oftmals benötigt um etwa, wie im Fall von Borg-Qt, externe Applikationen zu starten, zu steuern und ihre Ausgabewerte auszulesen. Das effektive Kommando wird dann aus dem Property self.command gelesen.

Damit gls:borg die Ausgabe im gls:json Format ausgibt, muss man man noch die Parameter --log-json und --json mitgeben. Der erste Parameter ändert hauptsächlich das Format von Errormeldungen und der zweite formatiert dann die finale Ausgabe. Die Ausgaben werden jeweils an Variablen weitergegeben (json_output und json_error) welche im weiteren Code verarbeitet werden.

Insbesondere json_error ist für den weiteren Programmablauf von grosser Wichtigkeit. Wenn Borg ein Problem feststellt, wird die Error Meldung von gls:borg an json_error weitergegeben. Mittels der Methode im Codesnippet:(code:json_err), wird die Variabel ausgewertet und im Falle eines Fehlers wirft der Code eine Exception, welche im Hauptprogramm abgefangen wird. Dabei wird eine Fehlermeldung in einem separaten Fenster ausgegeben. Die Methode wurde dabei auf der Klasse BorgQtThread umgesetzt und steht somit allen Funktionen zur Verfügung. Die Fehlermeldung bei einer fehlenden Konfigurationsdatei, Abbildung:(fig:borgqt_missing_config), funktioniert nach dem gleichen Prinzip und konnte somit zum grössten Teil wiederverwendet werden. Der restliche gls:json Output kann dann einfach mit dem json Modul geparst werden. Somit werden dem User, gemäss Ziel Nr. 14, direkt die Fehlermeldungen von gls:borg angezeigt und es muss nur an gewissen Stellen noch applikationsspezifisches Exception Handling betrieben werden.

# borg_qt/borg_interface.py

def process_json_error(self, json_err):
    if json_err:
        error_list = json_err.split('\n')
        if "borg.locking" in error_list[0]:
            pass
        else:
            err = json.loads(error_list[0])
            raise BorgException(err['message'])

Die ganze Funktionalität wurde dann in der Klasse BorgQtThread zusammengefasst. Somit kann für jede Funktion von gls:borg eine einzelne Klasse geschrieben werden, welche dann von BorgQtThread die Funktionen erbt. Die Funktionsklassen müssen dann jeweils nur die Methode self.create_command(self) implementieren, welche das Property self.command erstellt und die einfachen Funktionen von gls:borg sollten direkt funktionieren.

Backup

Daten zu sichern ist die primäre Funktion von Borg-Qt. Deshalb soll das Erstellen eines Backups so schnell und unkompliziert wie möglich vonstattengehen.

Backend

Um Backups erstellen zu können, wurde die Klasse BackupThread erstellt, welche von BorgQtThread erbt. Die Klasse BackupThread nimmt beim instantiieren 3 Argumente auf: includes, excludes, prefix. Wobei excludes und prefix beide optional sind. Im Hauptcode werden diese Argumente aus der Konfigurationsdatei ausgelesen und übergeben. Die Includes werden im Falle eines Backups im Hintergrund aus der Konfigurationsdatei gelesen. Wenn es der User manuell ausführt, wird der im Frontend ausgewählte Pfad mitgegeben.

Die "Excludes" haben lange nicht funktioniert. Der Grund dafür waren zusätzliche Anführungszeichen um die Exclude Pfade. Diese wurden aus Versehen hinzugefügt, da gls:borg normalerweise auf der Kommandozeile ausgeführt wird und die Anführungszeichen dort notwendig sind, um allfällige Leer- oder Sonderzeichen abzufangen. Es wurde davon ausgegangen, dass das subprocess Modul ähnlich funktioniert wie die Kommandozeile. Da man an das Modul direkt einen String übergibt, sind die zusätzlichen Anführungszeichen nicht notwendig und führen sogar dazu, dass die Pfade gar nicht funktionieren. Somit werden die "Excludes" mittels der Methode _process_excludes mit dem entsprechenden Parameter gepaart und als gesamte Liste an das finale Kommando angehängt. Die "Includes" funktionieren auf die gleiche Weise, benötigen jedoch keine zusätzlichen Parameter. Zu sehen ist dies im Codesnippet:(code:excludes).

# borg_qt/borg_interface.py
# Funktion zum Verarbeiten der "Excludes"
def _process_excludes(self, excludes):
    processed_items = []
    if excludes:
        for item in excludes:
            processed_items.extend(['-e', item])
        return processed_items
    else:
        return processed_items

# Methode zum Erstellen des gls:borg Kommandos.
def create_command(self):
    self.command = ['borg', 'create', '--log-json', '--json',
                    ('::'
                        + self.prefix
                        + '{now:%Y-%m-%d_%H:%M:%S}')]
    self.command.extend(self.includes)
    if self.excludes:
        self.command.extend(self.excludes)

Frontend

Damit die Backups im Frontend funktionieren, musste zum einen der "Backup" Knopf mit der Methode create_backup verknüpft werden. Des Weiteren wurde ein Dateibaum, in Abbildung:(fig:borgqt_file_tree) grün umrahmt, eingefügt. Dieser gibt den Pfad des angewählten Objektes and die create_backup Methode weiter.

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/borgqt_file_tree.png

Während dem ein Archiv erstellt wird, wird ein kleiner Dialog mit Ladebalken angezeigt, Abbildung:(fig:borgqt_progress_v2). Dieser dient hauptsächlich dazu dem User das Gefühl zu geben, dass die Applikation noch am Arbeiten ist.

Der Dialog musste gegenüber der ersten Version in Sektion: Erste Umsetzung noch etwas angepasst werden. gls:borg gibt, während dem Erstellen eines Archivs keine Informationen zurück, welche es einem erlauben würden einen Fortschrittsbalken zu generieren, welcher den effektiven Fortschritt anzeigt. gls:borg gibt einzig die Anzahl der verarbeiteten Dateien in regelmässigen Abständen zurück. Da gls:borg jedoch zu Beginn nicht meldet, wie viele Dateien gesichert werden, lässt sich damit keine Prozentzahl erstellen. Ein paar Experimente, bei denen die zu sichernden Dateien zuerst von Borg-Qt gezählt werden sollten, wurden verworfen. Einerseits weil keine Methode gefunden werden konnte, welche die gleiche Anzahl Dateien zurückgab wie gls:borg. Anderseits, weil es den Backup Vorgang unnötig in die Länge zieht. Dies ist insbesondere der Fall, wenn sich sehr viele Dateien im Quellverzeichnis befinden. Es kann sogar soweit kommen, dass das Zählen länger als das eigentliche Sichern dauert. Aus diesem Grund wurde der Fortschrittsbalken mit Prozentanzeige durch einen sich wiederholenden Ladebalken ersetzt.

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/borgqt_progress_v2.png

Wurde das Archiv erfolgreich erstellt, wird die Liste mit den Archiven sowie die Repository Statistik aktualisiert. Beide Elemente sind in der Abbildung:(fig:borgqt_archive_list), grün respektive rot umrahmt. Für die beiden Funktionen wurde jeweils eine eigene Klasse, ListThread und InfoThread, erstellt. Beide erben von BorgQtThread. In den Klassen wird wie bei BackupThread gls:borg über einen subprocess aufgerufen, um die Archiv Liste respektive Statistik zurückzuerhalten Die gls:json Strings werden wieder auf die jeweilige Information geparst und die Archive in eine Python Liste, die Repository Statistik, in Zahlen umgewandelt.

Da gls:borg die Repository Grössen in Bytes zurückgibt, sollten diese zur Anzeige noch in eine Menschen lesbarses Format umgerechnet werden. In Borg-Qt geschieht dies mit der Helferfunktion convert_size. Die Funktion wurde von Stackoverflow footcite:sizeformat übernommen.

Beim Durchführen der Usability-Studie wurde noch ein Bug entdeckt welcher die Anwendung zum Abstürzen brachte. Der Bug, der entdeckt wurde, tritt immer dann auf, wenn ein Archiv gemountet ist während man ein Archiv erstellen möchte. Dies ist jedoch offenbar eine 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, dass 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.

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/borgqt_archive_list.png

Restore

Der Code für das Wiederherstellen eines Archivs ist sehr ähnlich wie der Code für das Erstellen. Die Besonderheiten bei dieser Funktion sind vor allem die Kontrolle, dass ein Archiv angewählt wurde, bevor man die Wiederherstellung startet, das Erstellen des Zielpfades sowie das Aufräumen bei einem Fehler.

Wird der "Restore" Knopf gedrückt ohne das ein Archiv angewählt wurde, erscheint folgende Fehlermeldung, Abbildung:(fig:no_archive_selected), um den Benutzer darauf hinzuweisen, das er dies noch tun sollte.

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/borgqt_no_archive_selected.png

Für die Wiederherstellung einer Datensicherung, selektiert der User das gewünschte Archiv. Als zweiten Schritt startet er den Prozess mit Klick auf "Restore". Im sich automatisch öffnenden Dialogfenster, ist der gewünschte Zielort auszuwählen. Ist der Zielort festgelegt, erstellt Borg-Qt ein Subverzeichnis mit dem Namen des Archivs und beginnt mit der eigentlichen Wiederherstellung. Ist der Zielort für die Applikation nicht beschreibbar erscheint die Fehlermeldung, Abbildung:(fig:not_writeable), und der Vorgang wird abgebrochen. Nach der erfolgreichen Wiederherstellung öffnet die Applikation den Zielort in einem Dateimanager, damit der User gleich mit den Dateien weiterarbeiten kann.

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/borgqt_not_writeable.png

Gibt es, während dem Wiederherstellen, einen Fehler gibt die Anwendung den entsprechenden Fehler aus und löscht zusätzlich noch den zu Beginn erstellten Archiv Ordner.

Wird das gleiche Archiv nochmal an den gleichen Zielort wiederhergestellt, werden bereits vorhandene Dateien überschrieben.

Mount

Die "Mount" Funktion prüft zuerst ob der Benutzer ein Archiv angewählt hat und gibt, falls dies nicht der Fall ist, eine entsprechende Fehlermeldung aus. Im Gegensatz zur "Restore" Funktion zeigt die "Mount" Funktion jedoch keinen Dialog zum Auswählen des Zielpfades. Die Funktion erstellt sich diesen selbst. Der Zielpfad ist dabei kombiniert aus dem /tmp Verzeichnis und dem Namen des Archivs

gls:borg mountet jedes Archiv nur mit Leserechten. Es ist relativ unwahrscheinlich, dass der Zielpfad in unbeschreibbarer Form bereits vor dem Ausführen der mount_backup Methode bereits vorhanden ist. Ist dies der Fall kann davon ausgegangen werden, dass der Benutzer das Archiv bereits einmal gemountet hat. Genau dies wird in der Applikation auch so überprüft. Hat die Applikation Schreibrechte auf den Zielpfad, wird das ausgewählte Archiv auf diesem Pfad gemountet. Anschliessend wird der Pfad in einem Dateimanager geöffnet, damit der Benutzer direkt mit den Dateien weiterarbeiten kann. Wurde erkannt, dass das Archiv bereits gemountet wurde, also der Pfad nicht schreibbar ist, öffnet die Applikation direkt den Dateimanager, ohne zu versuchen das Archiv noch einmal zu mounten.

Zusätzlich wird der Pfad jedes gemounteten Archivs in einer Liste gespeichert. Beim Beenden der Applikation iteriert die Applikation über jeden Pfad in der Liste unmountet das Archiv und löscht den Ordner. Somit befindet sich das System wieder im gleichen Zustand wie vor dem Start der Applikation.

Delete

Soll ein Archiv gelöscht werden wird, wie bei der "Restore" und "Mount" Funktion, überprüft ob eines angewählt ist. Ist dies gegeben, zeigt die Applikation dem Benutzer einen Dialog, Abbildung:(fig:yes_no). Bestätigt er diesen mit "Yes" wird der Vorgang fortgesetzt und das Archiv gelöscht mit "No" wird der Vorgang abgebrochen. Nach der Löschung werden die Archivliste und die Repository Statistik aktualisiert, um den neuen Zustand wiederzugeben.

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/borgqt_yes_no.png

Automatische Backups

Damit der Benutzer die Backups nicht von Hand machen muss, ist es sinnvoll eine Funktion bereitzustellen, welche die Backups automatisch im Hintergrund erledigt. Dadurch ist sichergestellt das die Backups im allgemeinen Trubel des Lebens nicht vergessen gehen.

Voraussetzung für automatisierte Backups ist, dass die Datensicherung ohne gls:gui gestartet werden kann. Bei Borg-Qt wird dies über einen Kommandozeilen Parameter realisiert. Hierfür wurde das Python Standard Paket argparser verwendet. Konkret bedeutet dies, dass wenn die Applikation auf der Kommandozeile mit folgendem Befehl ausgeführt wird: borg_qt -B. Wird die grafische Oberfläche nicht angezeigt und es wird direkt die Methode background_backup der Klasse MainWindow ausgeführt. Dabei werden alle Ordner, welche in den Einstellungen unter "Include" sowie "Exclude" gespeichert wurden, im Archiv gesichert, respektive davon ausgeschlossen. Damit sind die Voraussetzungen für automatische Backups gegeben.

Um die Backups in regelmässigen Intervallen auszuführen, gibt es zwei Möglichkeiten, wie man dies implementieren könnte.

Variante a), die Applikation permanent im Hintergrund laufen lassen, etwa als Trayicon wie man das von anderen Applikationen wie etwas Dropbox kennt.

Variante b) über Werkzeuge des Betriebssystems. Die drei Desktop Betriebsysteme, Windows, OS X und Linux bringen alle drei Werkzeuge mit, um periodisch ein Programm auszuführen.

Für Borg-Qt wurde beschlossen Variante b) zu realisieren. Die Anwendung soll dem Benutzer soweit als möglich aus dem Weg gehen. Eine Anwendung welche permanent in der Taskleiste lebt, erfüllt das Kriterum nicht.

Unter Linux wurden sich wiederholende Aufgaben, früher mit sogenannten Cron Jobs umgesetzt. Die moderne Lösung sind heutzutage jedoch Systemd Timer. Also konkret Systemd. Dies aus dem Grund das Systemd genau für das Managen von Systemdiensten programmiert wurde. Ein Grossteil der benötigten Funktion ist bereits in Systemd enthalten, somit kann bei der Entwicklung zusätzlich Zeit gespart werden.

Systemd ist ein init System, welches dazu dient dazu die Benutzerumgebung und die dazugehörigen Prozesse zu starten und zu verwalten footcite:systemd. Die Prozesse werden über sogenannte "Services" gestartet. Die Services werden dabei einfach in Klartextdateien mit der Dateiendung .service definiert. Der Inhalt orientiert sich dabei praktischerweise am "INI" Stil. In Borg-Qt wurde das INI Format bereits bei den Konfigurationsdateien verwendet. Somit können die dort gesammelte Erfahrungen zur Implementation von configparser wiederverwendet werden. Soll ein Service in einem gewissen Zeitintervall ausgeführt werden, benötigt Systemd eine weitere Datei mit dem gleichen Namen jedoch mit der Dateiendung .timer . Der Inhalt ist auch wieder im INI Stil gehalten. Systemd versteht eine Vielzahl an Datumsformaten footcite:systemddate. In Borg-Qt wurden zwei Varianten in den Einstellungen umgesetzt. Eine, welche "Predefined Schedule" genannt wurde und eine mit dem Namen "Custom Schedule", zu sehen in, Abbildung:(fig:schedule). Die Predefined Option wird dabei in die von Systemd unterstützten Formate "hourly, daily, weekly und monthly" übersetzt. Entsprechend der gewählten Wiederholung wird automatisch ein Archiv erstellt. Mit der Custom Option kann der Benutzer sich den Zeitplan individueller gestalten. Etwa "jeden Mittwoch um 12:00 Uhr" für Systemd übersetzt würde dieser Zeitplan dann so aussehen: Wednesday *-*-* 12:00:00. Für spätere Versionen von Borg-Qt wäre es allenfalls auch möglich die Auswahl von mehreren Wochentagen zu ermöglichen, damit der Benutzer etwa folgenden Zeitplan erstellen könnte "Montag, Mittwoch, Freitag stündliche Backups." (Monday, Wednesday, Friday *-*-* *:00:00).

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/borgqt_settings_schedule.png

Das Erstellen der eigentlichen Systemd Konfiguration passiert in Borg-Qt in der Config Klasse zum gleichen Zeitpunkt, wie die eigentliche Konfigurationsdatei geschrieben wird. Zum Schreiben und de-/aktivieren des Systemd Services, respektive Timers wurde eine Klasse SystemdFile erstellt. Somit könnte die Funktion auch einfach in einem anderen Projekt verwendet werden.

Systemd benötigt zum Starten der Anwendung den absoluten Pfad in der Service Datei. Da davon ausgegangen werden kann, das Borg-Qt im PATH des Systems abgelegt wird, wurde das Unix Tool which verwendet, um den exakten Speicherort zu erhalten. Mittels des Befehls which borg-qt erhält man den absoluten Speicherort der Datei. Zusammen mit den Daten aus den Einstellungen wird diese Information in einem Configparser Objekt gespeichert, welches dann mithilfe der SystemdFile Klasse in eine borg_qt.service, Codesnippet:(code:systemdservice), respektive borg_qt.timer, Codesnippet:(code:systemdtimer), Datei, im Systemd Pfad /home/username/.config/systemd/user/ geschrieben und aktiviert wird.

Eine Option in der Datei borg_qt.timer, die noch erwähnenswert ist, ist Persistent = true. Ist Persistent auf true gesetzt, holt Systemd den Tasks nach sollte er eine Ausführung verpasst haben. Dies ist insbesondere dann hilfreich, wenn etwa der Zeitplan auf daily oder weekly gesetzt wurde. Sollte also etwa jeden Mittwoch ein Backup gemacht werden aber der Computer lief an diesem Tag nicht, startet Systemd Borg-Qt, sobald der Computer das nächste Mal eingeschaltet wird kommt.

#~/.config/systemd/user/borg_qt.service
[Unit]
Description = Runs Borg-Qt once in the backround to take a backup according to the configuration.

[Service]
Type = oneshot
ExecStart = /home/andreas/bin/borg_qt -B

#~/.config/systemd/user/borg_qt.timer
[Unit]
Description = Starts the borg_qt.service according to the configured schedule.

[Timer]
OnCalendar = hourly
Persistent = true

[Install]
WantedBy = timers.target

GUI Anpassungen nach Usability-Studie

Im Rahmen der durchgeführten Usability-Studie machten die User folgenden Feststellungen:

"Include" und "Exclude" Funktionen sind unklar beschriftet.
Die Funktionen sind unklar.
Texte sind nicht einheitlich.

Die Korrekturen wurden im Rahmen der Diplomarbeit angepasst.

In den "Include" sowie "Exclude" Optionen wurden einige Buttons neu beschriftet und zwei Labels hinzugefügt, nun wird klarer auf ihre Funktion hingewiesen, Abbildungen:(fig:borgqt_settings_include_v2) und (fig:borgqt_settings_exclude_v2).

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/borgqt_settings_include_v2.png

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/borgqt_settings_exclude_v2.png

Um die Funktionen der Applikation zur erklären wurde ein Hilfe Fenster, Abbildung:(fig:borgqt_help), eingebaut. Dieses wird dem Benutzer beim Start der Applikation angezeigt. Es gibt ihm einen kurzen Überblick welcher Button welche Aktion auslöst und welche Elemente welche Information anzeigen. Optional kann der Benutzer entscheiden, dass er das Fenster beim nächsten Start nicht mehr angezeigt bekommen möchte. Über den Button "Help" kann das Fenster jederzeit unabhängig der Einstellungen wieder angezeigt werden.

/Nebucatnetzer/thesis/media/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/borgqt_help.png

Mit Fertigstellung der Anpassungen wurde die Realisierung erfolgreich abgeschlossen und die Entwicklung neuer Funktionen für den Zeitrahmen der Diplomarbeit gestoppt.

Releases

Für die finale Veröffentlichung wird Borg-Qt als ein sogenanntes ausführbares "Binary" zur Verfügung gestellt. Man kennt diese auf Windows Systemen etwa als die Dateien mit der Endung .exe. Beim Binary handelt es sich um ein selbst entpackendes Dateiarchiv. Sämtliche benötigten Python Module und sonstige Dateien wie etwa die Icons oder gls:gui Definitionsdateien sind darin enthalten.

Diese Art der Auslieferung hat den Vorteil, dass der User das Programm nicht speziell installieren muss oder dafür irgendwelche zusätzlichen Dinge installieren muss. Der Nachteil ist jedoch, dass ein solches Binary nur auf dem jeweiligen Betriebssystem erstellt und ausgeführt werden kann. Das heisst, dass man unter Linux etwa keine Binaries für Mac erstellen kann oder umgekehrt.

Das Binary wird mit dem Programm "PyInstaller"footcite:pyinstaller erstellt. PyInstaller wird auf der Kommandozeile mit Angabe der Hauptdatei des Codes ausgeführt. Der Befehl dafür ist relativ einfach, Codesnippet:(code:pyinstaller). Pfade zusätzlicher Dateien wie etwa Icons müssen mit angegeben werden. PyInstaller kann diese sonst nicht in das Binary einbinden. Der gezeigte Code wurde dabei in ein Makefile implementiert. Somit kann man in der obersten Ebene des Repository einfach den Befehl make ausführen und das Binary wird im Ordner dist erstellt.

pyinstaller --hidden-import=PyQt5.sip \
    --add-data=borg_qt/static/icons:static/icons \
    --add-data=borg_qt/static/UI:static/UI \
    -F borg_qt/borg_qt.py; \

Auf Github wird jeweils ein Release erstellt und dazu die passenden Binaries hochgeladen. Github packt dabei den Source Code beim Erstellen des Releases in ein Zip Archiv. Somit steht der exakte Source Code zu jedem Binary direkt zu Verfügung. Dies um den Regeln der gls:gpl zu folgen sowie um Benutzern die Möglichkeit zu geben den Code vor einer Nutzung zu überprüfen und als sicher zu befinden.

Kontrollieren der Testfälle

Am 25.02.2019 würden gemäss dem Zeitplan die Testfälle durchgegangen. Bis auf die Testfälle TC-18 und TC-24 konnten alle Testfälle erfolgreich durchgeführt werden. TC-18 und TC-24 konnten deshalb nicht durchgeführt werden, da diese Funktionen noch nicht implementiert wurden. TC-18 ist zwar technisch bereits möglich wurde im gls:gui jedoch noch nicht umgesetzt. Die Resultate wurden in der Tabelle:(tab:testcases) erfasst.

Ausblick/Fazit

Zielbewertung

In der nachfolgenden Tabelle:(tab:bewertete_projektziele) wurden die Ziele nach "Erfüllt", "Nicht erfüllt" oder "Teilweise erfüllt" bewertet. Die Ziel-Nr. entspricht dabei der Ziel-Nr. in der Tabelle:(tab:projektziele). In der Spalte Bemerkung wird noch kurz ausgeführt, in welcher Form das Ziel bewiesen wurde.

Ziel-Nr.\cellcolor[HTML]{C0C0C0}	Muss\cellcolor[HTML]{C0C0C0}	Bewertung\cellcolor[HTML]{C0C0C0}	Bemerkung\cellcolor[HTML]{C0C0C0}
1.	x	Erfüllt	Wurde in der Sektion: Cross-plattform Kompatibilität mit einem Proof of Concept bewiesen.
2.	x	Erfüllt	Die Lizenz der Anwendung ist unter diesem Link im öffentlichen Repository von Borg-Qt einsehbar: https://github.com/borg-qt/borg-qt/blob/master/LICENSE
3.	x	Erfüllt	Wurde mit TC-04 bewiesen.
4.	x	Erfüllt	Wurde mit TC-08 bewiesen.
5.	x	Erfüllt	Wurde mit TC-16 bewiesen.
6.	x	Erfüllt	Wurde mit TC-11 bewiesen.
7.	x	Erfüllt	Wurde mit TC-04 bewiesen.
8.	x	Erfüllt	Wurde mit TC-01 - TC-03 sowie TC-19 und TC-21 bewiesen.
9.	x	Erfüllt	Wurde mit TC-04 bewiesen.
10.	x	Erfüllt	Die Konfigurationsdatei kommt standardmässig mit einer Liste an Excludes, welche für ein Linux Desktop System sinnvoll sind. Wurde mit TC-15 bewiesen.
11.	x	Erfüllt	Wurde mit TC-04 und TC-08 bewiesen.
12.		Erfüllt	Wurde mit TC-23 bewiesen. Läuft so produktiv auf dem Computer des Projektleiters.
13.		Erfüllt	Wurde mit TC-19 bewiesen.
14.		Erfüllt	Wurde mit TC-02, TC-06, TC-09, TC-13 und TC-17 bewiesen.
15.		Nicht erfüllt	Dies ist ein sehr komplexes Feature und braucht genügend Zeit, damit es richtig umgesetzt werden kann. Konnte deshalb nicht im Rahmen der Diplomarbeit realisiert werden.
16.		Erfüllt	Wurde mit TC-02, TC-05, TC-06, TC-09, TC-13 und TC-17 bewiesen. Die angezeigten Fehlermeldungen sind Meldungen von gls:borg welche 1:1 an den User durchgereicht werden.
17.		Erfüllt	Wurde mit TC-05 bewiesen.
18.		Erfüllt	Wurde mit TC-25 bewiesen.
19.		Erfüllt	Wurde mit TC-21 und TC-22 bewiesen. Läuft so produktiv auf dem Computer des Projektleiters.
20.		Nicht erfüllt	Wurde noch nicht umgesetzt.
21.		Erfüllt	Ist in der Sektion Einstellungen beschrieben. Zurzeit wird jedoch nur `$HOME` verwendet.
22.		Nicht erfüllt	Zurzeit werden noch alle Daten direkt aus dem gls:borg Repository gelesen.
23.		Nicht erfüllt	Wurde noch nicht umgesetzt.
24.		Nicht erfüllt	Wurde mangels Datenbank noch nicht umgesetzt.
25.		Nicht erfüllt	Wurde noch nicht umgesetzt.
26.		Erfüllt	Wurde mit TC-19 - TC-21 bewiesen.
27.		Nicht erfüllt	Zurzeit werden alle gemounteten Archive beim Schliessen der Anwendung wieder ausgehängt.
28.		Erfüllt	Der Benutzer kann das Repository wechseln, allerdings muss er hierzu die Anwendung neustarten. Ein fliegender Wechsel ist zur Zeit nicht unterstützt.
29.		Teilweise erfüllt	Hat der Benutzer ein Archiv gemountet kann, er darin mit einem Drittwerkzeug oder von Hand nach einer Datei suchen.
30.		Nicht erfüllt	Zurzeit gibt es keine Einstellungen zur "Retention Policy" in Borg-Qt.
31.		Nicht erfüllt	Zurzeit sind nur die Features `create`, `delete`, `mount`, `list`, `info` und `extract` zu Teilen implementiert.
32.		Nicht erfüllt	Wurde noch nicht umgesetzt.

#+LATEX:≠wpage

Risikoanalyse der neuen Ist-Situation

Das Ist-Riskio in der Sektion Risiko-Analyse könnte wie prognostiziert erhehblich gesenkt werden. Entgegen der ursprünglichen Annahme konnten die automatischen Backups doch noch während der Diplomarbeit implementiert werden. Dadurch konnte auch das Risiko Nr. 5 (Der Benutzer vergisst Backups zu machen) erheblich gesenkt werden. Somit hat die neue Ist-Situation, Abbildung:(fig:new-is-risk), eine bessere Risikobewertung als das geplante Soll-Risiko.

/Nebucatnetzer/thesis/src/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/ist_risiko_neu.pdf

Projektmanagement

Das zu Beginn erstellte Gantt Chart war sehr hilfreich, um den Überblick über das Projekt zu behalten. Anhand davon konnte immer abgeschätzt werden wie das Projekt etwa im Zeitplan steht. Durch die Annahme das an arbeitsfreien Tagen nur 6 Stunden gearbeitet wird, konnte unter der Woche auch mal ein Abend ausgesetzt werden, wenn am Wochenende zuvor einmal 8 Stunden gearbeitet wurde.

Die regelmässigen Arbeitsessions an jedem schulfreien Samstag und an den freien Montagen haben sich als eine gute Variante des Arbeiten erwiesen und haben die Last der Diplomarbeit gut verteilt.

Die konservativen Zeitschätzungen haben sich als korrekte Entscheidung erwiesen. In Zukunft kann noch stärker versucht werden die Zeit, welche für ähnliche Code Teile verwendet wird kürzer zu schätzen. Copy/Paste erlaubt unter Umständen enorme Zeitersparnise. Trotzdem sollte genügend Reserve für allfällige Herausforderungen eingeplant werden. In der Entwicklung kann es immer wieder vorkommen das man an einem Bug oder Ähnlichem hängen bleibt ohne das man es mit mehr Arbeitskräften oder Zeit schneller beheben kann.

Für die Planung der Programmierarbeiten haben sie die Use Cases und Aktivitätsdiagramme als eine grosse Hilfe erwiesen. Besonders um den roten Faden während der Entwicklung zu behalten waren sie sehr hilfreich.

Zeitaufwand

Der Zeitaufwand ist wie in Tabelle:(tab:zeitcontr) zu sehen, leicht tiefer als geplant. Dies ist vor allem auf die Zeitersparnisse bei der Realisierung zurückzuführen.

Ressourcen

Die im Projekt eingesetzten Ressourcen entsprechen den in der Tabelle:(tab:ressources) geplanten 1:1.

Kosten

Da die geleisteten Stunden tiefer als geplant waren, sind auch die geschätzten Kosten tiefer. Wie in der Tabelle:(tab:kosten) zu sehen würden sich die angenommenen, internen Kosten für die Arbeit auf ca. 17302.20 CHF belaufen. Dies stellt eine Einsparung von 1777.8 CHF dar.

Usability-Studie

Die Studie war eine sehr interessante Erfahrung. Enduser sehen eine Anwendung mit ganz anderen Augen als der Entwickler der Anwendung. Dieser weiss von jedem Element wie der Code dazu aussieht. Es wurde auch klar, dass die Aufgaben in einer Studie richtig gestellt werden müssen. Ansonsten wissen die Probanden schon gar nicht erst was von ihnen gefordert wird.

Auch sollte, wenn möglich, darauf geachtet werden, dass auf einem Betriebssystem getestet mit welchem die Probanden bereits etwas Erfahrung haben. Zwei der Probanden waren ab dem Verhalten und Aussehen des Dateimanagers von Ubuntu 18.04 etwas verwirrt. Sie hatten ihn zuvor weder gesehen noch genutzt. Alternativ könnte auch die Gruppe der Probanden so gewählt werden, dass sie mit dem Betriebssystem bereits vertraut sind.

Eine Usability-Studie ist auf jeden Fall etwas, was man bei zukünftigen Software Projekten, wieder machten sollte.

Umsetzung

Die Entwicklung mit Qt und Python ging sehr gut von der Hand. Die grafische Erstellung des gls:gui mit dem Qt Designer war sehr hilfreich und hat es ermöglicht mit den Elementen auch einfach mal zu spielen, um zu sehen was passt und was eher weniger geht. Qt selbst ist ein gutes und sehr umfangreiches Framework. Das die Dokumentation den Fokus hauptsächlich auf C++ Code hat, machte es einem zu Beginn etwas schwieriger die gewünschte Information zu finden.

Python als Programmiersprache hat sich in der Entwicklung als gute Entscheidung bewährt. Die Entwicklung ging schnell und unkompliziert von der Hand. Python wurde, als eine sehr flexible Sprache wahrgenommen die einem bei der Entwicklung aus dem Weg geht.

Die eingesetzten glspl:unittest waren hilfreiche Werkzeuge bei der Entwicklung. Gegen Ende der Entwicklung wurden sie jedoch weniger eingesetzt da die Entwicklung davon doch etwas Zeit beansprucht und auch ein gewisses Mass an Erfahrung. Wenn man zuerst noch Recherchieren muss wie man den gls:unittest schreibt verliert man wertvolle Zeit die man, während einer Diplomarbeit nicht zur Verfügung hat.

Diejenigen Tests die jedoch geschrieben wurden haben sich, als sehr hilfreich erwiesen einem ein Art Sicherheitsnetz zu bieten in dem sie aufgezeigt haben das nach einer grösseren Änderung immer noch alles so funktionert, wie es sollte. Es ist schade das glspl:unittest an der IBZ nicht gelehrt wurden. Sie scheinen definitiv etwas zu sein was jeder Programmierer beherrschen sollte und die Grundlagen für jedes Projekt, das über ein paar Zeilen hinausgeht, sein sollten. glspl:unittest werden mit Sicherheit eines der Hauptthemen zum Lernen in den nächsten paar Monaten sein.

Weiterverwendung von Borg-Qt

Borg-Qt wird als Freizeitprojekt des Projektleiters weiter geführt. Ein paar der Kann-Ziele wären noch sehr nützlich wären sie in der Applikation integriert. Zudem sind ein paar davon interessante Aufgaben um die eigenen Fähigkeiten zu erweitern. Nach Abschluss der Diplomarbeit wird die Entwicklung der Anwendung dann auch für Externe geöffnet. Vonseiten der gls:borg Community kam zum Zeitpunkt der Arbeit noch kein spezifisches Feedback zurück. Die Hoffnung besteht, dass sich allenfalls noch ein, zwei Interessierte finden, um am Projekt mitzuarbeiten.

Die Applikation wird aber auf jeden Fall vom Projektleiter produktiv eingesetzt, um seine sowie teilweise auch die Daten von Bekannten zu sichern.

Anhang

Ressourcen

Ressource\cellcolor[HTML]{C0C0C0}	geschätzte Anzahl\cellcolor[HTML]{C0C0C0}	effekt. Anzahl\cellcolor[HTML]{C0C0C0}	Begründung\cellcolor[HTML]{C0C0C0}
Projektleiter/Mitarbeiter	1	1	keine Abweichung
Diplombetreuer	1	1	keine Abweichung
Testuser	5	5	keine Abweichung
Korrekturleser	3	3	keine Abweichung
iPad	1	1	keine Abweichung
Notebook	1	1	keine Abweichung

Kosten

Name\cellcolor[HTML]{C0C0C0}	geschätzter Aufwand in h\cellcolor[HTML]{C0C0C0}	geschätzte Kosten in CHF\cellcolor[HTML]{C0C0C0}	effektiver Aufwand in h\cellcolor[HTML]{C0C0C0}	effektive Kosten in CHF\cellcolor[HTML]{C0C0C0}
Initialisierung	22	1320	20.3	1218.
Analyse	47	2820	41.6	2496.
Konzept	34	2040	35.1	2106.
Realisierung	172	10320	149.3	8958.
Ausblick	8	480	7.5	450.
Dokumentation korrigieren	20	1200	22.7	1362.
Meeting #1	5	300	6.87	412.2
Meeting #2	5	300	3	180
Meeting #3	5	300	2	120
Total	318	19080	288.37	17302.2

Zeitaufwand

Aufgabe\cellcolor[HTML]{C0C0C0}	Gesch. Aufwand in h\cellcolor[HTML]{C0C0C0}	Effekt. Aufwand in h\cellcolor[HTML]{C0C0C0}	Begründung\cellcolor[HTML]{C0C0C0}
Initialisierung	22	20.3	Das bescheiben der Ziele hat weniger Zeit in Anspruch genommen als geplant.
Analyse	47	41.6	Da Diagramme aus alten Arbeiten übernommen werden konnten, konnte etwas Zeit eingespart werden.
Konzept	34	35.1	Die Testfälle erstellen hat etwas mehr Zeit in Anspruch genommen als geplant.
Realisierung	172	149.3	Trotz der Schwierigkeiten beim Erstellen der Backup Funktion konnte beim Borg Interface viel Code wieder verwendet werden was massiv Zeit gespart hat.
Ausblick	8	7.5	-
7 Arbeit korrigieren	20	22.7	Das Korrigieren war aufwändiger als gedacht.
8 Meeting #1	5	6.87	Das erste Meeting hat viele Nacharbeiten nach sich gezogen die so nicht geplant waren.
9 Meeting #2	5	3	Das zweite Meeting hat weit weniger Zeit benötigt und auch viel weniger Nacharbeiten nach sich gezogen.
10 Meeting #3	5	2	Beim dritten Meeting ging es hauptsächlich nur noch um kleinere Details.
Total	318	288.37

#+LATEX:\begin{landscape}

Testfälle

#+LATEX:{\footnotesize

ID\cellcolor[HTML]{C0C0C0}	Objective\cellcolor[HTML]{C0C0C0}	Precondition\cellcolor[HTML]{C0C0C0}	Steps\cellcolor[HTML]{C0C0C0}	Testdata\cellcolor[HTML]{C0C0C0}	Expected Result\cellcolor[HTML]{C0C0C0}	Postcondition\cellcolor[HTML]{C0C0C0}	Result\cellcolor[HTML]{C0C0C0}
TC-01	Anwendung starten	Lokales Repository initialisiert.≠wline Lokale Konfigurationsdatei erstellt.	1. Anwendung starten.	-	Die Anwendung startet ohne Fehlermeldung und zeigt eine leere Backup Liste an.	Die Anwendung wird angezeigt.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-02	Anwendung starten	Lokale Konfigurationsdatei erstellt.	1. Anwendung starten.	-	Die Anwendung wirft eine Fehlermeldung das sie das lokale Repository nicht finden kann.	Die geöffnete Fehlermeldung blockiert die Applikation.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-03	Anwendung starten	-	1. Anwendung starten.	-	Die wirft eine Fehlermeldung das sie die Konfigurationsdatei nicht finden kann.	Die geöffnete Fehlermeldung blockiert die Applikation.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-04	Lokales Backup erstellen	TC-01 ausgeführt.	1. In der Ordnerübersicht das Code Repository auswählen.≠wline 2. Den Button “Backup” betätigen.	Testdateien	Die Anwendung zeigt einen Fortschrittsbalken der nach erfolgreichem Backupen verschwindet.	Die Archiv Liste wird aktualisiert und zeigt ein Archiv an.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-05	Lokales Backup erstellen	TC-01 ausgeführt.≠wline gls:borg erstellt bereits ein Archiv.	1. In der Ordnerübersicht das Code Repository auswählen.≠wline 2. Den Button “Backup” betätigen.	Testdateien	Die Anwendung wirft eine Fehlermeldung das gls:borg bereits ausgeführt wird.	Die geöffnete Fehlermeldung blockiert die Applikation.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-06	Lokales Backup erstellen	TC-01 ausgeführt.	1. Das Lokale Repository an einen beliebigen Ort verschieben.≠wline 2. In der Ordnerübersicht das Code Repository auswählen.≠wline 3. Den Button “Backup” betätigen.	Testdateien	Die Anwendung wirft eine Fehlermeldung das sie das lokale Repository nicht finden kann.	Die geöffnete Fehlermeldung blockiert die Applikation.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-07	In lokales Repository sichern	TC-01 ausgeführt.	1. Den Button “Backup” betätigen.	-	Die Anwendung wirft eine Fehlermeldung das der User einen Pfad angeben soll.	Die geöffnete Fehlermeldung blockiert die Applikation.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-08	Lokales Archiv löschen	TC-04 ausgeführt.	1. In der Backup Liste das Backup auswählen.≠wline 2. Den Button “Delete” betätigen.	-	Die Anwendung zeigt einen Fortschrittsbalken der nach erfolgtem Löschen verschwindet.	Die Archiv Liste wird aktualisiert und ist nun leer.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-09	Lokales Archiv löschen	TC-04 ausgeführt.	1. Das Lokale Repository an einen beliebigen Ort verschieben.≠wline 2. In der Archiv Liste das Archiv auswählen.≠wline 3. Den Button “Delete” betätigen.	-	Die Anwendung wirft eine Fehlermeldung das sie das lokale Repository nicht finden kann.	Die geöffnete Fehlermeldung blockiert die Applikation.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-10	Lokales Archiv löschen	TC-04 ausgeführt.	1. Den Button “Delete” betätigen.	-	Die Anwendung wirft eine Fehlermeldung das der User ein Archiv auswählen soll.	Die geöffnete Fehlermeldung blockiert die Applikation.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-11	Lokales Archiv wiederherstellen	TC-04 ausgeführt.	1. In der Archiv Liste das Archiv auswählen.≠wline 2. Den Button “Restore” betätigen.≠wline 3. Im geöffneten Dateidialog den Pfad "/home/andreas/Downloads" auswählen.≠wline 4. Den Button “Open” anklicken.	-	Nach erfolgtem Wiederherstellen öffnet ein Dateiexplorer den Ziel Pfad.	Die Anwendung und ein Dateiexplorer wird angezeigt.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-12	Lokales Archiv wiederherstellen	TC-01 ausgeführt.	1. Den Button “Backup” betätigen.	-	Die Anwendung wirft eine Fehlermeldung das der User ein Archiv auswählen soll.	Die geöffnete Fehlermeldung blockiert die Applikation.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-13	Lokales Archiv wiederherstellen	TC-04 ausgeführt.	1. Das Lokale Repository an einen beliebigen Ort verschieben.≠wline 2. In der Archiv Liste das Archiv auswählen.≠wline 3. Den Button “Restore” betätigen.	-	Die Anwendung wirft eine Fehlermeldung das sie das lokale Repository nicht finden kann.	Die geöffnete Fehlermeldung blockiert die Applikation.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-14	Lokales Archiv wiederherstellen	TC-01 ausgeführt.	1. In der Archiv Liste das Archiv auswählen.≠wline 2. Den Button “Restore” betätigen.≠wline 3. Im geöffneten Dateidialog den Pfad "/home/andreas/Downloads" auswählen.≠wline 4. Den Button “Cancel” anklicken.	-	Der Datei Dialog schliesst sich wieder.	Die Anwendung wird angezeigt.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-15	Home Directory sichern und wiederherstellen	TC-01 ausgeführt.	1. Vom Pfad "home/andreas" ein Archiv erstellen.≠wline 2. In der Archiv Liste das gemachte Archiv auswählen.≠wline 3. Den Button “Restore” betätigen.≠wline 4. Im geöffneten Dateidialog den Pfad "/home/andreas/Downloads" auswählen.≠wline 5. Den Button “Open” anklicken.	"home/andreas"	Nach erfolgtem Wiederherstellen öffnet ein Dateiexplorer den Ziel Pfad.≠wline Darin fehlen jedoch temporäre Pfade wie “~/.cache” etc.	Die Anwendung und ein Dateiexplorer wird angezeigt.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-16	Einzelne Datei wiederherstellen	TC-04 ausgeführt.	1. In der Backup Liste das Backup auswählen.≠wline 2. Den Button “Mount” betätigen.≠wline 3. Aus dem sich öffnenden Dateiexplorer die Datei README.org nach "/home/andreas/Downloads" kopieren.	-	Die wiederhergestellte Datei ist identisch mit der in TC-04 gesicherten.	Die Anwendung und ein Dateiexplorer wird angezeigt.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-17	Einzelne Datei wiederherstellen	TC-01 ausgeführt.	1. Das Lokale Repository an einen beliebigen Ort verschieben.≠wline 2. In der Archiv Liste das Archiv auswählen.≠wline 3. Den Button “Mount” betätigen.	-	Die Anwendung wirft eine Fehlermeldung das sie das lokale Repository nicht finden kann.	Die geöffnete Fehlermeldung blockiert die Applikation.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-18	Pfad des lokalen Backup Repository anpassen	TC-04 ausgeführt.≠wline Backup Repository nach "/tmp/test-borgqt2" verschoben	1. Den Button "Settings" betätigen.≠wline 2. Den Repository Pfad auf "tmp/test-borgqt2" ändern.≠wline 3. Den Button "Apply" betätigen.	-	Die Archiv Liste wird aktualisiert und zeigt wieder das Archiv von TC-04 an.	Die Anwendung wird angezeigt. Die Konfigurationsdatei zeigt auf den neuen Pfad.	Nicht implementiert
TC-19	Archiv Name ändern	TC-01 ausgeführt.	1. Den Button "Settings" betätigen.≠wline 2. Bei der Option "Archive Prefix" "Muster" eintragen.≠wline 3. Den Button "Apply" betätigen.≠wline 4. TC-04 durchführen.	Archiv Name: Muster	Die Anwendung zeigt einen Fortschrittsbalken der nach erfolgtem Backup verschwindet.	Die Archiv Liste wird aktualisiert und zeigt ein Archiv mit dem Präfix "Muster" an. Die Konfigurationsdatei beinhaltet die Option des Präfixes.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-20	Keine Einstellungen ändern	TC-01 ausgeführt.	1. Den Button "Settings" betätigen.≠wline 2. Eine beliebige Option ändern.≠wline 3. Den Button "Cancel" betätigen.	-	Der Einstellungsdialog schliesst sich.	Die Anwendung wird angezeigt. Die Konfigurationsdatei ist noch im selben Zustand wie bei TC-01.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-21	Automatische Backups konfigurieren	TC-01 ausgeführt.	1. Den Button "Settings" betätigen.≠wline 2. Bei der Option "Includes" die Testdateien angeben sowie unter Schedule "Custom" auswählen und bei "Time" die nächste Stunde angeben.≠wline 3. Den Button Apply betätigen.	Backupzeit: 2 Minuten nach aktueller Zeit Testdateien	Der Datei Dialog schliesst sich wieder.	Die Anwendung wird angezeigt. Die Konfigurationsdatei wurde um die Option des automatischen Backups erweitert. Die Anwendung hat einen "Service" auf dem System erstellt.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-22	Automatische Backups durchführen	TC-16 ausgeführt.	1. TC-21 durchführen.≠wline 2. Auf Ablauf der Zeit warten.≠wline 3. Die Anwendung öffnen.	-	In der Archiv Liste wird ein Archiv angezeigt.	Die Anwendung wird angezeigt.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-23	Server Archiv erstellen	Server Repository bereit.≠wline Server Konfigurationsdatei erstellt.	TC-04 durchführen.	Testdateien	Die Anwendung zeigt einen Fortschrittsbalken der nach erfolgtem Backup verschwindet.	Die Archiv Liste wird aktualisiert und zeigt ein Archiv an.	Erfolgreich durchgeführt 25.02.2019 A.Z.
TC-24	Lokales Archiv erstellen während dem eine VM läuft	TC-01 ausgeführt.≠wline Virtualbox VM Starten.	1. In der Ordnerübersicht das Code Repository auswählen.≠wline 2. Den Button “Backup” betätigen.	Testdateien	Die Anwendung wirft eine Fehlermeldung aus das es zur Zeit aufgrund einer laufenden VM unsicher sei ein Backup durchzuführen.	Die geöffnete Fehlermeldung blockiert die Applikation.	Nicht implementiert
TC-25	Abgebrochenes Backup bereinigen	TC-01 ausgeführt.	1. In der Ordnerübersicht das Code Repository auswählen.≠wline 2. Den Button “Backup” betätigen.≠wline 3. Die Anwendung schliessen.≠wline 4. Anwendung wieder öffnen.≠wline 5. TC-04 Durchführen.	Testdateien	Bei Schritt 4. sollte ein Teilarchiv zu sehen sein.≠wline Bei Schritt 5 sollte einfach ein normales Archiv zu sehen sein.	Die Anwendung wird angezeigt.	Erfolgreich durchgeführt 25.02.2019 A.Z.

#+LATEX:} #+LATEX:\end{landscape}

#+LATEX:≠wpage #+LATEX:\begin{landscape}

Klassendiagramm

/Nebucatnetzer/thesis/src/commit/86a01a96ea6c20adbf2a9cab3f8a6b002a87001b/projektdokumentation/pictures/class_diagramm.pdf #+LATEX:\end{landscape}

#+LATEX:≠wpage #+LATEX:\begin{landscape}

Arbeitsjournal

Von/Bis\cellcolor[HTML]{C0C0C0}	Geplante Arbeiten\cellcolor[HTML]{C0C0C0}	Erreichte Arbeiten\cellcolor[HTML]{C0C0C0}	Eindruck\cellcolor[HTML]{C0C0C0}
10.-16.12.2018	Zeitplan erarbeiten, Ziele dokumentieren	keine Abweichung	-
17.-23.12.2018	Lösungsvarianten erfassen, Lösungsvarianten bewerten, Lösungsvariante bestimmen, SWOT Analyse erstellen, 1. Meeting	keine Abweichung	Marco Frei hat noch diverse Punkte eingebracht, die die Planung ziemlich durcheinander bringen. Bedeute viel zusätzliche Arbeit.
24.-30.12.2018	Controlling erarbeiten, Ist- und Soll-Analyse, SWOT Analyse, Umweltanalyse, Massnahmen Katalog erarbeiten, User Stories erarbeiten, Use Case Diagramm erstellen, Use Cases ausarbeiten, Anforderungskatalog erstellen, UML Diagramme	keine Abweichung	UML Diagramme für eine Software zu erstellen die nicht existiert ist noch eine interessante Herausforderung.
31.12-06.01.2019	Lösungsvarianten erarbeiten und entscheiden, Test Konzept beschreiben und Testfälle erstellen, Github Repository erstellen	Testfälle liessen sich noch nicht für alle Ziele erstellen. Gewisse Features hängen noch sehr davon ab, wie die Basis der Applikation sich entwickelt.	Insgesamt gut gelaufen. Das Repository auf Github konnte ich unter einer eigenen Organisation erstellen, dadurch wird das Zusammenarbeiten in der Zukunf einfacher.
07.-13.01.2019	UI ausarbeiten, UI Test ausarbeiten	keine Abweichung	Da das Projekt gut im Zeitplan ist besteht zur Zeit ein positiver Eindruck.
14.-20.01.2019	Backend "Read Config" Funktion schreiben, Frontend "Read Config" Funktion beginnen	"Frontend Read Config", "Backend Write Config", "Frontend Write Config", Funktion bereits abgeschlossen.	Soweit sehr gut im Zeitplan. Die Arbeitssessions mit den Kollegen helfen. Seltsam das Qt keine Methode list.items() kennt.
21.-27.01.2019	"Backend Backup" Funktion, "Frontend Backup" Funktion beginnen, Automatische Backups recherchieren	keine Abweichung	Erkältung drückt etwas auf die Performance. gls:unittest sind nocht nicht perfekt aber sind eine grosse Hilfe.
28.-03.02.2019	"Frontend Backup" Funktion fertigstellen, "Backend und Frontend Restore" Funktion	Geplantes erreicht sowie "Mounting" und "Delete" Funktion sowohl im Backend wie auch im Frontend bereits umgesetzt.	Da die Funktionen immer von gls:borg ausgeführt werden konnte sehr viel Code von den "Backup" und "Restore" Funktionen übernommen werden, was die Entwicklung sehr beschleunigt hat.
04.02.-10.02.2019	Meeting Pendenzen nochmal durchgehen. Die Interface Funktionen bereinigen. Automatische Backups implementieren.	Meeting Pendenzen wurden aufgenommen und das Interface wurde bereinigt. Automatische Backups konnten noch nicht fertig gestellt werden.	Automatische Backups sind noch relativ komplex und benötigen Kenntnisse der Systemd Timer.
11.02.-17.02.2019	UI Tests mit den Usern durchführen, Resultate auswerten, Feedback in Applikation einarbeiten	keine Abweichung	Es ist sehr spannend zu sehen wie Benutzer mit der Anwendung interagieren und welche Featues sie vermissen.
18.02.-24.02.2019	Automatische Backups implementieren, 1. Release veröffentlichen, Readme updaten	keine Abweichung	Das Projekt ist soweit sehr gut im Zeitplan. Die Systemd Timer sind können mit vielen verschiedenen Zeitformaten umgehen und sind sehr flexibel.
25.02.-03.03.2019	Testfälle durchgehen, Dokumentation zur Realisierung abschliessen	keine Abweichung	Das Projekt befindet sich immer noch auf gutem Kurs. Nun fehlt noch der Feinschliff.
04.03.-10.03.2019	Ausblick abschliessen, Controlling abschliessen	keine Abweichung	-
11.03.-18.03.2019	Korrekturen der Korrekturleser einarbeiten, Abgabe	keine Abweichung	-

#+LATEX:\end{landscape}

Meeting Protokolle

Die Meeting Protokolle sind in der Datei 03_Meeting_Protokolle.pdf zu finden.

279 KiB Raw Blame History

Projekthandbuch

Über dieses Dokument

Beschreibung

Zweck und Inhalt

Aufbau

Lizenz

Initialisierung

Vision

Ausgangslage

Projektziele

Ziele inklusive Gewichtung

Projektabgrenzung

Projektmethode

Konfigurationsmanagement

Versionskontrolle

Editor

Dokumentation

Zeitplanung

Controlling

Zeitaufwand

Ressourcen

Kosten

Projektrisiken

Risikobeschreibung

Analyse

SWOT-Analyse

Umweltanalyse

Risiko-Analyse

Anforderungskatalog

Use Cases

Anwendungsfalldiagramm

Use Cases Detailbeschreibung

Use Case 1.0 Backup erstellen

Use Case 2.0 Backup löschen

Use Case 3.0 Backup wiederherstellen

Use Case 4.0 Einzelne Datei wiederherstellen

Use Case 4.1 Backup mounten

Use Case 5.0 Konfiguration ändern

Use Case 6.0 automatische Backups aktivieren

Benötigte Funktionalität von Borg

Konzept

Varianten

Bewertung

Backend

C#

C++

Python

Frontend

Qt

Gtk

Electron

Ergebnis

Applikationsname

Testing

Klassendiagramm

Usability-Studie

Aufgaben

Resultate

Proband 1

Proband 2

Proband 3

Proband 4

Probandin 5

Auswertung

Realisierung

Cross-plattform Kompatibilität

Benutzerinterface

Inspiration

Erste Umsetzung

Einstellungen

Backend

Frontend

Borg Interface

Backup

Backend

Frontend

Restore

Mount

Delete

279 KiB

Raw Blame History