Infrastructure/MirrorManager

MirrorManager is the application that keeps track of each of the 200+ global mirror servers for Fedora content. It has three distinct audiences: End Users, Mirror Server Administrators, and Fedora Infrastructure System Administrators.

End User Interfaces

mirrorlists (used by YUM)

Metalink format mirrorlist

Yum in Fedora 10 and higher can process the mirror list in metalink format, which provides additional security checking capability. Yum compares the SHA1 checksums of each repository's repomd.xml file against that of the master mirrors. This ensures that significantly out-of-date mirrors are not used.

The yum repo file URL format is:

metalink=http://mirrors.fedoraproject.org/metalink?repo=fedora-10&arch=$basearch

Traditional mirrorlist

Yum also can process a mirror list in plain text format.

The yum repo file URL format is:

mirrorlist=http://mirrors.fedoraproject.org/mirrorlist?repo=fedora-10&arch=$basearch

Optional use of HTTPS

MirrorManager may use HTTPS instead of HTTP upon request. However, as of Fedora 10, yum does not validate HTTPS certificates to ensure they were issued by a trusted certificate authority, so this is of limited value and not enabled by default in Fedora repo config files.

URL formats:

metalink=https://mirrors.fedoraproject.org/metalink?repo=fedora-10&arch=$basearch
mirrorlist=https://mirrors.fedoraproject.org/mirrorlist?repo=fedora-10&arch=$basearch

Additional options

The following options can be appended to each of the URLs listed above to return more customized mirror lists.

Options that can be passed to mirrorlist or metalink:

&repo=fedora-7&arch=i386	Some combination of repository tag, and an architecture
&path=pub/.....	A path name, either a directory or path to a file, using the tree names as found on the master servers.
&country=global	override the GeoIP checks for your country and specify you want the global list
&country=us,ca,jp	override the GeoIP checks and specify a list of comma-separated 2-letter ISO country codes
&ip=18.0.0.1	override the client IP address detection and specify an IP address instead
&redirect=1	After all other processing is done, automatically perform a HTTP redirect to the first result returned

download.fedoraproject.org

URLs of the form http://download.fedoraproject.org/pub/fedora/linux/... (directory path or full file path) are automatically redirected to a mirror containing that path or file.

Public List web pages

Human-readable lists of the mirror servers are available at http://mirrors.fedoraproject.org/publiclist/.

Mirror Server Administrators

Mirror servers may be public (e.g. open for anyone to download data from), or private (e.g usage restricted in some way). Data for both types may be stored in the mirrormanager database.

The MirrorManager web user interface is at https://admin.fedoraproject.org/mirrormanager. You must have a Fedora Account System account to log in and edit data there.

Information about your Site (the administrative level of control), your Hosts (the servers themselves), what Categories of content they carry, and at which URLs can be entered. In addition, you may specify Netblocks - groups of IP addresses which are considered "local", and therefore preferred, for your servers. The mirrorlist CGI will return Netblock-local servers first.