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

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

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.18 Revision 1.19
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version='1.0' encoding="UTF-8"?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/source_mirrors.xml,v 1.18 2004/06/28 23:31:25 jforman Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/source_mirrors.xml,v 1.19 2004/06/29 09:54:45 neysx Exp $ -->
3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4 4
5<guide link="/doc/en/source_mirrors.xml"> 5<guide link="/doc/en/source_mirrors.xml">
6<title>Gentoo Linux Source Mirrors Policy</title> 6<title>Gentoo Linux Source Mirrors Policy</title>
7<author title="Author"><mail link="klieber@gentoo.org">Kurt Lieber</mail></author> 7<author title="Author">
8 <mail link="klieber@gentoo.org">Kurt Lieber</mail>
9</author>
10<author title="Editor">
8<author title="Editor"><mail link="cshields@gentoo.org">Corey Shields</mail></author> 11 <mail link="cshields@gentoo.org">Corey Shields</mail>
12</author>
13<author title="Editor">
9<author title="Editor"> <mail link="bennyc@gentoo.org">Benny Chuang</mail></author> 14 <mail link="bennyc@gentoo.org">Benny Chuang</mail>
15</author>
16<author title="Editor">
10<author title="Editor"> <mail link="jforman@gentoo.org">Jeffrey Forman</mail></author> 17 <mail link="jforman@gentoo.org">Jeffrey Forman</mail>
18</author>
11 19
12<abstract> 20<abstract>
13This document explains the requirements for source mirrors. 21This document explains the requirements for source mirrors.
14</abstract> 22</abstract>
23
15<license/> 24<license/>
16<version>1.2</version> 25<version>1.3</version>
17<date>8 Mar 2004</date> 26<date>June 28, 2004</date>
18
19 27
20<chapter> 28<chapter>
21<title>Requirements</title> 29<title>Requirements</title>
22<section> 30<section>
23<title>Minimum Bandwidth</title> 31<title>Minimum Bandwidth</title>
24<body> 32<body>
33
34<p>
25<p> To properly host a source mirror, you should have a minimum of 5Mbps upstream bandwidth. 35To properly host a source mirror, you should have a minimum of 5Mbps upstream
26ADSL and cable connections do not generally make adequate connections for distfile hosts due to their limited upstream performance.</p> 36bandwidth. ADSL and cable connections do not generally make adequate
37connections for distfile hosts due to their limited upstream performance.
38</p>
39
27</body> 40</body>
28</section> 41</section>
29<section> 42<section>
30<title>Minimum Disk Space</title> 43<title>Minimum Disk Space</title>
31<body> 44<body>
32<p> The space requirements depend on whether you choose to run a "Full" mirror or a "Distfiles only" mirror. Full mirrors require 60 gigabytes of disk space. Distfiles only mirrors require 30 gigabytes of space.</p> 45
46<p>
47The 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.
49Distfiles only mirrors require 30 gigabytes of space.
50</p>
51
33</body> 52</body>
34</section> 53</section>
35<section> 54<section>
36<title>Minimum User Count</title> 55<title>Minimum User Count</title>
37<body> 56<body>
57
58<p>
38<p>We ask that you support a minimum of 15 and preferrably 30 concurrent user connections.</p> 59We ask that you support a minimum of 15 and preferrably 30 concurrent user
60connections.
61</p>
62
39</body> 63</body>
40</section> 64</section>
41<section> 65<section>
42<title>Update Frequency</title> 66<title>Update Frequency</title>
43<body> 67<body>
44<p>All mirrors must be synchronized every four hours, starting at midnight in your local time zone. This helps distribute the load out over a period of time, rather than having all mirrors synchronize at the same time.</p> 68
69<p>
70All mirrors must be synchronized every four hours, starting at midnight in your
71local time zone. This helps distribute the load out over a period of time,
72rather than having all mirrors synchronize at the same time.
73</p>
45</body> 74</body>
46</section> 75</section>
47</chapter> 76</chapter>
77
48<chapter> 78<chapter>
49<title>Implementation details</title> 79<title>Implementation details</title>
50<section> 80<section>
51<body> 81<body>
82
83<p>
52<p>For new source mirror requests, the procedure will be as follows:</p> 84For new source mirror requests, the procedure will be as follows:
53<p>Set up your server to rsync with www.ibiblio.org::gentoo. Once you have a complete mirror of that server, please file a bug report on bugs.gentoo.org under the "rsync" category stating that you have a new mirror and wish it to be added to the list of official mirrors. Please specify whether you wish to be a "Full" mirror or "Distfiles only" mirror. Distfiles only mirrors will be designated as such on the website.</p> 85</p>
86
87<p>
88Set up your server to rsync with www.ibiblio.org::gentoo. Once you have a
89complete mirror of that server, please file a bug report on bugs.gentoo.org
90under the "rsync" category stating that you have a new mirror and wish it to be
91added 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
93designated as such on the website.
94</p>
95
96<p>
54<p>Full mirrors must carry the following directories (plus any directories that get added in the future):</p> 97Full mirrors must carry the following directories (plus any directories that
98get added in the future):
99</p>
100
55<ul> 101<ul>
56 <li>/releases</li> 102 <li>/releases</li>
57 <li>/experimental</li> 103 <li>/experimental</li>
58 <li>/distfiles</li> 104 <li>/distfiles</li>
59 <li>/snapshots</li> 105 <li>/snapshots</li>
60 <li>/grp</li> 106 <li>/grp</li>
61</ul> 107</ul>
108
109<p>
62<p>Distfiles only mirrors need to carry the following directories:</p> 110Distfiles only mirrors need to carry the following directories:
111</p>
112
63<ul> 113<ul>
64 <li>/distfiles</li> 114 <li>/distfiles</li>
65 <li>/snapshots</li> 115 <li>/snapshots</li>
66</ul> 116</ul>
67 117
68<p>We will then verify that the mirror exists and we can connect to it properly. Then, in the next 48-72 hours, we will determine if your mirror is syncing correctly and in accordance with this policy.</p> 118<p>
119We will then verify that the mirror exists and we can connect to it properly.
120Then, in the next 48-72 hours, we will determine if your mirror is syncing
121correctly and in accordance with this policy.
122</p>
69 123
70<p>If all steps went smoothly, we will then add you to our list of <uri link="http://www.gentoo.org/main/en/mirrors.xml">download mirrors</uri> on the main web site. We will also send you the login information for our private master distfile mirror which is only available to official Gentoo Linux source mirrors.</p> 124<p>
71 125If all steps went smoothly, we will then add you to our list of <uri
72<p>Additionally, you, the mirror admin, will be requested to subscribe to the gentoo-mirrors mailing list (low traffic) so that you can follow all issues associated with source mirrors. 126link="http://www.gentoo.org/main/en/mirrors.xml">download mirrors</uri> on the
127main web site. We will also send you the login information for our private
128master distfile mirror which is only available to official Gentoo Linux source
129mirrors.
73</p> 130</p>
131
132<p>
133Additionally, you, the mirror admin, will be requested to subscribe to the
134gentoo-mirrors mailing list (low traffic) so that you can follow all issues
135associated with source mirrors.
136</p>
137
74<note> 138<note>
75Thanks for helping out Gentoo Linux users and developers! :) For any mirror administration issues or problems, please contact <mail link="mirror-admin@gentoo.org">mirror-admin@gentoo.org</mail>. 139Thanks for helping out Gentoo Linux users and developers! :) For any mirror
140administration issues or problems, please contact <mail
141link="mirror-admin@gentoo.org">mirror-admin@gentoo.org</mail>.
76</note> 142</note>
143
77</body> 144</body>
78</section> 145</section>
79</chapter> 146</chapter>
147
80<chapter> 148<chapter>
81<title>Short FAQ</title> 149<title>Short FAQ</title>
82<section> 150<section>
83<title>Q: Who should I contact regarding new mirrors or to get my mirror added to the Gentoo web site?</title> 151<title>Q: Who should I contact regarding new mirrors or to get my mirror added to the Gentoo web site?</title>
84<body> 152<body>
153
154<p>
85<p>A: Please file a bug on bugs.gentoo.org under the rsync category.</p> 155A: Please file a bug on bugs.gentoo.org under the rsync category.
156</p>
157
86</body> 158</body>
87</section> 159</section>
88<section> 160<section>
89<title>Q: Who should I contact regarding mirror issues and maintenance?</title> 161<title>Q: Who should I contact regarding mirror issues and maintenance?</title>
90<body> 162<body>
163
164<p>
91<p>A: Please file a bug on bugs.gentoo.org under the rsync category.</p> 165A: Please file a bug on bugs.gentoo.org under the rsync category.
166</p>
167
92</body> 168</body>
93</section> 169</section>
94<section> 170<section>
95<title>Q: I run a private source mirror for my company. Can I still access the private master source mirror?</title> 171<title>Q: I run a private source mirror for my company. Can I still access the private master source mirror?</title>
96<body> 172<body>
173
174<p>
97<p>A: Because our resources are limited, we need to ensure we allocate them in such a way 175A: Because our resources are limited, we need to ensure we allocate them in
98to provide the maximum amount of benefit to our users. As such, we limit connections 176such a way to provide the maximum amount of benefit to our users. As such, we
99to our master rsync and distfile mirrors to public mirrors only. Users are welcome to use our regular mirror system to establish a private source mirror. 177limit connections to our master rsync and distfile mirrors to public mirrors
178only. Users are welcome to use our regular mirror system to establish a
179private source mirror.
100</p> 180</p>
181
101</body> 182</body>
102</section> 183</section>
103 184
104<section> 185<section>
105<title>Q: How do I find the mirror nearest to me?</title> 186<title>Q: How do I find the mirror nearest to me?</title>
106<body> 187<body>
107<p>A: mirrorselect was designed to do this for you. If you haven't already run <c>emerge mirrorselect</c>, then please do so. 188
108Then run: <c>mirrorselect</c>. An ncurses-based menu will display allowing you to select a mirror close to you.
109</p> 189<p>
190A: mirrorselect was designed to do this for you. If you haven't already run
191<c>emerge mirrorselect</c>, then please do so. Then run: <c>mirrorselect</c>.
192An ncurses-based menu will display allowing you to select a mirror close to
193you.
194</p>
195
110</body> 196</body>
111</section> 197</section>
112<section> 198<section>
113<title>Q: I don't have that much disk space. Can I mirror part of the sources?</title> 199<title>Q: I don't have that much disk space. Can I mirror part of the sources?</title>
114<body> 200<body>
201
202<p>
115<p>A: Yes, if you are unable to mirror our full sources, you can elect to mirror the following two directories only:</p> 203A: Yes, if you are unable to mirror our full sources, you can elect to mirror
204the following two directories only:
205</p>
206
116<ul> 207<ul>
117 <li>/distfiles</li> 208 <li>/distfiles</li>
118 <li>/snapshots</li> 209 <li>/snapshots</li>
119</ul> 210</ul>
120<p>These two directories will require approximately 30GB of space and you will be listed on our site as a distfiles-only mirror.</p> 211
212<p>
213These two directories will require approximately 30GB of space and you will be
214listed on our site as a distfiles-only mirror.
215</p>
216
121</body> 217</body>
122</section> 218</section>
123<section> 219<section>
124<title>Q: Do I have to turn on Directory Indexing for directories served up via HTTP?</title> 220<title>Q: Do I have to turn on Directory Indexing for directories served up via HTTP?</title>
125<body> 221<body>
126<p>A: Directory Indexing is required for the /releases and /experimental directories, but can be turned off for all other directories (including /distfiles) if you wish. 222
127</p> 223<p>
224A: Directory Indexing is required for the /releases and /experimental
225directories, but can be turned off for all other directories (including
226/distfiles) if you wish.
227</p>
228
128</body> 229</body>
129</section> 230</section>
130</chapter> 231</chapter>
131</guide> 232</guide>
Legend:
Removed from v.1.18  
changed lines
  Added in v.1.19
  ViewVC Help
Powered by ViewVC 1.1.20