Deinstallation und erneute Anmeldung

Einen Endpoint zu entfernen hat zwei Teile: den Agent auf dem Rechner entfernen und den Endpoint in Restow sperren. Bereits vorhandene Backups bleiben in beiden Fällen in Ihrem Speicherziel. Seit 0.4.5 ist ein dritter Schritt möglich: den gesperrten Rechner aus Restow entfernen, wobei seine Backups sofort oder bei Ablauf gelöscht werden (unten).

Den Agent auf dem Rechner entfernen

sudo restow-agent uninstall

In einem Terminal fragt der Befehl zuerst nach einer Bestätigung. --yes überspringt die Frage. Wird restow-agent nicht gefunden, nutzen Sie den vollen Pfad: sudo /opt/restow-agent/bin/restow-agent uninstall unter Linux, sudo '/Library/Application Support/Restow/bin/restow-agent' uninstall unter macOS.

Ist der Agent defekt oder schon weg, nutzen Sie das Installationsskript mit --uninstall. Das Skript entfernt auch Überreste, wenn die Binärdatei restow-agent fehlt.

# Linux
curl -fsSL 'https://<your instance>/install/linux.sh' | sudo sh -s -- --uninstall
# macOS
curl -fsSL 'https://<your instance>/install/macos.sh' | sudo sh -s -- --uninstall

Was entfernt wird

• der Dienst (die systemd-Unit oder der LaunchDaemon),
• der Ordner /etc/restow-agent: die gespeicherten Zugangsdaten und die Hook-Regel (state.json) sowie die Hook-Skripte in hooks.d,
• die Arbeitsdaten (/var/lib/restow-agent: Cache, temporäre Dateien, Status, nicht zugestellte Lauf-Berichte),
• die Binärdateien restow-agent, restow-agent.prev und restic in /opt/restow-agent/bin (macOS: /Library/Application Support/Restow/bin), die Lizenzhinweise THIRD_PARTY_NOTICES.txt neben diesem Ordner, die Ordner, sobald sie leer sind, und der Link /usr/local/bin/restow-agent,
• der Log-Ordner /var/log/restow-agent.

Bewahren Sie eine Kopie Ihrer Hook-Skripte an anderer Stelle auf, wenn Sie sie noch brauchen.

Optionen

Option	Wirkung
--yes	Nicht nach einer Bestätigung fragen.
--keep-logs	Den Log-Ordner behalten.

Was bleibt

Die Backups bleiben auf der Instanz, in Ihrem Speicherziel. Der Endpoint bleibt außerdem in Restow, bis Sie ihn sperren, und bis dahin wendet der tägliche Aufbewahrungslauf seine Regeln weiter auf die Backups an. Ein Server, der entfernt, aber nicht gesperrt wurde, wird nach 2 Stunden als „Meldet sich nicht“ gemeldet.

Sperren und Deinstallieren löschen nichts. Ein gesperrter Endpoint wird nicht mehr bereinigt, seine Snapshots bleiben also, wie sie sind, und Sie können sie weiterhin durchsuchen und Dateien als ZIP herunterladen. Nur Aus Restow entfernen löscht die Backups (seit 0.4.5, siehe unten); vor 0.4.5 gab es keinen Weg, einen gesperrten Rechner zusammen mit seinen Sicherungsständen zu löschen. Siehe Restore. Seit 0.4.0 ist ein gesperrter Rechner im Inventar ausgeblendet, bis Sie Gesperrte Rechner anzeigen wählen, und Datei-Restore führt ihn in einer eigenen Gruppe, Gesperrte Rechner. Alle Rechner zu sperren oder zu deinstallieren ist außerdem der erste Schritt, wenn Sie das primäre Speicherziel des Mandanten wechseln wollen, was der Server ablehnt, solange Endpoints aktiv sind (siehe Überblick).

In Restow sperren oder deinstallieren

Öffnen Sie den Rechner unter Server & Clients → Inventar, den Tab Einstellungen und den Bereich Sicherung dieses Rechners beenden (vor 0.4.0 hieß er Rechner entfernen). Keine der beiden Aktionen löscht den Rechner oder seine Backups: Der Rechner bleibt als gesperrt im Inventar, ausgeblendet, bis Sie gesperrte Rechner einblenden, und vorhandene Backups bleiben wiederherstellbar.

Aktion	Was passiert
Agent deinstallieren	Restow sendet eine Deinstallations-Aufgabe. Der Agent entfernt sich bei seinem nächsten Kontakt selbst vom Rechner, und der Endpoint wird dabei gesperrt. Ist der Rechner aus oder offline, wartet das, bis er sich meldet; seit 0.4.5 bietet die Seite dann Jetzt sperren an.
Rechner sperren	Der Rechner wird sofort abgewiesen: keine Backups und keine Aufgaben mehr. Der Agent bleibt installiert und versucht es weiter, bis Sie ihn auf dem Rechner deinstallieren. Ein Sperren lässt sich nicht rückgängig machen. Um den Rechner wieder zu sichern, melden Sie ihn neu an.

