os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Use cvsup(1) to mirror the web pages.

Browse source 
Rsync(1) will still work for mirroring, but it is not recommended
and documented anymore.
This commit is contained in:
Wolfram Schneider 1998-11-01 21:40:29 +00:00
parent c5c71e62d2
commit d433577198
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/www/; revision=3717
1 changed files with 28 additions and 50 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

78
en/internal/mirror.sgml
View file

@ -1,81 +1,59 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN" [
<!ENTITY base CDATA "..">
<!ENTITY date "$Date: 1998-10-25 17:58:27 $">
<!ENTITY date "$Date: 1998-11-01 21:40:29 $">
<!ENTITY title "Mirroring the FreeBSD Web Pages">
<!ENTITY % includes SYSTEM "../includes.sgml"> %includes;
]>
<!-- $Id: mirror.sgml,v 1.8 1998-10-25 17:58:27 wosch Exp $ -->
<!-- $Id: mirror.sgml,v 1.9 1998-11-01 21:40:29 wosch Exp $ -->
<html>
&header;
<p>You can (and are encouraged to) mirror the FreeBSD web pages on
<tt>www.freebsd.org</tt>. To do this, you need to obtain and install
a program called <em>rsync</em> 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.</p>
<p>You can (and are encouraged to) mirror the FreeBSD web pages
<tt>www.freebsd.org</tt>.
<H2>Installing Rsync</H2>
To do this, you need to obtain and install
a program called <em>cvsup</em> on your web server.
<a href="../handbook/cvsup.html">CVSup</a> is a software package for
distributing and updating collections of files across a network.
<H2>Installing CVSup</H2>
<p>To build and install it, do the following:</p>
<pre>
% cd /usr/ports/net/rsync
% make all install
% rehash (for csh users)
# cd /usr/ports/net/cvsup-bin
# make all install clean
</pre>
<H2>Running Rsync</H2>
<H2>Running CVSup</H2>
<p>If you keep your mirrored FreeBSD web pages in the directory
<tt>/usr/FreeBSD-mirror/data</tt> and are owned by the user `fred', then
<tt>/usr/FreeBSD-mirror</tt> and are owned by the user `fred', then
run the following command as user `fred':</p>
<pre>
% rsync --client -avz www.freebsd.org:www /usr/FreeBSD-mirror/data
$ cvsup supfile-www
</pre>
<p>This will mirror the FreeBSD web pages into <tt>/usr/FreeBSD-mirror/data</tt>.
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.</p>
<p>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
<a href="ftp://ftp.freebsd.org/pub/FreeBSD/FreeBSD-current/www">the
central FTP site's copy</a>.
<H2>Optimizing Rsync's Performance</H2>
<p>There are several gzipped tar files kept in the web hierarchy at
<tt>www.freebsd.org</tt>. 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 <em>rsync</em> to exclude
them. To do this, run the following command as user `fred':</p>
The file <tt>supfile-www</tt> contain:
<pre>
% 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
</pre>
<p>You should see a dramatic improvement in <em>rsync</em>'s
performance. (A better mechanism for dealing with the tar files needs
to be established.)</p>
<p>This will mirror the FreeBSD web pages into
<tt>/usr/FreeBSD-mirror</tt>. 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.</p>
<H2>More Information on Rsync</H2>
<H2>More Information on CVSup</H2>
<p>Now that you can use <em>rsync</em>, I would suggest you read the
following files:</p>
<ul>
<li>README
<li>The rsync man page, rsync.1
<li>tech_report.ps
</ul>
<p>If you have any questions about <em>rsync</em>, please pass them on to the
authors, or join the rsync mailing list (both described in the
README).</p>
See the <a href="../handbook/cvsup.html">CVSup introduction</a> in the
handbook.
<p></p><A HREF="internal.html">FreeBSD Internal Home</a>
&footer;