Fortschritt, Meldungen und Protokoll

Ob Backup, Prüfung oder Restore: Während das Plugin arbeitet, zeigt es seinen Fortschritt, und am Ende meldet es das Ergebnis. Beides sieht auf jeder Seite gleich aus. Hier liest Du, was die Fortschrittszeile, die Meldungen und das Fenster Protokoll sagen.

Jobs und Schritte

Ein Backup, eine Prüfung, das Löschen eines Backups und ein Restore sind Jobs. Ein Job läuft nie an einem Stück, sondern in vielen kurzen Schritten: Webserver beenden ein Programm wie dieses Plugin oft schon nach rund 30 Sekunden. Jeder Schritt speichert seinen Stand, der nächste Schritt macht dort weiter.

• Es läuft immer nur ein Job zur selben Zeit. Solange einer läuft, ist Jetzt sichern gesperrt. Startest Du in dieser Zeit über ein Menü einen weiteren Job, zum Beispiel eine Prüfung, meldet die Seite in Rot Es läuft schon ein Job.
• Ein Job läuft weiter, wenn Du die Seite schließt. Öffnest Du sie wieder, zeigt sie den laufenden Job.
• Die Übersicht und die Seite Backup zeigen auch Jobs, die der Zeitplan oder die Kommandozeile gestartet hat.
• Während ein Job läuft, darfst Du Einstellungen, Backup-Pläne und Ziele ändern und Protokolle lesen. Die Änderungen gelten ab dem nächsten Job. Ein Backup löschen oder ein Ziel samt seinen Backups entfernen kannst Du erst nach dem Ende des Jobs: Beides ist selbst ein Job.

Die Fortschrittszeile

1. Was das laufende Backup sichert und an welches Ziel, zum Beispiel „Datenbank, Dateien → SFTP 1“.
2. Die Fortschrittszeile nennt die Phase, die Einträge, die Menge und die verbleibende Zeit.
3. Backup abbrechen hält den Job beim nächsten Schritt an.
4. Jetzt sichern ist gesperrt, solange ein Job läuft.

Die Teile der Zeile sind durch einen Punkt getrennt. Ein Teil fehlt, wenn die Phase ihn nicht zählt.

Teil	Beispiel	Bedeutung
Phase	Dateien werden gepackt	Woran der Job gerade arbeitet.
Einträge	… von … Einträgen	Wie viele Einträge der Phase erledigt sind. Beim Export der Datenbank sind es Zeilen der Tabellen, beim Packen Dateien und Ordner.
Menge	„412 MB / 1,8 GB“	Die erledigte und die ganze Menge der Phase. Ab 1 GB steht sie in GB, darunter in MB.
Zeit	noch etwa …	Die geschätzte verbleibende Zeit.

Die Zeile wird jede Sekunde aus dem gespeicherten Stand des Jobs erneuert. Wo sie steht, hängt von der Seite ab:

Seite	Ort der Fortschrittszeile
Übersicht	in der Statuskachel
Backup	in der Kachel Backup
Ziele	unter der Statuskachel, beim Prüfen, Aufräumen, Wiederfinden und Entfernen samt Backups
Restore	in der Hauptkachel, zusammen mit dem Schritt des Restores und einem Balken; beim Import in der Kachel des Imports
Einstellungen	in der Ansicht Erweitert in der Kachel System und Support, im Block Diagnose

Die Phasen eines Backups

Anzeige	Was geschieht
Ziele werden geprüft	Das Plugin verbindet sich einmal mit jedem Ziel. Ein Ziel, das nicht erreichbar ist, wird ausgelassen und ergibt eine Warnung. Bleibt kein Ziel übrig, endet der Job.
Dateien werden gelistet	Die Liste der Dateien und Ordner entsteht.
Freier Platz wird geprüft	Das Plugin prüft den freien Platz im Arbeitsordner und an jedem Ziel.
Datenbank wird exportiert	Die Tabellen der Website gehen in das Backup.
Dateien werden gepackt	Die Dateien gehen in das Backup. Jedes fertige Teil liest das Plugin zur Kontrolle noch einmal.
Übertragung an die Ziele	Ein fertiges Teil geht an alle Ziele und wird danach im Arbeitsordner gelöscht.
Paket wird abgeschlossen	Der Index und zuletzt die Info-Datei entstehen. Erst mit der Info-Datei ist ein Backup vollständig.
Katalog wird aktualisiert	Das Plugin trägt das Backup im Katalog jedes Ziels ein.

