Program Output

The Program Output Protected Item type backs up the stdout (Standard Output) stream of any command you run. This lets you use application-specific tooling to take consistent, point-in-time snapshots of applications that expose their own dump or export command.

Program Output acts as an integration point for backing up a wide range of programs with Magnus Box:

• MySQL and MariaDB using mysqldump (a dedicated MySQL Protected Item type is also available)
• MongoDB using mongodump (a dedicated MongoDB Protected Item type is also available)
• PostgreSQL using pg_dump
• Materialize DB using pg_dump
• Interbase using gbak
• Firebird using gbak
• WordPress using wp db export
• Docker using docker save
• OpenVZ using vzdump
• Proxmox VE using vzdump
• CockroachDB using cockroach dump
• Neo4j using neo4j-admin dump
• RethinkDB using rethinkdb dump

Behavior

The program runs during each backup job. Any data streamed to stdout is saved directly to your storage as a virtual file and never touches the local disk. Because the data is streamed rather than pre-calculated, progress bars and ETAs cannot be displayed. You can choose any filename for the resulting virtual file.

Error handling

Magnus Box uses the command's own error signals to set the job status:

• If the program writes any content to stderr (Standard Error), that content is logged in the job report and the final job status is set to at least Warning.
• If the program exits with a non-zero error code, the error code is logged in the job report and the final job status is set to at least Error.