aboutsummaryrefslogtreecommitdiff
path: root/doc/beam.1in
blob: fc150649f4c3b71118b71bf85e35cd8cb98cc7da (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
.\" This file is part of BEAM -*- nroff -*-
.\" Copyright (C) 2012 Sergey Poznyakoff
.\"
.\" BEAM is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 3, or (at your option)
.\" any later version.
.\"
.\" BEAM is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with BEAM.  If not, see <http://www.gnu.org/licenses/>.
.\"
.TH BEAM 1 "October 24, 2012" "BEAM" "BEAM User Reference"
.SH NAME
beam \- a backup manager
.SH SYNOPSIS
.B beam
backup [\fIoptions\fB]

.B beam
restore [\fIoptions\fB]

.B beam
list [\fIoptions\fB]

.B beam
s3 [\fIoptions\fB]

.B beam
help \fICOMMAND\fR

.B beam
[\fB\-h\fR] [\fB\-\-help\fR] [\fB\-V\fR] [\fB\-\-version\fR]
.SH DESCRIPTION
.BR B ackup
.BR E asy
.BR A nd
.BR M anageable
is a suite of backup programs written in reasonably portable shell language
with the purpose of making backup process as easy as possible.
.PP
All backup operations are controlled by the
.B beam
utility, which acts as a dispatcher between programs responsible for
particular tasks.  The actual task is specified as a
.BR command ,
i.e. a command verb given as the first argument to the program.
For example,
.B beam backup
creates a backup.
.PP
.B Beam
operates on
.BR 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
.B type.
For example, the basic item type is \fBfs\fR (file system),
which implies archiving all files comprising the item into a single
.BR tar (1)
archive.  There are special item types for MySQL and PostgreSQL
databases, etc.
.PP
.B 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 
.B @LIBDIR@/beam
directory.
.PP
The backup process is controlled by the configuration file
.BR @SYSCONFDIR@/beam.conf .
This file is a set of shell variable assignments which define the
items to include in the backup.
.PP
For a detailed description of
.B beam
configuration file, backup item definitions and module system, see
.BR beam.conf (5).
.SH COMMANDS
.TP
.B backup
Create a backup.  See
.BR beam\-backup (1).
.TP
.B restore
Restore files from backup.  See
.BR beam\-restore (1).
.TP
.B list
List items included in the backup.  See
.BR  beam\-list (1).
.TP
.B s3
Mount or unmount a backup s3 bucket.  This command is available only
if
.B beam
was configured with the
.B \-\-with-s3
option.  See
.BR beam\-s3 (1).
.TP
.BR help " " \fIcommand\fR
Display help page for a particular \fIcommand\fR.
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Display a short help summary.
.TP
\fB\-V\fR, \fB\-\-version\fR
Display program version.
.SH FILES
.TP
.B @SYSCONFDIR@/beam.conf
Default configuration file.
.TP
.B @LIBDIR@/beam
Backup module directory.
.SH ENVIRONMENT
.TP
.B BEAM_CONFIG
If defined, this variable supplies full pathname of the configuration
file to use instead of the default
.BR @SYSCONFDIR@/beam.conf .
.SH "SEE ALSO"
.BR beam\-backup (1),
.BR beam\-restore (1),
.BR beam\-s3 (1),
.BR beam\-module (5),
.BR beam.conf (5).
.SH AUTHORS
Sergey Poznyakoff
.SH "BUG REPORTS"
Report bugs to <@PACKAGE_BUGREPORT@>.
.\" Local variables:
.\" eval: (add-hook 'write-file-hooks 'time-stamp)
.\" time-stamp-start: ".TH [A-Z_][A-Z0-9_]* [0-9] \""
.\" time-stamp-format: "%:B %:d, %:y"
.\" time-stamp-end: "\""
.\" time-stamp-line-limit: 20
.\" end:

Return to:

Send suggestions and report system problems to the System administrator.