Exportieren, Packen und Übertragen wechseln sich ab: Jedes fertige Teil geht an die Ziele, bevor das nächste entsteht. Die Zeile springt deshalb zwischen diesen Phasen hin und her.

Andere Jobs

Anzeige	Job
Backup wird geprüft	Die Prüfung eines Backups oder aller Backups an einem Ziel.
Backup wird gelöscht	Das Löschen eines Backups von Hand. Dieselbe Zeile steht da, wenn Du ein Ziel samt seinen Backups entfernst.
Veraltete Backups werden gelöscht	Der Nachlauf nach einem Backup: Das Plugin löscht, was über Max. Sicherungen hinausgeht.
Reste werden aufgeräumt	Das Aufräumen von Resten abgebrochener Jobs.
Backups suchen	Das Wiederfinden von Backups an einem Ziel.
Ein Teil wird gegengelesen	Der Import eines Backups aus einer Datei: Das Plugin liest jedes Teil gegen seine Prüfsumme, bevor es das Backup am Ziel speichert. Dieselbe Zeile steht beim Datenbank-Export der Diagnose, während er den Export zurückliest.
Probelauf	Der Probelauf der Diagnose.

Nennt der Job keine Phase, steht dort Backup läuft. Die Schritte eines Restores erklärt Die Seite „Restore“.

1. Die Fortschrittszeile einer Prüfung. Statt der Einträge zählt sie Backups: Backup … von … nennt das Backup, an dem die Prüfung gerade arbeitet. Bei nur einem Backup fehlt die Angabe.
2. Prüfung abbrechen

Der Nachlauf nach einem Backup

Nach jedem guten Backup startet von selbst ein zweiter Job. Er löscht an den Zielen die Backups, die über Max. Sicherungen hinausgehen, und räumt Reste abgebrochener Jobs weg. Seine Fortschrittszeile erscheint nur, wenn er wirklich etwas löscht. Auch eine Meldung kommt nur dann: Ein altes Backup gelöscht., … alte Backups gelöscht. oder Reste aufgeräumt: … Ordner. Scheitert das Löschen, meldet er in Gelb Das Löschen alter Backups ist fehlgeschlagen.

Die verbleibende Zeit

Das Plugin schätzt die Zeit aus dem Tempo der laufenden Phase: beim Export der Datenbank aus den Zeilen je Sekunde, beim Packen aus der Menge je Sekunde. Beim Packen zählt die Übertragung mit, die noch aussteht.

• noch etwa … nennt die Zeit gerundet in einer Einheit: Sekunden, Minuten, Stunden oder Tage.
• verbleibende Zeit wird berechnet … steht am Anfang eines Jobs, solange das Plugin noch zu wenig gemessen hat. Eine Schätzung aus den ersten Sekunden wäre unzuverlässig.
• Hat die Zeile für einen Job schon eine Zeit genannt, erscheint dieser Satz nicht wieder. In den letzten Phasen steht dann oft keine Zeit mehr da.

Während die Datenbank exportiert wird, zählen die Dateien noch nicht mit: Das Tempo des Packens ist noch nicht bekannt. Die genannte Zeit gilt in dieser Phase nur für die Datenbank.

Einen Job abbrechen

Der Link zum Abbrechen steht direkt unter der Fortschrittszeile. Er heißt bei einer Prüfung Prüfung abbrechen, beim Wiederfinden von Backups Suche abbrechen und bei jedem anderen Job Backup abbrechen, auch beim Löschen und beim Restore. Eine Rückfrage gibt es nicht.

