Voortgang, meldingen en logboek

Of het nu een back-up, een controle of een herstel is: terwijl de plugin werkt, toont hij zijn voortgang, en aan het einde meldt hij het resultaat. Beide zien er op elke pagina hetzelfde uit. Hier lees je wat de voortgangsweergave, de meldingen en het dialoogvenster Logboek zeggen.

Taken en stappen

Een back-up, een controle, het verwijderen van een back-up en een herstel zijn taken. Een taak loopt nooit in één keer, maar in veel korte stappen: webservers beëindigen een programma als deze plugin vaak al na ongeveer 30 seconden. Elke stap slaat zijn toestand op, de volgende stap gaat daar verder.

• Er loopt altijd maar één taak tegelijk. Zolang er een loopt, is Nu back-uppen geblokkeerd. Start je in die tijd via een menu een andere taak, bijvoorbeeld een controle, dan meldt de pagina in rood Er loopt al een taak.
• Een taak loopt door als je de pagina sluit. Open je hem weer, dan toont hij de lopende taak.
• Het Overzicht en de pagina Back-up tonen ook taken die het schema of de opdrachtregel heeft gestart.
• Terwijl een taak loopt, mag je instellingen, back-upplannen en doelen wijzigen en logboeken lezen. De wijzigingen gelden vanaf de volgende taak. Een back-up verwijderen of een doel samen met zijn back-ups verwijderen kun je pas na het einde van de taak: beide zijn zelf een taak.

De voortgangsweergave

1. Wat de lopende back-up back-upt en naar welk doel, bijvoorbeeld “Database, bestanden → SFTP 1”.
2. De voortgangsweergave noemt de fase, de items, de hoeveelheid en de resterende tijd.
3. Back-up afbreken stopt de taak bij de volgende stap.
4. Nu back-uppen is geblokkeerd zolang een taak loopt.

De delen van de regel zijn door een punt gescheiden. Een deel ontbreekt als de fase het niet telt.

Deel	Voorbeeld	Betekenis
Fase	Bestanden worden ingepakt	Waaraan de taak op dat moment werkt.
Items	… van … items	Hoeveel items van de fase klaar zijn. Bij de export van de database zijn het rijen van de tabellen, bij het inpakken bestanden en mappen.
Hoeveelheid	“412 MB / 1,8 GB”	De verwerkte en de hele hoeveelheid van de fase. Vanaf 1 GB staat ze in GB, daaronder in MB.
Tijd	nog ongeveer …	De geschatte resterende tijd.

De regel wordt elke seconde ververst uit de opgeslagen toestand van de taak. Waar hij staat, hangt af van de pagina:

Pagina	Plek van de voortgangsweergave
Overzicht	in de statustegel
Back-up	in de tegel Back-up
Doelen	onder de statustegel, bij het controleren, opruimen, terugvinden en verwijderen samen met back-ups
Herstellen	in de hoofdtegel, samen met de stap van het herstel en een balk; bij de import in de tegel van de import
Instellingen	in de weergave Uitgebreid in de tegel Systeem en support, in het blok Diagnose

De fasen van een back-up

Weergave	Wat er gebeurt
Doelen worden gecontroleerd	De plugin maakt eenmaal verbinding met elk doel. Een doel dat niet bereikbaar is, wordt overgeslagen en levert een waarschuwing op. Blijft er geen doel over, dan eindigt de taak.
Bestanden worden geïnventariseerd	De lijst van de bestanden en mappen ontstaat.
Vrije ruimte wordt gecontroleerd	De plugin controleert de vrije ruimte in de werkmap en op elk doel.
Database wordt geëxporteerd	De tabellen van de website gaan in de back-up.
Bestanden worden ingepakt	De bestanden gaan in de back-up. Elk voltooid deel leest de plugin ter controle nog een keer.
Overdracht naar de doelen	Een voltooid deel gaat naar alle doelen en wordt daarna in de werkmap verwijderd.
Pakket wordt afgerond	De index en als laatste het infobestand ontstaan. Pas met het infobestand is een back-up volledig.
Catalogus wordt bijgewerkt	De plugin zet de back-up in de catalogus van elk doel.

Exporteren, inpakken en overdragen wisselen elkaar af: elk voltooid deel gaat naar de doelen voordat het volgende ontstaat. De regel springt daarom tussen deze fasen heen en weer.

Andere taken

