Jobs file options
The jobs file ~/dardrive/jobs.cfg is a ini-style text file whith a per-job
config section, which inherit options from a mandatory [global] section.
- archive_store
- This is where backups are stored, the same archive store can be
defined in a multiple jobs as it will be appended by the job name.
- catalog_begin
- When importing an archive_store, archives produced before this date won’t
get isolated and loaded in the dmd, thus, filesystem recovery of previous
archives must be performed manually. If this value is changed later on (ex:
to minimize the size of the dmd), you’ll provably need to recreate the
(with the rebuild_dmd command) or manually remove previous entries from t
(which is not advisable).
- catalog_store
- This is where DAR’s isolated catalogs are stored, the same archive store
can be defined in a multiple jobs as it will be appended by the job name.
- compr
- Possible values are configparser’s negative values, or the compression
algorithm suported by DAR, “gzip” “bzip2” or “lzo”.
- compr_exempt
- A regular expression as DAR(1) “alter regex”, matching elements
are excluded from compression.
- compr_level
- An integer from 1 to 9 that controls the compression level.
- compr_min
- Integer, files which size is below this value will not be compressed
as in “dar -m”.
- dar_bin
- Should point to the dar binary file.
- dar_manager_bin
- Should point to the dar_manager binary file.
- recover_path
- The directory on which dar_manager will restore files to, it defaults to /tmp
- diffdays
- The maximum time allowed between incrementals expressed in days, ex: if
diffdays is 7, and a backup job is run once a day, then dardrive will
produce a full backup every 7 days.
- email_from
- The sender address used when sending email reports.
- email_to
- The recipient used to adress the message to when sending email reports.
- exclude_file
- A file containing a listing of files to be excluded from the backup
operation, exactly as --exclude-from-file dar’s option, see DAR(1).
- exclude_regex
- A regular expression passed to dar via the -ar -X switches. It can be
deactivated with negative configparser’s booleans (no, false, 0)
- encryption
- A string representing the encryption algorithm and password as in “dar
-K”: <algo>:password. When running a database dump the algorithm is set
to aes-cbc 256, and is handled by OpenSSL.
- local_store
- A temporary directory where archives are created if the par_local option is
set, usually needed when the archive_store is a remote location and the job
is configured to produce parity files, in which case, producing them
locally results in network IO saving. After parity files are produced,
they are moved to the archive_store. This filesystem mus have enough space
to hold at leas a slice and its parity data.
- mysql
- Enables mysql dump. Expects boolean values.
- mysql_compr
- Enables mysql compression of dump archives. Expects boolean values.
- mysql_host
- Host name passed to mysql_dump.
- mysql_user
- User name passed to mysql_dump via a –defaults-extra-file.
- mysql_password
- password passed to mysql_dump via a –defaults-extra-file.
- openssl_bin
- Should point to the openssl binary file.
- par_bin
- Should point to the par binary file.
- par_local
- If this option is set, archives and error correction files are created in the
local_store and moved to the archive_store after each slice is created.
- par_mem
- Memory used by the par2 binary as in “par2 -m”.
- redundancy
- Level of redundancy of parity files as in “par2 -r”.
- report_success
- If send_email is set, report successful operations via email, otherwise
only errors are reported.
- root
- Points to the directory tree containing all the files that will be
used in the filesystem backup operation as a source.
- save_xattr
- Boolean which tells dar to save extended attributes.
- same_fs
- Boolean which tells dar to include only files in the same filesystem of
root in the backups.
- send_email
- Boolean which enables email reporting.
- slice
- A string representing the slice size as in dar --slice. Possible values
are boolean negative values, or a string composed of an integer optionally
appended by one of : K, M, G, T, P E, Z or Y. See DAR(1).
- smtp_server
- Specifies the smtp server to be used, it can be a host name or a
hostname:port string. if the port is 587, STARTTLS will be used.
- smtp_user
- When using TLS, the smtp user name.
- smtp_pass
- When using TLS, the smtp password.
- subject
- Subject used in the email reports.