Back-ups maken en beheren met WP-CLI

Met wp cloneworx-backup backup start je een back-up zonder plan en beheer je de back-ups in de lijst: tonen, vergrendelen, controleren, downloaden, verwijderen. wp cloneworx-backup retention toont welke oude back-ups wegvallen en verwijdert ze desgewenst meteen.

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: datum, tijd en een kenmerk van 32 tekens. De taaknaam toont backup list. In de voorbeelden staat daarvoor <Job>.
• Een doel noem je in --targets met zijn kenmerk, bijvoorbeeld local-1. De kenmerken toont wp cloneworx-backup target list.
• 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 van de commando’s is Engels.
• backup run, backup check, backup delete en retention run controleren eerst de gebruiker: het commando moet lopen als de gebruiker aan wie de mappen van de plugin toebehoren. Bestanden die een andere gebruiker aanmaakt, zou de website later niet meer kunnen wijzigen of verwijderen. --force slaat de controle over.

Een back-up zonder plan starten: run

backup run start meteen een back-up en voert die in dit proces tot het einde uit. De back-up hoort bij geen enkel plan. Een back-upplan voer je uit met wp cloneworx-backup plan run; meer daarover in Back-upplannen beheren met WP-CLI.

Parameter	Betekenis	Toegestane waarden
--roots	Wat wordt geback-upt. Zonder de parameter back-upt de plugin alles.	Roots, gescheiden door komma’s: db, wp-config, wp-content, wp-core, wp-mu-plugins, wp-plugins, wp-themes, wp-uploads, wp-root
--targets	Waar de back-up naartoe gaat. Zonder de parameter gaat hij naar elk bruikbaar doel.	Kenmerken van bruikbare doelen, gescheiden door komma’s
--no-snapshot	Leest de database zonder momentopname. Standaard is de momentopname.	zonder waarde
--background	Het commando start de back-up alleen. De website voert hem zelf verder uit.	zonder waarde
--max-per-step	Beëindigt elke stap na zoveel items of rijen. De parameter dient voor diagnose.	geheel getal
--force	Loopt ook als andere gebruiker.	zonder waarde

Een root is een benoemd deel van de website: de database of een map. Wat in welke root staat, legt Instellingen en omvang met WP-CLI uit.

# Alles naar elk bruikbaar doel back-uppen
wp cloneworx-backup backup run

# Alleen database en uploads naar één doel back-uppen
wp cloneworx-backup backup run --roots=db,wp-uploads --targets=local-1

# De back-up starten en aan de website overlaten
wp cloneworx-backup backup run --background

Terwijl de back-up loopt, schrijft het commando per stap een regel: de fase, de afgehandelde items en bytes en de resterende tijd, zodra de plugin die kent. Aan het einde noemt het het aantal stappen en waarschuwingen. Daaronder staat de samenvatting: roots, doelen, opgeslagen grootte, de ruimte per locatie, de database, de bestanden, de delen en per doel het resultaat van de overdracht.

Na een goede back-up voert hetzelfde proces het nawerk uit: de plugin verwijdert verouderde back-ups en ruimt resten van afgebroken taken op de doelen op.

Eindigt de back-up met een fout, dan noemt het commando de laatste meldingen van de taak, per doel de stand en de reden. Bij een fout op een doel staat daaronder ongewijzigd de melding van het doel, in de regel target:.

Met --background keert het commando meteen terug. De voortgang toont dan wp cloneworx-backup job status.

De back-ups weergeven: list

backup list toont de back-ups in de lijst, de nieuwste eerst. Zonder actie doet wp cloneworx-backup backup hetzelfde.

Parameter	Betekenis	Toegestane waarden
--limit	Hoeveel back-ups de uitvoer toont.	1 tot 100, standaard 20

# De laatste 20 back-ups tonen
wp cloneworx-backup backup list

# Alleen de laatste 5 tonen
wp cloneworx-backup backup list --limit=5

Elke regel noemt een back-up: taaknaam, status, plan, einde, grootte en per doel de toestand van de back-up daar. Aan het einde van de regel staat locked als de back-up vergrendeld is. De laatste regel zegt hoeveel back-ups de uitvoer toont en hoeveel er zijn.

Status in de uitvoer	In het statusfilter van de pagina Back-up
running	Bezig
success	Volledig
warnings	Met waarschuwingen
error	Mislukt
aborted	Afgebroken

In de kolom voor het plan staat het kenmerk van het plan, bijvoorbeeld plan-1. manual staat voor een back-up zonder plan, import voor een geïmporteerde back-up en rediscovered voor een back-up die op een doel is teruggevonden.

Een back-up vergrendelen en ontgrendelen: lock, unlock

backup lock vergrendelt een back-up. Een vergrendelde back-up wordt nooit automatisch verwijderd en telt niet mee voor Max. back-ups. Handmatig verwijderen kan pas na backup unlock. Beide acties hebben geen parameters.

# Een back-up vergrendelen
wp cloneworx-backup backup lock <Job>

# De back-up ontgrendelen
wp cloneworx-backup backup unlock <Job>

Het commando bevestigt de vergrendeling of het einde ervan in één zin. Meer over de vergrendeling: Een back-up beschermen tegen verwijderen.

Een back-up controleren: check

backup check leest een back-up op elk doel waarop die volledig staat of als beschadigd is gemarkeerd: een nieuwe controle kan het resultaat veranderen. Teruggezet wordt daarbij niets. De plugin controleert of elk bestand met zijn grootte aanwezig is, of het infobestand geldig is, of elk deel bij zijn controlesom past en of elk blok te lezen is. Een lokale map leest hij ter plekke. Van een extern doel haalt hij het ene deel na het andere naar de werkmap.

