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

Legend:
Removed from v.1.25  
changed lines
  Added in v.1.30

  ViewVC Help
Powered by ViewVC 1.1.20