Attachment 26307 Details for Bug 42857 – rsync.xml

rsync.xml

rsync.xml (text/plain), 13.18 KB, created by Xavier Neys (RETIRED) on 2004-02-25 02:33:14 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Xavier Neys (RETIRED)

Created: 2004-02-25 02:33:14 UTC

Size: 13.18 KB

patch

obsolete

><?xml version='1.0' encoding="UTF-8"?>
>
><!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
>
><guide link="/doc/fr/rsync.xml">
><title>RÃ¨gles au sujet des miroirs rsync de Gentoo Linux</title>
>
><author title="Auteur">
>  <mail link="mirror-admin@gentoo.org">Administrateurs du miroir Gentoo</mail>
></author>
><author title="Traducteur">
>  <mail link="mat@frheaven.com">Matthieu Montaudouin</mail>
></author>
>
><abstract>
>Guide et rÃ¨gles pour la mise en place d'un miroir rsync pour Gentoo Linux.
></abstract>
>
><license/>
>
><version>1.3</version>
><date>23 fÃ©vrier 2004</date>
>
><chapter>
><title>Conditions requises</title>
><section>
><title>Bande passante minimum</title>
><body>
><p>
>Pour hÃ©berger un miroir correctement, vous devez disposer d'une bande passante
>d'au moins 5Mbps en full duplex.
></p>
></body>
></section>
>
><section>
><title>Nombre d'utilisateurs minimum</title>
><body>
><p>
>Nous vous demandons de supporter un minimum de 15 connexions simultanÃ©es.
></p>
></body>
></section>
>
><section>
><title>MatÃ©riel minimum</title>
><body>
><p>
>Afin de servir correctement au moins 15 personnes simultanÃ©ment, nous vous
>demandons d'avoir au moins le matÃ©riel suivant&nbsp;:
></p>
><ul>
>	<li>Processeur PIII 500</li>
>	<li>256Mo RAM</li>
></ul>
></body>
></section>
>
><section>
><title>FrÃ©quence de mise Ã  jour</title>
><body>
><p>
>Les mises Ã  jour doivent avoir lieu Ã  :00 et :30 toutes les heures, 24 heures
>sur 24.  Il est <e>trÃ¨s</e> important de respecter strictement cet horaire, car
>nous utilisons un DNS de type round robin pour sÃ©lectionner le serveur rsync de
>l'utilisateur.
></p> 
></body>
></section>
>
><section>
><title>MOTD (<path>/etc/rsync/rsyncd.motd</path>)</title>
><body>
><p>
>Veuillez inclure les informations suivantes dans le fichier MOTD (Message Of
>The Day - message du jour) du rsync&nbsp;:
></p>
><ul>
>	<li>Nom du serveur</li>
>	<li>Adresse IP du serveur</li>
>	<li>SpÃ©cifications du serveur (processeur et RAM)</li>
>	<li>Bande passante utilisable du serveur</li>
>	<li>Nombre d'utilisateurs maximum, si nÃ©cessaire</li>
>	<li>Localisation du serveur (ville et pays)</li>
>	<li>Un nom de contact et une adresse email</li>
></ul>
><p>
>Mettre ces informations dans votre fichier MOTD permet d'identifier plus
>rapidement votre miroir en cas de problÃ¨me.
></p>
></body>
></section>
></chapter>
>
><chapter>
><title>DÃ©tails pour la mise en place</title>
><section>
><body>
><p>
>Pour installer un miroir, veuillez suivre ces Ã©tapes&nbsp;:
></p>
><ul>
>	<li>
>    Configurez votre miroir pour qu'il se synchronise avec un miroir rsync Gentoo
>    Linux public existant, peu importe lequel.  Assurez-vous de le synchroniser
>    comme indiquÃ© dans les <e>frÃ©quences de mises Ã  jour</e> ci-dessus.
>	</li>
>	<li>
>    Remplissez un rapport de bug sur <uri
>    link="http://bugs.gentoo.org">bugs.gentoo.org</uri> qui contient le nom de
>    votre serveur, son adresse IP, les informations concernant le contact et le
>    fait que vous souhaitez devenir un miroir rsync.  Nous vÃ©rifierons votre
>    serveur pour nous assurer qu'il se synchronise correctement. Votre serveur
>    doit se synchroniser deux fois par heure, entre :00 et :10, et entre :30 et
>    :40, vous pouvez dÃ©cider de l'heure exacte dans ces fenÃªtres.  Nous vous
>    contacterons pour vous demander d'ajuster votre planification correctement.
>	</li>
>	<li>
>    Une fois que nous aurons vÃ©rifiÃ© que le miroir se synchronise correctement,
>    nous ajouterons l'adresse IP de votre serveur dans la liste d'accÃ¨s de
>    rsync1.us.gentoo.org.
>	</li>
>	<li>
>    Mettez Ã  jour votre tÃ¢che cron rsync pour que la synchronisation se fasse
>    sur <path>rsync1.us.gentoo.org</path>.  Nous surveillerons votre serveur
>    durant les 48-72 heures qui suivent pour nous assurer qu'il se synchronise
>    correctement.
>	</li>
></ul>
>
><p>
>Si toutes les Ã©tapes se sont dÃ©roulÃ©es correctement, nous ajouterons une entrÃ©e
>DNS officielle rsync[num].[code_pays].gentoo.org et vous ajouterons Ã  notre
>round robin DNS pour rsync.[code_continent].gentoo.org et
>rsync.[code_pays].gentoo.org.  Peu de temps aprÃ¨s avoir Ã©tÃ© ajoutÃ© Ã  notre DNS,
>vous devriez commencer Ã  voir du trafic rsync.
></p>
><p>
>Qui plus est, vous, l'administrateur, serez ajoutÃ© Ã  la mailing list
>gentoo-mirrors (faible trafic) afin de pouvoir suivre tous les problÃ¨mes liÃ©s
>aux miroirs rsync.
></p>
><note>
>Merci d'aider les utilisateurs et dÃ©veloppeurs Gentoo Linux&nbsp;!  Pour tout
>problÃ¨me relatif Ã  l'administration d'un serveur rsync, visitez <uri
>link="http://bugs.gentoo.org">bugs.gentoo.org</uri> et remplissez un bug sur le
>produit "Rsync".
></note>
></body>
></section>
></chapter>
>
><chapter>
><title>TÃ¢ches parallÃ¨les</title>
><section>
><body>
><p>
>Nous aurons bientÃ´t une page crÃ©Ã©e par rrdtool qui permettra d'avoir des liens
>vers les graphes (triÃ©s par continent, puis par pays, puis par serveur) d'accÃ¨s
>aux serveurs miroirs rsync officiels (ces graphes seront faits avec le rÃ©sultat
>d'une commande sping).  Nous vÃ©rifierons ces graphes au moins une fois par jour
>et les machines injoignables seront enlevÃ©es de notre DNS round robin jusqu'Ã 
>ce que les problÃ¨mes soient rÃ©solus.  Des scripts vÃ©rifieront toutes les 30
>minutes que tous les miroirs se synchronisent bien avec nous.
></p>
><warn>
>Si un miroir a rÃ©guliÃ¨rement un comportement problÃ¨matique, que
>l'administrateur est contactÃ© et que la situation ne s'amÃ©liore pas, alors le
>miroir sera supprimÃ© du round robin de faÃ§on permanente.
></warn>
></body>
></section>
></chapter>
>
><chapter>
><title>FAQ rapide</title>
><section>
><title>Q: Qui dois-je contacter pour tout ce qui concerne les problÃ¨mes et la maintenance de serveurs rsync&nbsp;?</title>
><body>
><p>
>R: Visitez <uri link="http://bugs.gentoo.org">bugs.gentoo.org</uri> et
>remplissez un bug sur le produit "Rsync".
></p>
></body>
></section>
>
><section>
><title>Q: J'utilise un miroir rsync privÃ© pour mon entreprise. Puis-je quand mÃªme accÃ¨der Ã  rsync1.us.gentoo.org&nbsp;?</title>
><body>
><p>
>R: Etant donnÃ© que nos ressources sont limitÃ©es, nous les allouons de telle
>sorte qu'elles bÃ©nÃ©ficient au maximum Ã  nos utilisateurs.  Nous limitons donc
>les connexions Ã  notre rsync maÃ®tre et aux miroirs distfiles pour les miroirs
>publics seulement.  Les utilisateurs sont encouragÃ©s Ã  utiliser notre systÃ¨me
>de miroirs normal pour Ã©tablir un miroir rsync privÃ©, il leur est donc demandÃ©
>de suivre les <uri
>link="http://www.gentoo.org/news/en/gwn/20030505-newsletter.xml#doc_chap1_sect3">rÃ¨gles
>de bonne conduite rsync</uri>.
></p>
></body>
></section>
>
><section>
><title>Q: Est-il important de synchroniser mon miroir deux fois par heure&nbsp;?</title>
><body>
><p>
>R: Oui, c'est important. Votre miroir doit se synchroniser deux fois par heure
>dans les fenÃªtres ci-dessous&nbsp;:
></p>
><ol>
>  <li>entre :00 et :10</li>
>  <li>entre :30 et :40</li>
></ol>
><p>
>Veuillez aussi synchroniser aux mÃªmes minutes, par exemple :08 et :38, pour
>garantir une synchronisation toutes les trente minutes.
></p>
></body>
></section>
>
><section>
><title>Q: Comment puis-je trouver le miroir le plus proche de chez moi&nbsp;?
></title>
><body>
><p>
>R: netselect a Ã©tÃ© conÃ§u pour faire cela Ã  votre place.  Si vous n'avez pas
>encore fait <c>emerge netselect</c>, alors faites-le.  ExÃ©cutez ensuite
><c>netselect rsync.gentoo.org</c>. AprÃ¨s une minute environ, netselect vous
>indiquera une adresse IP.  Notez cette adresse et utilisez-la comme seul
>paramÃ¨tre pour rsync en lui accolant deux "deux points", par exemple <c>rsync
>1.2.3.4::</c>.  Vous devriez Ãªtre capable de trouver quel est ce miroir par son
>MOTD. Adaptez ensuite votre /etc/make.conf selon ces nouvelles informations.
></p>
></body>
></section>
>
><section>
><title>Q: Puis-je utiliser la compression quand je me synchronise avec rsync1.us.gentoo.org&nbsp;?</title>
><body>
><p>
>R: Non.  La compression utilise trop de ressources sur le serveur, nous l'avons
>donc dÃ©sactivÃ©e sur rsync1.us.gentoo.org.  S'il vous plaÃ®t <b>n'utilisez
>pas</b> la compression quand vous vous synchronisez avec ce serveur.
></p>
></body>
></section>
>
><section>
><title>Q: Comment Ã©liminer les processus rsync morts&nbsp;?</title>
><body>
>
><p>
>R: Voyez la section Â«&nbsp;Exemples de scripts&nbsp;Â».
></p>
>
></body>
></section>
><section>
><title>Q: Des utilisateurs se connectent <b>trÃ¨s</b> fÃ©quemment sur mon miroir et causent parfois un dÃ©ni de service. Comment empÃªcher cela&nbsp;?</title>
><body>
><p>
>R: Voyez la section Â«&nbsp;Exemples de scripts&nbsp;Â».
></p>
></body>
></section>
>
></chapter>
>
><chapter>
><title>Exemples de scripts</title>
><section>
><body>
><p>
>Actuellement, faire un miroir de notre arbre de Portage ne demande qu'environ
>250 Mo d'espace disque. Avoir 500 Mo de libre devrait permettre de voir venir.
>Mettre en place un miroir de l'arbre de Portage est simple, tout d'abord
>assurez vous que rsync est installÃ© sur votre miroir, puis configurez votre
>fichier rsyncd.conf pour qu'il ressemble Ã  ceci&nbsp;:
></p>
><pre caption="rsyncd.conf">
>uid = nobody
>gid = nobody
>use chroot = yes
>max connections = 15
>pid file = /var/run/rsyncd.pid
>motd file = /etc/rsync/rsyncd.motd
>log file = /var/log/rsync.log
>transfer logging = yes
>log format = %t %a %m %f %b
>syslog facility = local3
>timeout = 300
>
>[gentoo-x86-portage]
>#pour des raisons de compatibilitÃ©
>path = /space/gentoo/rsync
>comment = Gentoo Linux Portage tree
>
>[gentoo-portage]
>#les versions modernes de portage utilisent cette section
>path = /gentoo/rsync
>comment = Gentoo Linux Portage tree mirror
>exclude = distfiles
></pre>
><p>
>Ci-dessus, le miroir gentoo-x86-portage pointe vers les mÃªmes donnÃ©es que
>gentoo-portage.  Bien que nous ayons rÃ©cemment changÃ© le nom officiel de notre
>miroir en gentoo-portage, il est encore nÃ©cessaire de garder gentoo-x86-portage
>pour des raisons de compatibilitÃ©, indiquez donc les deux sections.
></p>
><p>
>Pour des raisons de sÃ©curitÃ©, l'utilisation d'un environnement chroot est
>imposÃ©e.
></p>
><p>
>Maintenant, vous avez besoin de construire un miroir de l'arbre de Portage de
>Gentoo Linux.  Vous pouvez utiliser le script suivant pour cela:
></p>
><pre caption="rsync-gentoo-portage.sh">
>#!/bin/bash
>
>RSYNC="/usr/bin/rsync"
>OPTS="--quiet --recursive --links --perms --times --devices --delete --timeout=300"
>#dÃ©commentez la ligne suivante seulement si vous avez obtenu un accÃ¨s Ã  rsync1.us.gentoo.org
>#SRC="rsync://rsync1.us.gentoo.org/gentoo-portage"
>#Si vous attendez l'accÃ¨s Ã  notre miroir maÃ®tre, sÃ©lectionnez un de nos miroirs publics:
>SRC="rsync://rsync2.de.gentoo.org/gentoo-portage"
>DST="/space/gentoo/rsync/"
>
>echo "Mise Ã  jour commencÃ©e Ã " `date` >> $0.log 2>&amp;1
>logger -t rsync "Mise Ã  jour de l'arbre de Portage Gentoo"
>${RSYNC} ${OPTS} ${SRC} ${DST} >> $0.log 2>&amp;1
>
>echo "Fin: "`date` >> $0.log 2>&amp;1 
></pre>
><pre caption="/etc/init.d/rsyncd">
>#!/sbin/runscript
># Copyright 1999-2002 Gentoo Technologies, Inc.
># Distributed under the terms of the GNU General Public License, v2 or later
># $Header: /home/cvsroot/gentoo-x86/net-misc/rsync/files/rsyncd.init.d,v 1.1 2003/02/22 22:41:09 vapier Exp &#36;
>
>depend() {
>need net
>}
>
># Pour votre information: --sparce semble causer des problÃ¨mes.
>RSYNCOPTS="--daemon --safe-links --timeout=300"
>
>start() {
>ebegin "Starting rsync daemon"
>start-stop-daemon --start --quiet --pidfile /var/run/rsyncd.pid --nicelevel 15 --exec /usr/bin/rsync -- ${RSYNCOPTS}
>eend $?
>}
>
>stop() {
>ebegin "Stopping rsync daemon"
>start-stop-daemon --stop --quiet --pidfile /var/run/rsyncd.pid
>eend $?
>} 
></pre>
><p>
>Votre fichier rsyncd.motd devrait contenir votre adresse IP et d'autres
>informations utiles sur votre miroir, comme l'hÃ´te fournissant le miroir
>Portage et un moyen de contacter l'administrateur.  AprÃ¨s avoir Ã©tÃ© approuvÃ©
>comme serveur miroir rsync officiel, votre hÃ´te recevra un alias de la forme:
><path>rsync[num].[code_pays].gentoo.org</path>
></p>
>
><p>
>La commande suivante vous permet de supprimer les vieux processus rsync qui
>traÃ®nent Ã  cause de problÃ¨mes de connexion. Il est important de les supprimer,
>car ils comptent pour appliquer la limite sur le nombre maximum de connexions.
>Vous devriez exÃ©cuter cette commande toutes les heures via cron. Elle supprime
>les connexions Ã©tablies depuis plus d'une heure.
></p>
>
><pre>
>/bin/kill -9 `/bin/ps --no-headers -Crsync -o etime,user,pid,command|/bin/grep nobody | \
>          /bin/grep "[0-9]\{2\}:[0-9]\{2\}:" |/bin/awk '{print $3}'`
></pre>
>
><p>
>Parfois, certains utilisateurs indÃ©licats abusent des miroirs en synchronisant
>plus d'une Ã  deux fois par jour. Dans des cas extrÃªmes, des utilisateurs
>lancent un rsync toutes les 15 minutes. Cela provoque souvent un dÃ©ni de
>service et occupe une connexion qui pourrait Ãªtre utilisÃ©e par un autre
>utilisateur. Pour essayer de bloquer ces utilisateurs, vous pouvez essayer ce
><uri link="/proj/en/infrastructure/mirrors/rsyncd.conf_pl.txt">script
>perl</uri> qui dÃ©tecte les IP qui ont Ã©tabli plus de N connexions dans la
>journÃ©e et crÃ©e un fichier rsyncd.conf qui leur bloque l'accÃ¨s.
>La ligne suivante utilise une valeur N de 4 connexions&nbsp;:
></p>
>
><pre>
>@badhosts=grep {$hash{$_}>4} keys %hash;
></pre>
>
><p>
>Si vous utilisez ce script, n'oubliez pas d'effectuer une rotation quotidienne
>de vos fichiers de log et dÃ©finissez le chemin vers votre fichier rsyncd.conf.
>Le script a Ã©tÃ© testÃ© sur Gentoo, mais devrait fonctionner dans d'autres
>environnements qui supportent rsync et perl.
></p>
></body>
></section>
></chapter>
></guide>

Actions: View

Attachments on bug 42857: 26307