1. Abbruch angefordert; das Backup hält beim nächsten Schritt an. Der Satz steht an der Stelle des Links.

• Der Job hält nicht sofort an, sondern an der nächsten Stelle, an der er seinen Stand speichert.
• Ein abgebrochenes Backup räumt auf: Es entfernt seine Arbeitsdateien und alles, was es schon an die Ziele übertragen hat.
• Das Ergebnis ist die gelbe Meldung Backup abgebrochen. In der Liste der Backups steht der Eintrag mit grauem Punkt und Abgebrochen.
• Ein abgebrochenes Backup ändert das Urteil der Statuskachel auf der Übersicht nicht.
• Ein Restore lässt sich abbrechen, bis der Tausch beginnt. So lange zeigt die Seite Restore zusätzlich den Knopf Abbrechen. Danach bleibt der Weg Restore rückgängig machen.

Die Meldung

Jede Seite zeigt ihre Meldungen an einer Stelle: direkt unter der Hauptkachel. Zu sehen ist immer nur die Meldung der letzten Aktion. Beginnst Du eine neue Aktion, verschwindet die vorige Meldung, auch eine rote.

Farbe	Bedeutung	Verhalten
grün	Es hat geklappt.	Die Meldung schließt sich nach 8 Sekunden von selbst.
gelb	Eine Warnung: Nicht alles lief glatt, oder es fehlt noch etwas.	Die Meldung bleibt stehen, bis Du sie schließt oder eine neue Aktion beginnst.
rot	Es ist gescheitert.	Die Meldung bleibt stehen, bis Du sie schließt oder eine neue Aktion beginnst.

1. Die grüne Meldung, hier Backup abgeschlossen.
2. Das Band am oberen Rand läuft nach links ab und zeigt die Zeit, die bleibt. Steht die Maus auf der Meldung, hält die Zeit an.
3. Schließen schließt die Meldung sofort.

1. Die gelbe Meldung, hier nach einem Backup mit Warnungen.
2. Schließen
3. Der Link Protokoll öffnet das Protokoll dieses Backups.

Der Link zum Protokoll

Bei einem Problem musst Du das Protokoll nicht suchen. Der Link steht in der Meldung:

• Eine rote Meldung nach einem Job trägt den Link Protokoll. Er öffnet das Protokoll dieses Jobs. Denselben Link trägt die gelbe Meldung nach einem Backup, einer Prüfung, dem Löschen alter Backups, dem Aufräumen, dem Wiederfinden und einer Diagnose, zum Beispiel nach Warnungen oder nach einem Abbruch.
• Eine rote Meldung ohne Job trägt den Link Protokoll anzeigen. Er öffnet das allgemeine Protokoll. Beispiele: Ein Backup ließ sich nicht starten, oder die Testmail ließ sich nicht senden. Denselben Link trägt die gelbe Meldung nach einem fehlgeschlagenen Verbindungstest.
• Ohne Link bleiben grüne Meldungen und Meldungen, zu denen es nichts nachzulesen gibt, zum Beispiel Es läuft schon ein Job. Auch die gelben Meldungen nach einem Restore haben keinen Link, zum Beispiel nach einem Restore mit Warnungen oder nach einem abgebrochenen Restore. Das Protokoll eines Restores öffnest Du auf der Seite Restore in der Ansicht Erweitert unter Letzte Restores. Ohne Link bleibt auch die gelbe Meldung nach Taktgeber prüfen auf der Seite Einstellungen.

1. Die rote Meldung, hier Das Backup konnte nicht gestartet werden: … Hinter dem Doppelpunkt steht die Ursache.
2. Protokoll anzeigen öffnet das allgemeine Protokoll.

Die Meldungen nach einem Backup

