/[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.1 Revision 1.14
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.14 2003/11/15 00:35:19 neysx Exp $ -->
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3 4
4<guide link="/doc/en/rsync.xml"> 5<guide link="/doc/en/source_mirrors.xml">
5<title>Gentoo Linux Source Mirrors Policy</title> 6<title>Gentoo Linux Source Mirrors Policy</title>
6<author title="Author"><mail link="klieber@gentoo.org">Kurt Lieber</mail></author> 7<author title="Author"><mail link="klieber@gentoo.org">Kurt Lieber</mail></author>
7 8
8<version>1.1</version> 9<version>1.1</version>
9<date>17 Feb 2003</date> 10<date>17 Feb 2003</date>
10 11
12<license/>
13
11<chapter> 14<chapter>
12<title>Requirements</title> 15<title>Requirements</title>
13<section> 16<section>
14<title>Minimum Bandwidth</title> 17<title>Minimum Bandwidth</title>
15<body> 18<body>
16<p> To properly host a source mirror you should have a minimum of T1 bandwidth. 19<p> To properly host a source mirror you should have a minimum of 5Mbps upstream bandwidth.
17ADSL and cable connections do not generally make adequate connections for rsync hosts due to their limited upstream performance.</p> 20ADSL and cable connections do not generally make adequate connections for distfile hosts due to their limited upstream performance.</p>
18</body> 21</body>
19</section> 22</section>
20<section> 23<section>
21<title>Minimum User Count</title> 24<title>Minimum User Count</title>
22<body> 25<body>
23<p>We ask that you support a minimum of 5 and preferrably 10 concurrent user connections.</p> 26<p>We ask that you support a minimum of 15 and preferrably 30 concurrent user connections.</p>
24</body> 27</body>
25</section> 28</section>
26<section> 29<section>
27<title>Update Frequency</title> 30<title>Update Frequency</title>
28<body> 31<body>
29<p>We ask that source mirrors be updated at least 3-4 times throughout the day. At a minimum, source mirrors should be updated once per day.</p> 32<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>
30</body> 33</body>
31</section> 34</section>
32</chapter> 35</chapter>
33<chapter> 36<chapter>
34<title>Implementation details</title> 37<title>Implementation details</title>
35<section> 38<section>
36<body> 39<body>
37<p>for new source mirror requests, the procedure will be as follows:</p> 40<p>for new source mirror requests, the procedure will be as follows:</p>
38<p>Someone asks to be a mirror, then we verify that the mirror exists and we can connect to it properly. Then we will contact you and enable your server to connect to <path>rsync1.us.gentoo.org</path>, the master rsync mirror. Then, in the next 48-72 hours we will determine if your mirror is syncing correctly with <path>rsync1.us.gentoo.org</path> and accordingly with this policy.</p> 41<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.</p>
42<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>
39 43
40<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.</p> 44<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>
41 45
42<p>Additionally, you, the mirror admin will be added to the gentoo-mirrors mailing list (low traffic) so that you can folllow all issues associated with source mirrors. 46<p>Additionally, you, the mirror admin will be added to the gentoo-mirrors mailing list (low traffic) so that you can follow all issues associated with source mirrors.
43</p> 47</p>
44<note> 48<note>
45Thanks 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>. 49Thanks 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>.
46</note> 50</note>
47</body> 51</body>
50<chapter> 54<chapter>
51<title>Short FAQ</title> 55<title>Short FAQ</title>
52<section> 56<section>
53<title>Q: Who should I contact regarding new mirrors or to get my mirror added to the Gentoo web site?</title> 57<title>Q: Who should I contact regarding new mirrors or to get my mirror added to the Gentoo web site?</title>
54<body> 58<body>
55<p>A: <mail link="klieber@gentoo.org">klieber@gentoo.org</mail></p> 59<p>A: Please file a bug on bugs.gentoo.org under the rsync category.</p>
56</body> 60</body>
57</section> 61</section>
58<section> 62<section>
59<title>Q: Who should I contact regarding mirror issues and maintenance?</title> 63<title>Q: Who should I contact regarding mirror issues and maintenance?</title>
60<body> 64<body>
61<p>A: <mail link="mirror-admin@gentoo.org">mirror-admin@gentoo.org</mail></p> 65<p>A: Please file a bug on bugs.gentoo.org under the rsync category.</p>
66</body>
67</section>
68<section>
69<title>Q: I run a private source mirror for my company. Can I still access the private master source mirror?</title>
70<body>
71<p>A: Because our resources are limited, we need to ensure we allocate them in such a way
72to provide the maximum amount of benefit to our users. As such, we limit connections
73to 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.
74</p>
62</body> 75</body>
63</section> 76</section>
64 77
65<section> 78<section>
66<title>Q) How do I find the mirror nearest to me?</title> 79<title>Q: How do I find the mirror nearest to me?</title>
67<body> 80<body>
68<p>A) mirrorselect was designed to do this for you. If you haven't already run <c>emerge mirrorselect</c> then do it. 81<p>A: mirrorselect was designed to do this for you. If you haven't already run <c>emerge mirrorselect</c> then do it.
69Then run: <c>mirrorselect</c>. An ncurses-based menu will display allowing you to select a mirror close to you. 82Then run: <c>mirrorselect</c>. An ncurses-based menu will display allowing you to select a mirror close to you.
83</p>
84</body>
85</section>
86<section>
87<title>Q: How much space does a full source mirror require?</title>
88<body>
89<p>A: At the moment, a full mirror requires between 30GB and 40GB of disk space and comprises the following four directories.
90</p>
91<ul>
92 <li>/release</li>
93 <li>/experimental</li>
94 <li>/distfiles</li>
95 <li>/snapshots</li>
96</ul>
97<p>In order to be a full Gentoo Linux source mirror, we ask that you mirror all four of these directories in their entirety.</p>
98</body>
99</section>
100<section>
101<title>Q: I don't have that much disk space. Can I mirror part of the sources?</title>
102<body>
103<p>A: Yes, if you are unable to mirror our full sources, you can elect to mirror the following two directories only:</p>
104<ul>
105 <li>/distfiles</li>
106 <li>/snapshots</li>
107</ul>
108<p>These two directories will require approximately 20GB of space and you will be listed on our site as a distfiles-only mirror.</p>
109</body>
110</section>
111<section>
112<title>Q: Do I have to turn on Directory Indexing for directories served up via HTTP?</title>
113<body>
114<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.
70</p> 115</p>
71</body> 116</body>
72</section> 117</section>
73</chapter> 118</chapter>
74</guide> 119</guide>

Legend:
Removed from v.1.1  
changed lines
  Added in v.1.14

  ViewVC Help
Powered by ViewVC 1.1.20