Freigabe hinzufügen und sichern

Prüfen Sie vorab die Voraussetzungen: Der Mounter läuft, der Docker-Host hat das Modul cifs oder den NFS-Client, und der Docker-Host erreicht den Dateiserver. Ohne den Mounter sagen die Seiten das, und geplante Sicherungen von Freigaben warten. Ein Mandanten-Administrator sieht „Diese Installation sichert noch keine Freigaben. Ihr Anbieter kann das einschalten.“; der Provider-Inhaber sieht Netzlaufwerke einschalten.

Wer Freigaben hinzufügt. Mandanten-Administratoren verwalten die Freigaben ihres eigenen Mandanten. Provider-Administratoren tun dasselbe in einem Mandanten. Ein Dateiserver mit privater oder Loopback-Adresse verlangt mehr, siehe Budgets, Netzwerke und Runner: Ein Provider-Administrator darf ihn immer hinzufügen, ein Mandanten-Administrator nur mit einer Genehmigung oder einem Schalter der Installation.

Freigabe hinzufügen

Öffnen Sie Server & Clients → Freigaben und wählen Sie Freigabe hinzufügen. Der Dialog hat vier Schritte: Protokoll, Verbindung, Test und Optionen.

Protokoll. SMB (Windows, Samba, NAS) oder NFS.

Verbindung. Die Felder:

Feld	Was Sie eintragen
Server	Ein Hostname oder eine IP-Adresse, ohne `\\` oder `smb://`.
Freigabename (SMB) oder Export (NFS)	Der Name der Freigabe, zum Beispiel `Projekte` (höchstens 80 Zeichen, keines von `\ / : * ? " < > \|`), oder der exportierte Pfad, zum Beispiel `/volume1/daten`.
Unterordner	Optional. Nur diesen Ordner der Freigabe sichern. Der Container sieht dann nur diesen Ordner.
Konto und Domäne (SMB)	`backup`, `DOMÄNE\backup` oder `backup@corp.example.com`. Die Domäne kann auch in ihr eigenes Feld. Das Konto darf weder `,` noch `=` noch `/` enthalten.
Passwort (SMB)	Höchstens 256 Byte, keine Steuerzeichen. Ein Passwort mit einem Teil zwischen Kommas, der einer Mount-Option entspricht (etwa `ro` oder `exec`), wird abgelehnt.
SMB-Version	3.1.1 (empfohlen), 3.0 oder 2.1 (veraltet, ohne Verschlüsselung). Eine Freigabe mit 2.1 zeigt „SMB 2.1: veraltet“.
Verbindung verschlüsseln (SMB)	SMB-3-Verschlüsselung. Standardmäßig aus, weil viele NAS-Geräte damit langsam sind. Sie braucht SMB 3.
NFS-Version	3, 4, 4.1 oder 4.2. Standard ist NFS 4.1.

Test. Wählen Sie Verbindung testen. Der Test bindet die Freigabe einmal ein, liest ihren obersten Ordner und trennt sie wieder. Er zeigt die Ordner der obersten Ebene (und daneben Als Unterordner verwenden, wenn Sie nur einen sichern wollen) und was das Konto von den Berechtigungen lesen kann:

Ergebnis	Bedeutung
„Besitzer, Berechtigungen und Überwachungseinträge sind lesbar.“	Vollständig.
„Besitzer und Berechtigungen sind lesbar.“	Das Konto kann die Überwachungseinträge nicht lesen. Sicherungen enthalten den Besitzer und die Zugriffssteuerungsliste.
„Nur Berechtigungen: der Besitzer ist mit diesem Konto nicht lesbar.“	Dem Konto fehlt das Recht, den Besitzer zu lesen.
„NFS-Berechtigungen sind lesbar.“	NFS: Die Berechtigungen des Exports sind lesbar.
„Berechtigungen sind mit diesem Konto nicht lesbar. Dateien werden ohne sie gesichert.“	Nehmen Sie das Konto in die Sicherungs-Operatoren auf (Backup Operators), siehe das SMB-Konto.

