files/mirror/README.mirroring

 __  __                  _
|  \/  | __ _  __ _  ___(_) __ _
| |\/| |/ _` |/ _` |/ _ \ |/ _` |
| |  | | (_| | (_| |  __/ | (_| |
|_|  |_|\__,_|\__, |\___|_|\__,_|
              |___/

This document describes the way to implement a Mageia Mirror.

1) Prerequisite
---------------

The expected size of the mirror is around 700GB.

You need rsync software to synchronise the tree.

2) Official source
------------------

For public mirror, we encourage you to use one of our Tier1 mirror.

Theses servers synchronises the tree directly from the Mageia rsync server.

    o rsync://distrib-coffee.ipsl.jussieu.fr/mageia/
      located in Paris (France)

3) Rsync options
----------------

Ensure you're using at least these options:

    -a -H

We appreciate if, in addition, you also add the options:

   --delete-after -S

Don't use the compression and checksum options, they create excessive
load on the remote server

4) Automated update procedure
-----------------------------

The tree must be synchronized at least every 2 hours.

Please ensure that another rsync process is not started while a first
one is still running. Use a lock file.

5) Registering your mirror
--------------------------

TODO
1	misc	872	__ __ _
2			\| \/ \| __ _ __ _ ___(_) __ _
3			\| \|\/\| \|/ _` \|/ _` \|/ _ \ \|/ _` \|
4			\| \| \| \| (_\| \| (_\| \| __/ \| (_\| \|
5			\|_\| \|_\|\__,_\|\__, \|\___\|_\|\__,_\|
6			\|___/
7
8	misc	1113	This document describes the way to implement a Mageia Mirror.
9	misc	872
10	misc	873	1) Prerequisite
11			---------------
12	misc	872
13	misc	1113	The expected size of the mirror is around 700GB.
14	misc	872
15	misc	1113	You need rsync software to synchronise the tree.
16	misc	872
17			2) Official source
18	misc	873	------------------
19	misc	872
20	misc	1113	For public mirror, we encourage you to use one of our Tier1 mirror.
21	misc	872
22	misc	1113	Theses servers synchronises the tree directly from the Mageia rsync server.
23	misc	872
24			o rsync://distrib-coffee.ipsl.jussieu.fr/mageia/
25			located in Paris (France)
26
27			3) Rsync options
28	misc	873	----------------
29	misc	872
30	misc	1113	Ensure you're using at least these options:
31	misc	872
32			-a -H
33
34	misc	1113	We appreciate if, in addition, you also add the options:
35	misc	872
36			--delete-after -S
37
38	misc	1113	Don't use the compression and checksum options, they create excessive
39			load on the remote server
40	misc	872
41	misc	1113	4) Automated update procedure
42			-----------------------------
43	misc	872
44	misc	873	The tree must be synchronized at least every 2 hours.
45	misc	872
46	misc	1113	Please ensure that another rsync process is not started while a first
47			one is still running. Use a lock file.
48	misc	872
49			5) Registering your mirror
50	misc	873	--------------------------
51	misc	872
52			TODO