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