Instructions for mirroring with rsync.

A mirroring policy still needs to be added.
Submitted by:	Warren Toomey <wkt@csadfa.cs.adfa.oz.au>
This commit is contained in:
John Fieber 1996-12-13 00:46:58 +00:00
parent 6a7b328bcd
commit 079734b3e4
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/www/; revision=802
4 changed files with 160 additions and 4 deletions

View file

@ -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

78
data/mirror.sgml Normal file
View file

@ -0,0 +1,78 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN" [
<!ENTITY date "$Date: 1996-12-13 00:46:58 $">
<!ENTITY title "Mirroring the FreeBSD Web Pages">
<!ENTITY % includes SYSTEM "includes.sgml"> %includes;
]>
<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>
<H2>Installing Rsync</H2>
<p>The source code to <em>rsync</em> can be obtained via anonymous ftp
at <a href="ftp://minnie.cs.adfa.oz.au/rsync/rsync_client.tar.gz">ftp://minnie.cs.adfa.oz.au/rsync/rsync_client.tar.gz</a>.</p>
<p>To build and install it, do the following:</p>
<pre>
% tar vxzf rsync_client.tar.gz
% cd rsync-1.6.2
% ./configure
% make; make install
% rehash (for csh users)
</pre>
<H2>Running Rsync</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
run the following command as user `fred':</p>
<pre>
% rsync --client -avz www.freebsd.org:www /usr/FreeBSD-mirror/data
</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>
<H2>Optimizing Rsync's Performance</H2>
<p>There are several gzipped tar files kept in the web hierachy at
<tt>www.freebsd.org</tt>. 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 <em>rsync</em> to exclude
them. To do this, run the following command as user `fred':</p>
<pre>
% rsync --client -avz --exclude '*.tar.gz' www.freebsd.org:www /usr/FreeBSD-mirror/data
</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>
<H2>More Information on Rsync</H2>
<p>Now that you can use <em>rsync</em>, I'd suggest you read the
following files:</p>
<ul>
<li>README
<li>The rsync man page, rsync.1
<li>tech_report.ps
<li>Readme.daemon
</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>
&footer;

View file

@ -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

78
en/internal/mirror.sgml Normal file
View file

@ -0,0 +1,78 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN" [
<!ENTITY date "$Date: 1996-12-13 00:46:58 $">
<!ENTITY title "Mirroring the FreeBSD Web Pages">
<!ENTITY % includes SYSTEM "includes.sgml"> %includes;
]>
<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>
<H2>Installing Rsync</H2>
<p>The source code to <em>rsync</em> can be obtained via anonymous ftp
at <a href="ftp://minnie.cs.adfa.oz.au/rsync/rsync_client.tar.gz">ftp://minnie.cs.adfa.oz.au/rsync/rsync_client.tar.gz</a>.</p>
<p>To build and install it, do the following:</p>
<pre>
% tar vxzf rsync_client.tar.gz
% cd rsync-1.6.2
% ./configure
% make; make install
% rehash (for csh users)
</pre>
<H2>Running Rsync</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
run the following command as user `fred':</p>
<pre>
% rsync --client -avz www.freebsd.org:www /usr/FreeBSD-mirror/data
</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>
<H2>Optimizing Rsync's Performance</H2>
<p>There are several gzipped tar files kept in the web hierachy at
<tt>www.freebsd.org</tt>. 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 <em>rsync</em> to exclude
them. To do this, run the following command as user `fred':</p>
<pre>
% rsync --client -avz --exclude '*.tar.gz' www.freebsd.org:www /usr/FreeBSD-mirror/data
</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>
<H2>More Information on Rsync</H2>
<p>Now that you can use <em>rsync</em>, I'd suggest you read the
following files:</p>
<ul>
<li>README
<li>The rsync man page, rsync.1
<li>tech_report.ps
<li>Readme.daemon
</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>
&footer;