Met wp cloneworx-backup restore controleer je vóór een herstel of het kan slagen, zet je een back-up terug en behoud je het herstel of maak je het ongedaan. Met wp cloneworx-backup import neem je een back-up uit een bestand op in de lijst.
Ontbreekt WP-CLI nog? De handleiding staat in WP-CLI installeren. Alle commando’s van de plugin staan in De opdrachten in één oogopslag.
Dit geldt voor alle acties
- Een back-up geef je op met zijn taaknaam.
wp cloneworx-backup backup listtoont die naam. In de voorbeelden staat daarvoor<Job>. Een back-up met de statussuccessofwarningskan worden teruggezet. - Per website loopt nooit meer dan één taak tegelijk. Loopt er al een, dan eindigt elk commando dat een taak start met een fout en vermeldt het de lopende taak.
- De uitvoer is Engels. De termijn van de rollback staat daar in UTC.
- Alle acties behalve
restore statuscontroleren eerst de gebruiker: het commando moet lopen als de gebruiker aan wie de mappen van de plugin toebehoren. Bijrestore precheckenimportslaat--forcede controle over. Bijrestore run,keepenundois er geen--force: de website zou bestanden van een andere gebruiker daarna niet meer kunnen wijzigen.
Vóór het herstel controleren: precheck
restore precheck voert de voorcontrole uit: negen punten, voordat een herstel iets schrijft. De voorcontrole wijzigt niets aan de website. Om de rechten te testen maakt ze mappen en tabellen aan en verwijdert ze die weer.
| Parameter | Betekenis | Toegestane waarden |
|---|---|---|
--target |
Het doel waarop de plugin de back-up leest. Zonder de parameter: het eerste lokale doel waarop de back-up volledig staat, anders het eerste andere. | Kenmerk van een doel |
--roots |
Wat wordt teruggezet. Zonder de parameter: elke root van de back-up. | Roots, gescheiden door komma’s, bijvoorbeeld db,wp-uploads
|
--include-core |
Zet de WordPress-kern ook op een andere website terug. | zonder waarde |
--include-dropins |
Zet object-cache.php, advanced-cache.php en db.php ook op een andere website terug. |
zonder waarde |
--include-htaccess |
Zet .htaccess, web.config en .user.ini ook op een andere website terug. |
zonder waarde |
--uploads-in-place |
Kiest voor de uploads de werkwijze zonder rollback als de ruimte naast de actieve map niet voldoende is. | zonder waarde |
--remove-extras |
Controleert voor een herstel dat alles verwijdert wat niet in de back-up staat: de regel tables not in the backup meldt dan dat de vermelde tabellen naar de vorige toestand gaan. De voorcontrole zelf verwijdert niets. De vroegere naam --remove-extra-uploads wordt nog steeds geaccepteerd. |
zonder waarde |
--force |
Loopt ook als andere gebruiker. | zonder waarde |
De drie parameters met --include werken alleen als de back-up van een andere website komt of de herkomst ervan onbekend is. Op dezelfde website zet de plugin kern, drop-ins en .htaccess standaard terug.
# De voorcontrole voor een back-up uitvoeren wp cloneworx-backup restore precheck <Job> # De back-up op een bepaald doel lezen, slechts twee roots wp cloneworx-backup restore precheck <Job> --target=local-1 --roots=db,wp-uploads
Kent deze website de back-up niet, omdat hij op een doel is teruggevonden, is geïmporteerd of met een eerdere versie van de plugin is geschreven, dan eindigen restore precheck en restore run met een fout. Met --accept-unknown bevestig je de back-up als correct: de website onthoudt het infobestand dan zoals het op het doel staat. Bevestig de back-up alleen als correct als je het opslagdoel vertrouwt.
De eerste regel van de uitvoer toont de back-up, het doel waarop is gelezen, de roots en de herkomst: dezelfde website, een andere of onbekend. Daarna volgt per punt een regel met toestand en bevinding.
| Toestand | Betekenis |
|---|---|
OK |
Het punt is in orde. |
WARN |
Iets wat je zou moeten weten. Jij beslist. Een waarschuwing blokkeert het herstel nooit. |
FAIL |
Het herstel kan niet starten. |
UNKNOWN |
Het punt kon niet worden vastgesteld. |
| Punt in de uitvoer | In de interface |
|---|---|
readable |
Back-up leesbaar en volledig |
versions |
PHP- en MySQL-versie |
space |
Vrije ruimte |
permissions |
Schrijfrechten op de doelmappen |
packet |
max_allowed_packet tegenover de grootste rij |
collations |
Collaties |
fingerprint |
Dezelfde website |
db_rights |
Databaserechten (proef) |
loopback |
Zelfaanroep mogelijk |
Onder de punten staat wat niet wordt teruggezet en waarom. Hoort de database bij de roots en heeft deze website tabellen die niet in de back-up staan, dan vermeldt de regel tables not in the backup deze tabellen: hoogstens 50 met naam, de overige alleen als aantal. Tussen haakjes staat of ze blijven (they stay) of met --remove-extras naar de vorige toestand gaan (they move to the previous state). Tabellen van een andere WordPress-installatie die in dezelfde database onder een langer voorvoegsel staan, staan niet in de regel. Als laatste somt de uitvoer de verschillen tussen de back-up en deze website op: per regel de waarde in de back-up en de waarde hier. Het risico van deze verschillen beoordeel je zelf. Heeft een punt de toestand FAIL, dan eindigt het commando met een fout. Elk punt wordt uitgelegd in De voorcontrole van het herstel: elk punt uitgelegd.
Een back-up terugzetten: run
Een herstel vervangt de toestand van de website
De back-up vervangt de huidige toestand van de gekozen roots. De vorige toestand blijft 7 dagen bewaard; zo lang kun je het herstel ongedaan maken. Een uitzondering zijn uploads die met --uploads-in-place ter plekke zijn vervangen: daarvoor is er geen rollback.
restore run zet de gekozen roots terug. Dat gaat zo:
- De voorcontrole loopt als eerste fase. Een
FAILbeëindigt de taak voordat iets is geschreven. - De plugin bouwt de bestanden op naast de actieve mappen en importeert de database in tabellen naast de actieve. De website draait intussen door.
- De plugin wisselt uploads en bestanden in de hoofdmap bestand voor bestand, zonder onderhoudsmodus.
- De plugin schakelt database, kern, must-use-plugins, plugins, thema’s en het overige
wp-contentom in de onderhoudsmodus van WordPress. Deze stap loopt in de webserver: het commando draagt hem via de zelfaanroep over en wacht. - De nieuwe website bevestigt zichzelf. Blijft de bevestiging 60 seconden uit, dan schakelt dezelfde stap terug, en de website draait weer in de vorige toestand.
Komt de zelfaanroep niet binnen 60 seconden bij de webserver aan, dan breekt het commando het herstel vóór het omschakelen af. De plugin draait terug wat tot dan was gewisseld, en de website draait door in haar vorige toestand. Alleen uploads die met --uploads-in-place ter plekke zijn vervangen, blijven vervangen.
De plugin zelf met zijn mappen en tabellen en de wp-config.php worden nooit teruggezet. Bestanden in de uploads en in de hoofdmap die niet in de back-up staan, blijven standaard staan. Tabellen van deze website die niet in de back-up staan, blijven standaard bestaan; het resultaat vermeldt ze. Met --remove-extras gaan deze bestanden en tabellen naar de vorige toestand.
| Parameter | Betekenis | Toegestane waarden |
|---|---|---|
--target, --roots, --include-core, --include-dropins, --include-htaccess, --uploads-in-place
|
Zoals bij restore precheck. |
zoals hierboven |
--remove-extras |
Verwijdert in de gekozen roots alles wat niet in de back-up staat: bestanden in de uploads en in de hoofdmap en, met de root db, tabellen van deze website. Er wordt niets meteen gewist: de bestanden en tabellen gaan naar de vorige toestand. restore undo brengt ze terug, restore keep wist ze definitief. Standaard blijven ze. Vervangt het herstel de uploads met --uploads-in-place ter plekke, dan werkt de parameter niet. De vroegere naam --remove-extra-uploads wordt nog steeds geaccepteerd; hij doet nu hetzelfde en geldt niet meer alleen voor de uploads. |
zonder waarde |
--accept-damaged |
Zet ook een back-up met beschadigde items terug en laat precies die items weg. Zonder de parameter eindigt het herstel voordat iets is gewisseld, en noemt het het aantal beschadigde items. | zonder waarde |
--accept-failed |
Zet ook een back-up terug waarvan items in de opbouwmap niet konden worden aangemaakt (geen ruimte, geen rechten, naamconflict) en laat precies die items weg. Zonder de parameter eindigt het herstel voordat iets is gewisseld. | zonder waarde |
--without-confirmation |
Schakelt in dit proces om, zonder de bevestiging van de nieuwe website. Voor servers waarop de zelfaanroep niet werkt. | zonder waarde |
--background |
Het commando start het herstel alleen. De website voert het zelf verder uit. | zonder waarde |
# De hele back-up terugzetten wp cloneworx-backup restore run <Job> # Alleen de database terugzetten wp cloneworx-backup restore run <Job> --roots=db # Alleen plugins en thema’s terugzetten wp cloneworx-backup restore run <Job> --roots=wp-plugins,wp-themes
Het commando schrijft per stap een regel met de voortgang. Terwijl de webserver omschakelt, meldt het commando elke tien seconden dat het wacht. Aan het einde staat het resultaat: de back-up en het doel, de roots, het aantal geschreven items, de bestanden buiten de back-up, de vergelijking van de wp-config.php met de back-up, de database met tabellen en rijen, de duur van het omschakelen, de manier van bevestigen en het antwoord van de startpagina. De laatste regel toont het aantal waarschuwingen en het tijdstip tot wanneer de vorige toestand bewaard blijft.
Deze regels van het resultaat tonen wat niet in de back-up stond en wat de vergelijking van de wp-config.php oplevert:
| Regel in het resultaat | Betekenis |
|---|---|
wp-uploads: … files not in the backup, wp-root: … files not in the backup
|
Zoveel bestanden van deze root staan niet in de back-up; tussen haakjes staat hoeveel daarvan uitvoerbaar zijn. De regel eindigt met they stay of, met --remove-extras, met … moved to the previous state: zoveel bestanden zijn naar de vorige toestand gegaan. Konden bestanden niet worden verplaatst, dan volgt … could not be moved and stay. |
wp-config.php: |
De vergelijking van de wp-config.php van deze website met de back-up. Een back-up bevat het bestand nooit; de regel luidt daarom not in the backup, nothing to compare. |
tables not in the backup stay: |
De tabellen van deze website die niet in de back-up staan. Deze tabellen blijven bestaan. |
tables not in the backup moved to the previous state (undo brings them back): |
Met --remove-extras: deze tabellen zijn naar de vorige toestand gegaan. |
could not be created:, name conflicts:, symlinks pointing outside:, damaged:
|
De namen van de items die niet konden worden aangemaakt, die op een naamconflict stuitten, die als symbolische link naar buiten wijzen of die beschadigd zijn, telkens hoogstens tien. |
…: … excluded entries inside swapped folders stay in place |
Zoveel items die bij de back-up waren uitgesloten, zijn binnen gewisselde mappen op hun plaats gebleven. |
Het herstel zet de wp-config.php nooit terug; hij blijft zoals hij is.
Na een herstel van de database kan je aanmelding in de WP-admin ongeldig zijn. Meld je dan opnieuw aan.
Zolang de rollback van een herstel open is, start er geen nieuw herstel. Behoud het open herstel eerst of maak het ongedaan.
De stand van een herstel tonen: status
restore status toont het lopende herstel. Loopt er geen, dan toont het commando het herstel waarvan de rollback open is. Met de taaknaam van een herstel toont het precies dat herstel. De actie heeft geen parameters.
# Het lopende herstel of de open rollback tonen wp cloneworx-backup restore status
Bij een lopend herstel toont de uitvoer de fase en de voortgang. Bij een beëindigd herstel toont ze de status, de rollback met zijn termijn en het resultaat zoals na restore run.
Het herstel behouden of ongedaan maken: keep, undo
| Actie | Doel |
|---|---|
restore keep |
Behoudt het herstel: de plugin verwijdert de vorige toestand, de oude mappen en de oude tabellen. Daarbij hoort wat --remove-extras naar de vorige toestand heeft gebracht: deze bestanden en tabellen zijn dan definitief gewist. Daarna is er geen rollback meer. |
restore undo |
Maakt het herstel ongedaan: de plugin brengt de vorige toestand terug, ook de bestanden en tabellen die --remove-extras naar de vorige toestand heeft gebracht. Uploads die ter plekke zijn vervangen, blijven zoals het herstel ze heeft geschreven. Is het behouden al begonnen, dan weigert restore undo. |
Beide acties gebruiken zonder taaknaam het herstel waarvan de rollback open is. Met --background start het commando alleen, en de website voert de taak zelf verder uit.
# Het herstel behouden wp cloneworx-backup restore keep # Het herstel ongedaan maken wp cloneworx-backup restore undo
De uitvoer toont hoeveel items zijn verwijderd en hoeveel tabellen zijn verwijderd of teruggezet. Beslis je niets, dan behoudt de plugin het herstel na 7 dagen vanzelf. Meer daarover: Een herstel behouden of ongedaan maken.
Als de WP-admin niet bereikbaar is
Voor een herstel op de opdrachtregel heb je geen aanmelding in de WP-admin en geen browser nodig. Je hebt de toegang tot de server en WP-CLI nodig. De commando’s zijn beschikbaar zolang WP-CLI WordPress met de plugin kan laden.
- Zoek de back-up:
wp cloneworx-backup backup list. - Voer de voorcontrole uit en lees de regel
loopback. BijOKkomt de zelfaanroep aan. BijWARNkomt die niet aan: het herstel werkt dan alleen met--without-confirmation. BijUNKNOWNheeft de plugin de zelfaanroep op deze server nog niet getest. - Start het herstel met
restore run. Komt de zelfaanroep aan, dan loopt het herstel zoals hierboven beschreven. - Breekt het herstel af omdat de zelfaanroep niet aankomt, dan draait de website door in haar vorige toestand. Start het herstel dan nog een keer, met
--without-confirmation. - Controleer de website. Klopt er iets niet, dan brengt
restore undode vorige toestand terug.
# Stap 1: de back-up zoeken wp cloneworx-backup backup list # Stap 2: de voorcontrole wp cloneworx-backup restore precheck <Job> # Stap 3: het herstel wp cloneworx-backup restore run <Job> # Stap 4: in dit proces omschakelen wp cloneworx-backup restore run <Job> --without-confirmation # Stap 5: zo nodig de vorige toestand terughalen wp cloneworx-backup restore undo
Zonder bevestiging controleer je zelf
Met --without-confirmation bevestigt de nieuwe website zichzelf niet. Start ze niet, dan schakelt de plugin niet vanzelf terug. De OPcache van de webserver wordt niet geleegd: de server kan nog een tijd lang oude code uitleveren. Controleer de website na het herstel zelf.
Een back-up uit een bestand importeren: import
import accepteert een back-upbestand dat op deze server staat: het tar-bestand uit het downloaden van een back-up. De plugin leest het bestand in delen, controleert elk deel van de back-up tegen zijn controlesom en slaat de back-up op het doel op dat je opgeeft. Daarna staat de back-up in de lijst, onder de taaknaam van de oorspronkelijke back-up. Als datum toont backup list het tijdstip van de import.
| Opgave | Betekenis | Toegestane waarden |
|---|---|---|
<Datei> |
Het back-upbestand. Verplicht. De opgave staat direct na import. |
Pad van een tar-bestand op deze server |
--target |
Het doel waarop de back-up wordt opgeslagen. Verplicht. | Kenmerk van een bruikbaar doel |
--background |
Het commando leest het bestand en start de import alleen. De website voert de taak zelf verder uit. | zonder waarde |
--max-per-step |
Beëindigt elke stap van de controle na zoveel delen. De parameter dient voor diagnose. | geheel getal |
--force |
Loopt ook als andere gebruiker. | zonder waarde |
# Een back-upbestand naar het doel local-1 importeren wp cloneworx-backup import /tmp/backup.tar --target=local-1
De opdracht importeert een back-up die deze website niet kent alleen met --accept-unknown.
Het commando toont eerst de gelezen grootte en de taaknaam van de back-up in het bestand, dan de voortgang van de import. Aan het einde staat wanneer en op welke website de back-up is ontstaan, op welk doel die nu staat, hoeveel delen zijn gecontroleerd en welke roots die bevat.
Het commando eindigt met een fout,
- als het bestand geen back-upbestand van deze plugin is of onvolledig is,
- als een deel niet bij zijn controlesom past: dan wordt niets opgeslagen,
- als dezelfde back-up al op dit doel staat,
- als er in de lijst een andere back-up met dezelfde naam is,
- als in de werkmap de ruimte voor het bestand ontbreekt,
- als het bestand groter is dan 32 GiB.
Staat dezelfde back-up tot nu toe alleen op een ander doel, dan krijgt zijn vermelding in de lijst het nieuwe doel erbij.
Een back-up die de import als nieuwe vermelding in de lijst zet, blijft tot je hem verwijdert
Een back-up die de import als nieuwe vermelding in de lijst zet, heeft het plan import. De plugin verwijdert hem nooit automatisch. Hij telt niet mee voor de waarschuwing voor achterstallige back-ups. Krijgt een bestaande vermelding alleen het nieuwe doel erbij, dan behoudt die haar plan: toont backup list daar het kenmerk van een back-upplan of manual, dan telt de back-up ook op het nieuwe doel mee voor Max. back-ups, en kan de plugin hem daar automatisch verwijderen.