Mit wp cloneworx-backup backup startest Du ein Backup ohne Plan und verwaltest die Backups der Liste: zeigen, sperren, prüfen, herunterladen, löschen. wp cloneworx-backup retention zeigt, welche alten Backups wegfallen, und löscht sie auf Wunsch sofort.
WP-CLI fehlt noch? Die Anleitung steht in WP-CLI installieren. Alle Befehle des Plugins zeigt Die Befehle im Überblick.
Das gilt für alle Aktionen
- Ein Backup gibst Du mit seinem Job-Namen an: Datum, Uhrzeit und eine Kennung aus 32 Zeichen. Den Job-Namen zeigt
backup list. In den Beispielen steht dafür<Job>. - Ein Ziel gibst Du in
--targetmit seiner Kennung an, zum Beispiellocal-1. Die Kennungen zeigtwp cloneworx-backup target list. - Je Website läuft immer nur ein Job. Läuft schon einer, endet jeder Befehl, der einen Job startet, mit einem Fehler und nennt den laufenden Job.
- Die Ausgaben der Befehle sind englisch.
-
backup run,backup check,backup deleteundretention runprüfen zuerst den Benutzer: Der Befehl muss als der Benutzer laufen, dem die Ordner des Plugins gehören. Dateien, die ein anderer Benutzer anlegt, könnte die Website später nicht mehr ändern oder löschen.--forceübergeht die Prüfung.
Ein Backup ohne Plan starten: run
backup run startet sofort ein Backup und führt es in diesem Prozess bis zum Ende aus. Das Backup gehört zu keinem Plan. Einen Backup-Plan führst Du mit wp cloneworx-backup plan run aus; mehr dazu in Backup-Pläne verwalten mit WP-CLI.
| Parameter | Bedeutung | Erlaubte Werte |
|---|---|---|
--roots |
Was gesichert wird. Ohne den Parameter sichert das Plugin alles. Die Datei wp-config.php ist nie Teil eines Backups; mit wp-config bricht der Befehl ab. |
Wurzeln, durch Komma getrennt: db, wp-content, wp-core, wp-mu-plugins, wp-plugins, wp-themes, wp-uploads, wp-root
|
--target |
Wohin das Backup übertragen wird. Pflichtangabe: Ein Backup geht nie von selbst an alle Ziele. | Die Kennung eines benutzbaren Ziels. Genau ein Ziel; mehrere Ziele nimmt wp pro-backup run mit --targets an. |
--no-snapshot |
Liest die Datenbank ohne Momentaufnahme. Standard ist die Momentaufnahme. | ohne Wert |
--background |
Der Befehl startet das Backup nur. Die Website führt es selbst fort. | ohne Wert |
--max-per-step |
Beendet jeden Schritt nach so vielen Einträgen oder Zeilen. Der Parameter dient der Diagnose. | ganze Zahl |
--force |
Läuft auch als anderer Benutzer. | ohne Wert |
Eine Wurzel ist ein benannter Teil der Website: die Datenbank oder ein Ordner. Was in welcher Wurzel liegt, erklärt Einstellungen und Umfang mit WP-CLI.
# Alles an das Ziel local-1 sichern wp cloneworx-backup backup run --target=local-1 # Nur Datenbank und Uploads an ein Ziel sichern wp cloneworx-backup backup run --roots=db,wp-uploads --target=local-1 # Das Backup starten und der Website überlassen wp cloneworx-backup backup run --target=local-1 --background
Während das Backup läuft, schreibt der Befehl je Schritt eine Zeile: die Phase, die erledigten Einträge und Bytes und die restliche Zeit, sobald das Plugin sie kennt. Bei der Übertragung nennt die Phase das Ziel, bei mehreren Zielen mit seiner Stelle, zum Beispiel transfer to "SFTP 1" (2/3). Am Ende nennt er die Zahl der Schritte und der Warnungen. Darunter steht die Zusammenfassung: Wurzeln, Ziele, gespeicherte Größe, der Platz je Ort, die Datenbank, die Dateien, die Teile und je Ziel das Ergebnis der Übertragung. Hat das Backup eine andere WordPress-Installation innerhalb der Website ausgelassen, nennt die Zeile not backed up ihren Ordner.
Nach einem korrekten Backup führt derselbe Prozess den Nachlauf aus: Das Plugin löscht veraltete Backups und räumt Reste abgebrochener Jobs an den Zielen auf.
Endet das Backup mit einem Fehler, nennt der Befehl die letzten Meldungen des Jobs, je Ziel den Stand und den Grund. Zu einem Fehler an einem Ziel steht darunter unverändert die Meldung des Ziels, in der Zeile target:.
Mit --background kehrt der Befehl sofort zurück. Den Fortschritt zeigt dann wp cloneworx-backup job status.
Ohne Plan heißt: eigene Zählung
Ein Backup aus backup run zählt zur Gruppe manual. Wie viele davon bleiben, bestimmt die Einstellung Max. Sicherungen ohne Plan, Standardwert 7.
Die Backups auflisten: list
backup list zeigt die Backups der Liste, das neueste zuerst. Ohne Aktion tut wp cloneworx-backup backup dasselbe.
| Parameter | Bedeutung | Erlaubte Werte |
|---|---|---|
--limit |
Wie viele Backups die Ausgabe zeigt. | 1 bis 100, Standardwert 20 |
# Die letzten 20 Backups zeigen wp cloneworx-backup backup list # Nur die letzten 5 zeigen wp cloneworx-backup backup list --limit=5
Jede Zeile nennt ein Backup: Job-Name, Status, Plan, Ende, Größe und je Ziel den Zustand des Backups dort. Am Ende der Zeile steht locked, wenn das Backup gesperrt ist. Die letzte Zeile zeigt, wie viele Backups die Ausgabe enthält und wie viele es gibt.
| Status in der Ausgabe | Im Status-Filter der Seite Backup |
|---|---|
running |
Läuft |
success |
Vollständig |
warnings |
Mit Warnungen |
error |
Fehlgeschlagen |
aborted |
Abgebrochen |
In der Spalte für den Plan steht die Kennung des Plans, zum Beispiel plan-1. manual steht für ein Backup ohne Plan, import für ein importiertes Backup und rediscovered für ein Backup, das an einem Ziel wiedergefunden wurde. Auf der Seite Backup stehen dafür in der Spalte Plan die Wörter manuell, importiert und wiedererlangt.
Ein Backup sperren und die Sperre aufheben: lock, unlock
backup lock sperrt ein Backup. Ein gesperrtes Backup wird nie automatisch gelöscht und bei Max. Sicherungen nicht mitgezählt. Von Hand löschen kannst Du es erst nach backup unlock. Beide Aktionen haben keine Parameter.
# Ein Backup sperren wp cloneworx-backup backup lock <Job> # Die Sperre aufheben wp cloneworx-backup backup unlock <Job>
Der Befehl bestätigt die Sperre oder ihr Ende in einem Satz. Löscht das Plugin das Backup gerade an einem Ziel, lehnt backup lock ab. Mehr zur Sperre: Ein Backup vor dem Löschen schützen.
Ein Backup prüfen: check
backup check liest ein Backup an jedem Ziel, an dem es vollständig liegt oder als beschädigt vermerkt ist: Eine neue Prüfung kann das Ergebnis ändern. Zurückgeschrieben wird dabei nichts. Das Plugin prüft, ob jede Datei mit der erwarteten Größe vorhanden ist, ob die Info-Datei gültig ist, ob jedes Teil zu seiner Prüfsumme passt und ob sich jeder Block lesen lässt. Einen lokalen Ordner liest es an Ort und Stelle. Von einem externen Ziel holt es ein Teil nach dem anderen in den Arbeitsordner.
| Parameter | Bedeutung | Erlaubte Werte |
|---|---|---|
--targets |
Prüft nur an diesen Zielen. Ohne den Parameter: an jedem Ziel, an dem das Backup vollständig liegt oder als beschädigt vermerkt ist. | Kennungen, durch Komma getrennt |
--background |
Der Befehl startet die Prüfung nur. Die Website führt den Job selbst fort. | ohne Wert |
--max-per-step |
Beendet jeden Schritt nach so vielen Blöcken. Der Parameter dient der Diagnose. | ganze Zahl |
--force |
Läuft auch als anderer Benutzer. | ohne Wert |
# Ein Backup an allen seinen Zielen prüfen wp cloneworx-backup backup check <Job> # Nur an einem Ziel prüfen wp cloneworx-backup backup check <Job> --targets=local-1
Die Ausgabe hat je Ziel eine Zeile mit dem Ergebnis:
| Ergebnis | Bedeutung |
|---|---|
ok |
Das Backup ist dort lesbar und vollständig. Die Zeile nennt Teile, Einträge und gelesene Bytes. |
damaged or incomplete |
Das Backup ist dort beschädigt oder unvollständig. Die Zeile nennt die Befunde. |
not checked |
Das Ziel hat nicht geantwortet. Das ist eine Warnung, kein Schaden. |
not complete at this target |
Das Backup liegt an diesem Ziel nicht vollständig. |
Die letzte Zeile zählt zusammen. Besteht das Backup die Prüfung an einem Ziel nicht, gilt es dort als beschädigt: Es wird bei Max. Sicherungen nicht mehr mitgezählt und nie automatisch gelöscht. Mehr dazu: Ein Backup prüfen.
Ein Backup als Datei schreiben: download
backup download schreibt ein Backup als eine tar-Datei auf den Server. Die Datei enthält einen Ordner mit dem Job-Namen, darin die Info-Datei, den Index und die Teile. Das Plugin liest am ersten lokalen Ziel, an dem das Backup vollständig liegt.
| Parameter | Bedeutung | Erlaubte Werte |
|---|---|---|
--to |
Der Name der Datei, die der Befehl schreibt, ohne Pfad. Die Datei entsteht im Ordner cloneworx-backup-exports-… im Ordner der Uploads und darf noch nicht existieren. Ohne den Parameter heißt sie backup-<Job>.tar. |
Dateiname aus Buchstaben, Ziffern, Punkt, Unterstrich und Bindestrich |
# Das Backup als tar-Datei schreiben wp cloneworx-backup backup download <Job> --to=backup.tar
Der Befehl nennt die Datei mit ihrem ganzen Pfad, ihre Größe, die Zahl der Dateien darin und das Ziel, an dem er gelesen hat. Liegt das Backup an keinem lokalen Ziel vollständig, endet er mit einem Fehler. Ein Backup, das nur an externen Zielen liegt, holst Du mit einem eigenen Programm von dort, zum Beispiel mit Deinem FTP-Programm. Mehr dazu: Ein Backup herunterladen.
wp cloneworx-backup import nimmt dieselbe Datei wieder an; siehe Wiederherstellen und importieren mit WP-CLI.
Ein Backup löschen: delete
backup delete löscht ein Backup an jedem Ziel, an dem es liegt. Mit seiner letzten Kopie verschwindet das Backup aus der Liste. Vor dem Löschen fragt der Befehl nach.
| Parameter | Bedeutung | Erlaubte Werte |
|---|---|---|
--target |
Löscht nur an diesem Ziel. Die Kopien an den anderen Zielen bleiben. Solange es noch eine Kopie gibt, bleibt das Backup in der Liste. | Die Kennung eines Ziels |
--entry-only |
Entfernt nur den Eintrag aus der Liste. An den Zielen löscht der Befehl nichts, und es läuft kein Job. Das funktioniert nur, solange mindestens ein Ziel das Backup nicht mehr hat, nicht antwortet oder entfernt wurde. Der Befehl prüft das nach der Sicherheitsabfrage: Hat jedes Ziel das Backup noch, endet er mit einem Fehler. Einen Eintrag ohne Kopie, zum Beispiel ein fehlgeschlagenes Backup, löschst Du ohne diesen Parameter. | ohne Wert |
--yes |
Löscht ohne Sicherheitsabfrage. | ohne Wert |
--force |
Läuft auch als anderer Benutzer. | ohne Wert |
# Ein Backup überall löschen, mit Rückfrage wp cloneworx-backup backup delete <Job> # Nur die Kopie an einem Ziel löschen, ohne Sicherheitsabfrage wp cloneworx-backup backup delete <Job> --target=local-1 --yes # Nur den Eintrag entfernen, an den Zielen nichts löschen wp cloneworx-backup backup delete <Job> --entry-only
- Ein gesperrtes Backup lehnt der Befehl ab. Hebe zuerst die Sperre auf.
- Ein laufendes Backup lehnt der Befehl ab. Brich es zuerst ab:
wp cloneworx-backup job abort. - Ein Ziel, das entfernt wurde, fasst der Befehl nicht an: Das Backup verliert nur den Verweis auf dieses Ziel, gelöscht wird dort nichts. Die Zahlen am Ende zählen das weder als gelöscht noch als gescheitert.
- Ein Eintrag ohne Kopie, zum Beispiel ein fehlgeschlagenes oder abgebrochenes Backup, verschwindet sofort aus der Liste, ohne Sicherheitsabfrage und ohne Job.
Das Löschen läuft als Job in diesem Prozess. Am Ende nennt der Befehl, wie viele Kopien er gelöscht hat und bei wie vielen das Löschen gescheitert ist. Ein Ziel, dessen Ordner einer anderen Installation gehört, zählt als gescheitert und steht in Klammern dabei. Ein Backup, das inzwischen gesperrt wurde, nennt die Zeile ebenfalls. Mehr dazu: Ein Backup löschen.
Das letzte korrekte Backup an einem Ziel
Ist das Backup an einem Ziel das letzte korrekte, warnt der Befehl und nennt das Ziel. Löschen bleibt erlaubt. Mit --yes folgt auf die Warnung keine Sicherheitsabfrage mehr.
Veraltete Backups zeigen und löschen: retention
Das Plugin behält je Backup-Plan und je Ziel so viele korrekte Backups, wie Max. Sicherungen im Plan vorgibt. Ältere fallen weg. Gesperrte Backups zählen nicht mit und fallen nie automatisch weg. Das neueste korrekte Backup fällt nie weg. Das geschieht von selbst nach jedem korrekten Backup. Mit wp cloneworx-backup retention siehst Du es vorher oder stößt es von Hand an.
| Aktion | Zweck |
|---|---|
retention list |
Zeigt, welche Backups jetzt wegfielen. Löscht nichts. Ohne Aktion tut der Befehl dasselbe. |
retention run |
Löscht diese Backups jetzt und führt den Job in diesem Prozess aus. |
| Parameter | Bedeutung | Erlaubte Werte |
|---|---|---|
--plan |
Nur diese Gruppe. Ohne den Parameter: jeder Plan und die Backups ohne Plan. | Kennung eines Plans, zum Beispiel plan-1, oder manual
|
--force |
Nur run: läuft auch als anderer Benutzer. |
ohne Wert |
# Zeigen, was wegfiele wp cloneworx-backup retention list # Jetzt löschen, nur für einen Plan wp cloneworx-backup retention run --plan=plan-1 # Jetzt löschen, nur Backups ohne Plan wp cloneworx-backup retention run --plan=manual
retention list nennt je Zeile ein Backup, das Ziel und die Gruppe: den Namen des Plans oder manual. Die letzte Zeile zählt die Löschungen. Fällt nichts weg, meldet der Befehl das in einem Satz. retention run nennt am Ende, wie viele Backups gelöscht wurden.