Mit dem Befehl plan verwaltest Du Deine Backup-Pläne auf der Kommandozeile: zeigen, anlegen, ändern, pausieren, einschalten, sofort ausführen und löschen.
WP-CLI ist noch nicht eingerichtet? Dann beginne mit WP-CLI installieren. Was für jeden Befehl gilt, zum Beispiel der Benutzer und der Parameter --force, steht in Die Befehle im Überblick.
Ein Backup-Plan bündelt, wann ein Backup läuft, was es enthält, wohin es übertragen wird und wie viele Backups je Ziel bleiben. Einen Plan gibst Du mit seiner Kennung, zum Beispiel plan-1, oder mit seinem Namen an. Bei den Buchstaben a bis z spielt Groß- und Kleinschreibung im Namen keine Rolle; Umlaute schreibst Du so, wie sie im Namen stehen. Ein Name mit Leerzeichen steht in Anführungszeichen.
Jede Aktion außer list prüft, ob Du als der Benutzer arbeitest, dem die Ordner des Plugins gehören. --force übergeht diese Prüfung.
Pläne zeigen: list
# Alle Pläne mit Zustand, Rhythmus und nächstem Lauf zeigen wp cloneworx-backup plan list
Die Ausgabe enthält je Plan zwei Zeilen. Die erste enthält die Kennung, den Zustand, den Namen, den Rhythmus mit der Startzeit und die Kennungen der Ziele. Die zweite zeigt den nächsten Lauf, den letzten Lauf, den Inhalt, Max. Sicherungen und die Momentaufnahme. Die letzte Zeile zählt die Pläne und die aktiven Pläne. Läuft ein eingeschalteter Plan nicht nach Zeitplan, steht der Grund in einer eigenen Zeile unter dem Plan.
| In der Ausgabe | Bedeutung |
|---|---|
active |
Der Plan ist aktiv und läuft zu seinem nächsten Lauf von selbst. |
paused |
Der Plan ist pausiert. Es sind keine Backups geplant. |
paused (no target) |
Der Plan ist pausiert, weil er kein Ziel mehr hat. Wähle ein Ziel, dann lässt er sich einschalten. |
next run |
Der nächste Lauf in der Zeitzone der Website. Bei einem pausierten Plan steht hier ein Strich. |
last run |
Der letzte Lauf mit seinem Auslöser: schedule (Zeitplan), manual (auf den Seiten des Plugins) oder cli (Kommandozeile). missed nennt einen Termin, der danach verpasst wurde. could not start bedeutet: Der letzte Lauf auf Termin konnte nicht starten. Hinter dem Code in Klammern steht der Grund im Klartext. |
roots |
Was der Plan sichert, als Liste der Bereiche. |
retention |
Max. Sicherungen |
snapshot |
Datenbank als Momentaufnahme sichern: yes oder no
|
Einen Plan anlegen: add
# Täglich um 03:15 Uhr an das Ziel sftp-1 sichern wp cloneworx-backup plan add --target=sftp-1 --rhythm=daily --time=03:15 --name="Nachts" # Sonntags um 22 Uhr Datenbank und Uploads, 3 Backups behalten wp cloneworx-backup plan add --target=local-1 --rhythm=weekly --weekday=7 --time=22:00 --roots=db,wp-uploads --retention=3 # Den neuen Plan einschalten wp cloneworx-backup plan resume "Nachts"
Pflicht ist allein --target. Alles andere hat einen Standardwert.
| Parameter | Bedeutung | Erlaubte Werte |
|---|---|---|
--target=<Kennung> |
Das Ziel des Plans, im Formular Ziele und Rotation. Pflichtangabe. | Die Kennung eines benutzbaren Ziels, nicht sein Name. Genau ein Ziel: Den Wert teilt der Befehl nicht am Komma. Mehrere Ziele nimmt wp pro-plan mit --targets an. |
--name=<Name> |
Der Name des Plans. Ohne den Parameter vergibt das Plugin seinen Vorschlag. | Höchstens 100 Zeichen. Jeder Name ist möglich, den noch kein anderer Plan hat. |
--rhythm=<Rhythmus> |
Rhythmus |
1h, 2h, 4h, 6h, 12h, daily, weekly, monthly. wp pro-plan akzeptiert außerdem 5m, 10m, 15m, 30m. Standard: daily. |
--time=HH:MM |
Uhrzeit in der Zeitzone der Website. | Stunde 0 bis 23, Minuten 00, 15, 30 oder 45. Standard: eine zufällige Uhrzeit. |
--weekday=<Zahl> |
Wochentag, beim Rhythmus weekly. |
1 für Montag bis 7 für Sonntag. Standard: 1. |
--monthday=<Tag> |
Tag im Monat, beim Rhythmus monthly. |
1 bis 28, oder last für den letzten Tag des Monats. Standard: 1. |
--roots=<Liste> |
Was gesichert wird: die Bereiche, durch Komma getrennt. | Siehe die Tabelle der Bereiche. Standard: alle. wp-config akzeptiert der Befehl nicht: Die Datei wp-config.php ist nie Teil eines Backups. |
--retention=<Zahl> |
Max. Sicherungen: so viele korrekte Backups bleiben je Ziel. | 1 bis 99. Standard: 7. 0 nur mit der Aufbewahrung nach Alter von cloneworx Backup Pro. |
--snapshot=<Wert> |
Datenbank als Momentaufnahme sichern |
yes oder no. Standard: yes. |
--force |
Übergeht die Prüfung des Benutzers. |
-
Ein neuer Plan ist pausiert. Er läuft erst, wenn Du ihn mit
resumeeinschaltest. - Die Startzeit kann von der Uhrzeit abweichen. Beim Anlegen zählt das Plugin zufällig 0 bis 14 Minuten dazu und behält diesen Zusatz bei. Aus 03:15 wird zum Beispiel 03:22. So starten nicht alle Websites eines Servers in derselben Minute.
-
Bei den Rhythmen von
1hbis12hzählt von der Uhrzeit nur die Minute. Die Läufe liegen ab 0 Uhr im Abstand des Rhythmus. -
Bei
5mbis30m, den Rhythmen vonwp pro-plan, zählt keine Uhrzeit, und es gibt keinen zufälligen Zusatz. Der Befehl warnt mit dem Wortlaut des Dialogfensters Achtung, dass diese Rhythmen einen System-Cron brauchen, und legt den Plan trotzdem an: Backups alle 5 bis 30 Minuten. -
In der freien Version läuft ein Plan nach Zeitplan. Ist schon ein Plan eingeschaltet, lehnt
resumeeinen zweiten ab und nennt den Plan, den Du zuerst pausieren musst. Mit cloneworx Backup Pro laufen alle eingeschalteten Pläne nach Zeitplan.
Die Bereiche für --roots
| Wert | Im Formular | Inhalt |
|---|---|---|
db |
Datenbank | Die Tabellen der Datenbank, die zu dieser Website gehören. |
wp-content |
wp-content | Alles in wp-content, das nicht zu Plugins, Themes, Must-use-Plugins oder Uploads gehört. |
wp-core |
WordPress-Kern | Die Ordner wp-admin und wp-includes und die Dateien, die WordPress im Hauptverzeichnis ausliefert. |
wp-mu-plugins |
Must-use-Plugins | Der Ordner der Must-use-Plugins. |
wp-plugins |
Plugins | Der Ordner der Plugins. |
wp-themes |
Themes | Der Ordner der Themes. |
wp-uploads |
Uploads | Der Ordner der Uploads. |
wp-root |
Hauptverzeichnis | Alles andere im Ordner des WordPress-Kerns, zum Beispiel .htaccess und robots.txt. Liegt WordPress in einem eigenen Unterordner mit eigener Adresse, gehören die Dateien des Web-Wurzelordners dazu. |
Ausschlussregeln und Tabellen, von denen nur die Struktur gesichert wird, gelten für die ganze Website und damit für jeden Plan. Mehr dazu: Festlegen, was gesichert wird.
Einen Plan ändern: edit
# Die Uhrzeit ändern und die Momentaufnahme abschalten wp cloneworx-backup plan edit "Nachts" --time=04:30 --snapshot=no # Ein anderes Ziel wählen wp cloneworx-backup plan edit plan-1 --target=local-1
edit akzeptiert dieselben Parameter wie add und braucht mindestens einen davon. Geändert wird nur, was Du angibst. Änderst Du Rhythmus, Tag oder Uhrzeit, rechnet das Plugin den nächsten Lauf neu. Der zufällige Zusatz zur Uhrzeit bleibt derselbe. Hat der Plan Einstellungen von cloneworx Backup Pro, und cloneworx Backup Pro ist mit gültiger Lizenz aktiv, ändert plan edit nichts und nennt wp pro-plan edit. Fehlt cloneworx Backup Pro oder gilt die Lizenz nicht, entfernt plan edit diese Einstellungen aus dem Plan und sagt das in einer Warnung.
Pausieren und einschalten: pause und resume
# Den Plan pausieren wp cloneworx-backup plan pause plan-1 # Den Plan einschalten wp cloneworx-backup plan resume plan-1
resume zeigt in der Ausgabe den nächsten Lauf. Das Plugin rechnet ihn ab jetzt: Ein Plan, der wochenlang pausiert war, startet nicht in dem Augenblick, in dem Du ihn einschaltest. Einschalten lässt sich ein Plan nur mit einem benutzbaren Ziel, also einem Ziel, dessen letzter Verbindungstest gelungen ist.
Ein aktiver Plan startet zu seinem nächsten Lauf von selbst, sobald ein Taktgeber die Website anstößt. Kommt innerhalb einer Stunde nach dem Termin kein Taktgeber, gilt der Lauf als verpasst: Es startet nichts, und der Plan rückt auf seinen nächsten regulären Termin. Eine Website ohne Besucher braucht deshalb einen System-Cron: Zeitplan und System-Cron mit WP-CLI.
Einen Plan sofort ausführen: run
# Den Plan jetzt ausführen und auf das Ergebnis warten wp cloneworx-backup plan run "Tägliches Backup" # Das Backup nur starten; die Website führt es weiter wp cloneworx-backup plan run plan-1 --background
run startet sofort ein Backup mit dem Inhalt und dem Ziel des Plans. Das funktioniert auch bei einem pausierten Plan: Die Pause betrifft nur den Zeitplan. Das Backup zählt zum Plan und gilt als sein letzter Lauf. Den nächsten geplanten Lauf verschiebt es nicht. Hat der Plan Einstellungen von cloneworx Backup Pro, startet plan run nichts und nennt wp pro-plan run.
| Parameter | Bedeutung |
|---|---|
--background |
Der Befehl startet das Backup und endet. Die Website führt es selbst weiter; den Stand zeigt wp cloneworx-backup job status. |
--force |
Übergeht die Prüfung des Benutzers. |
Ohne --background zeigt der Befehl je Schritt eine Zeile mit dem Fortschritt: die Phase, die Zahl der Einträge, die Menge und, sobald sie sich schätzen lässt, die verbleibende Zeit. Am Ende steht das Ergebnis mit der Zahl der Schritte und der Warnungen, darunter die Einzelheiten zu Datenbank, Dateien und Übertragung je Ziel. Nach einem korrekten Backup führt der Befehl auch den Nachlauf zu Ende: Er löscht Backups, die über Max. Sicherungen hinausgehen, und räumt Reste an den Zielen auf.
Scheitert das Backup, zeigt die Ausgabe die letzten Meldungen des Jobs, den Stand je Ziel und den Grund. Hat der Plan kein benutzbares Ziel oder läuft schon ein anderer Job, startet der Befehl nichts und meldet das.
Einen Plan löschen: remove
# Den Plan löschen; seine Backups bleiben wp cloneworx-backup plan remove "Nachts"
Der Befehl fragt nicht nach
Anders als auf der Seite Backup gibt es hier keine Sicherheitsabfrage: Der Plan ist sofort gelöscht. Die Backups, die er erstellt hat, bleiben.
Löschst Du alle Pläne, legt das Plugin mit dem nächsten Ziel, das Du hinzufügst, wieder einen ersten Plan an.
Wenn der Befehl eine Angabe ablehnt
Passt eine Angabe nicht, speichert der Befehl nichts. Er nennt das Feld mit einem Code und endet mit Plan settings are not valid.
| Feld | Code | Bedeutung |
|---|---|---|
name |
required, taken, too_long
|
Der Name ist leer, gehört schon einem anderen Plan oder ist länger als 100 Zeichen. |
rhythm, weekday, monthday, snapshot
|
invalid |
Der Wert steht nicht in der Tabelle der erlaubten Werte. |
roots |
required, invalid
|
Die Liste ist leer oder enthält einen Bereich, den es nicht gibt. |
targets |
required |
Die Liste ist leer. |
targets |
unknown |
Das Ziel gibt es nicht, oder es ist entfernt. |
targets |
not_usable |
Das Ziel ist nicht benutzbar. Teste zuerst seine Verbindung. |
retention |
invalid, out_of_range
|
Der Wert ist keine ganze Zahl oder liegt nicht zwischen 1 und 99. |
state |
no_usable_target |
Der Plan lässt sich nicht einschalten, weil er kein benutzbares Ziel hat. |
state |
single_plan |
In der freien Version ist schon ein anderer Plan eingeschaltet. Der Befehl warnt: Only one plan runs on schedule. Pause the plan "…" first.
|
rhythm |
pro_rhythm |
This rhythm exists only with cloneworx Backup Pro. Choose another rhythm (--rhythm) to switch the plan on. |
retention |
retention_required |
Max. Sicherungen steht auf 0. Setze --retention auf eine Zahl von 1 bis 99. |
retention |
retention_pro_missing |
Der Plan hat Stufen der Aufbewahrung nach Alter, aber keine gültige Lizenz. Setze --retention auf eine Zahl von 1 bis 99 und schalte den Plan danach wieder ein. |
Eine Uhrzeit in falscher Form lehnt der Befehl sofort ab und nennt die erlaubte Form.
PROMehrere Ziele und kurze Rhythmen: wp pro-plan
Diese Funktion gehört zu cloneworx Backup Pro: Installation · Bestellung
# Zwei Ziele, s3-1 bekommt nur den ersten Lauf jeder Woche wp pro-plan add --targets=local-1,s3-1 --rules=s3-1:weekly --rhythm=daily --time=03:15 --name="Nachts" # Den Rhythmus auf alle 15 Minuten stellen wp pro-plan edit "Nachts" --rhythm=15m # Den Plan jetzt ausführen, an die Ziele dieses Laufs wp pro-plan run "Nachts" # Ein Backup ohne Plan an zwei Ziele wp pro-backup run --targets=local-1,s3-1
wp pro-plan add und wp pro-plan edit akzeptieren alle Parameter von plan add und plan edit. Dazu kommen --targets mit einem Ziel oder mehreren, durch Komma getrennt, --rules mit der Regel je weiterem Ziel in der Form <Ziel>:<Regel> und die Rhythmen 5m, 10m, 15m und 30m. wp pro-plan run startet einen Plan sofort, mit --background wie plan run. wp pro-backup run startet ein Backup ohne Plan an die Ziele aus --targets. Alle vier brauchen eine gültige Lizenz. Mehr dazu: Die 3-2-1 Regel - der Goldstandard für Backups und Backups alle 5 bis 30 Minuten.
PROAusnahmen je Plan: wp pro-plan
Diese Funktion gehört zu cloneworx Backup Pro: Installation · Bestellung
Der Befehl wp pro-plan verwaltet die Ausnahmen eines Plans: Regeln, die zusätzlich zu den Ausschlüssen der Website nur für diesen Plan gelten. add und edit brauchen eine gültige Lizenz: Die Lizenz von cloneworx Backup Pro.
# Die Ausnahmen aller Pläne zeigen wp pro-plan list # Täglichen Plan ohne JPG-Dateien der Uploads anlegen wp pro-plan add --targets=local-1 --rhythm=daily --time=03:15 --name="Ohne Bilder" --exclusions="wp-uploads/**/*.jpg" # Die Ausnahmen eines Plans ersetzen wp pro-plan edit "Ohne Bilder" --exclusions="wp-uploads/**/*.jpg,wp-uploads/**/*.png" # Die Ausnahmen eines Plans entfernen wp pro-plan edit "Ohne Bilder" --exclusions=""
list zeigt je Plan die Kennung, den Namen, die Ausnahmen und die Stufen der Aufbewahrung nach Alter. add und edit akzeptieren alle Parameter von plan add und plan edit und dazu --exclusions: die Regeln, durch Komma getrennt, in denselben Formen wie die Ausschlüsse. --exclusions ersetzt die Ausnahmen des Plans; ein leerer Wert entfernt sie. Im Formular des Plans: Backup-Pläne: Kachel und Formular.
PROAufbewahrung nach Alter: wp pro-plan --age
Diese Funktion gehört zu cloneworx Backup Pro: Installation · Bestellung
# Aufbewahrung nach Alter setzen wp pro-plan edit "Nachts" --age=run:2,daily:7,weekly:4,monthly:12 # Zurück zu einer festen Zahl wp pro-plan edit "Nachts" --age="" --retention=7
--age akzeptiert die vier Stufen: run in Stunden, daily in Tagen, weekly in Wochen, monthly in Monaten. Nicht angegebene Stufen sind 0; ein leerer Wert schaltet alle aus. Mit einer Stufe steht --retention auf 0. Was die Stufen bewirken: Aufbewahrung nach Alter.
PROBackups verschlüsseln: wp pro-plan --encrypt
Diese Funktion gehört zu cloneworx Backup Pro: Installation · Bestellung
# Die Verschlüsselung eines Plans einschalten wp pro-plan edit "Nachts" --encrypt=yes # Die Verschlüsselung eines Plans ausschalten wp pro-plan edit "Nachts" --encrypt=no
--encrypt=yes braucht eine gültige Lizenz. Verschlüsselt wird erst, wenn der Wiederherstellungsschlüssel eingerichtet ist. wp pro-plan list nennt je Plan, ob der Plan verschlüsselt. Mehr dazu: Backups verschlüsseln.