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