mirrorselect

From Gentoo Wiki
Jump to: navigation, search
This page contains changes which are not marked for translation.

Resources

The mirrorselect program provides a nice interface to set the GENTOO_MIRRORS variable and the Gentoo rsync mirror.

Installation

Emerge

Install app-portage/mirrorselect:

root #emerge --ask app-portage/mirrorselect

Usage

Select the Gentoo source mirror(s)

A dialog will appear where the available mirrors can be selected. On save /etc/portage/make.conf will be backed up and written.

root #mirrorselect -i
* Modifying /etc/portage/make.conf with new mirrors...
        Reading make.conf
        Moving to /etc/portage/make.conf.backup
        Writing new /etc/portage/make.conf
* Done.
  • This example selects source mirrors only from country USA and add a new GENTOO_MIRRORS= line to /etc/portage/make.conf:
root #mirrorselect -i -c USA -o >> /etc/portage/make.conf
  • Find 3 fastest servers by downloading 100K from each. This command will use all available mirrors in the list:
root #mirrorselect -s3 -b10 -D

Options

Please consider using one of these additional options to limit the available mirrors in the list it tests.

Server type selection (choose at most one):

    -c COUNTRY, -country COUNTRY
                       only use mirrors from the specified country NOTE:
                       Names with a space must be quoted eg.:  -c 'South
                       Korea'
   -F, --ftp           ftp only mode. Will not consider hosts of other types.
   -H, --http          http only mode. Will not consider hosts of other types
   -r, --rsync         rsync mode. Allows you to interactively select your
                       rsync mirror. Requires -i or -a to be used.
    -R REGION, -region REGION
                       only use mirrors from the specified region NOTE: Names
                       with a space must be quoted eg.:  -R 'North America'
   -4, --ipv4          only use IPv4
   -6, --ipv6          only use IPv6

Select the Gentoo rsync mirror

Note
Gentoo documentation states:

Gentoo is hosted by many mirrors around the globe. Selecting a mirror that is geographically near you may help speed up Portage tree updates.
Note
But Gentoo handbook recommends to keep default settings:

The default sync-uri variable value listed above will determine a mirror location based on a rotation. This will aid in easing bandwidth stress on Gentoo's infrastructure and will provide a fail safe in case a specific mirror is offline. It is recommended the default URI is kept.

For those who wish to choose a single mirror in a closer geographic region, a text editor can be used to change the default value. Again, this is not recommended, but can be done if necessary. This can be helpful especially useful for those who use Gentoo in a private company or a large-scale corporate environment.

The default configuration of the Gentoo repository comes from sys-apps/portage and is located at /usr/share/portage/config/repos.conf. However settings in /etc/portage/repos.conf override it.

mirrorselect will not create the /etc/portage/repos.conf/gentoo.conf file automatically. If that file does not exist, mirrorselect will default to using the old make.conf SYNC variable which has been deprecated. In order to avoid this make sure Portage is up to date and copy the repos.conf file from Portage's /usr (library) location to the /etc (configuration) location:

root #emerge --ask --update sys-apps/portage
root #mkdir /etc/portage/repos.conf
root #cp /usr/share/portage/config/repos.conf /etc/portage/repos.conf/gentoo.conf
Note
For additional repos.conf documentation and configuration please refer to Portage/Sync#Portage_configuration

Then proceed with using the mirrorselect utility.

root #mirrorselect -i -r -o >> /etc/portage/repos.conf/gentoo.conf

Just navigate to the mirrors of choice and press Space to select one (or more) mirrors.

See also