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

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

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

Revision 1.2 Revision 1.24
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version='1.0' encoding="UTF-8"?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/source_mirrors.xml,v 1.24 2005/01/28 05:26:40 jforman Exp $ -->
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3 4
4<guide link="/doc/en/rsync.xml"> 5<guide link="/doc/en/source_mirrors.xml">
5<title>Gentoo Linux Source Mirrors Policy</title> 6<title>Gentoo Linux Source Mirrors Policy</title>
6<author title="Author"><mail link="klieber@gentoo.org">Kurt Lieber</mail></author> 7<author title="Author">
8 <mail link="klieber@gentoo.org">Kurt Lieber</mail>
9</author>
10<author title="Editor">
11 <mail link="cshields@gentoo.org">Corey Shields</mail>
12</author>
13<author title="Editor">
14 <mail link="bennyc@gentoo.org">Benny Chuang</mail>
15</author>
16<author title="Editor">
17 <mail link="jforman@gentoo.org">Jeffrey Forman</mail>
18</author>
7 19
20<abstract>
21This document explains the requirements for source mirrors.
22</abstract>
23
24<license/>
8<version>1.1</version> 25<version>1.4</version>
9<date>17 Feb 2003</date> 26<date>2005-01-11</date>
10 27
11<chapter> 28<chapter>
12<title>Requirements</title> 29<title>Requirements</title>
13<section> 30<section>
14<title>Minimum Bandwidth</title> 31<title>Minimum Bandwidth</title>
15<body> 32<body>
33
34<p>
16<p> To properly host a source mirror you should have a minimum of T1 bandwidth. 35To properly host a source mirror, you should have a minimum of 5Mbps upstream
17ADSL and cable connections do not generally make adequate connections for rsync hosts due to their limited upstream performance.</p> 36bandwidth. ADSL and cable connections do not generally make adequate
37connections for distfile hosts due to their limited upstream performance.
38</p>
39
40</body>
41</section>
42<section>
43<title>Minimum Disk Space</title>
44<body>
45
46<p>
47The space requirements depend on whether you choose to run a "Full" mirror or a
48"Distfiles only" mirror. Full mirrors require 90 GB of disk space. Distfiles
49only mirrors require 40 GB of space.
50</p>
51
18</body> 52</body>
19</section> 53</section>
20<section> 54<section>
21<title>Minimum User Count</title> 55<title>Minimum User Count</title>
22<body> 56<body>
57
58<p>
23<p>We ask that you support a minimum of 5 and preferrably 10 concurrent user connections.</p> 59We ask that you support a minimum of 15 and preferrably 30 concurrent user
60connections.
61</p>
62
24</body> 63</body>
25</section> 64</section>
26<section> 65<section>
27<title>Update Frequency</title> 66<title>Update Frequency</title>
28<body> 67<body>
29<p>We ask that source mirrors be updated at least 3-4 times throughout the day. At a minimum, source mirrors should be updated once per day.</p> 68
69<p>
70All mirrors must be synchronized every four hours, starting at midnight in your
71local time zone. This helps distribute the load out over a period of time,
72rather than having all mirrors synchronize at the same time.
73</p>
30</body> 74</body>
31</section> 75</section>
32</chapter> 76</chapter>
77
33<chapter> 78<chapter>
34<title>Implementation details</title> 79<title>Implementation details</title>
35<section> 80<section>
36<body> 81<body>
82
83<p>
37<p>for new source mirror requests, the procedure will be as follows:</p> 84For new source mirror requests, the procedure will be as follows:
38<p>Someone asks to be a mirror, then we verify that the mirror exists and we can connect to it properly. Then, in the next 48-72 hours we will determine if your mirror is syncing correctly with <path>www.ibiblio.org/gentoo/</path> and accordingly with this policy.</p> 85</p>
39 86
40<p>If all steps went smoothly, we will then add you to our list of <uri link="http://www.gentoo.org/main/en/mirrors.xml">download mirrors</uri> on the main web site.</p> 87<p>
88Set up your server to rsync with ftp.ussg.iu.edu::gentoo-distfiles. Once you
89have a complete mirror of that server, please file a bug report on
90bugs.gentoo.org under the "rsync" category stating that you have a new mirror
91and wish it to be added to the list of official mirrors. Please specify
92whether you wish to be a "Full" mirror or "Distfiles only" mirror. Distfiles
93only mirrors will be designated as such on the website.
94</p>
41 95
42<p>Additionally, you, the mirror admin will be added to the gentoo-mirrors mailing list (low traffic) so that you can folllow all issues associated with source mirrors. 96<p>
97Full mirrors must carry the following directories (plus any directories that
98get added in the future):
99</p>
100
101<ul>
102 <li>/releases</li>
103 <li>/experimental</li>
104 <li>/distfiles</li>
105 <li>/snapshots</li>
106 <li>/grp</li>
107</ul>
108
109<p>
110Distfiles only mirrors need to carry the following directories:
111</p>
112
113<ul>
114 <li>/distfiles</li>
115 <li>/snapshots</li>
116</ul>
117
118<p>
119We will then verify that the mirror exists and we can connect to it properly.
120Then, in the next 48-72 hours, we will determine if your mirror is syncing
121correctly and in accordance with this policy.
122</p>
123
124<p>
125If all steps went smoothly, we will then add you to our list of <uri
126link="/main/en/mirrors.xml">download mirrors</uri> on the main web site. We
127will also send you the login information for our private master distfile mirror
128which is only available to official Gentoo Linux source mirrors.
43</p> 129</p>
130
131<p>
132Additionally, you, the mirror admin, will be requested to subscribe to the
133gentoo-mirrors mailing list (low traffic) so that you can follow all issues
134associated with source mirrors.
135</p>
136
44<note> 137<note>
45Thanks for helping out Gentoo Linux users and developers! :) For any mirror administration issues or problems, please contact <mail link="mirror-admin@gentoo.org">mirror-admin@gentoo.org</mail>. 138Thanks for helping out Gentoo Linux users and developers! :) For any mirror
139administration issues or problems, please contact <mail
140link="mirror-admin@gentoo.org">mirror-admin@gentoo.org</mail>.
46</note> 141</note>
142
143<warn>
144Do NOT email mirror-admin@gentoo.org for mirror requests, please file a bug. It makes mirror tracking easier on us.
145</warn>
146
47</body> 147</body>
48</section> 148</section>
49</chapter> 149</chapter>
150
50<chapter> 151<chapter>
51<title>Short FAQ</title> 152<title>Short FAQ</title>
52<section> 153<section>
53<title>Q: Who should I contact regarding new mirrors or to get my mirror added to the Gentoo web site?</title> 154<title>Q: Who should I contact regarding new mirrors or to get my mirror added to the Gentoo web site?</title>
54<body> 155<body>
55<p>A: <mail link="klieber@gentoo.org">klieber@gentoo.org</mail></p> 156
157<p>
158A: Please file a bug on bugs.gentoo.org under the rsync category.
159</p>
160
56</body> 161</body>
57</section> 162</section>
58<section> 163<section>
59<title>Q: Who should I contact regarding mirror issues and maintenance?</title> 164<title>Q: Who should I contact regarding mirror issues and maintenance?</title>
60<body> 165<body>
61<p>A: <mail link="mirror-admin@gentoo.org">mirror-admin@gentoo.org</mail></p>
62</body>
63</section>
64 166
167<p>
168A: Please file a bug on bugs.gentoo.org under the rsync category.
169</p>
170
171</body>
65<section> 172</section>
173<section>
174<title>Q: I run a private source mirror for my company. Can I still access the private master source mirror?</title>
175<body>
176
177<p>
178A: Because our resources are limited, we need to ensure we allocate them in
179such a way to provide the maximum amount of benefit to our users. As such, we
180limit connections to our master rsync and distfile mirrors to public mirrors
181only. Users are welcome to use our regular mirror system to establish a
182private source mirror.
183</p>
184
185</body>
186</section>
187
188<section>
66<title>Q) How do I find the mirror nearest to me?</title> 189<title>Q: How do I find the mirror nearest to me?</title>
67<body>
68<p>A) mirrorselect was designed to do this for you. If you haven't already run <c>emerge mirrorselect</c> then do it.
69Then run: <c>mirrorselect</c>. An ncurses-based menu will display allowing you to select a mirror close to you.
70</p>
71</body> 190<body>
191
192<p>
193A: mirrorselect was designed to do this for you. If you haven't already run
194<c>emerge mirrorselect</c>, then please do so. Then run: <c>mirrorselect</c>.
195An ncurses-based menu will display allowing you to select a mirror close to
196you.
197</p>
198
199</body>
200</section>
72</section> 201<section>
202<title>Q: I don't have that much disk space. Can I mirror part of the sources?</title>
203<body>
204
205<p>
206A: Yes, if you are unable to mirror our full sources, you can elect to mirror
207the following two directories only:
208</p>
209
210<ul>
211 <li>/distfiles</li>
212 <li>/snapshots</li>
213</ul>
214
215<p>
216These two directories will require approximately 40GB of space and you will be
217listed on our site as a distfiles-only mirror.
218</p>
219
220</body>
221</section>
222<section>
223<title>Q: Do I have to turn on Directory Indexing for directories served up via HTTP?</title>
224<body>
225
226<p>
227A: Directory Indexing is required for the /releases and /experimental
228directories, but can be turned off for all other directories (including
229/distfiles) if you wish.
230</p>
231</body>
232</section>
233
234<section>
235<title>Q: Do I have to mirror historical? I mean, it is old releases.</title>
236<body>
237
238<p>
239A: Of course not, it is quite a bit of data. In your rsync command, add <path>--exclude=/releases/historical</path> to your rsync options.
240This will exclude historical and save you quite a bit of space.
241</p>
242</body>
243</section>
244
245
73</chapter> 246</chapter>
74</guide> 247</guide>

Legend:
Removed from v.1.2  
changed lines
  Added in v.1.24

  ViewVC Help
Powered by ViewVC 1.1.20