Richtlinie der Agenten

Eine Richtlinie der Agenten legt fest, wann die Agenten Ihrer Server und Clients eine Sicherung beginnen dürfen und wie sie sich dabei verhalten: in welchen Stunden, was mit einer Sicherung geschieht, die der Rechner verpasst hat, wie schnell sie hochladen, ob sie auf das Netzteil warten und wie oft sie es erneut versuchen. Die Richtlinie der Agenten gibt es seit 0.4.0.

Ohne Richtlinie verhalten sich die Agenten genau wie bisher. Die Standardwerte jeder Einstellung sind das, was die Agenten vor den Richtlinien taten, und eine Installation, die nichts festlegt, behält die Konfiguration ihrer Rechner Byte für Byte, mit derselben Version.

Die drei Ebenen

Eine Richtlinie hat drei Ebenen. Jede darf eine Einstellung für alles darunter festlegen, außer die Installation sperrt die Einstellung.

Ebene	Wo	Wer ändert sie	Was sie festlegt
Installation	Installation → Richtlinie der Agenten	Provider-Administratoren mit der Rolle Administrator oder Inhaber, die alle Mandanten haben. Jeder Provider-Administrator kann sie lesen.	Alle fünf Einstellungen und welche davon gesperrt sind
Mandant	Mandanten-Einstellungen → Agenten	Mandanten-Administratoren und Provider-Administratoren ab der Rolle Administrator	Alle fünf Einstellungen
Backup-Job	Der Editor eines Rechner-Jobs, der Abschnitt Richtlinie der Agenten, und sein Feld Bandbreite. Siehe Backup-Jobs.	Wer den Job ändern darf	Sicherungsfenster, Nachholen, Netzteil und Wiederholungen für die Rechner des Jobs sowie das eigene Upload-Limit des Jobs

Auf jeder Ebene ist eine Einstellung entweder festgelegt oder geerbt. Eine Ebene legt eine Einstellung fest, indem Sie sie einschalten („Für diesen Mandanten festlegen (sonst gilt der Wert der Installation)“, mit demselben Wortlaut für die Installation und einen Job). Eine Einstellung, die nicht eingeschaltet ist, übernimmt den Wert der Ebene darüber, und der Wert der Installation, oder der Standard, wenn sie keinen festlegt, steht am Anfang der Kette.

Sperren. Auf der Ebene der Installation lässt sich eine Einstellung außerdem sperren (Für alle Mandanten und Backup-Jobs sperren). Eine gesperrte Einstellung hat in jedem Mandanten und jedem Job den Wert der Installation, oder den Standard. Ein Mandant, der sie festlegen will, wird abgewiesen (agent-policy-locked, HTTP 409), und ein Job kann sie ebenfalls nicht ändern: Ein Wert, den ein Job schon vor der Sperre hatte, darf im Job stehen bleiben, wirkt aber nicht.

Das Speichern einer Richtlinie schreibt die neue Konfiguration jedes Rechners, dessen wirksame Richtlinie sich ändert, auf der Ebene der Installation in jedem Mandanten, und sagt Ihnen, wie viele Rechner das waren.

Die Einstellungen

Einstellung	Werte	Standard (wie vor den Richtlinien)
Sicherungsfenster	Tage, an denen es beginnt, eine Start- und eine Endzeit	Immer, kein Fenster
Verpasste Sicherungen nachholen	An oder aus, sobald der Rechner wieder an ist oder im nächsten Sicherungsfenster, optional nur bis zu einem Höchstalter	An, sobald der Rechner wieder an ist, jedes Alter
Upload-Limit	kbit/s oder unbegrenzt	Unbegrenzt
Nur am Netzteil	Nur am Netzteil oder auch im Akkubetrieb	Auch im Akkubetrieb
Automatische Wiederholungen	0 bis 10	5

Sicherungsfenster

Das Fenster legt fest, wann geplante Sicherungen beginnen dürfen: die reguläre Sicherung, eine nachgeholte, eine Wiederholung und das Fortsetzen einer unterbrochenen Sicherung. Im Fenster nennt Beginnt am die Tage, Von und Bis die Uhrzeiten.

