Amélioration de la doc

This commit is contained in:
Benjamin Renard 2017-03-06 18:16:13 +01:00
parent 55830cc964
commit 8877829719

View file

@ -5,40 +5,53 @@ Installation
--------------- ---------------
* Installer les dépendances : * Installer les dépendances :
* inoticoming
* cryptsetup
* beep
* mettre les fichiers suivant dans /usr/local/sbin : ```bash
apt-get install inoticoming cryptsetup beep libfuse-perl
```
* mettre les fichiers suivant dans */usr/local/sbin* :
* backup-usb * backup-usb
* backuppcfs * backuppcfs
* udev-bkp-usb * udev-bkp-usb
* run-bkp-usb * run-bkp-usb
* créer le fichier /etc/udev/rules.d/99-bkp-usb.rules : * créer les dossiers */mnt/backuppcfs* et */mnt/usb* :
```bash
mkdir /mnt/backuppcfs /mnt/usb
``` ```
* créer le fichier */etc/udev/rules.d/99-bkp-usb.rules* :
```bash
# A l'insertion du disque, lancement du script de backup # A l'insertion du disque, lancement du script de backup
# Rechargement des regles udev manuellement si necessaire : udevadm control --reload-rules # Rechargement des regles udev manuellement si necessaire : `udevadm control --reload-rules`
# Exemple :
# Disk 1 # Disk 1
ACTION=="add", ENV{DEVTYPE}=="disk", ENV{ID_FS_UUID}=="41fc79d3-25fd-4424-9fc8-92479deead27", RUN+="/usr/local/sbin/udev-bkp-usb" #  ACTION=="add", ENV{DEVTYPE}=="disk", ENV{ID_FS_UUID}=="41fc79d3-25fd-4424-9fc8-92479deead27", RUN+="/usr/local/sbin/udev-bkp-usb"
``` ```
* lancer la commande : udevadm control --reload-rules * lancer la commande :
* ajouter la ligne suivante dans le fichier /etc/rc.local :
```bash
udevadm control --reload-rules
``` ```
* ajouter les lignes suivantes dans le fichier */etc/rc.local* :
```bash
# Run backup on USB device detection (trigger by udev rule) # Run backup on USB device detection (trigger by udev rule)
inoticoming --logfile /var/log/bkp-usb.log /var/run/ --stderr-to-log --stdout-to-log --regex '^bkp-usb-detected$' /usr/local/sbin/run-bkp-usb {} \; inoticoming --logfile /var/log/bkp-usb.log /var/run/ --stderr-to-log --stdout-to-log --regex '^bkp-usb-detected$' /usr/local/sbin/run-bkp-usb {} \;
``` ```
* lancer manuellement la commande inoticoming (ou rebooter) * lancer manuellement la commande *inoticoming* du fichier précédent (ou rebooter)
Création du mot de passe de et la clé LUKS Création du mot de passe de et la clé LUKS
------------------------------------------ ------------------------------------------
``` ```bash
pwgen -1 -y 40 > /root/.luks.pwd pwgen -1 -y 40 > /root/.luks.pwd
dd if=/dev/urandom of=/root/.luks.key bs=1024 count=4 dd if=/dev/urandom of=/root/.luks.key bs=1024 count=4
chmod 0600 /root/.luks.pwd /root/.luks.pwd chmod 0600 /root/.luks.pwd /root/.luks.pwd
@ -48,42 +61,42 @@ Creation d'un disque USB
------------------------ ------------------------
- brancher le disque sur le serveur puis se connecter en tant que root au serveur - brancher le disque sur le serveur puis se connecter en tant que root au serveur
- détecter le nom qu'a pris le disque (en regardant le résultat de la commande *dmesg* par exemple), par exemple */dev/sdg* - détecter le nom qu'a pris le disque (en regardant le résultat de la commande *dmesg* par exemple), par exemple **/dev/sdg**
- formater le disque : - formater le disque :
``` ```bash
cryptsetup -q --use-urandom luksFormat /dev/sdg /root/.luks.pwd cryptsetup -q --use-urandom luksFormat /dev/sdg /root/.luks.pwd
cryptsetup luksAddKey /dev/sdg /root/.luks.key --key-file /root/.luks.pwd cryptsetup luksAddKey /dev/sdg /root/.luks.key --key-file /root/.luks.pwd
``` ```
- "Ouvrir" le disque chiffré : - "Ouvrir" le disque chiffré :
``` ```bash
cryptsetup luksOpen /dev/sdg bkp-usb --key-file /root/.luks.key cryptsetup luksOpen /dev/sdg bkp-usb --key-file /root/.luks.key
``` ```
- Formater le disque chiffré en ext4 : - Formater le disque chiffré en ext4 :
``` ```bash
mkfs.ext4 /dev/mapper/bkp-usb mkfs.ext4 /dev/mapper/bkp-usb
tune2fs -i0 -c0 -m0 /dev/mapper/bkp-usb tune2fs -i0 -c0 -m0 /dev/mapper/bkp-usb
``` ```
- Fermer le disque chiffré : - Fermer le disque chiffré :
``` ```bash
cryptsetup close bkp-usb cryptsetup close bkp-usb
``` ```
- Récupérer l'identifiant UUID du disque : - Récupérer l'identifiant UUID du disque :
``` ```bash
udevadm info -q all /dev/sdg|grep 'ID_FS_UUID=' udevadm info -q all /dev/sdg|grep 'ID_FS_UUID='
``` ```
Exemple : Exemple :
``` ```bash
root@bkphost:~# udevadm info -q all /dev/sdg|grep 'ID_FS_UUID=' root@bkphost:~# udevadm info -q all /dev/sdg|grep 'ID_FS_UUID='
E: ID_FS_UUID=41fc79d3-25fd-4424-9fc8-92479deead27 E: ID_FS_UUID=41fc79d3-25fd-4424-9fc8-92479deead27
``` ```
@ -91,7 +104,7 @@ E: ID_FS_UUID=41fc79d3-25fd-4424-9fc8-92479deead27
- Ajouter l'exécution automatique de l'export des backups pour ce disque - Ajouter l'exécution automatique de l'export des backups pour ce disque
dans le fichier le règle udev */etc/udev/rules.d/99-bkp-usb.rules* : dans le fichier le règle udev */etc/udev/rules.d/99-bkp-usb.rules* :
``` ```bash
# Disk X # Disk X
ACTION=="add", ENV{DEVTYPE}=="disk", ACTION=="add", ENV{DEVTYPE}=="disk",
ENV{ID_FS_UUID}=="41fc79d3-25fd-4424-9fc8-92479deead27", ENV{ID_FS_UUID}=="41fc79d3-25fd-4424-9fc8-92479deead27",
@ -100,8 +113,14 @@ RUN+="/usr/local/sbin/udev-bkp-usb"
- Recharger les règles UDEV : - Recharger les règles UDEV :
``` ```bash
udevadm control --reload-rules udevadm control --reload-rules
``` ```
- Débrancher puis re-brancher le disque une première fois pour vérifier qu'il est bien détecter et que le premier export (long) soit lancé. - Débrancher puis re-brancher le disque une première fois pour vérifier qu'il est bien détecter et que le premier export (long) soit lancé.
**Note :** A des fins de tests, il est possible de simuler l'exécution du script */usr/local/sbin/udev-bkp-usb* par UDEV de la manière suivante :
```bash
ACTION=add DEVTYPE=disk DEVNAME=/dev/sdg /usr/local/sbin/udev-bkp-usb
```