Attachment 19675 Details for Bug 31828 – rsync policy

rsync policy

rsync.xml (text/plain), 13.28 KB, created by Matthieu Montaudouin on 2003-10-23 08:49:11 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Matthieu Montaudouin

Created: 2003-10-23 08:49:11 UTC

Size: 13.28 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 concernant les miroirs rsync Gentoo Linux</title>
><author title="Auteur"><mail link="mirror-admin@gentoo.org">Administrateurs du miroir Gentoo</mail></author>
>
><version>1.1</version>
><date>13 DÃ©c 2002</date>
>
><license/>
>
><chapter>
><title>Conditions requises</title>
><section>
><title>Bande passante minimum</title>
><body>
><p>
>Pour hÃ©berger un miroir correctement, vous devez avoir 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:
></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 par jour.
>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> 
><impo>
>Cela doit Ãªtre respectÃ© strictement, car un serveur non synchronisÃ©, avec ce genre de configuration, gÃ©nÃ©re beaucoup plus de trafic pour tous les serveurs impliquÃ©s dans le processus (cf. la FAQ incluse pour plus de dÃ©tails).
></impo>
></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:
></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:
></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 vous 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.
>	Si votre serveur ne se synchronise pas exactement Ã  :00 et :30, nous vous contacterons pour vous demander d'ajuster votre planification horaire 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>
>	Mettes Ã  jour votre tÃ¢che cron rsync pour qu'elle pointe 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 mettrons alors en place une entrÃ©e DNS officielle rsync[num].[code_pays].gentoo.org, et vous ajouterons Ã  notre round robin DNS pour rsync.gentoo.org et rsync.[code_pays].gentoo.org.
>Peu de temps aprÃ¨s avoir Ã©tÃ© ajoutÃ© Ã  notre DNS, vous devriez commencer Ã  avoir 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! :)
>Pour tout problÃ¨me concernant 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 contient, puis par pays, puis par serveur) d'accessibilitÃ© 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.
>Nous aurons des scripts qui vÃ©rifieront que toutes les 30 minutes, 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?</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?</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 connections Ã  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 Ã  :00 et :30 toutes les heures?</title>
><body>
><p>R: Oui, c'est important. A chaque fois qu'un utilisateur fait un rsync sur un miroir, il obtient la diffÃ©rence entre ce miroir et ce qui se trouve sur son systÃ¨me.
>Si votre miroir est diffÃ©rent et un utilisateur utilise un round robin de noms d'hÃ´tes, alors vous augmentez la quantitÃ© de bande passante nÃ©cessaire pour l'utilisateur, vous et tous les autres miroirs.
>
>Par exemple:
>
>Un utilisateur est configurÃ© de telle sorte que son rsync se se fait avec <path>rsync://rsync.gentoo.org/gentoo-portage</path>.
>
>Supposons que <path>rsync.gentoo.org</path> est un round robin DNS pour <path>rsync1.gentoo.org</path>, <path>rsync2.gentoo.org</path>, et <path>rsync3.gentoo.org</path>.
>
>Supposons ensuite que rsync1 et rsync3 se synchronisent aux instants recommandÃ©s mais que rsync2 ne se synchrnoise qu'une fois Ã  minuit et qu'actuellement nous sommes l'aprÃ¨s-midi.
></p>
><ol>
><li>
>L'utilisateur se synchrnoise avec rsync1 et met Ã  jour son arbre /usr/portage. Disons que cela a nÃ©cessitÃ© 5 Mo de bande passante.
></li>
><li>
>L'utilisateur se re-synchronise, cette fois-Ã§i avec rsync2.
>A ce moment lÃ , leur arbre de portage n'est pas Ã  jour, et quelle que soit la bande passante utilisÃ©e par l'utilisateur pour mettre Ã  jour son arbre Ã  l'Ã©tape 1, elle est perdue.
>Disons que la diffÃ©rence soit de 5 Mo.
></li>
><li>
>L'utilisateur se re-synchronise, cette fois avec rsync3, et une fois encore met Ã  jour son arbre de portage.
>Comme rsync2 avait une version ancienne, l'utilisateur doit encore une fois transfÃ©rer 5 Mo.
></li>
></ol>
><p> 
>Dans l'exemple ci-dessus, l'utilisateur a du transfÃ©rer 5 Mo * 3 = 15 Mo, ce qui est trois fois plus que ce qui Ã©tait nÃ©cessaire, et donnera donc une mauvaise impression du systÃ¨me de Portage Gentoo Ã  l'utilisateur.
>
>De plus, rsync2 et rsync3 on transfÃ©rÃ© 5 Mo qui n'auraient pas Ã©tÃ© nÃ©cessaires si rsync2 avait Ã©tÃ© Ã  jour.
>
>Multipliez ceci par le nombre d'utilisateurs du round robin DNS et vous verrez la quantitÃ© de bande passante gaspillÃ©e, ce qui augmente les coÃ»ts, non seulement pour votre miroir, mais pour tous les autres miroirs.
>
>Nous comprenons que nous aurons toujours une diffÃ©rence de synchrnoisation d'horloge entre les miroirs, et chaque miroir ne se synchronisera pas exactement au mÃªme moment. Afin de garder cet Ã©cart le plus faible possible, nous vous encourageons Ã  utiliser un dÃ©mon NTP.
>
>Si cela ne vous paraÃ®t pas une raison suffisante, sachez que vos logs auront plus d'importance vis Ã  vis de la loi si vous pouvez prouver que l'heure de votre systÃ¨me est correcte et synchronisÃ©e avec le reste du monde.
>
>Si vous ne voulez pas faire tourner ntpd tout le temps, exÃ©cutez au moins ntpdate une fois par jour avec cron.
></p>
></body>
></section>
><section>
><title>Q: Comment puis-je trouver le miroir le plus proche de chez moi?
></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. Mettez ensuite Ã  jour votre /etc/make.conf avec ces nouvelles informations.
></p>
></body>
></section>
><section>
><title>Q: Puis-je utiliser la compression quand je me synchronise avec rsync1.us.gentoo.org?</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>
></chapter>
><chapter>
><title>Exemples de scripts</title>
><section>
><body>
><p>
>Actuellement, faire un miroir de notre arbre de portage demande environ 60 Mo d'espace disque, ce qui est peu. Avoir 200 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 Ã  quelque chose comme ceci:
></p>
><pre caption="rsyncd.conf">
>#uid = nobody
>#gid = nobody
>use chroot = no
>max connections = 20
>pid file = /var/run/rsyncd.pid
>motd file = /etc/rsync/rsyncd.motd
>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Ãªme 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Ã©, donc mettez les deux sections.
></p>
><p>
>Maintenant, vous avez besoin de faire 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=600"
>#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 depuis lequel se mettre Ã  jour:
>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/httpd/cvsroot/gentoo/xml/htdocs/doc/en/rsync.xml,v 1.18 2003/10/03 17:37:39 swift Exp $
>
>depend() {
>need net
>}
>
># Pour votre information: --sparce semble causer des problÃ¨mes.
>RSYNCOPTS="--daemon --safe-links --timeout=1800"
>
>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 doit contenir votre adresse IP et d'autres informations utiles sur votre miroir, comme l'hÃ´te fournissant le miroir Portage et un contact vers 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>
></body>
></section>
></chapter>
></guide>

Actions: View

Attachments on bug 31828: 19675 | 19791