| … | |
… | |
| 6 | <author title="Author"><mail link="klieber@gentoo.org">Kurt Lieber</mail></author> |
6 | <author title="Author"><mail link="klieber@gentoo.org">Kurt Lieber</mail></author> |
| 7 | |
7 | |
| 8 | <version>1.1</version> |
8 | <version>1.1</version> |
| 9 | <date>17 Feb 2003</date> |
9 | <date>17 Feb 2003</date> |
| 10 | |
10 | |
|
|
11 | <license/> |
|
|
12 | |
| 11 | <chapter> |
13 | <chapter> |
| 12 | <title>Requirements</title> |
14 | <title>Requirements</title> |
| 13 | <section> |
15 | <section> |
| 14 | <title>Minimum Bandwidth</title> |
16 | <title>Minimum Bandwidth</title> |
| 15 | <body> |
17 | <body> |
| 16 | <p> To properly host a source mirror you should have a minimum of 2Mbps upstream bandwidth. |
18 | <p> To properly host a source mirror you should have a minimum of 5Mbps upstream bandwidth. |
| 17 | ADSL and cable connections do not generally make adequate connections for distfile hosts due to their limited upstream performance.</p> |
19 | ADSL and cable connections do not generally make adequate connections for distfile hosts due to their limited upstream performance.</p> |
| 18 | </body> |
20 | </body> |
| 19 | </section> |
21 | </section> |
| 20 | <section> |
22 | <section> |
| 21 | <title>Minimum User Count</title> |
23 | <title>Minimum User Count</title> |
| 22 | <body> |
24 | <body> |
| 23 | <p>We ask that you support a minimum of 5 and preferrably 10 concurrent user connections.</p> |
25 | <p>We ask that you support a minimum of 15 and preferrably 30 concurrent user connections.</p> |
| 24 | </body> |
26 | </body> |
| 25 | </section> |
27 | </section> |
| 26 | <section> |
28 | <section> |
| 27 | <title>Update Frequency</title> |
29 | <title>Update Frequency</title> |
| 28 | <body> |
30 | <body> |
| 29 | <p>All mirrors must be synchronized every four hours, starting at midnight, UTC.</p> |
31 | <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> |
32 | </body> |
| 31 | </section> |
33 | </section> |
| 32 | </chapter> |
34 | </chapter> |
| 33 | <chapter> |
35 | <chapter> |
| 34 | <title>Implementation details</title> |
36 | <title>Implementation details</title> |
| … | |
… | |
| 38 | <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> |
40 | <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> |
| 39 | <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> |
41 | <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> |
| 40 | |
42 | |
| 41 | <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> |
43 | <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> |
| 42 | |
44 | |
| 43 | <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. |
45 | <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. |
| 44 | </p> |
46 | </p> |
| 45 | <note> |
47 | <note> |
| 46 | Thanks 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>. |
48 | Thanks 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>. |
| 47 | </note> |
49 | </note> |
| 48 | </body> |
50 | </body> |
| … | |
… | |
| 60 | <title>Q: Who should I contact regarding mirror issues and maintenance?</title> |
62 | <title>Q: Who should I contact regarding mirror issues and maintenance?</title> |
| 61 | <body> |
63 | <body> |
| 62 | <p>A: Please file a bug on bugs.gentoo.org under the rsync category.</p> |
64 | <p>A: Please file a bug on bugs.gentoo.org under the rsync category.</p> |
| 63 | </body> |
65 | </body> |
| 64 | </section> |
66 | </section> |
|
|
67 | <section> |
|
|
68 | <title>Q: I run a private source mirror for my company. Can I still access the private master source mirror?</title> |
|
|
69 | <body> |
|
|
70 | <p>A: Because our resources are limited, we need to ensure we allocate them in such a way |
|
|
71 | to provide the maximum amount of benefit to our users. As such, we limit connections |
|
|
72 | to 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. |
|
|
73 | </p> |
|
|
74 | </body> |
|
|
75 | </section> |
| 65 | |
76 | |
| 66 | <section> |
77 | <section> |
| 67 | <title>Q) How do I find the mirror nearest to me?</title> |
78 | <title>Q: How do I find the mirror nearest to me?</title> |
| 68 | <body> |
79 | <body> |
| 69 | <p>A) mirrorselect was designed to do this for you. If you haven't already run <c>emerge mirrorselect</c> then do it. |
80 | <p>A: mirrorselect was designed to do this for you. If you haven't already run <c>emerge mirrorselect</c> then do it. |
| 70 | Then run: <c>mirrorselect</c>. An ncurses-based menu will display allowing you to select a mirror close to you. |
81 | Then run: <c>mirrorselect</c>. An ncurses-based menu will display allowing you to select a mirror close to you. |
| 71 | </p> |
82 | </p> |
| 72 | </body> |
83 | </body> |
| 73 | </section> |
84 | </section> |
| 74 | <section> |
85 | <section> |
| 75 | <title>Q) How much space does a full source mirror require?</title> |
86 | <title>Q: How much space does a full source mirror require?</title> |
| 76 | <body> |
87 | <body> |
| 77 | <p>A) At the moment, a full mirror requires between 30GB and 40GB of disk space. |
88 | <p>A: At the moment, a full mirror requires between 30GB and 40GB of disk space and comprises the following four directories. |
|
|
89 | </p> |
|
|
90 | <ul> |
|
|
91 | <li>/release</li> |
|
|
92 | <li>/experimental</li> |
|
|
93 | <li>/distfiles</li> |
|
|
94 | <li>/snapshots</li> |
|
|
95 | </ul> |
|
|
96 | <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> |
|
|
97 | </body> |
|
|
98 | </section> |
|
|
99 | <section> |
|
|
100 | <title>Q: I don't have that much disk space. Can I mirror part of the sources?</title> |
|
|
101 | <body> |
|
|
102 | <p>A: Yes, if you are unable to mirror our full sources, you can elect to mirror the following two directories only:</p> |
|
|
103 | <ul> |
|
|
104 | <li>/distfiles</li> |
|
|
105 | <li>/snapshots</li> |
|
|
106 | </ul> |
|
|
107 | <p>These two directories will require approximately 20GB of space and you will be listed on our site as a distfiles-only mirror.</p> |
|
|
108 | </body> |
|
|
109 | </section> |
|
|
110 | <section> |
|
|
111 | <title>Q: Do I have to turn on Directory Indexing for directories served up via HTTP?</title> |
|
|
112 | <body> |
|
|
113 | <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. |
| 78 | </p> |
114 | </p> |
| 79 | </body> |
115 | </body> |
| 80 | </section> |
116 | </section> |
| 81 | </chapter> |
117 | </chapter> |
| 82 | </guide> |
118 | </guide> |