/[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.21 - (show annotations) (download) (as text)
Tue Oct 26 14:04:53 2004 UTC (9 years, 9 months ago) by jforman
Branch: MAIN
Changes since 1.20: +5 -1 lines
File MIME type: application/xml
added warning about emailing mirror-admin

1 <?xml version='1.0' encoding="UTF-8"?>
2 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/source_mirrors.xml,v 1.20 2004/10/22 14:39:36 jforman Exp $ -->
3 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4
5 <guide link="/doc/en/source_mirrors.xml">
6 <title>Gentoo Linux Source Mirrors Policy</title>
7 <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
20 <abstract>
21 This document explains the requirements for source mirrors.
22 </abstract>
23
24 <license/>
25 <version>1.3</version>
26 <date>June 28, 2004</date>
27
28 <chapter>
29 <title>Requirements</title>
30 <section>
31 <title>Minimum Bandwidth</title>
32 <body>
33
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 </body>
41 </section>
42 <section>
43 <title>Minimum Disk Space</title>
44 <body>
45
46 <p>
47 The space requirements depend on whether you choose to run a "Full" mirror or a
48 "Distfiles only" mirror. Full mirrors require 60 gigabytes of disk space.
49 Distfiles only mirrors require 30 gigabytes of space.
50 </p>
51
52 </body>
53 </section>
54 <section>
55 <title>Minimum User Count</title>
56 <body>
57
58 <p>
59 We ask that you support a minimum of 15 and preferrably 30 concurrent user
60 connections.
61 </p>
62
63 </body>
64 </section>
65 <section>
66 <title>Update Frequency</title>
67 <body>
68
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 </body>
75 </section>
76 </chapter>
77
78 <chapter>
79 <title>Implementation details</title>
80 <section>
81 <body>
82
83 <p>
84 For new source mirror requests, the procedure will be as follows:
85 </p>
86
87 <p>
88 Set up your server to rsync with ftp.ussg.iu.edu::gentoo-distfiles. Once you have a
89 complete mirror of that server, please file a bug report on bugs.gentoo.org
90 under the "rsync" category stating that you have a new mirror and wish it to be
91 added to the list of official mirrors. Please specify whether you wish to be a
92 "Full" mirror or "Distfiles only" mirror. Distfiles only mirrors will be
93 designated as such on the website.
94 </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 <ul>
102 <li>/releases</li>
103 <li>/experimental</li>
104 <li>/distfiles</li>
105 <li>/snapshots</li>
106 <li>/grp</li>
107 </ul>
108
109 <p>
110 Distfiles only mirrors need to carry the following directories:
111 </p>
112
113 <ul>
114 <li>/distfiles</li>
115 <li>/snapshots</li>
116 </ul>
117
118 <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
124 <p>
125 If all steps went smoothly, we will then add you to our list of <uri
126 link="http://www.gentoo.org/main/en/mirrors.xml">download mirrors</uri> on the
127 main web site. We will also send you the login information for our private
128 master distfile mirror which is only available to official Gentoo Linux source
129 mirrors.
130 </p>
131
132 <p>
133 Additionally, you, the mirror admin, will be requested to subscribe to the
134 gentoo-mirrors mailing list (low traffic) so that you can follow all issues
135 associated with source mirrors.
136 </p>
137
138 <note>
139 Thanks for helping out Gentoo Linux users and developers! :) For any mirror
140 administration issues or problems, please contact <mail
141 link="mirror-admin@gentoo.org">mirror-admin@gentoo.org</mail>.
142 </note>
143
144 <warn>
145 Do NOT email mirror-admin@gentoo.org for mirror requests, please file a bug. It makes mirror tracking easier on us.
146 </warn>
147
148 </body>
149 </section>
150 </chapter>
151
152 <chapter>
153 <title>Short FAQ</title>
154 <section>
155 <title>Q: Who should I contact regarding new mirrors or to get my mirror added to the Gentoo web site?</title>
156 <body>
157
158 <p>
159 A: Please file a bug on bugs.gentoo.org under the rsync category.
160 </p>
161
162 </body>
163 </section>
164 <section>
165 <title>Q: Who should I contact regarding mirror issues and maintenance?</title>
166 <body>
167
168 <p>
169 A: Please file a bug on bugs.gentoo.org under the rsync category.
170 </p>
171
172 </body>
173 </section>
174 <section>
175 <title>Q: I run a private source mirror for my company. Can I still access the private master source mirror?</title>
176 <body>
177
178 <p>
179 A: Because our resources are limited, we need to ensure we allocate them in
180 such a way to provide the maximum amount of benefit to our users. As such, we
181 limit connections to our master rsync and distfile mirrors to public mirrors
182 only. Users are welcome to use our regular mirror system to establish a
183 private source mirror.
184 </p>
185
186 </body>
187 </section>
188
189 <section>
190 <title>Q: How do I find the mirror nearest to me?</title>
191 <body>
192
193 <p>
194 A: mirrorselect was designed to do this for you. If you haven't already run
195 <c>emerge mirrorselect</c>, then please do so. Then run: <c>mirrorselect</c>.
196 An ncurses-based menu will display allowing you to select a mirror close to
197 you.
198 </p>
199
200 </body>
201 </section>
202 <section>
203 <title>Q: I don't have that much disk space. Can I mirror part of the sources?</title>
204 <body>
205
206 <p>
207 A: Yes, if you are unable to mirror our full sources, you can elect to mirror
208 the following two directories only:
209 </p>
210
211 <ul>
212 <li>/distfiles</li>
213 <li>/snapshots</li>
214 </ul>
215
216 <p>
217 These two directories will require approximately 30GB of space and you will be
218 listed on our site as a distfiles-only mirror.
219 </p>
220
221 </body>
222 </section>
223 <section>
224 <title>Q: Do I have to turn on Directory Indexing for directories served up via HTTP?</title>
225 <body>
226
227 <p>
228 A: Directory Indexing is required for the /releases and /experimental
229 directories, but can be turned off for all other directories (including
230 /distfiles) if you wish.
231 </p>
232
233 </body>
234 </section>
235 </chapter>
236 </guide>

  ViewVC Help
Powered by ViewVC 1.1.20