aboutsummaryrefslogtreecommitdiff
path: root/man/backupninja.conf.5
blob: 50e0238f81910bb08aa97c8eb75a28349a160c51 (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
.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH BACKUPNINJA.CONF 5 "November 19, 2005" "riseup" "backupninja package"
.SH NAME 
BACKUPNINJA.CONF \- Configuration file(s) for \fBbackupninja (1)\fP.

.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.br
.SH SYNOPSIS
.B "/etc/backupninja.conf "
.br
.SH DESCRIPTION
.B backupninja.conf
is the general configuration file. In this file you can set the log level and change the default directory locations.  You can force a different general configuration file with "backupninja \-f /path/to/conf".

.SH OPTIONS

.TP
.B loglevel
How verbose to make the logs. 
.br
5 = Debugging messages
.br
4 = Informational messages
.br
3 = Warnings
.br
2 = Errors
.br
1 = Fatal errors 

.TP
.B reportemail
Send a summary of the backup status to this email address

.TP
.B reportsuccess
If set to 'yes', a report email will be generated even if all modules reported success.

.TP
.B reportwarning
If set to 'yes', a report email will be generated even if there was no error.

.TP
.B logfile
The path of the logfile.

.TP
.B configdirectory
The directory where all the backup action configuration files live.

.TP 
.B scriptdirectory 
Where backupninja handler scripts are found

.TP
.B usecolors
If set to 'yes', use colors in the log file and debug output.

.TP
.B when
When to process each configuration file. The value used here will
be applied for each configuration file. It is possibile to override
this "when" in each each configuration file, see also section 
"Scheduling" in backup.d(5).

For example:

  when = sundays at 02:00
  when = 30th at 22
  when = 30 at 22:00
  when = everyday at 01            <-- the default
  when = Tuesday at 05:00

These values for 'when' are equivalent:

  when = tuesday at 05:30
  when = TUESDAYS at 05

These values for 'when' are invalid:
  
  when = tuesday at 2am
  when = tuesday at 2
  when = tues at 02

.TP
.B vservers
If you are using Linux-Vservers (http://linux-vserver.org), there are some
special capabilities that different handlers have to make vserver backups easier.
See the example configuration files for each handler to configure the vserver specific
variables.

.SH DEFAULTS

loglevel = 4
.br
reportemail = root
.br
reportsuccess = yes
.br
reportwarning = yes
.br
logfile = /var/log/backupninja.log
.br
configdirectory = /etc/backup.d
.br
scriptdirectory = /usr/share/backupninja
.br
usecolors = yes 
.br
when = everyday at 01:00
.br
vservers = no

.SH SEE ALSO
.BR backupninja (1), 
.BR ninjahelper (1), 
.BR backup.d (5), 
.br
.SH AUTHOR
BACKUPNINJA was written by the riseup.net collective.