summaryrefslogtreecommitdiffstats
path: root/dev/archive/mirroring.mdwn
blob: 9d2b38ae489d798b67f046bee5bcb3d6a9acfb51 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
[[!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 takes about 700 MiB of storage space as of this writing and should be
expected to grow beyond that.

The following command will list files in the archive:

    $ rsync --recursive --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] ([list info][proteanos-dev-info]).  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
[proteanos-dev-info]: http://lists.proteanos.com/proteanos-dev/