backupninja/man/backupninja.conf.5

172 lines
3.7 KiB
Groff
Raw Normal View History

2005-10-07 20:27:29 +02:00
.\" 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)
2005-11-19 18:11:28 +01:00
.TH BACKUPNINJA.CONF 5 "November 19, 2005" "riseup" "backupninja package"
2021-01-10 00:27:33 +01:00
.SH NAME
2005-10-07 20:27:29 +02:00
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".
2005-10-07 20:27:29 +02:00
2005-10-10 19:36:09 +02:00
.SH OPTIONS
2005-10-07 20:27:29 +02:00
.TP
2005-10-10 19:36:09 +02:00
.B loglevel
2021-01-10 00:27:33 +01:00
How verbose to make the logs.
2005-10-10 19:36:09 +02:00
.br
5 = Debugging messages
.br
4 = Informational messages
.br
3 = Warnings
.br
2 = Errors
.br
2021-01-10 00:27:33 +01:00
1 = Fatal errors
2005-10-07 20:27:29 +02:00
.TP
.B reportprom
Produce prometheus metrics of backup status. Requires `prometheus-node-exporter`
to be installed.
2005-10-07 20:27:29 +02:00
.TP
2005-10-10 19:36:09 +02:00
.B reportemail
2021-01-24 18:00:26 +01:00
Send a summary of the backup status to this email address.
2005-10-07 20:27:29 +02:00
.TP
2005-10-10 19:36:09 +02:00
.B reportsuccess
If set to 'yes', a report email will be generated even if all modules reported success.
2005-10-07 20:27:29 +02:00
.TP
.B reportinfo
If set to 'yes', info messages from handlers will be sent into the email.
2005-10-07 20:27:29 +02:00
.TP
2005-10-10 19:36:09 +02:00
.B reportwarning
If set to 'yes', a report email will be generated even if there was no error.
2005-10-07 20:27:29 +02:00
.TP
.B reportspace
If set to 'yes', disk space usage will be included in the backup email report.
.TP
.B reporthost
Where to rsync the backupninja.log to be aggregated in a ninjareport.
2021-01-25 16:50:16 +01:00
.TP
.B reportuser
What user to connect to reporthost to sync the backupninja.log
.TP
.B reportdirectory
Where on the reporthost should the report go.
2021-01-25 16:50:16 +01:00
.TP
.B reportwrap
Number of columns the email report body should wrap to.
2005-10-07 20:27:29 +02:00
.TP
2005-10-10 19:36:09 +02:00
.B logfile
The path of the logfile.
2005-10-07 20:27:29 +02:00
.TP
2005-10-10 19:36:09 +02:00
.B configdirectory
The directory where all the backup action configuration files live.
2005-10-07 20:27:29 +02:00
.TP
.B admingroup
Administration user group that is allowed to read/write configuration files in \fBconfigdirectory\fB.
2021-01-10 00:27:33 +01:00
.TP
.B scriptdirectory
2021-01-24 18:00:26 +01:00
Where backupninja handler scripts are found.
2005-10-07 20:27:29 +02:00
2005-10-10 19:36:09 +02:00
.TP
.B usecolors
If set to 'yes', use colors in the log file and debug output.
2005-10-07 20:27:29 +02:00
2005-11-19 18:11:28 +01:00
.TP
.B when
When to process each configuration file. The value used here will
be applied for each configuration file. It is possible to override
this "when" in each configuration file, see also section
2005-11-19 18:11:28 +01:00
"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:
2021-01-10 00:27:33 +01:00
2005-11-19 18:11:28 +01:00
when = tuesday at 2am
when = tuesday at 2
when = tues at 02
.TP
2005-10-10 19:36:09 +02:00
.SH DEFAULTS
2005-10-07 20:27:29 +02:00
2005-10-10 19:36:09 +02:00
loglevel = 4
2005-10-07 20:27:29 +02:00
.br
2005-10-10 19:36:09 +02:00
reportemail = root
.br
reportsuccess = yes
2005-10-07 20:27:29 +02:00
.br
reportinfo = no
.br
reportspace = no
.br
reporthost =
.br
reportuser = ninja
.br
reportdirectory = /var/lib/backupninja/reports
2005-10-10 19:36:09 +02:00
.br
reportwrap = 1000
.br
2005-10-10 19:36:09 +02:00
logfile = /var/log/backupninja.log
.br
configdirectory = /etc/backup.d
.br
admingroup = root
.br
2005-10-10 19:36:09 +02:00
scriptdirectory = /usr/share/backupninja
.br
2021-01-10 00:27:33 +01:00
usecolors = yes
2005-11-19 18:11:28 +01:00
.br
when = everyday at 01:00
2005-10-07 20:27:29 +02:00
.SH SEE ALSO
2021-01-10 00:27:33 +01:00
.BR backupninja (1),
.BR ninjahelper (1),
.BR backup.d (5),
2005-10-07 20:27:29 +02:00
.br
.SH AUTHOR
2005-10-10 19:36:09 +02:00
BACKUPNINJA was written by the riseup.net collective.