X-Git-Url: https://arthur.barton.de/gitweb/?p=backup-script.git;a=blobdiff_plain;f=README.md;h=47ec27a91819dc27d1d52b6355126ed3deb3e16d;hp=f1c1e6ba66abaf294b5695375a70e01573818995;hb=HEAD;hpb=05cbdc409dd5e4ef1c1d32dcaf15c6baa77e865d diff --git a/README.md b/README.md index f1c1e6b..4f6ec52 100644 --- a/README.md +++ b/README.md @@ -1,15 +1,24 @@ # Backup Script -A script for cloning systems using rsync. -Copyright (c)2008-2016 Alexander Barton () -Homepage: https://github.com/alexbarton/backup-script +A script for backing up data using `ssh`(1), `rsync`(1), and `scp`(1). +Can handle backup generations on *btrfs* and *ZFS*. +Copyright (c)2008-2020 Alexander Barton () +Homepage: + +## Installation + +Call the scripts located in `./bin` directly from the source folder, or run +`make install` to install them to `/usr/local/sbin`. + +You can set `PREFIX` to use an other path prefix than `/usr/local` like this: +`make PREFIX=/opt/backup-script install`. ## Usage ### backup-script -Backup all or individual systems. +Run all or individual backup jobs. Usage: `backup-script [] [ [ [...]]]` @@ -60,7 +69,6 @@ Options: When no *job* is given, all defined jobs are checked. - ## Configuration All default configuration variables are read from the first file found of this @@ -88,7 +96,6 @@ For example: - `/etc/backups-script.d/host01.example.net`: configuration for host 1 - `/etc/backups-script.d/clientXY.example.com`: configuration for host 2 - ### Global Settings The following global configuration options exist: @@ -101,7 +108,6 @@ In Addition, all job configuration options (see below) that have a "default_XXX" variant can be used and define default values for all jobs that don't overwrite them individually. - ## Configuration Variables ### system @@ -198,11 +204,11 @@ inside of the target directory. Supported file systems are: - * *btrfs*: - All generations are btrfs subvolumes and named after the date and time. - * *ZFS*: - All generations are ZFS file systems. Latest generation is named `current`, - elders are links to the ZFS snapshot directories. +- *btrfs*: + All generations are btrfs subvolumes and named after the date and time. +- *ZFS*: + All generations are ZFS file systems. Latest generation is named `current`, + elders are links to the ZFS snapshot directories. The latest snapshot is always reachable using a symlink named `latest` inside the system directory. @@ -240,14 +246,14 @@ The following job configurations variables used by the outdated backup-pull(1) script in job definition files are automatically mapped to the new backup-script variables: -* host -> system -* source -> source_root -* pre_exec -> job_pre_exec -* post_exec -> job_post_exec - +- `host` -> `system` +- `source` -> `source_root` +- `pre_exec` -> `job_pre_exec` +- `post_exec` -> `job_post_exec` ## Exit codes +- 0: No error, success. - 1: Unspecific Error! - 2: Usage information has been shown. - 3: Can't read job definition