Meldung	Bedeutung
grün Backup abgeschlossen.	Jedes Ziel hat das vollständige Backup, und nichts wurde ausgelassen.
gelb Backup mit Warnungen abgeschlossen.	Das Backup ist da, aber etwas lief nicht glatt. Hinter dem Satz stehen Zahl und Art der Warnungen.
gelb Backup abgebrochen.	Du hast den Job abgebrochen.
rot Backup fehlgeschlagen.	Das Backup ist gescheitert. Was schon übertragen war, entfernt das Plugin an den Zielen wieder. Hinter dem Satz steht die Ursache im Klartext, zum Beispiel Nicht genug freier Platz. oder Kein Ziel ist erreichbar.

Andere Jobs melden in denselben Farben mit eigenem Wortlaut, zum Beispiel Backup geprüft: lesbar und vollständig. oder Backup gelöscht. Auf der Seite Ziele nennen die Meldungen das Ziel beim Namen.

Mit Warnungen

Ein Backup mit Warnungen sagt gleich in der Meldung, was nicht glatt lief. Die Meldung zählt je Art:

In der Meldung	Bedeutung
… nicht lesbar	Dateien oder Ordner, die das Plugin nicht lesen konnte.
… verschwunden	Dateien, die es beim Packen nicht mehr gab.
… nicht unterstützt	Einträge, die keine Dateien, Ordner oder Verknüpfungen sind und sich deshalb nicht sichern lassen.
… beim Lesen geändert	Dateien, die sich geändert haben, während das Plugin sie las.
… Ziel(e) gescheitert	Ziele, an denen das Backup nicht ankam, während ein anderes Ziel es hat.
… Datenbank-Vermerk(e)	Vermerke aus dem Export der Datenbank.

Die Namen stehen im Protokoll des Jobs: Es nennt jeden betroffenen Eintrag mit seinem Pfad innerhalb der Website. Je Grund nennt es höchstens 50 Einträge; weitere zählt es, ohne sie zu nennen.

Die Meldung des Servers im Wortlaut

Scheitert ein Job oder ein Verbindungstest an einem entfernten Ziel, zeigt das Plugin seine eigene Erklärung und darunter, was der Server und die Übertragung gemeldet haben.

1. Das gescheiterte Ziel und die Ursache im Klartext, in der Form Ziel „…“: …
2. Der Wortlaut im Original: Meldung des Servers ist die letzte Antwort des Servers, Meldung von cURL ist die Meldung der Übertragung.
3. Protokoll öffnet das Protokoll des Jobs.

• Der Wortlaut ist nicht übersetzt: Er steht so da, wie der Server und cURL ihn gemeldet haben.
• Bevor der Wortlaut erscheint, macht das Plugin unkenntlich, was nicht auf einen Bildschirm gehört. Aus dem Ordner des Ziels wird <folder>, aus dem Benutzer <user>, aus dem Server und jeder IP-Adresse <host>, aus dem Namen eines Backups <job>. An der Stelle eines Passworts oder Schlüssels stehen Sterne.
• Bricht das Senden mitten im Upload ab, kennt cURL die Antwort des Servers nicht. Das Plugin nennt dann beide möglichen Ursachen: Das Senden der Daten ist gescheitert. Mögliche Ursachen: Die Verbindung wurde unterbrochen, oder am Ziel ist kein Platz mehr.

Der Wortlaut steht an vier Stellen: im Ergebnis des Verbindungstests auf der Seite Ziele, in der Meldung nach einem Job, in der Statuskachel der Übersicht und im Protokoll.

Das Fenster „Protokoll“

Das Fenster heißt immer Protokoll, gleich was es zeigt. Was geschah und wann, steht in seinen Zeilen. So öffnest Du es:

• über den Link Protokoll oder Protokoll anzeigen in einer Meldung,
• über den Link Protokoll in der Statuskachel der Übersicht,
• über Mehr …, dann Protokoll in der Zeile eines Backups,
• über Protokoll anzeigen im Ergebnis eines fehlgeschlagenen Verbindungstests,
• über Protokoll in der Liste Letzte Restores auf der Seite Restore, in der Ansicht Erweitert,
• über Protokoll anzeigen auf der Seite Einstellungen, in der Ansicht Erweitert in der Kachel Protokoll.

