Contributing a mirror to Exherbo is fairly simple. It consists of syncing with the master mirror every so often via
rsync, adding an entry to the
arbor line in ::arbor’s mirrors.conf, and submitting a patch to Gerrit, which adds the mirror.
Mirrors with HTTP(S), FTP, with IPv4 and v6 (or both) are currently accepted.
For example, on the mirror at somasis.com, a cronjob executes
rsync at the 42nd minute of 2:00 (that’s AM, for 12-hour users) every day:
42 2 * * * flock /srv/www/somasis.com/mirror/exherbo-sync.lock rsync -ruvtE rsync://distfiles.exherbo.org/exherbo-mirror /srv/www/somasis.com/mirror/exherbo
flock is used to prevent long
rsync operations from starting when the file lock is currently used; otherwise it could result in multiple
rsync instances running at a time.
rsync -ruvtE: rsync recursively, update the local directory, verbosely, transfer modification times, and preserve executability.
Obviously, you should not copy this example blindly.
In addition, please don’t synchronize much more than once a day. The main mirror only updates once a day. Your IP may be banned if you are mean to the mirror.
Practice common courtesy and don’t be rude to our servers. Thank you. :)
|http://distfiles.exherbo.org/distfiles/||Kim Højgaard-Hansen email@example.com||Germany||Master mirror, IPv4 only|
|http://mirrors.dotsrc.org/exherbo/||Kim Højgaard-Hansen firstname.lastname@example.org||Denmark||Dual IP stack|
|ftp://mirrors.dotsrc.org/exherbo/||Kim Højgaard-Hansen email@example.com||Denmark||Dual IP stack|
|https://www.somasis.com/dl/mirror/exherbo/||Kylie McClain firstname.lastname@example.org||Germany||Dual IP stack, HTTPS only|
|https://git.exherbo.org/||Exherbo Developers||Denmark||Master mirror, IPv4 only|
|https://git.nightly.network/exherbo/||Irvin Choi email@example.com||United States||IPv4, HTTPS only|
By default, Paludis uses
git.exherbo.org to sync repositories with git protocol. To use different repository, simply edit
sync value into repository you want to use.
For example, steps for changing git mirror from
arbor would be:
/etc/paludis/repositories/arbor.conf with text-editor of your choice.
2) Under location, replace
sync value so that:
sync = git+https://git.exherbo.org/arbor.git
sync = git+https://git.nightly.network/exherbo/arbor.git.
3) Save the file, and exit.
4) Sync the repository,
cave sync arbor.
That’s it! If you have multiple repositories that you wish to change the mirror of, consider using
sed to make your life easier.
Copyright 2015-2016 Kylie McClain