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