Ein fehlgeschlagener Test nennt die Ursache und den ersten Schritt, zum Beispiel „Der Dateiserver hat das Konto abgelehnt“. Die Ursachen stehen unter Fehlerbehebung und Grenzen.

Sie können auch ohne bestandenen Test speichern, etwa wenn der Server heute Nacht ausgeschaltet ist. Restow fragt einmal nach („Ohne bestandenen Test speichern“).

Optionen. Ein Name (erscheint in der Liste, in Jobs und in Warnungen; unter den Freigaben des Mandanten eindeutig) und zwei Schalter:
- Berechtigungen sichern (an). Speichert die NTFS- oder NFS-Berechtigungen jeder Datei und jedes Ordners, damit eine Wiederherstellung sie zurückschreiben kann.
- Wiederherstellung in diese Freigabe erlauben (aus). Solange er aus ist, können Wiederherstellungen und Kopierjobs nicht in diese Freigabe schreiben. Die Wiederherstellung in die ursprüngliche Freigabe ist der Fall, in dem eine Wiederherstellung Dateien überschreibt; darum ist der Schalter aus, bis Sie anders entscheiden. Ein ZIP-Download geht immer. Siehe Wiederherstellen und Restore-Prüfung.

Wählen Sie Freigabe speichern. Der Dialog fragt dann Welcher Job sichert sie?. Eine Freigabe ohne Job wird nicht gesichert. Wählen Sie Zum Job hinzufügen (ein vorhandener Job für Freigaben, mit den Ordnern), Neuer Job oder Später.

Das Passwort

Das Passwort wird mit dem Mandantenschlüssel versiegelt und nie wieder angezeigt: Die API meldet nur, dass ein Passwort existiert. Zum Ändern öffnen Sie den Tab Einstellungen der Freigabe, Verbindung, tragen ein Neues Passwort ein und speichern („Leer behält das gespeicherte Passwort“). Die Freigabe muss nicht neu hinzugefügt werden. Lehnt der Server das Passwort ab, zeigt die Übersicht der Freigabe „Das Passwort wurde abgelehnt“ mit der Uhrzeit, und Sicherungen schlagen fehl, bis ein Test oder ein Lauf mit dem neuen gelingt.

Ändern Sie Server, Freigabenamen, Export oder Unterordner einer Freigabe, die Sicherungsstände hat, müssen Sie das bestätigen („Einen anderen Ort sichern?“): Die Sicherungsstände des alten Ortes bleiben, aber die nächste Sicherung liest alles neu und zählt als erste.

Der Backup-Job

Eine Freigabe wird von einem Backup-Job der Art Freigaben gesichert. Auf der Seite Freigaben öffnet Jobs die Liste „Jobs für Freigaben“, und Neuer Job dort öffnet den Editor „Neuer Job für Freigaben“. Eine Freigabe ist immer nur in einem Job; eine, die in einem anderen Job ist, wird erst nach Ihrer Bestätigung übernommen.

