Services/Backuppc.md
... ...
@@ -6,11 +6,11 @@ BackupPC est l'outil utilisé au ResEl pour faire des sauvegardes du contenu de
6 6
7 7
#Mise en place
8 8
9
-BackupPC est un service hébergé sur [Padova](Serveurs/Padova). Il pousse une plateforme web à https://backuppc.resel.fr.
9
+BackupPC est un [programme](http://backuppc.sourceforge.net/) de gestion de snapshots performant et open source. Il est hébergé sur [Padova](Serveurs/Padova). Il pousse une plateforme web à https://backuppc.resel.fr.
10 10
11 11
L'accès à BackupPC est contrôlé par le droit `backuppc` du LDAP.
12 12
13
-
13
+Le fonctionnement de BackupPC est assez simple, il utilise `rsync` en backend, et procède, selon sa configuration, à des sauvegardes **incrémentales** ou **complètes**. Une sauvegarde *incrémentale* est une sauvegarde qui enregistre seulement les différences par rapport à la sauvegade précédente. Elles sont donc légères, mais détruites si l'on perd les sauvegardes d'avant.
14 14
15 15
# Utilisation
16 16
... ...
@@ -56,7 +56,7 @@ backuppc ALL=NOPASSWD: /usr/bin/nice -n 19 /usr/bin/rsync *, /usr/bin/rsy
56 56
```
57 57
58 58
Créez des dossiers pour le SSH et mettez-y les bons droits :
59
-```
59
+```shell
60 60
su backuppc
61 61
cd; mkdir .ssh;
62 62
chmod 700 .ssh
... ...
@@ -77,7 +77,7 @@ Actuellement le provisionning de la machine du Padova n'est pas fait avec Ansibl
77 77
78 78
Supposons que vous vouliez ajouter une machine au nom de *cyric*
79 79
80
-Il faut tout d'abord éditer le fichier `/etc/backuppc/hosts/` et ajouter la ligne suivante :
80
+Il faut tout d'abord éditer le fichier `/etc/backuppc/hosts` et ajouter la ligne suivante :
81 81
```
82 82
cyric 0 backup
83 83
```
... ...
@@ -121,6 +121,41 @@ Il arrive que parfois padova n'arrive pas à se connecter au serveur distant. Ce
121 121
* La connexion est autorisée depuis le bon nom de domaine (si DNS présents !) et/ou adresse IP (`from "padova.adm.resel.fr,172.22.2.5" dans authorized_keys` par exemple)
122 122
* L'utilisateur backuppc n'a pas de mot de passe (`passwd -d backuppc` pour le supprimer ; ou `adduser --disabled-password` à la création)
123 123
124
+# Configuration
125
+
126
+Backupppc est installé sur [Padova](/Serveurs/Padova).
127
+
128
+Tout les fichiers de configurations sont dans le dossier `/etc/backuppc`, ils doivent êtres des scripts *perl* valide.
129
+
130
+Le fichier principal est `config.pl`. Il précise les configurations générales. Voici un extrait intéressant :
131
+```perl
132
+$Conf{ServerHost} = 'padova';
133
+$Conf{BackupPCUser} = 'backuppc';
134
+
135
+$Conf{TopDir} = '/var/lib/backuppc'; # Where all the backup data is stored
136
+$Conf{ConfDir} = '/etc/backuppc'; # Where the config and hosts files resides
137
+$Conf{LogDir} = '/var/log/backuppc'; # Log
138
+$Conf{InstallDir} = '/usr/share/backuppc'; # Where bin and doc reside, DO NOT CHANGE
139
+$Conf{CgiDir} = '/usr/share/backuppc/cgi-bin'; # Apache CGI dir for BackupPC_Admin
140
+```
141
+Tout les autres paramètres régissent les mécaniques de sauvegarde, comme par exemple le nombre de sauvegarde incrémentale, etc...
142
+
143
+Ensuite, *backuppc* lit le contenu du fichier `hosts`, chacune des lignes, décrites sous la syntaxe `hostname dhcp username` :
144
+- `hostname` : est le nom, résolvable par DNS, de la machine
145
+- `dhcp` : un flag valant soit 0 si l'ip est fixe, soit 1 si l'ip doit être cherchée dans le DHCP.
146
+- `user` : le nom de l'utilisateur posix ayant le droits de faire des snapshots sur la machine.
147
+À chaque ligne correspond une machine que backuppc va gérer.
148
+
149
+Puis, chaque machine a une configuration propre, qui doit résider dans un fichier `<hostname>.pl`
150
+Le gabarit classique qu'on utilise au ResEl est le suivant :
151
+```perl
152
+$Conf{BackupFilesOnly} = ['/'];
153
+
154
+$Conf{BackupFilesExclude} = ['/cdrom',...];
155
+
156
+$Conf{RsyncShareName} = ['/', '/boot',...];
157
+```
158
+Le premier argument, **BackupFilesOnly** précise le dossier racine de la sauvegarde, puis on peut préciser des dossiers à exclure dans **BackupFilesExlude** et le
124 159
# Articles connexes
125 160
* [Les sauvegardes au ResEl](Backups)
126 161
* [Installation d'un nouveau serveur - Backuppc](Guides/Installation machine physique#backuppc)