Eine laufende Sicherung wird nie angehalten, wenn das Fenster endet. Sie läuft weiter, bis sie fertig ist.
Jetzt sichern beachtet das Fenster nicht, ebenso wenig Jetzt starten eines Jobs (vor 0.4.5 Jetzt ausführen) und restow-agent backup-now auf dem Rechner.
Die Tage sind die Tage, an denen das Fenster beginnt. Ein Ende, das nicht nach dem Beginn liegt, liegt am Folgetag, und zweimal dieselbe Uhrzeit heißt: der ganze Tag. Montag bis Freitag von 20:00 bis 06:00 reicht deshalb von Freitagabend bis Samstag 06:00.
Die Uhrzeiten werden in der Zeitzone des Zeitplans des Jobs gelesen. Auf der Ebene der Installation und des Mandanten werden sie in der Zeitzone des Zeitplans des jeweiligen Rechners gelesen. Die Sommerzeit folgt der Uhr an der Wand: Ein Fenster über die Nacht der Umstellung ist eine Stunde kürzer oder länger, und ein Fenster, das ganz in der ausgefallenen Stunde liegt, öffnet an dem Tag nicht.
Fällt der Termin einer täglichen Sicherung aus dem Fenster, beginnt sie, sobald sich das Fenster öffnet. Das ist pünktlich, nicht verpasst.

Verpasste Sicherungen nachholen

Eine Sicherung ist verpasst, wenn der Rechner zu ihrer Zeit aus war oder schlief und der Agent mehr als 15 Minuten später wieder lief. Die Richtlinie entscheidet dann:

Aus: auf die nächste reguläre Sicherung warten: Der Agent wartet auf die nächste reguläre Sicherung.
Sobald der Rechner wieder an ist: Der Agent holt sofort nach, im Sicherungsfenster, wenn es eines gibt.
Im nächsten Sicherungsfenster: Der Agent wartet auf das Fenster, das sich nach der Rückkehr des Rechners öffnet. Ohne Fenster wirkt das wie die vorige Wahl.
Nur, wenn höchstens so viele Stunden verpasst (1 bis 720): Eine ältere verpasste Sicherung wird nicht nachgeholt, und der Agent wartet auf die nächste reguläre Sicherung. Leer heißt: jedes Alter.

Eine Sicherung, die fällig wurde, während der Agent lief, aber nicht beginnen konnte (die Restow-Instanz war nicht erreichbar, eine Update-Pause, Akkubetrieb, ein anderer Lauf), ist nie verpasst. Sie beginnt, sobald sie kann, ohne Altersgrenze. Auch die Zeitplanart „sobald der Rechner online ist“ kennt keine verpassten Sicherungen.

Upload-Limit

Das Limit der Richtlinie gilt für einen Backup-Job, der weder ein eigenes Upload-Limit noch eigene Zeitfenster festlegt. Ein Job, der ein eigenes Limit oder eigene Zeitfenster hat, behält sie. Im Job-Editor bietet das Feld Bandbreite neben einer Zahl zwei weitere Wahlmöglichkeiten:

Wie in der Richtlinie der Agenten (das Feld bleibt leer): Der Job erbt das Limit der Richtlinie. Das bedeutet jeder Job, der vor 0.4.0 gespeichert wurde.
Unbegrenzt, auch gegen ein Limit der Richtlinie: Der Job lädt ohne Limit hoch, obwohl ein Mandant oder die Installation eines festlegt.

Nur ein Limit, das die Installation gesperrt hat, setzt sich gegen den Job durch: Dann gilt das Limit der Installation für jeden Job, und das eigene Limit des Jobs, sein „Unbegrenzt“ und seine Zeitfenster wirken nicht. Das Limit gilt in kbit/s; 1000 kbit/s sind etwa 1 Mbit/s. Ein Freigabe-Job hat keine Richtlinie der Agenten.