Bereich	Was Sie festlegen	Standard
Freigaben	Welche Freigaben der Job sichert, und je Freigabe welche Ordner: alles oder Ordner, die Sie in einer Live-Ansicht der Freigabe wählen (Ordner wählen).	Alles
Zeitplan	Nach Zeitplan ausführen: Jeden Tag zu einer Uhrzeit, Alle paar Stunden oder ein Cron-Ausdruck (fünf Felder), in einer Zeitzone. Höchstens einmal pro Stunde. Ohne Zeitplan läuft der Job nur, wenn ihn jemand startet.	Täglich
Aufbewahrung	Tägliche Sicherungsstände, Wöchentliche Sicherungsstände, Monatliche Sicherungsstände: wie viele Sicherungsstände jede Freigabe behält.	30 täglich, 12 wöchentlich, 12 monatlich
Ausnahmen	Temporäre und Systemdateien auslassen (eine Voreinstellung, unter dem Schalter aufgelistet), Eigene Muster (ein Muster pro Zeile, zum Beispiel `.bak` oder `Archiv/Alt`), Dateitypen auslassen, Dateien auslassen, die größer sind als* (Größe in GB).	Die Voreinstellung ist an
Offline-Dateien zurückholen	Dateien, die auf langsameren Speicher verschoben wurden (Tiering, Cloud-Synchronisation), werden ausgelassen, solange dies aus ist. Beim Lesen werden sie zuerst auf den Server zurückgeholt.	Aus
Lesen und Bandbreite	Upload-Limit (kbit/s) und Zeitfenster mit einem anderen Limit sowie Parallele Lesevorgänge (1 bis 16). Das Limit, das beim Start eines Laufs gilt, gilt für den ganzen Lauf. Leere parallele Lesevorgänge: der Standard der Installation, siehe Budgets, Netzwerke und Runner.	Kein Limit

Die Voreinstellung Temporäre und Systemdateien auslassen lässt ~$*, *.tmp, Thumbs.db, desktop.ini, .DS_Store, *.lck, $RECYCLE.BIN, System Volume Information, .snapshot, ~snapshot, #recycle, #snapshot, @eaDir und .@__thumb aus. Die Snapshot-Ordner von NetApp, Synology und QNAP sind absichtlich dabei: Ohne sie würde jeder serverseitige Snapshot erneut gesichert.

Einen eigenen Zeitplan für Restore-Prüfungen gibt es nicht: Jeder neue Sicherungsstand wird direkt nach der Sicherung geprüft, siehe Wiederherstellen und Restore-Prüfung.

Was ein Lauf tut

Ein geplanter Lauf, oder Jetzt sichern bei der Freigabe, durchläuft diese Schritte. Die Seite des Laufs zeigt die Phase.

Phase	Was geschieht
Wartet	Der Lauf wartet auf einen freien Runner, siehe Einstellungen der Runner. Ein Lauf je Freigabe gleichzeitig.
Wird vorbereitet	Der Mounter bindet die Freigabe schreibgeschützt ein, und der Runner prüft, dass es wirklich die eingebundene Freigabe ist. Er sichert keine leere Freigabe, wenn der letzte Sicherungsstand nicht leer war, siehe Eine leere Freigabe.
Ordner werden gelesen	Der Runner geht durch die Ordner: Er zählt Dateien und Bytes, liest die Berechtigungen jeder Datei (für unveränderte Dateien nutzt er die vorigen wieder) und merkt sich, was er überspringen muss.
Wird gesichert	restic liest die geänderten Dateien und schreibt sie in das Repository der Freigabe.
Wird abgeschlossen	Der Runner nimmt bis zu 20 Stichprobendateien für die Restore-Prüfung und meldet das Ergebnis. Der Lauf endet als Abgeschlossen, Mit Warnungen, Fehlgeschlagen oder Abgebrochen.

Jeder Lauf macht einen Sicherungsstand, auch wenn sich nichts geändert hat, damit Aufbewahrung und Restore-Prüfung jeden erfolgreichen Lauf sehen. Ein geplanter Lauf, der fällig wird, während die vorige Sicherung derselben Freigabe noch wartet, wird nicht ein zweites Mal eingereiht: Er wird als Abgebrochen mit dem Hinweis „Skipped: the previous run was still running“ festgehalten (der Hinweis steht im Produkt auf Englisch).

Lauf abbrechen bei einem laufenden Lauf beendet ihn. Ein Lauf, der länger dauert als die längste Laufzeit (standardmäßig 72 Stunden), wird ebenfalls beendet, siehe Einstellungen der Runner.

Einen Lauf stoppen