Weergave	Taak
Back-up wordt gecontroleerd	De controle van een back-up of van alle back-ups op een doel.
Back-up wordt verwijderd	Het handmatig verwijderen van een back-up. Dezelfde regel staat er als je een doel samen met zijn back-ups verwijdert.
Verouderde back-ups worden verwijderd	Het nawerk na een back-up: de plugin verwijdert wat boven Max. back-ups uitkomt.
Resten worden opgeruimd	Het opruimen van resten van afgebroken taken.
Back-ups zoeken	Het terugvinden van back-ups op een doel.
Een deel wordt gecontroleerd	De import van een back-up uit een bestand: de plugin leest elk deel tegen zijn controlesom voordat hij de back-up op het doel opslaat. Dezelfde regel staat bij de database-export van de diagnose terwijl die de export terugleest.
Proefrun	De proefrun van de diagnose.

Noemt de taak geen fase, dan staat daar Back-up wordt uitgevoerd. De stappen van een herstel legt De pagina “Herstellen” uit.

1. De voortgangsweergave van een controle. In plaats van de items telt ze back-ups: Back-up … van … noemt de back-up waaraan de controle op dat moment werkt. Bij maar één back-up ontbreekt de vermelding.
2. Controle afbreken

Het nawerk na een back-up

Na elke goede back-up start vanzelf een tweede taak. Die verwijdert op de doelen de back-ups die boven Max. back-ups uitkomen, en ruimt resten van afgebroken taken op. Haar voortgangsweergave verschijnt alleen als ze werkelijk iets verwijdert. Ook een melding komt alleen dan: Eén oude back-up verwijderd., … oude back-ups verwijderd. of Resten opgeruimd: … mappen. Mislukt het verwijderen, dan meldt ze in geel Het verwijderen van oude back-ups is mislukt.

De resterende tijd

De plugin schat de tijd uit het tempo van de lopende fase: bij de export van de database uit de rijen per seconde, bij het inpakken uit de hoeveelheid per seconde. Bij het inpakken telt de overdracht mee die nog uitstaat.

• nog ongeveer … noemt de tijd afgerond in één eenheid: seconden, minuten, uren of dagen.
• resterende tijd wordt berekend … staat aan het begin van een taak, zolang de plugin nog te weinig heeft gemeten. Een schatting uit de eerste seconden zou onbetrouwbaar zijn.
• Heeft de regel voor een taak al een tijd genoemd, dan verschijnt deze zin niet opnieuw. In de laatste fasen staat er dan vaak geen tijd meer.

Terwijl de database wordt geëxporteerd, tellen de bestanden nog niet mee: het tempo van het inpakken is nog niet bekend. De genoemde tijd geldt in deze fase alleen voor de database.

Een taak afbreken

De link om af te breken staat direct onder de voortgangsweergave. Hij heet bij een controle Controle afbreken, bij het terugvinden van back-ups Zoeken afbreken en bij elke andere taak Back-up afbreken, ook bij het verwijderen en bij het herstel. Een bevestigingsdialoog is er niet.

1. Afbreken aangevraagd; de back-up stopt bij de volgende stap. De zin staat op de plaats van de link.

• De taak stopt niet meteen, maar op de volgende plek waar hij zijn toestand opslaat.
• Een afgebroken back-up ruimt op: hij verwijdert zijn werkbestanden en alles wat hij al naar de doelen heeft overgedragen.
• Het resultaat is de gele melding Back-up afgebroken. In de lijst van de back-ups staat de vermelding met een grijze stip; in de kolom Type staat Afgebroken.
• Een afgebroken back-up verandert het resultaat van de statustegel op het Overzicht niet.
• Een herstel kan worden afgebroken tot de omschakeling begint. Zo lang toont de pagina Herstellen bovendien de knop Annuleren. Daarna blijft de weg Herstel ongedaan maken.

De melding

Elke pagina toont zijn meldingen op één plek: direct onder de hoofdtegel. Te zien is altijd alleen de melding van de laatste actie. Begin je een nieuwe actie, dan verdwijnt de vorige melding, ook een rode.

Kleur	Betekenis	Gedrag
groen	Het is gelukt.	De melding sluit zichzelf na 8 seconden.
geel	Een waarschuwing: niet alles liep soepel, of er ontbreekt nog iets.	De melding blijft staan tot je hem sluit of een nieuwe actie begint.
rood	Het is mislukt.	De melding blijft staan tot je hem sluit of een nieuwe actie begint.

1. De groene melding, hier Back-up voltooid.
2. De balk aan de bovenrand loopt naar links af en toont de tijd die overblijft. Staat de muis op de melding, dan staat de tijd stil.
3. Sluiten sluit de melding meteen.

