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 staan in De opdrachten in één oogopslag.
Dit geldt voor alle acties
- Een back-up geef je op met zijn taaknaam: datum, tijd en een kenmerk van 32 tekens.
backup listtoont de taaknaam. In de voorbeelden staat daarvoor<Job>. - Een doel geef je in
--targetop met zijn kenmerk, bijvoorbeeldlocal-1.wp cloneworx-backup target listtoont de kenmerken. - 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 van de commando’s is Engels.
-
backup run,backup check,backup deleteenretention runcontroleren eerst de gebruiker: het commando moet lopen als de gebruiker aan wie de mappen van de plugin toebehoren. De website zou bestanden die een andere gebruiker aanmaakt, later niet meer kunnen wijzigen of verwijderen.--forceslaat 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. Het bestand wp-config.php maakt nooit deel uit van een back-up; met wp-config breekt het commando af. |
Roots, gescheiden door komma’s: db, wp-content, wp-core, wp-mu-plugins, wp-plugins, wp-themes, wp-uploads, wp-root
|
--target |
Waar de back-up naartoe gaat. Verplicht: een back-up gaat nooit vanzelf naar alle doelen. | Het kenmerk van een bruikbaar doel. Precies één doel; wp pro-backup run neemt meerdere doelen aan met --targets. |
--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 het doel local-1 back-uppen wp cloneworx-backup backup run --target=local-1 # Alleen database en uploads naar één doel back-uppen wp cloneworx-backup backup run --roots=db,wp-uploads --target=local-1 # De back-up starten en aan de website overlaten wp cloneworx-backup backup run --target=local-1 --background
Terwijl de back-up loopt, schrijft de opdracht per stap een regel: de fase, de afgehandelde items en bytes en de resterende tijd zodra de plugin die kent. Bij de overdracht toont de fase het doel, bij meerdere doelen met zijn positie, bijvoorbeeld transfer to "SFTP 1" (2/3). Aan het eind toont ze het aantal stappen en waarschuwingen. Daaronder staat de samenvatting: roots, doelen, opgeslagen grootte, de ruimte per plek, de database, de bestanden, de delen en per doel het resultaat van de overdracht. Heeft de back-up een andere WordPress-installatie binnen de website overgeslagen, dan toont de regel not backed up de map daarvan.
Na een correcte 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 toont 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. wp cloneworx-backup job status toont dan de voortgang.
Zonder plan betekent: eigen telling
Een back-up uit backup run telt mee voor de groep manual. Hoeveel daarvan blijven, bepaalt de instelling Max. back-ups zonder plan, standaard 7.
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 toont 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 toont 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. Op de pagina Back-up staan daarvoor in de kolom Plan de woorden handmatig, geïmporteerd en teruggehaald.
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. Verwijdert de plugin de back-up op dat moment op een doel, dan weigert backup lock. 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. Daarbij wordt niets teruggeschreven. De plugin controleert of elk bestand met de verwachte grootte aanwezig is, of het infobestand geldig is, of elk deel bij zijn controlesom past en of elk blok te lezen is. Hij leest een lokale map 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. Doorstaat de back-up de controle op een doel niet, dan geldt hij 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 |
De naam van het bestand dat het commando schrijft, zonder pad. Het bestand ontstaat in de map cloneworx-backup-exports-… in de uploadmap en mag nog niet bestaan. Zonder de parameter heet het backup-<Job>.tar. |
Bestandsnaam van letters, cijfers, punt, underscore en koppelteken |
# De back-up als tar-bestand schrijven wp cloneworx-backup backup download <Job> --to=backup.tar
Het commando toont het bestand met zijn volledige pad, 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.
wp cloneworx-backup import accepteert hetzelfde bestand 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 |
|---|---|---|
--target |
Verwijdert alleen op dit doel. De kopieën op de andere doelen blijven. Zolang er nog een kopie is, blijft de back-up in de lijst. | Het kenmerk van één doel |
--entry-only |
Haalt alleen de vermelding uit de lijst. Op de doelen verwijdert het commando niets, en er loopt geen taak. Dat kan alleen zolang minstens één doel de back-up niet meer heeft, niet antwoordt of is verwijderd. Het commando controleert dat na de bevestigingsvraag: heeft elk doel de back-up nog, dan eindigt het met een fout. Een vermelding zonder kopie, bijvoorbeeld een mislukte back-up, verwijder je zonder deze parameter. | zonder waarde |
--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> --target=local-1 --yes # Alleen de vermelding weghalen, op de doelen niets verwijderen wp cloneworx-backup backup delete <Job> --entry-only
- Het commando weigert een vergrendelde back-up. Ontgrendel hem eerst.
- Het commando weigert een lopende back-up. Breek die eerst af:
wp cloneworx-backup job abort. - Het commando raakt een doel dat is verwijderd niet aan: de back-up verliest alleen de verwijzing naar dit doel, er wordt daar niets verwijderd. De aantallen aan het einde tellen dat niet mee als verwijderd en ook niet als mislukt.
- 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 toont het commando hoeveel kopieën het heeft verwijderd en bij hoeveel het verwijderen is mislukt. Een doel waarvan de map bij een andere installatie hoort, telt als mislukt en staat er tussen haakjes bij. De regel vermeldt ook een back-up die intussen is vergrendeld. Meer daarover: Een back-up verwijderen.
De laatste correcte back-up op een doel
Is de back-up op een doel de laatste correcte, dan waarschuwt het commando en vermeldt het het doel. Verwijderen blijft toegestaan. Met --yes volgt op de waarschuwing geen bevestigingsvraag meer.
Verouderde back-ups tonen en verwijderen: retention
De plugin bewaart per back-upplan en per doel zoveel correcte back-ups als Max. back-ups in het plan aangeeft. Oudere vallen weg. Vergrendelde back-ups tellen niet mee en vallen nooit automatisch weg. De nieuwste correcte back-up valt nooit weg. Dat gebeurt vanzelf na elke correcte 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 toont 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 meldt het commando dat in één zin. retention run toont aan het einde hoeveel back-ups zijn verwijderd.