canasta backup databases add

canasta > backup > backup databases > add

canasta backup databases add

Include another database in a wiki's backups

Synopsis

Add a database to a wiki's backup group, for data an extension keeps outside the wiki database — Cargo's $wgCargoDBname being the usual case.

The group is dumped by a single mariadb-dump call, so every database in it comes from one transaction. Cargo needs that: its data tables live in the extra database while cargo_pages, which governs them, lives in the wiki database. Captured at different moments, cargo_pages under-reports, the delete on edit matches nothing, and the edit appends duplicate rows instead of replacing them.

The database must be reachable on the instance's own database server, since one dump is one connection. -w/--wiki is required on a farm and optional on a single-wiki instance. The declaration is stored in config/wikis.yaml and takes effect on the next backup — no restart.

canasta backup databases add [flags] DATABASE

Examples

canasta backup databases add mywiki_cargo
canasta backup databases add -w mywiki mywiki_cargo

Arguments

Argument	Description	Default	Required	Orchestrator
DATABASE	Name of the database to include		✓	Both

Flags

Flag	Shorthand	Description	Default	Required	Orchestrator
--id	-i	Canasta instance ID	*		Both
--wiki	-w	Wiki the database belongs to (required on a farm)			Both

* Defaults to the Canasta instance matching the current directory, if any.

Global flags

Flag	Shorthand	Description	Default	Required	Orchestrator
--help	-h	Show help message and exit			Both
--verbose	-v	Enable verbose output			Both