m (Cleanup.) |
(add metalink info, reformat) |
||
| Line 7: | Line 7: | ||
== End User Interfaces == | == End User Interfaces == | ||
=== mirrorlist | === mirrorlists (used by YUM) === | ||
==== Metalink format mirrorlist ==== | |||
Yum in Fedora 10 and higher can process the mirror list in [http://metalinker.org 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. | |||
Options that can be passed to mirrorlist: | 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: | |||
{| border="1" | {| border="1" | ||
Revision as of 18:33, 15 November 2008
Fedora 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.