diff --git a/en_US.ISO8859-1/articles/hubs/article.sgml b/en_US.ISO8859-1/articles/hubs/article.sgml index c52ca8b4a9..044ca8d581 100644 --- a/en_US.ISO8859-1/articles/hubs/article.sgml +++ b/en_US.ISO8859-1/articles/hubs/article.sgml @@ -1,169 +1,228 @@ %man; %authors; ]>
Mirroring FreeBSD $FreeBSD$ Jun Kuriyama
kuriyama@FreeBSD.org
Valentino Vaschetto
logo@FreeBSD.org
An in-progress article on how to mirror FreeBSD, aimed at hub administrators
How to mirror FreeBSD FTP At this time (just before 4.5-RELEASE), full mirror requires 65GB disk space. For safety, 70-80GB will be required An anonymous ftp mirror requires network bandwidth. It is not encouraged if your site does not have enough spare bandwidth Choose favorite ftp mirror tool (such as ftp/mirror, ftp/ftpmirror , ftp/spegla and so on.) Select upstream. First candidate is your local mirror (ftpX.XX.FreeBSD.org). If there is no official mirror in your country, use ftpX.FreeBSD.org instead. (X stands for a number, and XX stands for your local country code) Setting up your mirror configuration. CVSup At this time (01/29/2002), full CVSup mirror requires 3GB disk space. For safety, 4-5GB will be required. Public CVSup mirror requires high disk activity. It is encouraged to use RAID-0 or RAID-5. You can setting up CVSup mirror configuration by net/cvsup-mirror port. Upstream selection is same as ftp. First candidate is your local CVSup mirror (ftp?.??.FreeBSD.org). Next is ftp?.FreeBSD.org. WWW At this time (01/29/2002), full www mirror requires 150MB disk space. For safety, 200MB will be required How to become an official FreeBSD mirror site - Check your country subdomain is exist or not. If not, - configure nameserver appropriately and then send your - details to hostmaster@FreeBSD.org. If exists, - contact hostmaster of your country subdomain. Hostmaster of - subdomain is listed in the - - Handbook. Official mirrors may get access to master sites: ftp-master.FreeBSD.org: peter@FreeBSD.org cvsup-master.FreeBSD.org: jdp@FreeBSD.org About ftp-master.FreeBSD.org ftp-master.FreeBSD.org provides rsync and CVSup access rather in addition to ftp protocol. Mirrors should be encouraged to also allow rsync access for the FTP contents, especially Tier-1 mirrors. - - About cvsup-master.FreeBSD.org - Sample supfile for cvsup-master: - *default host=ftp-master.FreeBSD.org + + CVSup + + About cvsup-master.FreeBSD.org + Sample supfile for cvsup-master: + *default host=ftp-master.FreeBSD.org *default base=/ftp-master *default prefix=/ftp-master/pub *default delete use-rel-suffix FreeBSD-archive release=all preserve + + + Procedure + By jdp@FreeBSD.org. + + + Make sure your country really needs another mirror. + If it already has three or more, ask + freebsd-hubs@FreeBSD.org first. + + + Read the + + FreeBSD CVSup Access Policy + + + + Subscribe to freebsd-hubs@freebsd.org + + + Install CVSup using the net/cvsup port + or package. You may prefer to use the package, because it + eliminates the need to download and build the large PM3 + ports. You can find the latest package + here. + + + Set up the required authentication by following these + instructions. Make sure you specify the server as + freefall.freebsd.org on the cvpasswd + command line. + + + Install the net/cvsup-mirror port. Specify + the master site as cvsup-master.freebsd.org + when it asks you. + + + Once you are sure your mirror site is working OK, ask the DNS + administrator of the xx.freebsd.org zone (where + "xx" is your country) to add a CNAME cvsupN.xx.freebsd.org + pointing to your mirror + + + Ask freebsd-doc@freebsd.org, or + freebsd-hubs@freebsd.org to add your mirror site to + the FreeBSD + Handbook. Make sure you tell them the email address + to list as the maintainer of the site + + + To get better performance and lower system loads during updates + from the master site, edit /etc/crontab and add + the option "-s" at the end of the command + /usr/local/etc/cvsup/update.sh. Make sure your + mirror is working well before you do this. + + + + + + Stat links Here are links to the stat pages of your favorite mirrors (a.k.a. the only ones who feel like providing stats). FTP site stats ftp.is.FreeBSD.org - oli@isnic.is - (Bandwidth) (FTP users) (HTTP users) CVSup site stats cvsup5.FreeBSD.org - logo@FreeBSD.org - (CVSup processes) cvsup[23456].jp.FreeBSD.org - kuriyama@FreeBSD.org - (CVSup processes) Other important information It is very important for a hub administrator, especially Tier-1 hub admins, to check the release schedule for the next FreeBSD release. This is important because it will tell you when the next release is scheduled to come out, and thus giving you time to prepare for the big spike of traffic which follows it. It is also eminent that hub administrators try to keep their mirrors as up-to-date as possible (again, even more crucial for Tier-1 mirrors). If Mirror1 doesn't update for a while, lower tier mirrors will begin to mirror old data from Mirror1 and thus begins a downward spiral... Keep your mirrors up to date!