BEAM
NAMESYNOPSIS
DESCRIPTION
COMMANDS
OPTIONS
FILES
ENVIRONMENT
SEE ALSO
AUTHORS
BUG REPORTS
NAME
beam - a backup manager
SYNOPSIS
beam backup [options]
beam restore [options]
beam list [options]
beam s3 [options]
beam help COMMAND
beam [-h] [--help] [-V] [--version]
DESCRIPTION
Backup Easy And Manageable is a suite of backup programs written in reasonably portable shell language with the purpose of making backup process as easy as possible.
All backup operations are controlled by the beam utility, which acts as a dispatcher between programs responsible for particular tasks. The actual task is specified as a command, i.e. a command verb given as the first argument to the program. For example, beam backup creates a backup.
Beam operates on backup items. An item is a set of files, which should be handled together. The way to handle these files during backup or restore is defined by the item type. For example, the basic item type is fs (file system), which implies archiving all files comprising the item into a single tar(1) archive. There are special item types for MySQL and PostgreSQL databases, etc.
Beam is a modular system. New item types can easily be defined by providing a module which defines how they should be handled during backup and restore. A module is a shell script named after the item type and placed in the /usr/local/lib/beam directory.
The backup process is controlled by the configuration file /usr/local/etc/beam.conf. This file is a set of shell variable assignments which define the items to include in the backup.
For a detailed description of beam configuration file, backup item definitions and module system, see beam.conf(5).
COMMANDS
backup |
Create a backup. See beam-backup(1). |
restore
Restore files from backup. See beam-restore(1).
list |
List items included in the backup. See beam-list(1). | ||
s3 |
Mount or unmount a backup s3 bucket. This command is available only if beam was configured with the --with-s3 option. See beam-s3(1). |
help command
Display help page for a particular command.
OPTIONS
-h, --help
Display a short help summary.
-V, --version
Display program version.
FILES
/usr/local/etc/beam.conf
Default configuration file.
/usr/local/lib/beam
Backup module directory.
ENVIRONMENT
BEAM_CONFIG
If defined, this variable supplies full pathname of the configuration file to use instead of the default /usr/local/etc/beam.conf.
SEE ALSO
beam-backup(1), beam-restore(1), beam-s3(1), beam-module(5), beam.conf(5).
AUTHORS
Sergey Poznyakoff
BUG REPORTS
Report bugs to <gray@gnu.org.ua>.
Manpage server at man.gnu.org.ua.
Powered by mansrv 1.1