Seit 0.4.2 lässt sich ein Lauf einer Freigabe außer mit Lauf abbrechen auf der Seite der Freigabe auch in der Lauf-Schublade abbrechen (dem Detail eines Laufs im Verlauf), wie sich Läufe von Microsoft 365 und IMAP schon vorher abbrechen ließen. Es fragt vorher nach, und das Audit-Log hält file_share.run_cancel_requested fest.

Ein Lauf, der wartet, bis ein Runner frei ist, endet Abgebrochen, ohne zu starten.
Ein laufender Lauf erhält die Anforderung mit seiner nächsten Fortschrittsmeldung (höchstens alle 5 Sekunden). Der Runner stoppt restic mit einem Interrupt und meldet den Lauf als Abgebrochen. Einen Lauf, der die Anforderung nicht innerhalb von zwei Minuten befolgt, stoppt der Server.
Das Ende ist „Abgebrochen“, kein Fehler. Vom gestoppten Lauf wird kein Sicherungsstand, und der letzte gute bleibt der neueste.
Ein ganzer Job (seit 0.4.5). Stoppen bei einem Freigaben-Job in der Jobliste zieht seine wartenden Läufe zurück und lässt die Runner die laufenden in einer Anfrage stoppen; Jetzt starten (vor 0.4.5 Jetzt ausführen) startet ihn von Hand (Backup-Jobs).

Läufe von Proxmox-VE-Gästen und von Rechnern haben ein eigenes Stoppen (Proxmox VE, Server und Clients).

Warnungen

Ein Lauf, der Dateien übersprungen hat, endet Mit Warnungen: Der Sicherungsstand enthält alles, was sich lesen ließ, und der Lauf listet die Dateien mit der Ursache auf. Die Warnung erscheint auf der Seite Warnungen, wo eine Administration sie wie jede andere bestätigen kann.

Im Lauf	Ursache	Was Sie tun
Von einem anderen Programm gesperrt	`share.locked_files`: Die Datei ist auf dem Server mit einer Sperre geöffnet.	Sichern Sie nachts, wenn niemand Dateien geöffnet hat. Über SMB gibt es kein VSS.
Konnte nicht gelesen werden	`share.read_errors`: sonstige Fehler pro Datei.	Lesen Sie die Meldung der Datei. Oft fehlt dem Konto das Recht.
Berechtigungen konnten nicht gelesen werden	`share.acl_partial`: Das Konto darf die Berechtigungen einiger Dateien nicht lesen.	Nehmen Sie das Konto in die Sicherungs-Operatoren auf.
Offline-Datei ausgelassen	`share.offline_skipped`: Eine Datei, die auf dem Server nur als Platzhalter existiert, wurde wie im Job eingestellt übersprungen.	Schalten Sie Offline-Dateien zurückholen ein, wenn Sie sie wollen.
Weit weniger Dateien als beim letzten Mal	`share.files_dropped`: Die Freigabe enthält weniger als die Hälfte der Dateien des vorigen Sicherungsstands. Gesichert wurde, was vorhanden war.	Prüfen Sie, ob Dateien absichtlich gelöscht wurden, bevor die Aufbewahrung die älteren Sicherungsstände entfernt.

Ein Lauf behält die ersten 10.000 Dateien, die er auflistet, und zählt den Rest („N weitere sind gezählt, aber nicht aufgeführt“). Die vollständige Liste der Ursachen, auch für fehlgeschlagene Läufe, steht unter Fehlerbehebung und Grenzen.

Eine leere Freigabe