Nur am Netzteil

Geplante Sicherungen eines Laptops warten, bis er am Netzteil hängt. Ein Rechner, bei dem das in seinen eigenen Einstellungen eingeschaltet ist, behält es: Die Richtlinie kann die Einschränkung hinzufügen, nie wegnehmen. Sperrt die Installation die Einstellung, entscheidet allein die Installation. Die Grenzen von Nur am Netzstrom gelten wie bisher: Jetzt sichern wird nicht zurückgehalten, eine laufende Sicherung wird nicht gestoppt, und die Erkennung arbeitet nach dem Best-Effort-Prinzip.

Automatische Wiederholungen

Wie oft eine fehlgeschlagene Sicherung erneut versucht wird, bevor der Agent auf die nächste reguläre Sicherung wartet: nach 5, 15 und 30 Minuten, dann stündlich. 0 schaltet Wiederholungen aus, das Maximum ist 10, und der Standard von 5 ist das, was die Agenten bisher taten. Ein Fehler, der durch eine verlorene Verbindung entsteht, zählt als Unterbrechung, nicht als Fehlschlag. Siehe Zeitplan.

Was die Seite eines Rechners zeigt

Öffnen Sie einen Rechner unter Server & Clients → Inventar. Seine Übersicht hat die Karte Richtlinie der Agenten: jede Einstellung mit ihrem Wert, woher er kommt und ob sie gesperrt ist. Die Herkunft ist eine von Standard, Installation, Mandant, Backup-Job oder Dieser Rechner (das eigene Upload-Limit des Rechners, wenn er in keinem Job ist, und sein eigener Schalter für das Netzteil). Die Karte ist für alle nur lesbar. Geändert wird dort, wo die Ebene liegt: bei der Installation, unter Mandanten-Einstellungen → Agenten oder im Job.

In der Karte Dieser Rechner sagt Nächste Sicherung, wann die nächste Sicherung geplant ist und, wenn eine fällige Sicherung wartet, warum:

Was die Seite sagt	Was es bedeutet
Fällig, wartet auf das Sicherungsfenster (ab …)	Die Sicherung ist fällig, und das Fenster öffnet sich zur genannten Zeit.
Fällig, wartet: Restow wird aktualisiert und startet keine neuen Sicherungen	Eine Update-Pause ist aktiv.
Fällig, wartet auf das Netzteil	Ein Laptop im Akkubetrieb mit Nur am Netzstrom sichern.
Eine verpasste Sicherung wird im nächsten Sicherungsfenster nachgeholt (ab …)	Die Richtlinie holt im nächsten Fenster nach.
Eine verpasste Sicherung wird nicht nachgeholt (Richtlinie); es folgt die nächste reguläre Sicherung	Nachholen ist aus, oder die verpasste Sicherung ist älter als das Höchstalter.
Fällig, wartet, bis Restow erreichbar ist	Der Rechner erreicht die Instanz nicht.

Der Agent 0.4.0 sendet diesen Grund mit seinem Heartbeat (waiting). Bei einem älteren Agent zeigt die Seite keinen. Einen Grund, den die Seite nicht kennt, zeigt sie als „Fällig, wartet“ mit seinem Code.

Die Weboberfläche zeigt die Seite des Rechners nur Administratoren. Restore-Operatoren öffnen stattdessen Datei-Restore. Die Route, die die Karte bedient, GET /api/v1/endpoints/<id>/agent-policy, steht ihnen offen.

Auf dem Rechner zeigt restow-agent status dasselbe: Policy nennt, was die Richtlinie gegenüber dem Standard ändert (die Zeile entfällt, wenn nichts abweicht), und Waiting sagt, warum eine fällige Sicherung wartet. Diese Zeilen sind englisch, wie die übrige Ausgabe des Agents.

Was der Server schreibt und was auditiert wird

