Auf der Kommandozeile siehst Du mit einem Befehl, ob Deine Website gesichert ist. Du holst die Protokolle und den Support-Bericht, schaltest die Fehlersuche, prüfst die Benachrichtigungen und beobachtest oder beendest den laufenden Job.
WP-CLI fehlt noch? Die Anleitung steht in WP-CLI installieren. Alle Befehle des Plugins nennt Die Befehle im Überblick.
Die Ausgaben der Befehle sind englisch. Einige Aktionen prüfen zuerst den Benutzer: Der Befehl muss als der Benutzer laufen, dem die Ordner des Plugins gehören. --force übergeht die Prüfung. Die Abschnitte unten nennen den Schalter dort, wo es ihn gibt.
Den Zustand der Website zeigen: status
status zeigt dasselbe Urteil wie die Statuskachel der Seite Übersicht. Der Befehl hat keine Aktionen und keine Schalter und ändert nichts.
# Den Zustand der Website zeigen wp cloneworx-backup status
Die erste Zeile nennt den Zustand. Treffen mehrere zu, gilt die Reihenfolge der Tabelle:
| Zustand | Farbe der Statuskachel | Bedeutung |
|---|---|---|
error |
rot | Das letzte Backup ist fehlgeschlagen. |
overdue |
rot | Ein aktiver Backup-Plan hat nicht rechtzeitig ein gutes Backup gemacht. |
disconnected |
gelb | Ein Ziel ist getrennt. |
warn |
gelb | Die Website ist gesichert; das letzte Backup endete mit Warnungen. |
ok |
grün | Die Website ist gesichert. |
none |
grau | Es gibt noch kein Backup. |
Darunter stehen die Einzelheiten. Die Zeilen plans und operation stehen immer da, die anderen nur, wenn es etwas zu nennen gibt:
| Zeile | Bedeutung |
|---|---|
last backup |
Das letzte Backup: Job-Name, Status, Ende, Größe und je Ziel der Zustand. |
last good backup |
Das letzte gute Backup, wenn es ein anderes ist als das letzte. |
overdue |
Der überfällige Plan und wie lange er schon fällig ist oder kein gutes Backup gemacht hat. |
disconnected |
Das getrennte Ziel mit dem Grund. Sind es mehrere, nennt die Zeile die Zahl. |
warnings |
Die Warnungen des letzten Backups, nach Art gezählt. |
plans |
Wie viele Pläne aktiv sind, wie viele es gibt und die Zahl der Ziele. |
alarm |
Die Pläne, für die eine Warnung wegen eines überfälligen Backups läuft. |
operation |
Der Betrieb: das Urteil, der letzte automatische Takt mit seinem Taktgeber, WP-Cron und der Selbstaufruf. |
Das Urteil in der Zeile operation ist ok, late oder missing. late heißt: Es gibt einen aktiven Plan, aber seit zwei Stunden kam kein automatischer Taktgeber. missing heißt: Dem Server fehlt eine Voraussetzung des Plugins.
Die Protokolle holen: logs
logs listet die Protokolldateien des Plugins oder schreibt alle in eine tar-Datei. Es gibt das allgemeine Protokoll mit seiner Vorgängerdatei und je Job ein eigenes Protokoll.
| Schalter | Bedeutung | Erlaubte Werte |
|---|---|---|
--to |
Schreibt alle Protokolle in diese tar-Datei. Die Datei darf es noch nicht geben, und ihr Ordner muss beschreibbar sein. Ohne den Schalter zeigt der Befehl nur die Liste. | Pfad einer Datei |
# Die Protokolldateien auflisten wp cloneworx-backup logs # Alle Protokolle in eine tar-Datei schreiben wp cloneworx-backup logs --to=/tmp/cloneworx-logs.tar
Die Liste nennt je Datei den Namen, die Größe und die letzte Änderung, am Ende die Zahl der Dateien und ihre Größe zusammen. Die tar-Datei ist nicht komprimiert und enthält den Ordner cloneworx-backup-logs. Es ist dieselbe Datei wie bei Alle Protokolle herunterladen auf der Seite Einstellungen.
Wie Du ein Protokoll liest, zeigt Das Protokoll lesen.
Den Support-Bericht erstellen: support
support gibt den Support-Bericht als Text aus oder schreibt ihn in eine Datei. Es ist derselbe Bericht wie bei Support-Bericht kopieren auf der Seite Einstellungen.
| Schalter | Bedeutung | Erlaubte Werte |
|---|---|---|
--to |
Schreibt den Bericht in diese Datei. Die Datei darf es noch nicht geben. Ohne den Schalter erscheint der Bericht in der Ausgabe. | Pfad einer Datei |
# Den Bericht in der Ausgabe zeigen wp cloneworx-backup support # Den Bericht in eine Datei schreiben wp cloneworx-backup support --to=/tmp/cloneworx-bericht.txt
Der Bericht hat die Abschnitte Website, Server, Plugin, Einstellungen, Betrieb, Ziele, Pläne, die letzten zehn Jobs, Umfang, Diagnose und die letzten 40 Zeilen des allgemeinen Protokolls. Der Bericht ist englisch.
Nicht im Bericht stehen: Job-Namen und andere Kennungen aus 32 Zeichen, die Namen von Zielen und Plänen, die Orte und Zugangsdaten der Ziele, E-Mail-Adressen und Serverpfade. Ziele und Pläne erscheinen mit ihrer Kennung, E-Mail-Adressen nur als Zahl, Pfade als <wp>, <wp-content> und <uploads>. Im Bericht stehen die Adresse der Website, je Ziel die Ziel-Art und der Zustand und je Plan Rhythmus, Wurzeln, Ziele und die Zahl für Max. Sicherungen.
Nichts wird gesendet
Der Befehl schickt den Bericht nirgendwohin. Lies ihn durch, bevor Du ihn weitergibst.
Die Fehlersuche schalten: debug
Mit der Fehlersuche schreibt das Plugin ausführliche Zeilen ins Protokoll. Nach 24 Stunden schaltet sie sich selbst aus. In der Oberfläche heißt der Schalter Fehlersuche für 24 Stunden.
| Aktion | Zweck |
|---|---|
debug on |
Schaltet die Fehlersuche ein und nennt den Zeitpunkt, bis zu dem sie läuft. |
debug off |
Schaltet die Fehlersuche aus. |
debug status |
Zeigt, ob die Fehlersuche läuft und bis wann. Ohne Aktion tut wp cloneworx-backup debug dasselbe. |
on und off kennen den Schalter --force.
# Die Fehlersuche einschalten wp cloneworx-backup debug on # Den Zustand zeigen wp cloneworx-backup debug status # Die Fehlersuche ausschalten wp cloneworx-backup debug off
Kann das Plugin sein Protokoll nicht schreiben, warnt jede der drei Aktionen und nennt den Grund.
Die Benachrichtigungen prüfen: notify
| Aktion | Zweck |
|---|---|
notify status |
Zeigt die Empfänger, die drei Schalter der Benachrichtigungen, die laufenden Warnungen wegen überfälliger Backups, die letzte Prüfung, die letzte gesendete E-Mail und den letzten Fehlschlag beim Senden. Ohne Aktion tut wp cloneworx-backup notify dasselbe. |
notify check |
Prüft jetzt, ob ein Plan überfällig ist. Beginnt dabei eine Warnung oder ist eine Erinnerung fällig, sendet das Plugin die E-Mail, wenn diese Benachrichtigung eingeschaltet ist. |
notify test |
Sendet eine Testmail an die eingetragenen Empfänger. Ist niemand eingetragen, geht sie an die Admin-Adresse der Website. |
check und test kennen den Schalter --force.
# Den Stand der Benachrichtigungen zeigen wp cloneworx-backup notify status # Jetzt auf überfällige Backups prüfen wp cloneworx-backup notify check # Eine Testmail senden wp cloneworx-backup notify test
Ein Plan ist überfällig, wenn sein letztes gutes Backup älter ist als sein Rhythmus plus eine Toleranz. Die Toleranz ist der halbe Rhythmus, mindestens 6 Stunden: Ein täglicher Plan ist nach 36 Stunden überfällig. Von selbst läuft diese Prüfung bei jedem Taktgeber, höchstens alle 15 Minuten.
notify check nennt die überfälligen Pläne und zählt, wie viele Warnungen begonnen haben, erinnert wurden und beendet sind und wie viele E-Mails gesendet wurden. notify test nennt die Adressen, an die die Testmail ging. Lehnt WordPress das Senden ab, endet der Befehl mit einem Fehler und nennt den Grund.
Die Empfänger und die Schalter änderst Du mit wp cloneworx-backup settings; siehe Einstellungen und Umfang mit WP-CLI.
News an- und abmelden: news
news zeigt, beginnt oder beendet die Anmeldung für News zu cloneworx Backup. In der Oberfläche ist das der Schalter Über wichtige News und Updates zu cloneworx Backup informieren.
| Aktion | Zweck |
|---|---|
news status |
Zeigt den Zustand: off, pending (die Bestätigung steht aus) oder subscribed. Die Adresse erscheint nur verkürzt. Ohne Aktion tut wp cloneworx-backup news dasselbe. |
news subscribe |
Meldet die Adresse aus --email an. |
news unsubscribe |
Meldet ab. Im Plugin gilt das sofort. |
| Schalter | Bedeutung | Erlaubte Werte |
|---|---|---|
--email |
Nur subscribe: die Adresse, die angemeldet wird. Pflicht. |
eine E-Mail-Adresse |
--force |
Nur subscribe und unsubscribe: läuft auch als anderer Benutzer. |
ohne Wert |
# Den Zustand zeigen wp cloneworx-backup news status # Eine Adresse anmelden wp cloneworx-backup news subscribe --email=admin@example.com # Abmelden wp cloneworx-backup news unsubscribe
Erreicht das Plugin den News-Server nicht oder lehnt der Server ab, endet news subscribe mit einem Fehler und nennt den Grund. Angemeldet ist dann nichts. Bestätigt der Server eine Abmeldung nicht, warnt news unsubscribe; im Plugin ist die Anmeldung trotzdem beendet.
Der Aufruf gilt als Einwilligung
news subscribe sendet die Adresse, die Domain, die Sprache der Website, die Version des Plugins und den Zeitpunkt der Einwilligung an den News-Server von cloneworx. Wer den Befehl ausführt, willigt damit ein. Der Server bestätigt die Anmeldung per E-Mail.
Den laufenden Job beobachten, treiben, abbrechen: job
Ein Backup, ein Restore, eine Prüfung: Alles, was länger dauert, läuft als Job in vielen kurzen Schritten. Je Website läuft immer nur ein Job. job arbeitet mit dem Job, der gerade läuft.
| Aktion | Zweck |
|---|---|
job status |
Zeigt den laufenden Job. Ohne Aktion tut wp cloneworx-backup job dasselbe. |
job run |
Treibt den laufenden Job in diesem Prozess bis zum Ende, ohne Pausen zwischen den Schritten. |
job abort |
Merkt den Abbruch vor. Der Job hält an seinem nächsten Haltepunkt an, räumt auf und endet als abgebrochen. |
job probe |
Startet einen Probelauf: einen Job ohne Daten, der den Server misst. |
# Den laufenden Job zeigen wp cloneworx-backup job status # Den laufenden Job hier zu Ende treiben wp cloneworx-backup job run # Den laufenden Job abbrechen wp cloneworx-backup job abort
job status nennt den Job-Namen, die Art des Jobs, wer ihn gestartet hat und ob gerade ein Schritt arbeitet. Darunter stehen der Fortschritt mit Phase, Einträgen, Bytes und restlicher Zeit und die Zähler: Schritte, hart beendete Schritte, Versuche ohne Fortschritt, Warnungen. Läuft kein Job, sagt der Befehl das.
job run schreibt je Schritt eine Zeile und am Ende das Ergebnis des Jobs. Treibt schon ein anderer Prozess den Job, wartet der Befehl kurz und gibt dann auf. Der Job läuft ohne ihn weiter.
Der Probelauf: job probe
Der Probelauf misst, wie lange ein Schritt auf Deinem Server wirklich überlebt, welche Taktgeber ankommen, wie schnell der Arbeitsordner schreibt und wie viel Arbeitsspeicher da ist. Er sichert nichts und berührt kein Ziel.
| Schalter | Bedeutung | Erlaubte Werte |
|---|---|---|
--units |
Die Zahl der Arbeitseinheiten. | ganze Zahl, Vorgabe 200 |
--unit-ms |
Die nachgestellte Arbeit je Einheit in Millisekunden. | ganze Zahl, Vorgabe 50 |
--background |
Der Befehl startet den Probelauf und schickt den ersten Selbstaufruf. Danach treibt sich der Job über den Webserver selbst. Das Ergebnis zeigt dann die Grenzen des Webservers, nicht die der Kommandozeile. | ohne Wert |
--force |
Läuft auch als anderer Benutzer. | ohne Wert |
# Ein Probelauf über mehrere Schritte: rund 100 Sekunden wp cloneworx-backup job probe --units=2000 --unit-ms=50 # Derselbe Probelauf, vom Webserver getrieben wp cloneworx-backup job probe --units=2000 --unit-ms=50 --background
Das Ergebnis steht danach auch auf der Seite Einstellungen in der Kachel System und Support, im Block Diagnose der Ansicht Erweitert.
Weitere Diagnose-Jobs
Drei weitere Aktionen starten Diagnose-Jobs. Keiner macht ein Backup; was sie schreiben, entfernen sie am Ende wieder.
| Aktion | Zweck | Eigene Schalter |
|---|---|---|
job filelist |
Baut die Dateiliste: was ein Backup enthielte, was ausgelassen wird und ob der freie Platz reicht. |
--roots, --targets
|
job dbexport |
Exportiert die Datenbank in den Arbeitsordner, liest den Export zurück und vergleicht die Zeilen je Tabelle. |
--tables, --no-snapshot
|
job files |
Schreibt den Dateiteil eines Backups in den Arbeitsordner und prüft jedes Teil. Mit --targets überträgt der Job die Teile an diese Ziele, prüft sie dort und entfernt sie wieder. |
--roots, --targets, --part-limit (Größe eines Teils in MB, Vorgabe 256) |
Alle drei kennen außerdem --max-per-step, --background und --force.
# Zeigen, was ein Backup der Uploads und Plugins enthielte wp cloneworx-backup job filelist --roots=wp-uploads,wp-plugins # Den Export der Datenbank prüfen wp cloneworx-backup job dbexport