Die Aufbewahrung würde gute Sicherungsstände löschen, wenn eine leere Sicherung sie ersetzte. Restow sichert deshalb eine Freigabe nicht, die leer ist (oder deren gewählte Ordner leer sind), wenn der vorige Sicherungsstand Dateien hatte. Der Lauf scheitert mit share.empty_source („Die Freigabe ist leer“), nichts wird gesichert, und aus den Sicherungen wird nichts entfernt. Prüfen Sie die Freigabe: ein falscher Unterordner, ein Server, der das falsche Volume eingebunden hat, oder eine Freigabe, die wirklich geleert wurde. Wurde sie absichtlich geleert, wählen Sie Die leere Freigabe einmal sichern auf der Übersicht der Freigabe (oder beim fehlgeschlagenen Lauf). Das erlaubt eine leere Sicherung, danach gilt die Sperre wieder. share.include_missing ist dieselbe Prüfung für einen Ordner des Jobs, den es nicht mehr gibt.

Die Seite der Freigabe

Wählen Sie eine Freigabe in der Liste. Die Liste zeigt ihren Status (Geschützt, Mit Warnungen, Fehlgeschlagen, Läuft, Überfällig, In keinem Job, Noch keine Sicherung oder Stillgelegt), die Restore-Prüfung, die Letzte Sicherung und den Job. Die Seite der Freigabe hat die Schaltflächen Verbindung testen und Jetzt sichern und vier Tabs:

Übersicht. Schutz (Status, Restore-Prüfung, Job und Ordner, letzte Sicherung, Zahl der Sicherungsstände), der Live-Fortschritt eines laufenden Laufs (Phase, Dateien und Bytes, der aktuelle Pfad), die Größe des Repositorys im Vergleich zum Budget und die Verbindung mit dem letzten Test.
Sicherungsstände. Die Sicherungsstände mit ihren Dateien und dem, was jeder hinzufügte, der Dateibrowser, die Suche und der Dialog zum Wiederherstellen, siehe Wiederherstellen und Restore-Prüfung.
Läufe. Sicherungen, Wiederherstellungen und Kopien mit Status, Dauer, Dateien, hinzugekommenen Daten und Warnungen. Ein Lauf öffnet ein Blatt mit seinen Dateien nach Ursache, der Erklärung eines Fehlers und seinem Protokoll.
Einstellungen. Die Verbindung und das Passwort, Alle Berechtigungen neu lesen (einmal, bei der nächsten Sicherung; sonst werden nur geänderte Dateien neu gelesen), Wiederherstellung in diese Freigabe erlauben, die Genehmigung für das private Netz, der Job und die Ordner, das Budget, die Kopierjobs, die von dieser Freigabe lesen oder in sie schreiben, das Passwort des restic-Repositorys und der Bereich Stilllegen oder löschen.

Das Passwort des Repositorys

Das Repository der Freigabe ist ein gewöhnliches restic-Repository, file-shares/<Freigabe-ID>/ im primären Repository des Mandanten. Sein Passwort ist in Restow versiegelt. Passwort anzeigen in den Einstellungen zeigt es nach einer Bestätigung an, und die Aktion steht im Audit-Log. Sie brauchen es nur, um das Repository ohne diese Installation zu öffnen, etwa nach einem Totalausfall. Wer dieses Passwort und Zugriff auf das Repository hat, kann jede Sicherung der Freigabe lesen: Bewahren Sie es so sorgfältig auf wie den Master-Schlüssel.

Stilllegen, löschen

Stilllegen beendet die Sicherungen und behält die Sicherungsstände. Eine stillgelegte Freigabe steht unter „stillgelegte Freigaben anzeigen“, und Kopierjobs, die von ihr lesen oder in sie schreiben, werden ausgeschaltet. Wieder aktivieren nimmt sie zurück.
Mit allen Sicherungsständen löschen entfernt die Freigabe und jeden Sicherungsstand endgültig. Es braucht den eingetippten Namen der Freigabe und eine frische Anmeldung und lässt sich nicht rückgängig machen.
Eine Freigabe aus ihrem Job zu nehmen löscht nichts. Sie wird nur nicht mehr gesichert.

Bei einem Repository mit unveränderbaren Backups kann das Löschen die Daten nicht freigeben, bevor ihre Sperre abgelaufen ist, siehe Fehlerbehebung und Grenzen.