diff --git a/en/internal/mirror.sgml b/en/internal/mirror.sgml index 3146ec9878..7ba0a00c1a 100644 --- a/en/internal/mirror.sgml +++ b/en/internal/mirror.sgml @@ -1,81 +1,59 @@ - + %includes; ]> - + &header; -

You can (and are encouraged to) mirror the FreeBSD web pages on -www.freebsd.org. To do this, you need to obtain and install -a program called rsync on your web server. Rsync is a revolutionary -tree synchronising program written by Andrew Tridgell and Paul Mackerras -at the Australian National University. It was modified to work in an -unprivileged client-server mode by Warren Toomey.

+

You can (and are encouraged to) mirror the FreeBSD web pages +www.freebsd.org. -

Installing Rsync

+To do this, you need to obtain and install +a program called cvsup on your web server. + +CVSup is a software package for +distributing and updating collections of files across a network. + +

Installing CVSup

To build and install it, do the following:

- % cd /usr/ports/net/rsync
- % make all install
- % rehash	(for csh users)
+ # cd /usr/ports/net/cvsup-bin
+ # make all install clean
 
-

Running Rsync

+

Running CVSup

If you keep your mirrored FreeBSD web pages in the directory -/usr/FreeBSD-mirror/data and are owned by the user `fred', then +/usr/FreeBSD-mirror and are owned by the user `fred', then run the following command as user `fred':

- % rsync --client -avz www.freebsd.org:www /usr/FreeBSD-mirror/data
+     $ cvsup supfile-www
 
-

This will mirror the FreeBSD web pages into /usr/FreeBSD-mirror/data. -You can install this into fred's crontab, so that it runs once a -day. The pages on www.freebsd.org are updated daily at about 4:30am -California time.

- -

If you do not wish to use rsync for some reason, you can also use -one of the popular FTP mirror utilities to simply mirror -the -central FTP site's copy. - -

Optimizing Rsync's Performance

- -

There are several gzipped tar files kept in the web hierarchy at -www.freebsd.org. Rsync does not deal with these very well; it -must transmit each tar file if it is changed. Because these files can -easily be created locally, you can get rsync to exclude -them. To do this, run the following command as user `fred':

- +The file supfile-www contain:
- % rsync --client -avz --exclude '*.tar.gz' www.freebsd.org:www /usr/FreeBSD-mirror/data
+       *default host=cvsup.FreeBSD.org
+       *default prefix=/usr/FreeBSD-mirror
+       *default base=/usr/local/etc/cvsup
+       www release=current delete use-rel-suffix compress
 
-

You should see a dramatic improvement in rsync's -performance. (A better mechanism for dealing with the tar files needs -to be established.)

+

This will mirror the FreeBSD web pages into +/usr/FreeBSD-mirror. You can install this into fred's +crontab, so that it runs once a day. The pages on www.freebsd.org are +updated daily at about 4:30am California time.

-

More Information on Rsync

+

More Information on CVSup

-

Now that you can use rsync, I would suggest you read the -following files:

- - - -

If you have any questions about rsync, please pass them on to the -authors, or join the rsync mailing list (both described in the -README).

+See the CVSup introduction in the +handbook.

FreeBSD Internal Home &footer;