Parameter	Betekenis	Toegestane waarden
--targets	Controleert alleen op deze doelen. Zonder de parameter: op elk doel waarop de back-up volledig staat of als beschadigd is gemarkeerd.	Kenmerken, gescheiden door komma’s
--background	Het commando start de controle alleen. De website voert de taak zelf verder uit.	zonder waarde
--max-per-step	Beëindigt elke stap na zoveel blokken. De parameter dient voor diagnose.	geheel getal
--force	Loopt ook als andere gebruiker.	zonder waarde

# Een back-up op al zijn doelen controleren
wp cloneworx-backup backup check <Job>

# Alleen op één doel controleren
wp cloneworx-backup backup check <Job> --targets=local-1

De uitvoer heeft per doel een regel met het resultaat:

Resultaat	Betekenis
ok	De back-up is daar leesbaar en volledig. De regel noemt delen, items en gelezen bytes.
damaged or incomplete	De back-up is daar beschadigd of onvolledig. De regel noemt de bevindingen.
not checked	Het doel heeft niet geantwoord. Dat is een waarschuwing, geen schade.
not complete at this target	De back-up staat op dit doel niet volledig.

De laatste regel telt op. Valt een doel af, dan geldt de back-up daar als beschadigd: hij telt niet meer mee voor Max. back-ups en wordt nooit automatisch verwijderd. Meer daarover: Een back-up controleren.

Een back-up als bestand schrijven: download

backup download schrijft een back-up als één tar-bestand op de server. Het bestand bevat een map met de taaknaam, daarin het infobestand, de index en de delen. De plugin leest op het eerste lokale doel waarop de back-up volledig staat.

Parameter	Betekenis	Toegestane waarden
--to	Het bestand dat het commando schrijft. Verplicht. Het bestand mag nog niet bestaan, en zijn map moet beschrijfbaar zijn.	Pad van een bestand

# De back-up als tar-bestand schrijven
wp cloneworx-backup backup download <Job> --to=/tmp/backup.tar

Het commando noemt het bestand, zijn grootte, het aantal bestanden erin en het doel waarop het heeft gelezen. Staat de back-up op geen enkel lokaal doel volledig, dan eindigt het met een fout. Een back-up die alleen op externe doelen staat, haal je met een eigen programma daarvandaan, bijvoorbeeld met je FTP-programma. Meer daarover: Een back-up downloaden.

Hetzelfde bestand accepteert wp cloneworx-backup import weer; zie Herstellen en importeren met WP-CLI.

Een back-up verwijderen: delete

backup delete verwijdert een back-up op elk doel waarop die staat. Met zijn laatste kopie verdwijnt de back-up uit de lijst. Vóór het verwijderen vraagt het commando om bevestiging.

Parameter	Betekenis	Toegestane waarden
--targets	Verwijdert alleen op deze doelen. De kopieën op de andere doelen blijven. Zolang er nog een kopie is, blijft de back-up in de lijst.	Kenmerken, gescheiden door komma’s
--yes	Verwijdert zonder bevestigingsvraag.	zonder waarde
--force	Loopt ook als andere gebruiker.	zonder waarde

# Een back-up overal verwijderen, met bevestigingsvraag
wp cloneworx-backup backup delete <Job>

# Alleen de kopie op één doel verwijderen, zonder bevestigingsvraag
wp cloneworx-backup backup delete <Job> --targets=local-1 --yes

• Een vergrendelde back-up weigert het commando. Ontgrendel hem eerst.
• Een lopende back-up weigert het commando. Breek die eerst af: wp cloneworx-backup job abort.
• Een vermelding zonder kopie, bijvoorbeeld een mislukte of afgebroken back-up, verdwijnt meteen uit de lijst, zonder bevestigingsvraag en zonder taak.

Het verwijderen loopt als taak in dit proces. Aan het einde noemt het commando hoeveel back-ups zijn verwijderd en hoeveel pogingen zijn mislukt. Meer daarover: Een back-up verwijderen.

Verouderde back-ups tonen en verwijderen: retention

De plugin bewaart per back-upplan en per doel zoveel goede back-ups als Max. back-ups in het plan zegt. Oudere vallen weg. Vergrendelde back-ups tellen niet mee en vallen nooit automatisch weg. De nieuwste goede back-up valt nooit weg. Dat gebeurt vanzelf na elke goede back-up. Met wp cloneworx-backup retention zie je het vooraf of stoot je het handmatig aan.

Actie	Doel
retention list	Toont welke back-ups nu zouden wegvallen. Verwijdert niets. Zonder actie doet het commando hetzelfde.
retention run	Verwijdert deze back-ups nu en voert de taak in dit proces uit.

Parameter	Betekenis	Toegestane waarden
--plan	Alleen deze groep. Zonder de parameter: elk plan en de back-ups zonder plan.	Kenmerk van een plan, bijvoorbeeld plan-1, of manual
--force	Alleen run: loopt ook als andere gebruiker.	zonder waarde

# Tonen wat zou vervallen
wp cloneworx-backup retention list

# Nu verwijderen, alleen voor één plan
wp cloneworx-backup retention run --plan=plan-1

# Nu verwijderen, alleen back-ups zonder plan
wp cloneworx-backup retention run --plan=manual

retention list noemt per regel een back-up, het doel en de groep: de naam van het plan of manual. De laatste regel telt de verwijderingen. Valt er niets weg, dan zegt het commando dat in één zin. retention run noemt aan het einde hoeveel back-ups zijn verwijderd.

Zie ook

• De pagina “Back-up”
• Meteen een back-up maken
• Bepalen hoeveel back-ups worden bewaard
• Back-upplannen beheren met WP-CLI
• Status, logboeken en support met WP-CLI