1. De gele melding, hier na een back-up met waarschuwingen.
2. Sluiten
3. De link Logboek opent het logboek van deze back-up.

De link naar het logboek

Bij een probleem hoef je het logboek niet te zoeken. De link staat in de melding:

• Een rode melding na een taak draagt de link Logboek. Die opent het logboek van deze taak. Dezelfde link draagt de gele melding na een back-up, een controle, het verwijderen van oude back-ups, het opruimen, het terugvinden en een diagnose, bijvoorbeeld na waarschuwingen of na een afbreking.
• Een rode melding zonder taak draagt de link Logboek tonen. Die opent het algemene logboek. Voorbeelden: een back-up kon niet worden gestart, of de testmail kon niet worden verzonden. Dezelfde link draagt de gele melding na een mislukte verbindingstest.
• Zonder link blijven groene meldingen en meldingen waarover niets na te lezen is, bijvoorbeeld Er loopt al een taak. Ook de gele meldingen na een herstel hebben geen link, bijvoorbeeld na een herstel met waarschuwingen of na een afgebroken herstel. Het logboek van een herstel open je op de pagina Herstellen in de weergave Uitgebreid onder Recente herstelacties. Zonder link blijft ook de gele melding na Taakbronnen controleren op de pagina Instellingen.

1. De rode melding, hier De back-up kon niet worden gestart: … Achter de dubbele punt staat de oorzaak.
2. Logboek tonen opent het algemene logboek.

De meldingen na een back-up

Melding	Betekenis
groen Back-up voltooid.	Elk doel heeft de volledige back-up, en er is niets weggelaten.
geel Back-up voltooid met waarschuwingen.	De back-up is er, maar iets liep niet soepel. Achter de zin staan aantal en soort van de waarschuwingen.
geel Back-up afgebroken.	Je hebt de taak afgebroken.
rood Back-up mislukt.	De back-up is mislukt. Wat al was overgedragen, verwijdert de plugin op de doelen weer. Achter de zin staat de oorzaak in gewone taal, bijvoorbeeld Niet genoeg vrije ruimte. of Geen enkel doel is bereikbaar.

Andere taken melden in dezelfde kleuren met een eigen tekst, bijvoorbeeld Back-up gecontroleerd: leesbaar en volledig. of Back-up verwijderd. Op de pagina Doelen noemen de meldingen het doel bij naam.

Met waarschuwingen

Een back-up met waarschuwingen zegt meteen in de melding wat niet soepel liep. De melding telt per soort:

In de melding	Betekenis
… niet leesbaar	Bestanden of mappen die de plugin niet kon lezen.
… verdwenen	Bestanden die er bij het inpakken niet meer waren.
… niet ondersteund	Items die geen bestanden, mappen of koppelingen zijn en daarom niet kunnen worden geback-upt.
… gewijzigd tijdens het lezen	Bestanden die zijn gewijzigd terwijl de plugin ze las.
… doel(en) mislukt	Doelen waarop de back-up niet aankwam, terwijl een ander doel hem heeft.
… databasenotitie(s)	Opmerkingen uit de export van de database.

De namen staan in het logboek van de taak: het noemt elk betrokken item met zijn pad binnen de website. Per reden noemt het hoogstens 50 items; verdere telt het zonder ze te noemen.

De melding van het doel in het origineel

Mislukt een taak of een verbindingstest op een extern doel, dan toont de plugin zijn eigen uitleg en daaronder wat het doel en de overdracht hebben gemeld.

1. Het mislukte doel en de oorzaak in gewone taal, in de vorm Doel “…”: …
2. De melding in het origineel: Melding van het doel is het laatste antwoord van het doel, dus van de server, de dienst of de aanbieder erachter; Melding van cURL is de melding van de overdracht.
3. Logboek opent het logboek van de taak.

• De melding is niet vertaald: de tekst staat er zoals het doel en cURL hem hebben gemeld.
• Voordat de melding verschijnt, maakt de plugin onherkenbaar wat niet op een scherm hoort. Van de map van het doel wordt <folder>, van de gebruiker <user>, van de server en elk IP-adres <host>, van de naam van een back-up <job>. Op de plaats van een wachtwoord of sleutel staan sterretjes.
• Breekt het verzenden midden in de upload af, dan kent cURL het antwoord van het doel niet. De plugin noemt dan beide mogelijke oorzaken: Het verzenden van de gegevens is mislukt. Mogelijke oorzaken: de verbinding is onderbroken, of er is geen ruimte meer op het doel.