1. Protokoll ist der Titel des Fensters.
2. Das Kreuz schließt das Fenster.
3. Eine Zeile: die Uhrzeit, die Stufe und die Meldung. Darunter stehen klein die Einzelheiten zur Meldung.
4. Eine Warnung: Die Stufe steht in Gelb. Bei einem Fehler steht sie in Rot.

Es gibt zwei Arten von Protokollen:

Art	Inhalt	Zeit in der Zeile
Protokoll eines Jobs	Alles, was bei diesem einen Backup, dieser Prüfung oder diesem Restore geschah.	Uhrzeit
allgemeines Protokoll	Alles, was zu keinem Job gehört: Verbindungstests von Zielen, Änderungen an Einstellungen, der Zeitplan.	Datum und Uhrzeit

1. Eine Zeile des allgemeinen Protokolls. Vor der Uhrzeit steht das Datum, weil dieses Protokoll über Tage reicht.

So liest Du eine Zeile

Stufe	Farbe	Bedeutung
INFO	ohne	Ein gewöhnlicher Schritt.
WARNING	gelb	Etwas lief nicht glatt; der Job lief weiter.
ERROR	rot	Ein Fehler.
DEBUG	grau	Ausführliche Zeilen. Es gibt sie nur, solange die Fehlersuche eingeschaltet ist.

• Die Zeiten stehen in der Zeitzone der Website.
• Die neueste Zeile steht unten.
• Protokolle sind englisch, in jeder Sprache der Oberfläche.
• Das Fenster zeigt die letzten 500 Zeilen. Ist das Protokoll länger, steht darüber Nur die letzten … Zeilen werden gezeigt.
• Passwörter und Schlüssel stehen nie im Protokoll: Das Plugin ersetzt sie durch Sterne.

Wenn das Protokoll fehlt

Im Fenster steht	Bedeutung
Zu diesem Backup gibt es kein Protokoll mehr. Protokolle werden … Tage aufbewahrt.	Die Datei des Protokolls gibt es nicht mehr, zum Beispiel weil die Aufbewahrung abgelaufen oder die Website umgezogen ist. Das Plugin bewahrt die Protokolle der Jobs in der Vorgabe 30 Tage auf; möglich sind 7 bis 365 Tage. Du änderst die Zahl auf der Seite Einstellungen, in der Ansicht Erweitert in der Kachel Protokoll, im Feld Protokolle aufbewahren für.
Es gibt noch kein allgemeines Protokoll.	Das Plugin hat noch nichts in das allgemeine Protokoll geschrieben.
Das Protokoll ist leer.	Die Datei ist da, enthält aber keine Zeile.
Das Protokoll konnte nicht geladen werden.	Der Server hat das Protokoll nicht geliefert. Dahinter steht die Ursache.

Siehe auch

• Das Protokoll lesen
• Wenn ein Backup fehlschlägt oder mit Warnungen endet
• Das Plugin an Deinen Server anpassen
• Hilfe holen: Support-Bericht, Fehlersuche und Diagnose
• Zustand, Protokolle und Support mit WP-CLI

Auf der Kommandozeile

WP-CLI noch nicht eingerichtet? So installierst Du WP-CLI.

Den laufenden Job siehst Du auch auf der Kommandozeile, und Du kannst ihn dort abbrechen. Das Fenster Protokoll gibt es dort nicht: Die Kommandozeile listet die Protokolldateien und schreibt sie in eine tar-Datei. Die Ausgaben sind englisch.

# Den laufenden Job mit Phase und Fortschritt zeigen
wp cloneworx-backup job status

# Den laufenden Job abbrechen
wp cloneworx-backup job abort

# Die Protokolldateien auflisten
wp cloneworx-backup logs

# Alle Protokolle in eine tar-Datei schreiben
wp cloneworx-backup logs --to=/pfad/protokolle.tar

# Die Fehlersuche für 24 Stunden einschalten
wp cloneworx-backup debug on