From f44c89329f5ae7b8a7a402c8295fef55b9cb7a61 Mon Sep 17 00:00:00 2001
From: P. J. McDermott <pehjota>
Date: Mon, 14 Oct 2013 16:50:08 -0400
Subject: dev/archive/mirroring: New page.

---
(limited to 'dev/archive/mirroring.mdwn')

diff --git a/dev/archive/mirroring.mdwn b/dev/archive/mirroring.mdwn
new file mode 100644
index 0000000..ae2ef42
--- /dev/null
+++ b/dev/archive/mirroring.mdwn
@@ -0,0 +1,51 @@
+[[!meta title="Mirroring the ProteanOS Package Archive"]]
+
+Running a mirror of the ProteanOS package archive contributes to the
+availability of ProteanOS.
+
+You can keep your mirror private or make it an official mirror.
+
+
+Setting up a mirror
+===================
+
+A mirror is currently expected to take approximately 300 MiB of storage space.
+
+The following command will list files in the archive:
+
+    $ rsync --exclude .db rsync://files.proteanos.com/proteanos
+
+The following command will mirror the archive:
+
+    $ rsync --recursive --times --delete --exclude .db \
+    > rsync://files.proteanos.com/proteanos /path/to/your/mirror/directory/
+
+Packages are moved from incoming into the archive four times daily.  The
+[[archive_management_software|dev/pro-archman]] is [configured][arch-conf] to
+keep unreferenced files in the pool for one day, so mirrors must be updated at
+least once a day.  Otherwise, during the update, some feed index files may
+reference deleted files.
+
+[arch-conf]: http://files.proteanos.com/pub/proteanos/conf
+
+
+Making an official mirror
+=========================
+
+Official mirror sites should make their archive mirrors available at
+`/pub/proteanos` over HTTP and FTP.  Sites should also make their archive
+mirrors accessible over rsync, if possible.
+
+Once your mirror is set up, please announce it to the [ProteanOS development
+mailing list][proteanos-dev].  Please include the following information in your
+announcement:
+
+  * Name and e-mail address of site maintainer;
+  * Name and URL of site sponsor, if any;
+  * Domain name, or IPv4 and/or IPv6 address, of mirror site;
+  * Available protocols;
+  * Country of site;
+  * Frequency of mirroring; and
+  * Any other comments about the site.
+
+[proteanos-dev]: mailto:proteanos-dev@lists.proteanos.com
--
cgit v0.9.1