Nutzen Sie Agent deinstallieren, wenn der Rechner erreichbar ist. Nutzen Sie Rechner sperren, wenn er verloren, gestohlen oder nicht erreichbar ist oder wenn Sie ihn sofort abschneiden wollen. Beides steht im Audit-Log (endpoint.uninstall.requested, endpoint.revoked).

Einen Rechner aus Restow entfernen (seit 0.4.5)

Ein gesperrter Rechner lässt sich aus Restow entfernen, mit oder ohne seine Sicherungen. Ein Rechner, der nicht gesperrt ist, lässt sich nicht entfernen („Sperren Sie den Rechner zuerst“). Öffnen Sie den gesperrten Rechner (wählen Sie zuerst Gesperrte Rechner anzeigen), seinen Tab Einstellungen und den Bereich Sicherung dieses Rechners beenden, und wählen Sie Aus Restow entfernen. Auch der Detailbereich des Rechners im Inventar bietet Aus Restow entfernen an, sobald der Rechner gesperrt ist. Sie wählen zwischen zwei Wegen:

Wahl	Was passiert
Aus der Liste entfernen, Sicherungen bis zum Ablauf behalten	Die Sicherungen bleiben gespeichert, bis die Aufbewahrung des Rechners die neueste von ihnen hätte gehen lassen, dann werden sie gelöscht. Dieses Datum ist die neueste Sicherung plus die längste Regel der Aufbewahrung des Rechners, als Zeit gelesen (N Tage, N Wochen, N Kalendermonate; mit der Voreinstellung zwölf Monate). Die Regeln von restic zählen Snapshots, nicht Zeit, und würden auf einem Rechner, der nicht mehr sichert, die letzten für immer behalten. Eine Aufbewahrung ohne Regel behält alles, und diese Wahl wird dafür abgelehnt.
Rechner und seine Sicherungen löschen	Jede Sicherung des Rechners wird jetzt gelöscht. Das wird abgelehnt, solange eine Legal Hold über den ganzen Mandanten oder ein ungeklärter verdächtiger Sicherungsstand des Rechners sie hält.

Das Entfernen braucht einen Mandanten-Administrator, den zur Bestätigung eingegebenen Hostnamen und eine Anmeldung aus den letzten 10 Minuten. Es lässt sich nicht rückgängig machen: Gelöschte Sicherungen lassen sich nicht wiederherstellen. Danach:

• Der Rechner verschwindet aus jeder Liste, Auswahl, Übersicht und Zählung und aus seinem Backup-Job. Seine Läufe, Berichte und Audit-Einträge bleiben, der Verlauf und das Audit-Log nennen ihn also weiter.
• Der Worker löscht das Repository des Rechners (endpoints/<Endpoint-ID>/) auf jedem Speicherziel, das Dateien davon hält: das primäre, seine Kopien und die stillgelegten primären Ziele eines Wechsels des primären Repositorys. Er tut es sofort bei Löschen und wenn die Sicherungen ablaufen bei „behalten“.
• Holds werden beachtet. Hält eine Legal Hold über den Mandanten oder ein ungeklärter verdächtiger Sicherungsstand die Sicherungen, wird nichts gelöscht, und der Worker prüft nach einem Tag erneut, auch wenn die Sicherungen ablaufen. Objekte, die der Speicher noch sperrt (S3 Object Lock, die Löschverzögerung eines Verzeichnisses), werden zurückgestellt, bis ihre Sperre abläuft, wie ein verweigertes Prune vermerkt und von der Verlängerung der Sperren ausgenommen.
• Das Inventar führt die noch ausstehenden Entfernungen auf, unter den Rechnern, als Sicherungen von N entfernten Rechnern, jeweils mit Gelöscht am einem Datum, Wird gelöscht, der Sperre (Teils bis ein Datum vom Speicher gesperrt, danach gelöscht) oder der Hold (Gehalten von einer Legal Hold über den ganzen Mandanten, Gehalten von einem ungeklärten verdächtigen Sicherungsstand).
• Jeder Schritt wird auditiert: endpoint.removed, endpoint.removal.held, endpoint.removal.deferred, endpoint.removal.completed und endpoint.removal.failed.

