aboutsummaryrefslogtreecommitdiffstats
path: root/deployment/main_mirror/files/mirror/mirror.readme
diff options
context:
space:
mode:
Diffstat (limited to 'deployment/main_mirror/files/mirror/mirror.readme')
-rw-r--r--deployment/main_mirror/files/mirror/mirror.readme79
1 files changed, 79 insertions, 0 deletions
diff --git a/deployment/main_mirror/files/mirror/mirror.readme b/deployment/main_mirror/files/mirror/mirror.readme
new file mode 100644
index 00000000..5846d12e
--- /dev/null
+++ b/deployment/main_mirror/files/mirror/mirror.readme
@@ -0,0 +1,79 @@
+ __ __ _
+| \/ | __ _ __ _ ___(_) __ _
+| |\/| |/ _` |/ _` |/ _ \ |/ _` |
+| | | | (_| | (_| | __/ | (_| |
+|_| |_|\__,_|\__, |\___|_|\__,_|
+ |___/
+
+This document describes the way to implement a Mageia Mirror.
+
+1) Prerequisite
+---------------
+
+The expected size of the mirror is around 1.8-2TB.
+The mirror only contains the last 2 stable releases + the development
+branch called cauldron.
+
+For older unsupported releases, you can find them at the archive
+provided by distrib-coffee mirror:
+https://distrib-coffee.ipsl.jussieu.fr/pub/linux/Mageia-archive/
+
+Look here to see the (planned) end of support date for each version:
+https://www.mageia.org/en/support/#lifecycle
+
+You need rsync software to synchronise the tree.
+
+2) Official source
+------------------
+
+For a public mirror, we encourage you to use one of our Tier1 mirrors.
+
+The servers below synchronise the tree directly from the Mageia rsync server.
+
+ Check https://mirrors.mageia.org/ for their bandwidths.
+ Check https://mirrors.mageia.org/status for their current statuses.
+
+ o rsync://mageia.c3sl.ufpr.br/mageia/
+ located in Curitiba (Brasil)
+ o rsync://mirrors.kernel.org/mirrors/mageia/
+ located in USA and Europe
+ o rsync://mirror.accum.se/mirror/mageia/
+ located in Umea (Sweden)
+ o rsync://mirror.math.princeton.edu/pub/mageia/
+ located in Princeton (USA)
+
+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.
+Tier 1 mirrors should preferably sync at least every hour.
+
+Please ensure that another rsync process is not started while a first
+one is still running. Use a lock file.
+
+5) Registering your mirror
+--------------------------
+
+Go to https://mirrors.mageia.org/new and enter all possible protocols.
+
+6) Subscribe to the mirrors-announce mailing list
+-------------------------------------------------
+
+To get infos about new releases uploaded to the mirrors and other mirror
+updates, you can subscribe to the mirrors-announce mailing list :
+https://ml.mageia.org/wwsympa-wrapper.fcgi/info/mirrors-announce
+