/[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.27 Revision 1.33
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.27 2005/04/12 17:52:20 alin Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/source_mirrors.xml,v 1.33 2008/12/18 21:00:25 robbat2 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.6</version> 35<version>1.10</version>
26<date>2005-04-11</date> 36<date>2008-12-18</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 90 GB of disk space. Distfiles 58"Distfiles only" mirror. Full mirrors require 130 GB of disk space. Distfiles
49only mirrors require 40 GB of space. 59only mirrors require 80 GB of space.
50</p> 60</p>
51 61
52</body> 62</body>
53</section> 63</section>
54<section> 64<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>
74</body>
75</section>
76 84
85</body>
86</section>
77<section> 87<section>
78<title>Mirror Needs</title> 88<title>Mirror Needs</title>
79<body> 89<body>
80<p> 90
81Your mirror may not be added immediately to our listing and given access to the private distribution point. We add mirrors
82on an as-needed basis so as not to clutter up the listing, and to provide an adequate amount of high speed mirrors. You are more than
83welcome to peek in #gentoo-mirrors on irc.freenode.org and chat up to see the status of your mirror being added to our official network.
84</p> 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
85</body> 100</body>
86</section> 101</section>
87</chapter> 102</chapter>
88 103
89<chapter> 104<chapter>
94<p> 109<p>
95For new source mirror requests, the procedure will be as follows: 110For new source mirror requests, the procedure will be as follows:
96</p> 111</p>
97 112
98<p> 113<p>
99Set up your server to rsync with ftp.ussg.iu.edu::gentoo-distfiles. Once you 114Set up your server to rsync with ftp.ussg.iu.edu::gentoo-distfiles. Once you
100have a complete mirror of that server, please file a bug report on 115have a complete mirror of that server, please file a bug report on <uri
101bugs.gentoo.org under the "rsync" category stating that you have a new mirror 116link="http://bugs.gentoo.org/enter_bug.cgi?product=Mirrors">bugs.gentoo.org</uri>
117under the <c>Mirrors</c> category stating that you have a new mirror and wish
102and wish it to be added to the list of official mirrors. Please specify 118it to be added to the list of official mirrors. Please specify whether you
103whether you wish to be a "Full" mirror or "Distfiles only" mirror. Distfiles 119wish to be a "Full" mirror or "Distfiles only" mirror. Distfiles
104only mirrors will be designated as such on the website. 120only mirrors will be designated as such on the website.
105</p> 121</p>
106 122
107<p> 123<p>
108Full mirrors must carry the following directories (plus any directories that 124Full mirrors must carry the following directories (plus any directories that
109get added in the future): 125get added in the future):
110</p> 126</p>
111 127
112<ul> 128<ul>
113 <li>/releases</li> 129 <li>/releases (20G)</li>
114 <li>/experimental</li> 130 <li>/experimental (20-30G)</li>
115 <li>/distfiles</li> 131 <li>/distfiles (80G)</li>
116 <li>/snapshots</li> 132 <li>/snapshots (0.5G)</li>
117 <li>/grp</li> 133 <li>/grp</li>
118</ul> 134</ul>
119 135
120<p> 136<p>
121Distfiles only mirrors need to carry the following directories: 137Distfiles only mirrors need to carry the following directories:
122</p> 138</p>
123 139
124<ul> 140<ul>
125 <li>/distfiles</li> 141 <li>/distfiles (80G)</li>
126 <li>/snapshots</li> 142 <li>/snapshots (0.5G)</li>
127</ul> 143</ul>
128 144
129<p> 145<p>
130We will then verify that the mirror exists and we can connect to it properly. 146We will then verify that the mirror exists and we can connect to it properly.
131Then, in the next 48-72 hours, we will determine if your mirror is syncing 147Then, in the next 48-72 hours, we will determine if your mirror is syncing
135<p> 151<p>
136If all steps went smoothly, we will then add you to our list of <uri 152If all steps went smoothly, we will then add you to our list of <uri
137link="/main/en/mirrors.xml">download mirrors</uri> on the main web site. We 153link="/main/en/mirrors.xml">download mirrors</uri> on the main web site. We
138will also send you the login information for our private master distfile mirror 154will also send you the login information for our private master distfile mirror
139which is only available to official Gentoo Linux source mirrors. 155which is only available to official Gentoo Linux source mirrors.
140</p> 156</p>
141 157
142<p> 158<p>
143Additionally, you, the mirror admin, will be requested to subscribe to the 159Additionally, you, the mirror admin, will be requested to subscribe to the
144gentoo-mirrors mailing list (low traffic) so that you can follow all issues 160gentoo-mirrors mailing list (low traffic) so that you can follow all issues
145associated with source mirrors. 161associated with source mirrors.
150administration issues or problems, please contact <mail 166administration issues or problems, please contact <mail
151link="mirror-admin@gentoo.org">mirror-admin@gentoo.org</mail>. 167link="mirror-admin@gentoo.org">mirror-admin@gentoo.org</mail>.
152</note> 168</note>
153 169
154<warn> 170<warn>
155Do NOT email mirror-admin@gentoo.org for mirror requests, please file a bug. It makes mirror tracking easier on us. 171Do NOT email mirror-admin@gentoo.org for mirror requests, please file a bug. It
172makes mirror tracking easier on us.
156</warn> 173</warn>
157 174
158</body> 175</body>
159</section> 176</section>
160</chapter> 177</chapter>
161 178
162<chapter> 179<chapter>
163<title>Short FAQ</title> 180<title>Short FAQ</title>
164<section> 181<section>
182<title>
165<title>Q: Who should I contact regarding new mirrors or to get my mirror added to the Gentoo web site?</title> 183Q: Who should I contact regarding new mirrors or to get my mirror added to the
184Gentoo web site?
185</title>
166<body> 186<body>
167 187
168<p> 188<p>
169A: Please file a bug on bugs.gentoo.org under the rsync category. 189A: Please file a bug on bugs.gentoo.org under the <c>Mirrors</c> category.
170</p> 190</p>
171 191
172</body> 192</body>
173</section> 193</section>
174<section> 194<section>
175<title>Q: Who should I contact regarding mirror issues and maintenance?</title> 195<title>Q: Who should I contact regarding mirror issues and maintenance?</title>
176<body> 196<body>
177 197
178<p> 198<p>
179A: Please file a bug on bugs.gentoo.org under the rsync category. 199A: Please file a bug on bugs.gentoo.org under the <c>Mirrors</c> category.
180</p> 200</p>
181 201
182</body> 202</body>
183</section>
184<section> 203</section>
204<section>
205<title>
185<title>Q: I run a private source mirror for my company. Can I still access the private master source mirror?</title> 206Q: I run a private source mirror for my company. Can I still access the
207private master source mirror?
208</title>
186<body> 209<body>
187 210
188<p> 211<p>
189A: Because our resources are limited, we need to ensure we allocate them in 212A: Because our resources are limited, we need to ensure we allocate them in
190such a way to provide the maximum amount of benefit to our users. As such, we 213such a way to provide the maximum amount of benefit to our users. As such, we
193private source mirror. 216private source mirror.
194</p> 217</p>
195 218
196</body> 219</body>
197</section> 220</section>
198
199<section> 221<section>
200<title>Q: How do I find the mirror nearest to me?</title> 222<title>Q: How do I find the mirror nearest to me?</title>
201<body> 223<body>
202 224
203<p> 225<p>
208</p> 230</p>
209 231
210</body> 232</body>
211</section> 233</section>
212<section> 234<section>
235<title>
213<title>Q: I don't have that much disk space. Can I mirror part of the sources?</title> 236Q: I don't have that much disk space. Can I mirror part of the sources?
237</title>
214<body> 238<body>
215 239
216<p> 240<p>
217A: Yes, if you are unable to mirror our full sources, you can elect to mirror 241A: Yes, if you are unable to mirror our full sources, you can elect to mirror
218the following two directories only: 242the following two directories only:
219</p> 243</p>
220 244
221<ul> 245<ul>
222 <li>/distfiles</li> 246 <li>/distfiles</li>
223 <li>/snapshots</li> 247 <li>/snapshots</li>
224</ul> 248</ul>
225 249
226<p> 250<p>
227These two directories will require approximately 40GB of space and you will be 251These two directories will require approximately 50GB of space and you will be
228listed on our site as a distfiles-only mirror. 252listed on our site as a distfiles-only mirror.
229</p> 253</p>
230 254
231</body> 255</body>
232</section> 256</section>
233<section> 257<section>
258<title>
234<title>Q: Do I have to turn on Directory Indexing for directories served up via HTTP?</title> 259Q: Do I have to turn on Directory Indexing for directories served up via HTTP?
260</title>
235<body> 261<body>
236 262
237<p> 263<p>
238A: Directory Indexing is required for the /releases and /experimental 264A: Directory Indexing is required for the /releases and /experimental
239directories, but can be turned off for all other directories (including 265directories, but can be turned off for all other directories (including
240/distfiles) if you wish. 266/distfiles) if you wish.
241</p> 267</p>
268
242</body> 269</body>
243</section> 270</section>
244 271
245<section> 272<section>
246<title>Q: Do I have to mirror historical? I mean, it is old releases.</title> 273<title>Q: Do I have to mirror historical? I mean, it is old releases.</title>

Legend:
Removed from v.1.27  
changed lines
  Added in v.1.33

  ViewVC Help
Powered by ViewVC 1.1.20