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.
+ +The source code to rsync can be obtained via anonymous ftp +at ftp://minnie.cs.adfa.oz.au/rsync/rsync_client.tar.gz.
+ +To build and install it, do the following:
+ ++ % tar vxzf rsync_client.tar.gz + % cd rsync-1.6.2 + % ./configure + % make; make install + % rehash (for csh users) ++ +
If you keep your mirrored FreeBSD web pages in the directory +/usr/FreeBSD-mirror/data 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 ++ +
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.
+ +There are several gzipped tar files kept in the web hierachy at +www.freebsd.org. Rsync doesn't 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':
+ ++ % rsync --client -avz --exclude '*.tar.gz' www.freebsd.org:www /usr/FreeBSD-mirror/data ++ +
You should see a dramatic improvement in rsync's +performance. (A better mechanism for dealing with the tar files needs +to be established.)
+ +Now that you can use rsync, I'd 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).
+ +&footer; diff --git a/en/Makefile b/en/Makefile index ea83db4114..eb287aa30a 100644 --- a/en/Makefile +++ b/en/Makefile @@ -1,10 +1,10 @@ -# $Id: Makefile,v 1.6 1996-11-19 15:05:14 jfieber Exp $ +# $Id: Makefile,v 1.7 1996-12-13 00:46:57 jfieber Exp $ # These are turned into validated, normalized HTML files. DOCS= about.sgml branch.sgml commercial.sgml daemon.sgml docproj.sgml DOCS+= docs.sgml gallery.sgml index-site.sgml index.sgml license.sgml -DOCS+= mailto.sgml newsflash.sgml searchhints.sgml support.sgml +DOCS+= mailto.sgml mirror.sgml newsflash.sgml searchhints.sgml support.sgml DOCS+= welcome.sgml where.sgml search.sgml send-pr.sgml DOCS+= internet.sgml features.sgml applications.sgml availability.sgml diff --git a/en/internal/mirror.sgml b/en/internal/mirror.sgml new file mode 100644 index 0000000000..de90c53edf --- /dev/null +++ b/en/internal/mirror.sgml @@ -0,0 +1,78 @@ + + + %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.
+ +The source code to rsync can be obtained via anonymous ftp +at ftp://minnie.cs.adfa.oz.au/rsync/rsync_client.tar.gz.
+ +To build and install it, do the following:
+ ++ % tar vxzf rsync_client.tar.gz + % cd rsync-1.6.2 + % ./configure + % make; make install + % rehash (for csh users) ++ +
If you keep your mirrored FreeBSD web pages in the directory +/usr/FreeBSD-mirror/data 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 ++ +
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.
+ +There are several gzipped tar files kept in the web hierachy at +www.freebsd.org. Rsync doesn't 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':
+ ++ % rsync --client -avz --exclude '*.tar.gz' www.freebsd.org:www /usr/FreeBSD-mirror/data ++ +
You should see a dramatic improvement in rsync's +performance. (A better mechanism for dealing with the tar files needs +to be established.)
+ +Now that you can use rsync, I'd 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).
+ +&footer;