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

Legend:
Removed from v.1.20  
changed lines
  Added in v.1.38

  ViewVC Help
Powered by ViewVC 1.1.20