/[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.29 - (hide annotations) (download) (as text)
Mon Apr 3 09:50:37 2006 UTC (8 years, 3 months ago) by neysx
Branch: MAIN
Changes since 1.28: +33 -15 lines
File MIME type: application/xml
#128614 part I, fixed coding style, *no content change*

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

  ViewVC Help
Powered by ViewVC 1.1.20