Der Server berechnet die wirksame Richtlinie jedes Rechners aus der Installation, dem Mandanten und dem Job des Rechners und schreibt sie in die Konfiguration des Rechners. Ändert sie sich für einen Rechner, steigt die Konfigurationsversion, der Rechner bekommt eine Aufgabe update_config und holt die neue Konfiguration bei seinem nächsten Kontakt, meist innerhalb weniger Minuten. Ein Rechner, dessen Richtlinie nur aus Standardwerten besteht und bei dem nichts gesperrt ist, bekommt gar keine Richtlinie.

Audit-Ereignis	Wann
`settings.agent_policy.updated`	Die Richtlinie oder die Sperren der Installation wurden geändert (vorher und nachher stehen im Eintrag).
`tenant.agent_policy.updated`	Die Richtlinie eines Mandanten wurde geändert.
`endpoint.config.changed`	Die Konfiguration eines Rechners hat sich geändert. Bei einer Richtlinie nennt der Eintrag `config.policy` und ob die Änderung über die Installation, den Mandanten oder den Job kam.

Siehe Audit-Log.

Die Update-Pause

Solange ein Restow-Update neue Läufe pausiert, beginnt der Agent 0.4.0 keine geplante Sicherung, keine Wiederholung und kein Nachholen. Die Konfiguration und der Heartbeat sagen startsPaused, und der Agent fragt jede Minute neu. Ist die Pause vorbei, beginnt die Sicherung.

Das Warten ist kein Fehler. Es zählt weder als verpasste noch als fehlgeschlagene Sicherung, denn es gibt keinen Versuch und keinen Lauf. Die Seite des Rechners sagt „Fällig, wartet: Restow wird aktualisiert und startet keine neuen Sicherungen“.
Eine laufende Sicherung läuft weiter und zählt im Update-Dialog wie bisher.
Jetzt sichern bleibt auf dem Server in der Warteschlange, bis die Pause vorbei ist, auch für Agents älter als 0.4.0. restow-agent backup-now auf dem Rechner sagt, dass die Instanz aktualisiert wird, und wartet (Strg-C beendet das Warten, ohne eine Sicherung zu beginnen).
Agents älter als 0.4.0 halten ihre eigenen Zeitpläne während einer Update-Pause nicht an. Eine Sicherung, die ein solcher Rechner in dieser Zeit selbst beginnt, läuft und kann fehlschlagen, wenn die API unter ihr neu startet. Aktualisieren Sie die Agents, um das zu vermeiden.

Wie ein Update neue Läufe pausiert und was der Installationsdialog für laufende Läufe anbietet, steht unter Updates.

Welcher Agent was befolgt

Einstellung	Agent 0.4.0	Ältere Agents
Sicherungsfenster	Befolgt es	Ignorieren es
Verpasste Sicherungen nachholen	Befolgt es	Ignorieren es und holen sofort nach, wie bisher
Automatische Wiederholungen	Befolgt die Zahl	Ignorieren sie und wiederholen 5-mal
Grund des Wartens auf der Seite des Rechners	Sendet ihn mit dem Heartbeat	Keiner
Update-Pause für geplante Starts	Hält sie an	Halten sie nicht an
Upload-Limit	Befolgt es	Befolgen es
Nur am Netzteil	Befolgt es	Befolgen es

Das Upload-Limit und das Netzteil erreichen ältere Agents, weil der Server sie in die Konfigurationsfelder einrechnet, die diese Agents schon lesen. Der Agent aktualisiert sich selbst, außer der Mandant hat Agent-Updates pausiert, siehe Agent-Updates.

Getestet und nicht getestet

Die Release-Hinweise zu 0.4.0 führen die Richtlinie der Agenten unter den Funktionen auf, die nur gegen simulierte Dienste getestet wurden, nicht gegen echte Systeme. Die Zeitplanregeln des Agents, die Auflösung der drei Ebenen und die Konfiguration, die der Server schreibt, sind durch die Testsuiten abgedeckt. Rollen Sie eine Richtlinie zuerst auf einem Rechner aus, prüfen Sie seine Seite und restow-agent status und weiten Sie sie danach aus.