Herstellen en importeren met WP-CLI

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 noemt De opdrachten in één oogopslag.

Dit geldt voor alle acties

• Een back-up noem je met zijn taaknaam. Die toont wp cloneworx-backup backup list. In de voorbeelden staat daarvoor <Job>. Terugzetten kan een back-up met de status success of warnings.
• Per website loopt altijd maar één taak. Loopt er al een, dan eindigt elk commando dat een taak start met een fout en noemt het de lopende taak.
• De uitvoer is Engels. De termijn van de rollback staat daar in UTC.
• Alle acties behalve restore status controleren eerst de gebruiker: het commando moet lopen als de gebruiker aan wie de mappen van de plugin toebehoren. Bij restore precheck en import slaat --force de controle over. Bij restore run, keep en undo is er geen --force: bestanden van een andere gebruiker zou de website 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. Voor de proef van de rechten 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. wp-config wordt nooit teruggezet.	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 weg zonder rollback als de ruimte naast de actieve map niet voldoende is.	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

De eerste regel van de uitvoer noemt 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. 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 legt De voorcontrole van het herstel: elk punt uitgelegd uit.

Een back-up terugzetten: run

restore run zet de gekozen roots terug. Dat gaat zo:

1. De voorcontrole loopt als eerste fase. Een FAIL beëindigt de taak voordat iets is geschreven.
2. De plugin bouwt de bestanden op naast de actieve mappen en importeert de database in tabellen naast de actieve. De website draait intussen door.
3. Uploads en bestanden in de hoofdmap wisselt de plugin bestand voor bestand, zonder onderhoudsmodus.
4. Database, kern, must-use-plugins, plugins, thema’s en het overige wp-content schakelt de plugin om in de onderhoudsmodus van WordPress. Deze stap loopt in de webserver: het commando draagt hem via de zelfaanroep over en wacht.
5. 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.

Nooit teruggezet worden de plugin zelf met zijn mappen en tabellen en de wp-config.php. Bestanden in de uploads en in de hoofdmap die niet in de back-up staan, blijven staan. Tabellen van deze website die niet in de back-up staan, blijven bestaan; het resultaat noemt ze.

Parameter	Betekenis	Toegestane waarden
--target, --roots, --include-core, --include-dropins, --include-htaccess, --uploads-in-place	Zoals bij restore precheck.	zoals hierboven
--remove-extra-uploads	Verplaatst uploads die niet in de back-up staan naar de vorige toestand. Met restore undo komen deze uploads terug. Standaard blijven ze staan.	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
--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 database met tabellen en rijen, de duur van het omschakelen, de weg van de bevestiging en het antwoord van de startpagina. De laatste regel noemt het aantal waarschuwingen en het tijdstip tot wanneer de vorige toestand bewaard blijft.

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 noemt de uitvoer de fase en de voortgang. Bij een beëindigd herstel noemt 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. Daarna is er geen rollback meer.
restore undo	Maakt het herstel ongedaan: de plugin brengt de vorige toestand terug. Uploads die ter plekke zijn vervangen, blijven zoals het herstel ze heeft geschreven.

Beide acties nemen 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 noemt 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 bestaan zolang WP-CLI WordPress met de plugin kan laden.

1. Zoek de back-up: wp cloneworx-backup backup list.
2. Voer de voorcontrole uit en lees de regel loopback. Bij OK komt de zelfaanroep aan. Bij WARN komt die niet aan: het herstel werkt dan alleen met --without-confirmation. Bij UNKNOWN heeft de plugin de zelfaanroep op deze server nog niet beproefd.
3. Start het herstel met restore run. Komt de zelfaanroep aan, dan loopt het herstel zoals hierboven beschreven.
4. 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.
5. Controleer de website. Klopt er iets niet, dan brengt restore undo de 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

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 noemt. Daarna staat de back-up in de lijst, onder de taaknaam van de oorspronkelijke back-up. Als datum noemt backup list het tijdstip van de import.

Opgave	Betekenis	Toegestane waarden
<Datei>	Het back-upbestand. Verplicht. De opgave staat direct achter 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

Het commando noemt 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.

Zie ook

• De website herstellen vanuit een back-up
• Een back-up op een andere website terugzetten
• Uploads herstellen als er niet genoeg ruimte is
• Een back-up uit een bestand importeren
• Back-ups maken en beheren met WP-CLI