/[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.24 - (hide annotations) (download) (as text)
Fri Jan 28 05:26:40 2005 UTC (9 years, 2 months ago) by jforman
Branch: MAIN
Changes since 1.23: +13 -1 lines
File MIME type: application/xml
added Q and A about excluding historical

1 klieber 1.1 <?xml version='1.0' encoding="UTF-8"?>
2 jforman 1.24 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/source_mirrors.xml,v 1.23 2005/01/11 21:04:40 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 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 neysx 1.23 <version>1.4</version>
26     <date>2005-01-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     </chapter>
77 neysx 1.19
78 klieber 1.1 <chapter>
79     <title>Implementation details</title>
80     <section>
81     <body>
82 neysx 1.19
83     <p>
84     For new source mirror requests, the procedure will be as follows:
85     </p>
86    
87     <p>
88 neysx 1.23 Set up your server to rsync with ftp.ussg.iu.edu::gentoo-distfiles. Once you
89     have a complete mirror of that server, please file a bug report on
90     bugs.gentoo.org under the "rsync" category stating that you have a new mirror
91     and wish it to be added to the list of official mirrors. Please specify
92     whether you wish to be a "Full" mirror or "Distfiles only" mirror. Distfiles
93     only mirrors will be designated as such on the website.
94 neysx 1.19 </p>
95    
96     <p>
97     Full mirrors must carry the following directories (plus any directories that
98     get added in the future):
99     </p>
100    
101 cshields 1.16 <ul>
102     <li>/releases</li>
103     <li>/experimental</li>
104     <li>/distfiles</li>
105     <li>/snapshots</li>
106     <li>/grp</li>
107     </ul>
108 neysx 1.19
109     <p>
110     Distfiles only mirrors need to carry the following directories:
111     </p>
112    
113 cshields 1.16 <ul>
114     <li>/distfiles</li>
115     <li>/snapshots</li>
116     </ul>
117    
118 neysx 1.19 <p>
119     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
121     correctly and in accordance with this policy.
122     </p>
123 klieber 1.1
124 neysx 1.19 <p>
125     If all steps went smoothly, we will then add you to our list of <uri
126 neysx 1.23 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
128     which is only available to official Gentoo Linux source mirrors.
129 neysx 1.19 </p>
130    
131     <p>
132     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
134     associated with source mirrors.
135     </p>
136 klieber 1.1
137     <note>
138 neysx 1.19 Thanks for helping out Gentoo Linux users and developers! :) For any mirror
139     administration issues or problems, please contact <mail
140     link="mirror-admin@gentoo.org">mirror-admin@gentoo.org</mail>.
141 klieber 1.1 </note>
142 neysx 1.19
143 jforman 1.21 <warn>
144     Do NOT email mirror-admin@gentoo.org for mirror requests, please file a bug. It makes mirror tracking easier on us.
145     </warn>
146    
147 klieber 1.1 </body>
148     </section>
149     </chapter>
150 neysx 1.19
151 klieber 1.1 <chapter>
152     <title>Short FAQ</title>
153     <section>
154     <title>Q: Who should I contact regarding new mirrors or to get my mirror added to the Gentoo web site?</title>
155     <body>
156 neysx 1.19
157     <p>
158     A: Please file a bug on bugs.gentoo.org under the rsync category.
159     </p>
160    
161 klieber 1.1 </body>
162     </section>
163     <section>
164     <title>Q: Who should I contact regarding mirror issues and maintenance?</title>
165     <body>
166 neysx 1.19
167     <p>
168     A: Please file a bug on bugs.gentoo.org under the rsync category.
169     </p>
170    
171 klieber 1.1 </body>
172     </section>
173 klieber 1.9 <section>
174     <title>Q: I run a private source mirror for my company. Can I still access the private master source mirror?</title>
175     <body>
176 neysx 1.19
177     <p>
178     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
180     limit connections to our master rsync and distfile mirrors to public mirrors
181     only. Users are welcome to use our regular mirror system to establish a
182     private source mirror.
183 klieber 1.9 </p>
184 neysx 1.19
185 klieber 1.9 </body>
186     </section>
187 klieber 1.1
188     <section>
189 klieber 1.9 <title>Q: How do I find the mirror nearest to me?</title>
190 klieber 1.1 <body>
191 neysx 1.19
192     <p>
193     A: mirrorselect was designed to do this for you. If you haven't already run
194     <c>emerge mirrorselect</c>, then please do so. Then run: <c>mirrorselect</c>.
195     An ncurses-based menu will display allowing you to select a mirror close to
196     you.
197 klieber 1.1 </p>
198 neysx 1.19
199 klieber 1.1 </body>
200     </section>
201 klieber 1.5 <section>
202 klieber 1.11 <title>Q: I don't have that much disk space. Can I mirror part of the sources?</title>
203     <body>
204 neysx 1.19
205     <p>
206     A: Yes, if you are unable to mirror our full sources, you can elect to mirror
207     the following two directories only:
208     </p>
209    
210 klieber 1.11 <ul>
211     <li>/distfiles</li>
212     <li>/snapshots</li>
213     </ul>
214 neysx 1.19
215     <p>
216 klieber 1.22 These two directories will require approximately 40GB of space and you will be
217 neysx 1.19 listed on our site as a distfiles-only mirror.
218     </p>
219    
220 klieber 1.5 </body>
221     </section>
222 klieber 1.8 <section>
223 swift 1.10 <title>Q: Do I have to turn on Directory Indexing for directories served up via HTTP?</title>
224 klieber 1.8 <body>
225 neysx 1.19
226     <p>
227     A: Directory Indexing is required for the /releases and /experimental
228     directories, but can be turned off for all other directories (including
229     /distfiles) if you wish.
230 klieber 1.8 </p>
231 jforman 1.24 </body>
232     </section>
233    
234     <section>
235     <title>Q: Do I have to mirror historical? I mean, it is old releases.</title>
236     <body>
237 neysx 1.19
238 jforman 1.24 <p>
239     A: Of course not, it is quite a bit of data. In your rsync command, add <path>--exclude=/releases/historical</path> to your rsync options.
240     This will exclude historical and save you quite a bit of space.
241     </p>
242 klieber 1.8 </body>
243     </section>
244 jforman 1.24
245    
246 klieber 1.1 </chapter>
247     </guide>

  ViewVC Help
Powered by ViewVC 1.1.20