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

Legend:
Removed from v.1.17  
changed lines
  Added in v.1.29

  ViewVC Help
Powered by ViewVC 1.1.20