/[gentoo]/xml/htdocs/doc/en/rsync.xml
Gentoo

Diff of /xml/htdocs/doc/en/rsync.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.63 Revision 1.64
1<?xml version="1.0" encoding="UTF-8"?> 1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/rsync.xml,v 1.63 2011/09/04 17:53:40 swift Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/rsync.xml,v 1.64 2012/07/24 12:12:51 swift Exp $ -->
4 4
5<guide lang="en"> 5<guide lang="en">
6<title>Gentoo Linux rsync Mirrors Policy and Guide</title> 6<title>Gentoo Linux rsync Mirrors Policy and Guide</title>
7 7
8<author title="Author"> 8<author title="Author">
9 <mail link="mirror-admin@gentoo.org">Gentoo Mirror Administrators</mail> 9 <mail link="mirror-admin@gentoo.org">Gentoo Mirror Administrators</mail>
10</author> 10</author>
11<author title="Author"> 11<author title="Author">
12 <mail link="klausman-gentoo@schwarzvogel.de">Tobias Klausmann</mail> 12 <mail link="klausman-gentoo@schwarzvogel.de">Tobias Klausmann</mail>
13</author> 13</author>
14<author title="Editor"> 14<author title="Editor">
15 <mail link="neysx@gentoo.org">Xavier Neys</mail> 15 <mail link="neysx@gentoo.org">Xavier Neys</mail>
16</author> 16</author>
17 17
18<abstract> 18<abstract>
19This document explains how to set up a official rsync mirror and your own local 19This document explains how to set up a official rsync mirror and your own local
20mirror. 20mirror.
21</abstract> 21</abstract>
22 22
23<!-- The content of this document is licensed under the CC-BY-SA license --> 23<!-- The content of this document is licensed under the CC-BY-SA license -->
24<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 24<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
25<license/> 25<license/>
26 26
27<version>3.9</version> 27<version>4</version>
28<date>2010-06-14</date> 28<date>2012-07-24</date>
29 29
30<chapter> 30<chapter>
31<title>Preliminaries</title> 31<title>Preliminaries</title>
32<section> 32<section>
33<title>Terms, names and all that</title> 33<title>Terms, names and all that</title>
34<body> 34<body>
35 35
36<p> 36<p>
37This guide is intended for people who would like to set up an rsync mirror of 37This guide is intended for people who would like to set up an rsync mirror of
38their own. It caters not only to those who want to run an official rsync mirror 38their own. It caters not only to those who want to run an official rsync mirror
39but also those wanting to run private mirrors. 39but also those wanting to run private mirrors.
40</p> 40</p>
41 41
42<p> 42<p>
43There are three kinds of Gentoo rsync mirrors: main rotation mirrors, community 43There are three kinds of Gentoo rsync mirrors: main rotation mirrors, community
189 189
190<note> 190<note>
191Please note that most public mirror administrators consider syncing more than 191Please note that most public mirror administrators consider syncing more than
192once or twice a day an abuse. Some if not most of them will ban your IP from 192once or twice a day an abuse. Some if not most of them will ban your IP from
193their server if you start abusing their machines. 193their server if you start abusing their machines.
194</note> 194</note>
195 195
196</body> 196</body>
197</section> 197</section>
198<section> 198<section>
199<title>Configuring your clients</title> 199<title>Configuring your clients</title>
200<body> 200<body>
201 201
202<p> 202<p>
203Now, make your other computers use your own local rsync mirror instead of a 203Now, make your other computers use your own local rsync mirror instead of a
204public one. Edit your <path>/etc/make.conf</path> and make the <c>SYNC</c> 204public one. Edit your <path>/etc/portage/make.conf</path> and make the <c>SYNC</c>
205variable point to your server. 205variable point to your server.
206</p> 206</p>
207 207
208<pre caption="Define SYNC in /etc/make.conf"> 208<pre caption="Define SYNC in /etc/portage/make.conf">
209<comment>(Use your server IP address)</comment> 209<comment>(Use your server IP address)</comment>
210SYNC="rsync://<i>192.168.0.1</i>/gentoo-portage" 210SYNC="rsync://<i>192.168.0.1</i>/gentoo-portage"
211<comment>(Or use your server name)</comment> 211<comment>(Or use your server name)</comment>
212SYNC="rsync://<i>your_server_name</i>/gentoo-portage" 212SYNC="rsync://<i>your_server_name</i>/gentoo-portage"
213</pre> 213</pre>
214 214
215<p> 215<p>
216You can check that your computer has been properly set up by syncing against 216You can check that your computer has been properly set up by syncing against
217your own local mirror for the first time: 217your own local mirror for the first time:
218</p> 218</p>
219 219
220<pre caption="Checking and syncing"> 220<pre caption="Checking and syncing">
221<comment>(Check that the SYNC variable has been setup)</comment> 221<comment>(Check that the SYNC variable has been setup)</comment>
222# <i>emerge --info|grep SYNC</i> 222# <i>emerge --info|grep SYNC</i>
223SYNC="rsync://your_server_name/gentoo-portage" 223SYNC="rsync://your_server_name/gentoo-portage"
405 405
406</body> 406</body>
407</section> 407</section>
408 408
409<section> 409<section>
410<title>Q: How do I find the mirror nearest to me?</title> 410<title>Q: How do I find the mirror nearest to me?</title>
411<body> 411<body>
412 412
413<p> 413<p>
414A: <c>netselect</c> was designed to do this for you. If you haven't already run 414A: <c>netselect</c> was designed to do this for you. If you haven't already run
415<c>emerge netselect</c> then do it. Then run: <c>netselect 415<c>emerge netselect</c> then do it. Then run: <c>netselect
416rsync.gentoo.org</c>. After a minute or so netselect will print an IP address. 416rsync.gentoo.org</c>. After a minute or so netselect will print an IP address.
417Take this address and use it as the only parameter for rsync with two colons 417Take this address and use it as the only parameter for rsync with two colons
418appended to it. e.g.: <c>rsync 1.2.3.4::</c>. You should be able to find out 418appended to it. e.g.: <c>rsync 1.2.3.4::</c>. You should be able to find out
419which mirror that is from the banner message. Update your 419which mirror that is from the banner message. Update your
420<path>/etc/make.conf</path> accordingly. 420<path>/etc/portage/make.conf</path> accordingly.
421</p> 421</p>
422 422
423</body> 423</body>
424</section> 424</section>
425<section> 425<section>
426<title>Q: Can I use compression when syncing against masterportage.gentoo.org?</title> 426<title>Q: Can I use compression when syncing against masterportage.gentoo.org?</title>
427<body> 427<body>
428 428
429<p> 429<p>
430A: No. Compression utilizes too many resources on the server, so we have 430A: No. Compression utilizes too many resources on the server, so we have
431forcibly disabled it on <path>masterportage.gentoo.org</path>. Please <e>do not</e> 431forcibly disabled it on <path>masterportage.gentoo.org</path>. Please <e>do not</e>
432attempt to use compression when syncing against this server. 432attempt to use compression when syncing against this server.
433</p> 433</p>
434 434
435</body> 435</body>

Legend:
Removed from v.1.63  
changed lines
  Added in v.1.64

  ViewVC Help
Powered by ViewVC 1.1.20