/[gentoo]/xml/htdocs/doc/en/source_mirrors.xml
Gentoo

Contents of /xml/htdocs/doc/en/source_mirrors.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.30 - (hide annotations) (download) (as text)
Mon Apr 3 09:54:43 2006 UTC (8 years, 4 months ago) by neysx
Branch: MAIN
Changes since 1.29: +13 -10 lines
File MIME type: application/xml
#128614 part II, bugs should filed under the "Mirrors" product

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

  ViewVC Help
Powered by ViewVC 1.1.20