path: root/dev/archive/mirroring.mdwn
diff options
authorP. J. McDermott <pehjota>2013-10-14 16:50:08 (EDT)
committer P. J. McDermott <>2013-10-14 16:50:08 (EDT)
commitf44c89329f5ae7b8a7a402c8295fef55b9cb7a61 (patch)
treef98d0b87e055384bcb2b708c0801a1162f719fb2 /dev/archive/mirroring.mdwn
parent10ce78331575bd8d0bc799918ca6fa094ab89432 (diff)
dev/archive/mirroring: New page.
Diffstat (limited to 'dev/archive/mirroring.mdwn')
1 files changed, 51 insertions, 0 deletions
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://
+The following command will mirror the archive:
+ $ rsync --recursive --times --delete --exclude .db \
+ > rsync:// /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.
+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
+ * 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.