344
edits
Changes
Jump to navigation
Jump to search
Line 14:
Line 14: − + − + − + − + + + + + + + − + − + + + + + +
Instructions for adding a mirror, minor changes
==Setting up a Mirror==
==Setting up a Mirror==
Setting up a mirror is very easy. All you need is a web server which is available via http, and (if possible) rsync.
Setting up a mirror is very easy. All you need is a web server which is available via http, and (if possible) rsync.
Please contact systems@sugarlabs.org if you are interested.
Please contact systems@sugarlabs.org if you are interested.
== System Summary ==
== System Summary ==
The Sugar Labs Content Delivery Network uses MirrorBrain as a redirector. The redirector, which lives in a Sugar Labs data center, keeps track of which files are available on which mirror. When a a user requests a file, the redirector points the user to the correct mirror and automatically starts the file download.
The Sugar Labs Content Delivery Network uses [http://www.mirrorbrain.org/ MirrorBrain] as a redirector. The redirector, which lives in a Sugar Labs data center, keeps track of which files are available on which mirror. When a user requests a file, the redirector points the user to the correct mirror and automatically starts the file download.
=== Mirrors ===
=== Mirrors ===
[http://mirrors.sugarlabs.org Mirrors] are completely passive. To set up a mirror, an mirror system administrator needs to:
[http://mirrors.sugarlabs.org Mirrors] are completely passive. To set up a mirror, a mirror system administrator needs to:
* Set up rsync job to synchronise a copy of the files on downloads.sugarlabs.org onto their local system.
* Set up rsync job to synchronise a copy of the files on downloads.sugarlabs.org onto their local system.
* Alert the Sugar Labs system administrators that they would like their mirror into rotation.
* Publish the files via HTTP and -- if possible -- rsync. Rsync allows for efficient [http://www.mirrorbrain.org/features/#mirror-monitoring mirror monitoring] (scanning). FTP is less efficient, but still preferred over an HTTP-only mirror.
* Alert the Sugar Labs system administrators that they would like their mirror into rotation, including the following information in the request:
** Name and URL of the mirror operator (e.g. organisation)
** Name and email address of the administrative contact
** [http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 ISO 3166-1 alpha-2] country code of the server location
** HTTP base URL of the files on the mirror
** rsync base URL of the files on the mirror
=== Redirector ===
=== Redirector ===
* Register mirror with mirrorbrain.
* Choose a name for the mirror, usually the host name.
* mirror probe
* Register the mirror with MirrorBrain:
sudo -u mirrorbrain mb new <mirror name> --operator-name <operator name> \
--operator-url <operator URL> -a <admin name> -e <admin email> \
-c <country code> -H <base HTTP URL> -R <base rsync URL> -F <base FTP URL>
* Scan and enable the mirror:
sudo -u mirrorbrain mb scan -e <mirror name>