Describe the backup and restore behaviour as the scripts run it

- BORG_RSH, the Borg SSH wizard and attached jobs match the code
- Restore path classes name the right examples and when each path is written
This commit is contained in:
MacRimi
2026-10-18 13:58:15 +02:00
parent 2efd775559
commit 7a6a6f93dc
24 changed files with 40 additions and 40 deletions
@@ -107,7 +107,7 @@
"heading": "SSH-Authentifizierung (Clientseite)",
"intro": "Remote-Borg-Repositories sind über SSH zugänglich. Die Verbindung läuft vom ProxMenux-Host zu einem Benutzerkonto auf dem Borg-Server, auf dem <code>borg serve</code> ausgeführt wird. Dieser Benutzer heißt normalerweise <code>borg</code>, NICHT der Admin / Root-Benutzer des Servers - die Befehlszeile borg-serve sperrt die Verbindung zu diesem spezifischen Repository-Pfad (siehe die wichtigsten Strategien unten).",
"strategiesTitle": "SSH-Schlüsselstrategien",
"strategiesIntro": "Beim Hinzufügen eines entfernten Ziels fragt ProxMenux nach SSH-Benutzer, Host und entferntem Pfad und bietet vier Anmeldeoptionen. Wird die Passwortanmeldung abgewiesen, steht zusätzlich generate-pct zur Wahl. Die Modi sind unten beschrieben:",
"strategiesIntro": "Beim Hinzufügen eines entfernten Ziels fragt ProxMenux nach SSH-Benutzer, Host, Port und entferntem Pfad und bietet vier Anmeldeoptionen. Wird die Passwortanmeldung abgewiesen, steht zusätzlich generate-pct zur Wahl. Die Modi sind unten beschrieben:",
"strategyRows": [
{
"mode": "generate-auto",
@@ -166,7 +166,7 @@
{
"var": "BORG_RSH",
"value": "ssh -i SSH_KEY_PATH -o IdentitiesOnly=yes -o StrictHostKeyChecking=accept-new [-p PORT]",
"purpose": "Remote-Shell-Befehl für Borg-Repositories über SSH. Ein gewählter Schlüssel ergänzt die Identitätsoptionen, ein abweichender Port ergänzt -p PORT. Ohne eigenen Schlüssel und mit Standardport bleibt die Variable ungesetzt; Borg nutzt dann die SSH-Vorgaben des Hosts."
"purpose": "Remote-Shell-Befehl für Borg-Repositories über SSH. Ein gewählter Schlüssel ergänzt die Identitätsoptionen. Wird ein Ziel erstmals mit einem abweichenden Port hinzugefügt, ergänzt ProxMenux zusätzlich -p PORT; gespeicherte Ziele, geplante Aufträge und der Monitor verwenden stattdessen den Port aus der ssh://-URL. Ohne eigenen Schlüssel und bei einem neuen Ziel mit Standardport bleibt die Variable ungesetzt; Borg nutzt dann die SSH-Vorgaben des Hosts."
},
{
"var": "BORG_PASSPHRASE",
@@ -156,7 +156,7 @@
{
"id": "modo-adjunto",
"term": "Anhängemodus",
"def": "Auftrag ohne eigenen Timer. Ein job-end-Hook von PVE-<code>vzdump</code> startet ihn nach Gastsicherungen bei passendem Zielspeicher. Der gewählte Elternauftrag liefert Speicher und anfängliche Aufbewahrung; der Hook vergleicht aber Speicher statt Auftrags-ID. Auch andere Aufgaben desselben Speichers können ihn auslösen. Nur Local und PBS."
"def": "Auftrag ohne eigenen Timer. Ein job-end-Hook von PVE-<code>vzdump</code> startet ihn nach Gastsicherungen bei passendem Zielspeicher. Der gewählte Elternauftrag liefert Speicher und Aufbewahrung, die bei jedem Lauf erneut aus dem Elternauftrag gelesen wird; der Hook vergleicht aber Speicher statt Auftrags-ID. Auch andere Aufgaben desselben Speichers können ihn auslösen. Nur Local und PBS."
},
{
"id": "timer-systemd",
@@ -81,11 +81,11 @@
},
{
"class": "reboot",
"detail": "Pfade, die dieser Ablauf für den <strong>nächsten Start</strong> zurückstellt, statt sie <strong>sofort</strong> anzuwenden. Sie betreffen die Startkonfiguration: Die Bootloader-Erzeugung liest <code>/etc/default/grub</code>, das Einhängen nutzt <code>/etc/fstab</code> und das Laden von Modulen <code>/etc/modules</code>. Nach dem Neustart werden die vorgemerkten Dateien angewendet und die nötigen Startartefakte neu erzeugt. Beispiele: <code>/etc/default/grub</code>, <code>/etc/kernel</code>, <code>/etc/modules</code>, <code>/etc/fstab</code>, <code>/etc/zfs</code>, <code>/etc/initramfs-tools</code>."
"detail": "Pfade, die dieser Ablauf für den <strong>nächsten Start</strong> zurückstellt, statt sie <strong>sofort</strong> anzuwenden. Sie betreffen die Startkonfiguration: Die Bootloader-Erzeugung liest <code>/etc/default/grub</code>, das Einhängen nutzt <code>/etc/fstab</code> und das Laden von Modulen <code>/etc/modules</code>. Nach dem Neustart werden die vorgemerkten Dateien angewendet und die nötigen Startartefakte neu erzeugt. Beispiele: <code>/etc/default/grub</code>, <code>/etc/kernel</code>, <code>/etc/modules</code>, <code>/etc/fstab</code>, <code>/etc/zfs</code>, <code>/etc/modprobe.d</code>."
},
{
"class": "dangerous",
"detail": "Pfade, die <strong>NICHT im laufenden System wiederhergestellt werden</strong>: Ein Schreibzugriff könnte dort den Zustand beschädigen oder die aktive Verbindung unterbrechen. Sie werden vorgemerkt und nach dem Neustart vom Post-Boot-Dispatcher geschrieben, wenn der Cluster verfügbar ist, das System aber noch nicht vollständig genutzt wird. Beispiele sind <code>/etc/pve</code> (pmxcfs ist ein aktiver FUSE-Mount mit laufender Clusterkonfiguration), <code>/var/lib/pve-cluster</code> (aktive Clusterdaten) und <code>/etc/network</code> (könnte die für die SSH-Verbindung verwendete Schnittstelle neu konfigurieren und dadurch die Sitzung trennen)."
"detail": "Pfade, die <strong>NICHT im laufenden System angewendet werden</strong>: Ein Schreibzugriff zur Laufzeit könnte den Zustand beschädigen oder die aktive Verbindung trennen. Sie werden vorgemerkt: <code>/etc/network</code> wird früh beim nächsten Start geschrieben, bevor das Netzwerk startet, und <code>/etc/pve</code> schreibt der Post-Boot-Dispatcher, sobald das Cluster-Dateisystem bereit ist. Beispiele: <code>/etc/pve</code> (pmxcfs ist ein aktiver FUSE-Mount mit laufender Clusterkonfiguration), <code>/var/lib/pve-cluster</code> (aktive Clusterdaten, nur zur manuellen Wiederherstellung im Wiederherstellungsverzeichnis abgelegt), <code>/etc/network</code> (könnte die für die SSH-Verbindung genutzte Schnittstelle neu konfigurieren und die Sitzung trennen)."
}
]
},