Installing EvoBackup
====================

Backup server side
------------------

1) Git clone the project (i.e in /root/evobackup).

2) Install configuration files.

```
root@backupserver:~/evobackup# install.sh
```

This will create /etc/evobackup and /etc/init.d/evobackup (or
/etc/init/evobackup.conf for Ubuntu).

3) Set up the first chroot.

```
root@backupserver:~/evobackup# chroot-new.sh -n client1 -i 192.168.0.10 -p 2222 -k /path/to/rsakeyclient1.pub
```

This will create the OpenSSH chroot for the machine "client1", listening on
port 2222 and accepting only connections from 192.168.0.10 using public key
rsakeyclient1.pub.

Tip: If you have already a chroot, you can commit the port option (-p), it
will be incremented from the last chroot.

4) Handle incrementals by modifying /etc/evobackup/conf.d/incs/client1

Syntax of this file is simple:

* +%Y-%m-%d.-0day Keep actual day
* +%Y-%m-%d.-1day Keep yesterday
* +%Y-%m-01.-0month Keep the firt day of the actual month
* +%Y-%m-01.-1month Keep the first day of the last month

Tip: You can use rdiff-backup in place of rsync, and choose to not use
EvoBackup incrementals method. You need to modify the cronjob.

5) Set up the scripts which will handle incrementals.

```
root@backupserver:~/evobackup# mkdir -p /usr/share/scripts
root@backupserver:~/evobackup# cp crons/evobackup-{inc,rm}.sh /usr/share/scripts/
root@backupserver:~/evobackup# chmod u+x /usr/share/scripts/evobackup-{inc,rm}.sh
root@backupserver:~/evobackup# crontab -e
```

Set this in the root crontab

```
29 10 * * * pkill evobackup-rm.sh && echo "Kill evobackup-rm.sh done" | mail -s "[warn] EvoBackup - purge incs interrupted" root
30 10 * * * /usr/share/scripts/evobackup-inc.sh && /usr/share/scripts/evobackup-rm.sh
````

Client side
-----------

1) Git clone the project (i.e in /root/evobackup).

2) Generates OpenSSH key for user root (if user root don't have one already).

```
root@client1:~/evobackup# ssh-keygen
```

Do not set a passphrase, otherwise you will need to enter the passphrase (or
store it using an agent) for each backups!

3) Install configuration files.

```
root@client1:~/evobackup# install.sh client
```

4) Add the zzz_evobackup crontab into the daily cronjobs (recommended):

```
root@client1:~/evobackup# cp crons/zzz_evobackup /etc/cron.daily/
root@client1:~/evobackup# chmod 700 /etc/cron.daily/zzz_evobackup
```

Why "zzz"? Because we want the backup cronjob to be the last one.

5) Configure the cronjob.

In /etc/evobackup:

* What to backup using shell scripts in actions.d. By default all scripts are
  commented out. Un-comment or write your own code, this will be launched
  before the rsync, using run-parts.

* What to backup using rsync filter rules in conf.d/include.cf
* General config in conf.d/cron.cf

6) Optional, test with sh -x.

```
root@client1:~/evobackup# sh -x /etc/cron.daily/zzz_evobackup
```

Updating OpenSSH chroot
-----------------------

When you upgrade you system you may need to upgrade the OpenSSH chroot. To do
that launch update-chroot.sh.

```
root@backupserver:~/evobackup# chroot-update.sh
```

Then reload sshd daemons.