De melding staat op vier plekken: in het resultaat van de verbindingstest op de pagina Doelen, in de melding na een taak, in de statustegel van het Overzicht en in het logboek. Op de opdrachtregel staat hij onder de meldingen van een taak: achter target: de melding van het doel, achter cURL het nummer en de melding van cURL.

Het dialoogvenster “Logboek”

Het dialoogvenster heet altijd Logboek, wat het ook toont. Wat er gebeurde en wanneer, staat in zijn regels. Zo open je het:

• via de link Logboek of Logboek tonen in een melding,
• via de link Logboek in de statustegel van het Overzicht,
• via Meer …, dan Logboek in de regel van een back-up,
• via Logboek tonen in het resultaat van een mislukte verbindingstest,
• via Logboek in de lijst Recente herstelacties op de pagina Herstellen, in de weergave Uitgebreid,
• via Logboek tonen op de pagina Instellingen, in de weergave Uitgebreid in de tegel Logboek.

1. Logboek is de titel van het dialoogvenster.
2. Het kruis sluit het dialoogvenster.
3. Een regel: de tijd, het niveau en de melding. Daaronder staan klein de details bij de melding.
4. Een waarschuwing: het niveau staat in geel. Bij een fout staat het in rood.

Er zijn twee soorten logboeken:

Soort	Inhoud	Tijd in de regel
Logboek van een taak	Alles wat bij deze ene back-up, deze controle of dit herstel gebeurde.	tijd
algemeen logboek	Alles wat bij geen enkele taak hoort: verbindingstests van doelen, wijzigingen van instellingen, het schema.	datum en tijd

1. Een regel van het algemene logboek. Vóór de tijd staat de datum, omdat dit logboek over dagen loopt.

Zo lees je een regel

Niveau	Kleur	Betekenis
INFO	zonder	Een gewone stap.
WARNING	geel	Iets liep niet soepel; de taak liep door.
ERROR	rood	Een fout.
DEBUG	grijs	Uitgebreide regels. Die zijn er alleen zolang de foutopsporing is ingeschakeld.

• De tijden staan in de tijdzone van de website.
• De nieuwste regel staat onderaan.
• Logboeken zijn Engels, in elke taal van de interface.
• Het dialoogvenster toont de laatste 500 regels. Is het logboek langer, dan staat erboven Alleen de laatste … regels worden getoond.
• Wachtwoorden en sleutels staan nooit in het logboek: de plugin vervangt ze door sterretjes.

Als het logboek ontbreekt

In het dialoogvenster staat	Betekenis
Er is geen logboek meer voor deze back-up. Logboeken worden … dagen bewaard.	Het bestand van het logboek bestaat niet meer, bijvoorbeeld omdat de bewaartermijn is verstreken of de website is verhuisd. De plugin bewaart de logboeken van de taken standaard 30 dagen; mogelijk is 7 tot 365 dagen. Je wijzigt het aantal op de pagina Instellingen, in de weergave Uitgebreid in de tegel Logboek, in het veld Logboeken bewaren gedurende.
Er is nog geen algemeen logboek.	De plugin heeft nog niets in het algemene logboek geschreven.
Het logboek is leeg.	Het bestand is er, maar bevat geen regel.
Het logboek kon niet worden geladen.	De server heeft het logboek niet geleverd. Erachter staat de oorzaak.

Zie ook

• Het logboek lezen
• Als een back-up mislukt of eindigt met waarschuwingen
• De plugin aanpassen aan je server
• Hulp krijgen: supportrapport, foutopsporing en diagnose
• Status, logboeken en support met WP-CLI

Op de opdrachtregel

WP-CLI nog niet ingesteld? Zo installeer je WP-CLI.

De lopende taak zie je ook op de opdrachtregel, en je kunt hem daar afbreken. Het dialoogvenster Logboek bestaat daar niet: de opdrachtregel somt de logbestanden op en schrijft ze in een tar-bestand. De uitvoer is Engels.

# De lopende taak met fase en voortgang tonen
wp cloneworx-backup job status

# De lopende taak afbreken
wp cloneworx-backup job abort

# De logbestanden weergeven
wp cloneworx-backup logs

# Alle logboeken naar een tar-bestand schrijven
wp cloneworx-backup logs --to=/pfad/protokolle.tar

# Foutopsporing gedurende 24 uur inschakelen
wp cloneworx-backup debug on