Met het commando plan beheer je je back-upplannen op de opdrachtregel: tonen, aanmaken, wijzigen, pauzeren, inschakelen, meteen uitvoeren en verwijderen.
Is WP-CLI nog niet ingesteld? Begin dan met WP-CLI installeren. Wat voor elk commando geldt, bijvoorbeeld de gebruiker en de parameter --force, staat in De opdrachten in één oogopslag.
Een back-upplan bundelt wanneer een back-up loopt, wat die bevat, waar die naartoe gaat en hoeveel back-ups per doel blijven. Een plan geef je op met zijn kenmerk, bijvoorbeeld plan-1, of met zijn naam. Bij de letters a tot z speelt hoofdlettergebruik in de naam geen rol; umlauten en accenten schrijf je zoals ze in de naam staan. Een naam met spaties staat tussen aanhalingstekens.
Elke actie behalve list controleert of je werkt als de gebruiker aan wie de mappen van de plugin toebehoren. --force slaat deze controle over.
Plannen tonen: list
# Alle plannen met status, ritme en volgende run tonen wp cloneworx-backup plan list
De uitvoer toont per plan twee regels. De eerste bevat het kenmerk, de toestand, de naam, het ritme met de starttijd en de kenmerken van de doelen. De tweede toont de volgende run, de laatste run, de inhoud, Max. back-ups en de momentopname. De laatste regel telt de plannen en de actieve plannen. Draait een ingeschakeld plan niet volgens schema, dan staat de reden op een eigen regel onder het plan.
| In de uitvoer | Betekenis |
|---|---|
active |
Het plan is actief en loopt bij zijn volgende run vanzelf. |
paused |
Het plan is gepauzeerd. Er zijn geen back-ups gepland. |
paused (no target) |
Het plan is gepauzeerd omdat het geen doel meer heeft. Kies een doel, dan kan het worden ingeschakeld. |
next run |
De volgende run in de tijdzone van de website. Bij een gepauzeerd plan staat hier een streepje. |
last run |
De laatste run met zijn aanleiding: schedule (schema), manual (op de pagina’s van de plugin) of cli (opdrachtregel). missed toont een run die daarna is gemist. could not start betekent: de laatste geplande run kon niet starten. Achter de code tussen haakjes staat de reden in gewone taal. |
roots |
Wat het plan back-upt, als lijst van de onderdelen. |
retention |
Max. back-ups |
snapshot |
Database als momentopname back-uppen: yes of no
|
Een plan aanmaken: add
# Dagelijks om 03:15 uur naar het doel sftp-1 back-uppen wp cloneworx-backup plan add --target=sftp-1 --rhythm=daily --time=03:15 --name="Nachts" # Zondags om 22 uur database en uploads, 3 back-ups behouden wp cloneworx-backup plan add --target=local-1 --rhythm=weekly --weekday=7 --time=22:00 --roots=db,wp-uploads --retention=3 # Het nieuwe plan inschakelen wp cloneworx-backup plan resume "Nachts"
Verplicht is alleen --target. Al het andere heeft een standaardwaarde.
| Parameter | Betekenis | Toegestane waarden |
|---|---|---|
--target=<kenmerk> |
Het doel van het plan, in het formulier Doelen en rotatie. Verplicht. | Het kenmerk van een bruikbaar doel, niet de naam. Precies één doel: de opdracht splitst de waarde niet op de komma. wp pro-plan neemt meerdere doelen aan met --targets. |
--name=<naam> |
De naam van het plan. Zonder de parameter geeft de plugin zijn voorstel. | Hoogstens 100 tekens. Elke naam is mogelijk die nog geen ander plan heeft. |
--rhythm=<Rhythmus> |
Ritme |
1h, 2h, 4h, 6h, 12h, daily, weekly, monthly. wp pro-plan accepteert ook 5m, 10m, 15m, 30m. Standaard: daily. |
--time=HH:MM |
Tijd in de tijdzone van de website. | Uur 0 tot 23, minuten 00, 15, 30 of 45. Standaard: een willekeurig tijdstip. |
--weekday=<Zahl> |
Weekdag, bij het ritme weekly. |
1 voor maandag tot 7 voor zondag. Standaard: 1. |
--monthday=<Tag> |
Dag van de maand, bij het ritme monthly. |
1 tot 28, of last voor de laatste dag van de maand. Standaard: 1. |
--roots=<Liste> |
Wat wordt geback-upt: de onderdelen, gescheiden door komma’s. | Zie de tabel met onderdelen. Standaard: alle. wp-config accepteert het commando niet: het bestand wp-config.php maakt nooit deel uit van een back-up. |
--retention=<Zahl> |
Max. back-ups: zoveel correcte back-ups blijven per doel bewaard. | 1 tot 99. Standaard: 7. 0 alleen met het bewaren op leeftijd van cloneworx Backup Pro. |
--snapshot=<Wert> |
Database als momentopname back-uppen |
yes of no. Standaard: yes. |
--force |
Slaat de controle van de gebruiker over. |
-
Een nieuw plan is gepauzeerd. Het loopt pas als je het met
resumeinschakelt. - De starttijd kan van de tijd afwijken. Bij het aanmaken telt de plugin er willekeurig 0 tot 14 minuten bij en behoudt die toeslag. Van 03:15 wordt bijvoorbeeld 03:22. Zo starten niet alle websites van een server in dezelfde minuut.
-
Bij de ritmes van
1htot12htelt van de tijd alleen de minuut. De runs liggen vanaf 0 uur op de afstand van het ritme. -
Bij
5mtot30m, de ritmes vanwp pro-plan, telt geen tijd en is er geen willekeurige toeslag. De opdracht waarschuwt met de tekst van het dialoogvenster Let op dat deze ritmes een systeemcron nodig hebben, en maakt het plan toch aan: Back-ups elke 5 tot 30 minuten. -
In de gratis versie draait één plan volgens schema. Is er al een plan ingeschakeld, dan weigert
resumeeen tweede en noemt het plan dat je eerst moet pauzeren. Met cloneworx Backup Pro draaien alle ingeschakelde plannen volgens schema.
De onderdelen voor --roots
| Waarde | In het formulier | Inhoud |
|---|---|---|
db |
Database | De tabellen van de database die bij deze website horen. |
wp-content |
wp-content | Alles in wp-content dat niet bij plugins, thema’s, must-use-plugins of uploads hoort. |
wp-core |
WordPress-kern | De mappen wp-admin en wp-includes en de bestanden die WordPress in de hoofdmap levert. |
wp-mu-plugins |
Must-use-plugins | De map van de must-use-plugins. |
wp-plugins |
Plugins | De map van de plugins. |
wp-themes |
Thema’s | De map van de thema’s. |
wp-uploads |
Uploads | De map van de uploads. |
wp-root |
Hoofdmap | Al het andere in de map van de WordPress-kern, bijvoorbeeld .htaccess en robots.txt. Staat WordPress in een eigen submap met een eigen adres, dan horen de bestanden van de webroot erbij. |
Uitsluitingsregels en tabellen waarvan alleen de structuur wordt bewaard, gelden voor de hele website en daarmee voor elk plan. Meer daarover: Bepalen wat er wordt geback-upt.
Een plan wijzigen: edit
# De tijd wijzigen en de momentopname uitschakelen wp cloneworx-backup plan edit "Nachts" --time=04:30 --snapshot=no # Een ander doel kiezen wp cloneworx-backup plan edit plan-1 --target=local-1
edit accepteert dezelfde parameters als add en heeft er minstens één nodig. Alleen wat je opgeeft, wordt gewijzigd. Wijzig je ritme, dag of tijd, dan berekent de plugin de volgende run opnieuw. De willekeurige toeslag op de tijd blijft dezelfde. Heeft het plan instellingen van cloneworx Backup Pro en is cloneworx Backup Pro actief met een geldige licentie, dan wijzigt plan edit niets en noemt het wp pro-plan edit. Ontbreekt cloneworx Backup Pro of is de licentie niet geldig, dan verwijdert plan edit deze instellingen uit het plan en meldt dat in een waarschuwing.
Pauzeren en inschakelen: pause en resume
# Het plan pauzeren wp cloneworx-backup plan pause plan-1 # Het plan inschakelen wp cloneworx-backup plan resume plan-1
resume toont in de uitvoer de volgende run. De plugin berekent die vanaf nu: een plan dat wekenlang gepauzeerd was, start niet op het moment dat je het inschakelt. Een plan kan alleen worden ingeschakeld met een bruikbaar doel, dus een doel waarvan de laatste verbindingstest is geslaagd.
Een actief plan start bij zijn volgende run vanzelf, zodra een taakbron de website aanstoot. Komt er binnen een uur na het tijdstip geen taakbron, dan geldt de run als gemist: er start niets, en het plan schuift door naar zijn volgende reguliere tijdstip. Een website zonder bezoekers heeft daarom een systeemcron nodig: Planning en systeem-cron met WP-CLI.
Een plan meteen uitvoeren: run
# Het plan nu uitvoeren en op het resultaat wachten wp cloneworx-backup plan run "Dagelijkse back-up" # De back-up alleen starten; de website zet hem voort wp cloneworx-backup plan run plan-1 --background
run start meteen een back-up met de inhoud en het doel van het plan. Dat kan ook bij een gepauzeerd plan: de pauze betreft alleen het schema. De back-up telt mee voor het plan en geldt als zijn laatste run. Die verschuift de volgende geplande run niet. Heeft het plan instellingen van cloneworx Backup Pro, dan start plan run niets en noemt het wp pro-plan run.
| Parameter | Betekenis |
|---|---|
--background |
Het commando start de back-up en eindigt. De website voert hem zelf verder uit; wp cloneworx-backup job status toont de stand. |
--force |
Slaat de controle van de gebruiker over. |
Zonder --background toont het commando per stap een regel met de voortgang: de fase, het aantal items, de hoeveelheid en, zodra die te schatten is, de resterende tijd. Aan het einde staat het resultaat met het aantal stappen en waarschuwingen, daaronder de details over database, bestanden en overdracht per doel. Na een correcte back-up voert het commando ook het nawerk tot het einde uit: het verwijdert back-ups die boven Max. back-ups uitgaan, en ruimt resten op de doelen op.
Mislukt de back-up, dan toont de uitvoer de laatste meldingen van de taak, de stand per doel en de reden. Heeft het plan geen bruikbaar doel of loopt er al een andere taak, dan start het commando niets en meldt dat.
Een plan verwijderen: remove
# Het plan verwijderen; zijn back-ups blijven wp cloneworx-backup plan remove "Nachts"
Het commando vraagt niet om bevestiging
Anders dan op de pagina Back-up is er hier geen bevestigingsvraag: het plan is meteen verwijderd. De back-ups die het heeft gemaakt, blijven.
Verwijder je alle plannen, dan maakt de plugin met het volgende doel dat je toevoegt weer een eerste plan aan.
Als het commando een opgave weigert
Klopt een opgave niet, dan slaat het commando niets op. Het vermeldt het veld met een code en eindigt met Plan settings are not valid.
| Veld | Code | Betekenis |
|---|---|---|
name |
required, taken, too_long
|
De naam is leeg, behoort al aan een ander plan toe of is langer dan 100 tekens. |
rhythm, weekday, monthday, snapshot
|
invalid |
De waarde staat niet in de tabel met toegestane waarden. |
roots |
required, invalid
|
De lijst is leeg of noemt een onderdeel dat niet bestaat. |
targets |
required |
De lijst is leeg. |
targets |
unknown |
Het doel bestaat niet, of het is verwijderd. |
targets |
not_usable |
Het doel is niet bruikbaar. Test eerst de verbinding ervan. |
retention |
invalid, out_of_range
|
De waarde is geen geheel getal of ligt niet tussen 1 en 99. |
state |
no_usable_target |
Het plan kan niet worden ingeschakeld omdat het geen bruikbaar doel heeft. |
state |
single_plan |
In de gratis versie is al een ander plan ingeschakeld. De opdracht waarschuwt: Only one plan runs on schedule. Pause the plan "…" first.
|
rhythm |
pro_rhythm |
This rhythm exists only with cloneworx Backup Pro. Choose another rhythm (--rhythm) to switch the plan on. |
retention |
retention_required |
Max. back-ups staat op 0. Zet --retention op een getal van 1 tot 99. |
retention |
retention_pro_missing |
Het plan heeft trappen van het bewaren op leeftijd, maar geen geldige licentie. Zet --retention op een getal van 1 tot 99 en zet het plan daarna weer aan. |
Het commando weigert een tijd in een verkeerde vorm meteen en toont de toegestane vorm.
PROMeerdere doelen en korte ritmes: wp pro-plan
Deze functie hoort bij cloneworx Backup Pro: Installatie · Bestelling
# Twee doelen, s3-1 krijgt alleen de eerste run per week wp pro-plan add --targets=local-1,s3-1 --rules=s3-1:weekly --rhythm=daily --time=03:15 --name="Nachts" # Het ritme op elke 15 minuten zetten wp pro-plan edit "Nachts" --rhythm=15m # Het plan nu uitvoeren, naar de doelen van deze run wp pro-plan run "Nachts" # Een back-up zonder plan naar twee doelen wp pro-backup run --targets=local-1,s3-1
wp pro-plan add en wp pro-plan edit accepteren alle parameters van plan add en plan edit. Daar komen bij: --targets met één doel of meerdere, gescheiden door komma’s, --rules met de regel voor elk extra doel in de vorm <Ziel>:<Regel>, en de ritmes 5m, 10m, 15m en 30m. wp pro-plan run start een plan meteen, met --background zoals bij plan run. wp pro-backup run start een back-up zonder plan naar de doelen uit --targets. Alle vier hebben een geldige licentie nodig. Meer hierover: De 3-2-1-regel - de gouden standaard voor back-ups en Back-ups elke 5 tot 30 minuten.
PROUitzonderingen per plan: wp pro-plan
Deze functie hoort bij cloneworx Backup Pro: Installatie · Bestelling
De opdracht wp pro-plan beheert de uitzonderingen van een plan: regels die alleen voor dit plan gelden, naast de uitsluitingen van de website. add en edit hebben een geldige licentie nodig: De licentie van cloneworx Backup Pro.
# De uitzonderingen van alle plannen tonen wp pro-plan list # Dagelijks plan zonder JPG-bestanden van de uploads aanmaken wp pro-plan add --targets=local-1 --rhythm=daily --time=03:15 --name="Ohne Bilder" --exclusions="wp-uploads/**/*.jpg" # De uitzonderingen van een plan vervangen wp pro-plan edit "Ohne Bilder" --exclusions="wp-uploads/**/*.jpg,wp-uploads/**/*.png" # De uitzonderingen van een plan verwijderen wp pro-plan edit "Ohne Bilder" --exclusions=""
list toont per plan het kenmerk, de naam, de uitzonderingen en de trappen van het bewaren op leeftijd. add en edit accepteren alle parameters van plan add en plan edit en daarnaast --exclusions: de regels, gescheiden door komma’s, in dezelfde vormen als de uitsluitingen. --exclusions vervangt de uitzonderingen van het plan; een lege waarde verwijdert ze. In het formulier van het plan: Back-upplannen: tegel en formulier.
PROBewaren op leeftijd: wp pro-plan --age
Deze functie hoort bij cloneworx Backup Pro: Installatie · Bestelling
# Bewaren op leeftijd instellen wp pro-plan edit "Nachts" --age=run:2,daily:7,weekly:4,monthly:12 # Terug naar een vast getal wp pro-plan edit "Nachts" --age="" --retention=7
--age accepteert de vier trappen: run in uren, daily in dagen, weekly in weken, monthly in maanden. Niet opgegeven trappen zijn 0; een lege waarde zet ze allemaal uit. Met een trap staat --retention op 0. Wat de trappen doen: Bewaren op leeftijd.
PROBack-ups versleutelen: wp pro-plan --encrypt
Deze functie hoort bij cloneworx Backup Pro: Installatie · Bestelling
# De versleuteling van een plan inschakelen wp pro-plan edit "Nachts" --encrypt=yes # De versleuteling van een plan uitschakelen wp pro-plan edit "Nachts" --encrypt=no
--encrypt=yes heeft een geldige licentie nodig. Het plan versleutelt pas als de herstelsleutel is ingesteld. wp pro-plan list noemt per plan of het plan versleutelt. Meer hierover: Back-ups versleutelen.