Eine Anfrage, die sich nicht ausführen lässt, antwortet mit einem stabilen Code: 409 endpoint-not-revoked, endpoint-removal-legal-hold, endpoint-removal-suspicion-hold oder endpoint-removal-never-expires und 422 endpoint-confirm-hostname (der Hostname stimmt nicht).

Entfernte Rechner behalten ihre Sicherungen durchsuchbar (seit 0.4.6). Bis die Sicherungen gelöscht sind, bietet die Seite eines entfernten Rechners deren Wiederherstellung an und sonst nichts: Die Sicherungsstände, das Durchsuchen, der ZIP-Download und das Repository-Passwort funktionieren für sie weiter, auditiert wie bei einem gesperrten Rechner, und Dateien wiederherstellen in der Liste der Entfernungen öffnet Datei-Restore für diesen Rechner. Das Wiederherstellen auf den Rechner und jede andere Aktion bleiben abgelehnt (404). Sind die Sicherungen gelöscht, ist der Rechner für jeden Leser weg. In 0.4.5 war das ein bekanntes Problem: Entfernte Rechner ließen sich in der Oberfläche nicht wiederherstellen. Der Dialog Aus Restow entfernen sagt das seit 0.4.7: Vorher sagte er noch, die Dateiwiederherstellung biete die Sicherungen eines entfernten Rechners nicht mehr an.

Sperren empfohlen und Jetzt sperren. Ein Rechner, der sich länger als eine Zahl von Tagen nicht gemeldet hat, schlägt vor, ihn zu sperren: das Badge Sperren empfohlen und der Hinweis „Sperren?“ auf seiner Seite und unter dem, was Aufmerksamkeit braucht, und in seinem Detailbereich Jetzt sperren. Die Zahl der Tage stellen Sie je Rechner unter Alarme des Rechners ein (Tage ohne Kontakt bis zum Hinweis auf Sperren, standardmäßig 30). Auch eine Deinstallation, die auf einen ausgeschalteten Rechner wartet, bietet jetzt Jetzt sperren an, für einen Rechner, den es nicht mehr gibt: Sperren Sie ihn, dann entfernen Sie ihn.

Erneut anmelden

Um einen Rechner wieder zu verbinden, zum Beispiel nachdem er gesperrt wurde oder seine Zugangsdaten verloren gingen:

1. Öffnen Sie in Restow Server & Clients → Inventar und wählen Sie Neuer Server oder Neuer Client. Das Fenster zeigt einen neuen Installationsbefehl und ein neues einmaliges Token.
2. Deinstallieren Sie den Agent auf dem Rechner (siehe oben) und führen Sie den neuen Installationsbefehl wie gewohnt aus. Das Skript fragt mit verdeckter Eingabe nach dem Token.

Um stattdessen den installierten Agent zu behalten, melden Sie ihn mit enroll --force erneut an. Der Befehl liest das Token nur aus der Umgebung. Setzen Sie es deshalb in einer Root-Shell, ohne es in eine Kommandozeile zu schreiben:

sudo -s
stty -echo; printf 'Token: '; read RESTOW_TOKEN; stty echo; echo
export RESTOW_TOKEN RESTOW_URL='https://<your instance>'
/opt/restow-agent/bin/restow-agent enroll --force
/opt/restow-agent/bin/restow-agent service restart
exit

Unter macOS nutzen Sie '/Library/Application Support/Restow/bin/restow-agent' statt /opt/restow-agent/bin/restow-agent. Vermeiden Sie sudo RESTOW_TOKEN=... restow-agent enroll: Diese Form legt das Token in die Prozessliste des Rechners. Eine erneute Anmeldung behält die Hook-Regel des Rechners.

Den Installationsbefehl auf einem Rechner auszuführen, der schon angemeldet ist, meldet ihn nicht erneut an. Das Skript behält das vorhandene Enrollment.

Eine erneute Anmeldung legt einen neuen Endpoint mit eigenem Repository an. Der alte Endpoint und seine Backups bleiben in Restow, bis Sie den alten Endpoint sperren, und sie bleiben gespeichert, bis Sie ihn außerdem aus Restow entfernen und die Backups löschen (seit 0.4.5). Seine Backups verschmelzen nicht mit dem neuen.

macOS: Vollzugriff auf die Festplatte aufräumen

Die Deinstallation entfernt den Agent, ändert aber die Datenschutz-Einstellungen nicht. Entfernen Sie den Eintrag selbst:

1. Öffnen Sie System Settings > Privacy & Security > Full Disk Access.
2. Wählen Sie restow-agent und restic (aus /Library/Application Support/Restow/bin) aus, falls sie noch aufgeführt sind, und entfernen Sie sie.

Auf einem Mac, der über MDM verwaltet wird, entfernen Sie in Ihrem MDM das Privacy Preferences Policy Control Profil für den Agent.