---
title: Howto SSL
categories: network
...

Rsync (*Remote synchronization*) permet de réaliser des synchronisations distante à travers SSH. Cette méthode est unidirectionnelle où l'on peut effectuer des sauvegardes incrémentielles ou différentielles.

* [https://rsync.samba.org/](https://rsync.samba.org/)
* [https://fr.wikipedia.org/wiki/Rsync](https://fr.wikipedia.org/wiki/Rsync)


## Installation

~~~
# apt install rync

$ dpkg -l |grep rsync
ii  rsync                         3.1.2-1+deb9u1                 amd64        fast, versatile, remote (and local) file-copying tool
~~~


##  Premiers pas

Admettons que l'on veut copier des données du serveur-A vers le serveur-B.

~~~
user@serveur-A:~$ rsync -vd mon-dossier serveur-B:/home/user/
~~~

Ainsi on retrouvera le dossier sur le serveur distant.

~~~
user@serveur-B:~$ ls mon-dossier/
un-fichier1.txt un-fichier2.txt
~~~

Liste des paramètres les plus communs :

~~~
-n = "Test si la copie peut se faire"
-z = "compression"
-v = "mode verbeux"
-q = "quiet -> pas de sortie en stdout"
-h = "les infos sont lisible par un humain"
-d = "Copie les dossiers sans avoir besoin de lui indiquer qu'il faut le faire récursivement"
~~~


## Commandes avancées


~~~
-4 = "Utiliser une connexion ipv4"
-6 = "Utiliser une connexion ipv6"
-P = "suivre la progression du transfère d'un fichier"
-r = "Mode récursif"
-a = "archive, repecter les liens symboliques"
--delete = "supprimer les données distantes qui sont absentes depuis la source"
~~~


## FAQ

Q : J'obtiens une erreur de ce type :

~~~
Write failed: Broken pipe
rsync: connection unexpectedly closed (128109911 bytes received so far) [receiver]
rsync error: error in rsync protocol data stream (code 12) at io.c(601) [receiver=3.0.7]
rsync: connection unexpectedly closed (128109911 bytes received so far) [generator]
rsync error: unexplained error (code 255) at io.c(601) [generator=3.0.7]
~~~

R : cela peut venir dans certains cas d'un routeur coupant agressivement les sessions en cas d'inactivité.
    Dans ce cas, une solution est d'ajouter l'option suivante en Rsync Over SSH : `-e "ssh -o ServerAliveInterval=5"`