/[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.28 - (hide annotations) (download) (as text)
Sun Jan 1 11:51:43 2006 UTC (8 years, 7 months ago) by neysx
Branch: MAIN
Changes since 1.27: +10 -10 lines
File MIME type: application/xml
Removed some tabs (blame rane) **No Content Change**

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

  ViewVC Help
Powered by ViewVC 1.1.20