summaryrefslogtreecommitdiffstats
path: root/dev/archive/mirroring.mdwn
blob: 1d81007bd8af8f6783335b80ca66678fdd50cc20 (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 will take approximately 330 MiB of storage space and should be expected
to grow to approximately 500 MiB by the release of ProteanOS 1.0.

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/