- Tweak wording.

- s/RSYNC/Rsync to match http://rsync.samba.org/
- Add missing comma.
- Remove old information pertaining to net/sup.
This commit is contained in:
Brad Davis 2006-04-20 08:55:53 +00:00
parent 5bb03fd94e
commit 1d664178d8
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=27588

View file

@ -124,7 +124,7 @@
</para>
<para>
For a moderately visited site that offers
<application>rsync</application>, you might
<application>Rsync</application>, you might
consider a current CPU with around 800MHz - 1 GHz,
and at least 512MB RAM. This is probably the
minimum you want for an <emphasis>official</emphasis>
@ -211,18 +211,18 @@
</para>
</sect3>
<sect3 id="mirror-serv-rsync">
<title>RSYNC (optional for FTP fileset)</title>
<title>Rsync (optional for FTP fileset)</title>
<para>
<application>rsync</application> is often offered for access to the
<application>Rsync</application> is often offered for access to the
contents of the FTP area of FreeBSD, so other mirror sites can use your system as their source. The
protocol is different from FTP in many ways.
It is much more
bandwidth friendly, as only differences between files
are transferred instead of whole files when they change.
<application>rsync</application> does require a significant amount of memory for
<application>Rsync</application> does require a significant amount of memory for
each instance. The size depends on the size of
the synced module in terms of the number of directories and
files. <application>rsync</application> can use <command>rsh</command> and
files. <application>Rsync</application> can use <command>rsh</command> and
<command>ssh</command> (now default) as a transport,
or use its own protocol for stand-alone access
(this is the preferred method for public rsync servers).
@ -286,7 +286,7 @@
FreeBSD CVS repository, you really want to consider
offering it via <application>CVSup</application>. It is possible to offer
the CVS repository via <application>AnonCVS</application>, FTP,
<application>Rsync</application> or HTTP, but
<application>rsync</application> or HTTP, but
people would benefit much more from <application>CVSup</application> access.
<application>CVSup</application> was developed by &a.jdp;.
It is a bit tricky to install on non-FreeBSD platforms,
@ -409,15 +409,14 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all
<title>With FTP mirror</title>
<para>
You can use a <application>FTP mirror</application>
program to get the files. There are a lot around and
widely used, like:
program to get the files. Some of the most commonly used are:
<itemizedlist>
<listitem><para><filename role="package">ftp/mirror</filename></para></listitem>
<listitem><para><filename role="package">ftp/ftpmirror</filename></para></listitem>
<listitem><para><filename role="package">ftp/emirror</filename></para></listitem>
<listitem><para><filename role="package">ftp/spegla</filename></para></listitem>
<listitem><para><filename role="package">ftp/omi</filename></para></listitem>
<listitem><para>some even use <filename role="package">ftp/wget</filename></para></listitem>
<listitem><para><filename role="package">ftp/wget</filename></para></listitem>
</itemizedlist>
<filename role="package">ftp/mirror</filename> was very popular, but seemed
@ -436,7 +435,7 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all
</para>
</sect3>
<sect3 id="mirror-ftp-rsync">
<title>With RSYNC</title>
<title>With rsync</title>
<para>
A better way to mirror the FTP area is <application>rsync</application>.
You can install the port <filename role="package">net/rsync</filename> and then use
@ -457,12 +456,12 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all
an exception for your host (since you are a mirror).
</para>
</note>
A command line to mirror FreeBSD could look like that:
A command line to mirror FreeBSD might look like:
<screen>&prompt.user; <userinput>rsync -vaz --delete ftp4.de.FreeBSD.org::FreeBSD/ /pub/FreeBSD/</userinput>
</screen>
Consult the documentation for <application>rsync</application>,
which is also available at
<ulink url="http://rsync.samba.org/">http://rsync.samba.org/</ulink>
<ulink url="http://rsync.samba.org/">http://rsync.samba.org/</ulink>,
about the various options to be used with rsync.
If you sync the whole module (unlike subdirectories),
be aware that the module-directory (here "FreeBSD")
@ -515,37 +514,20 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all
</sect2>
<sect2 id="mirror-cvs">
<title>Mirroring the CVS repository</title>
<para>
Again you have various possibilities, but the most
recommended one is to use <link linkend="mirror-cvs-cvsup">CVSup</link>.
</para>
<para>There are various ways to mirror the CVS repository,
<application>CVSup</application> is the most common method</para>
<sect3 id="mirror-cvs-cvsup">
<title>Using CVSup</title>
<para>
<application>CVSup</application> was already described to some
<application>CVSup</application> is described in some
detail in <xref linkend="mirror-serv-cvsup"> and <xref linkend="mirror-ftp-cvsup">.
</para>
<para>
Here we just describe an example to set up the <filename>supfile</filename>:
<programlisting>
#
# FreeBSD CVS supfile from master server
#
*default host=cvsup-master.FreeBSD.org
*default base=/usr
*default prefix=/pub/FreeBSD/development/FreeBSD-CVS
*default release=cvs
*default delete use-rel-suffix
*default umask=002
# If your network link is a T1 or faster, comment out the following line.
#*default compress
cvs-all
</programlisting>
You should also have a look at <filename>/usr/share/examples/cvsup</filename>
</para>
<para>It is very easy to setup a
<application>CVSup</application> mirror. Installing
<filename role="package">net/cvsup-mirror</filename> will
make sure all of the needed programs are installed and then
gather all the needed info to configure the mirror.</para>
<note>
<para>
Please do not forget to consider the hint
@ -565,23 +547,14 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all
the following methods could be used.
<itemizedlist>
<listitem><para><application>FTP</application></para></listitem>
<listitem><para><application>RSYNC</application></para></listitem>
<listitem><para>maybe even <application>HTTP</application></para></listitem>
<listitem><para><application>Rsync</application></para></listitem>
<listitem><para><application>HTTP</application></para></listitem>
</itemizedlist>
If you find a site that supports it, you could use
<filename role="package">net/sup</filename>. But it is inferior to <application>CVSup</application>
and its deficiencies caused John Polstra to develop
<application>CVSup</application> in the first place, so
it is clearly not recommended.
<important>
<para>
You can <emphasis>NOT</emphasis> use AnonCVS to
mirror the CVS repository since CVS does not allow
you to access the repository itself, but only checked
out versions of the modules.
</para>
<para>AnonCVS cannot be used to mirror the CVS repository
since CVS does not allow you to access the repository
itself, only checked out versions of the modules.</para>
</important>
</para>
</sect3>
@ -971,7 +944,7 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all
<listitem><para>carry the complete fileset</para></listitem>
<listitem><para>allow access to other mirror sites</para></listitem>
<listitem><para>provide <application>FTP</application> and
<application>RSYNC</application> access</para></listitem>
<application>rsync</application> access</para></listitem>
</itemizedlist>
Furthermore, admins should be subscribed to the &a.hubs;.
@ -1076,7 +1049,7 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all
<para>ftp.cz.FreeBSD.org - <email>cejkar@fit.vutbr.cz</email> -
<ulink url="http://www.cz.FreeBSD.org/stats/mrtg/net.html">(Bandwidth)</ulink>
<ulink url="http://www.freebsd.cz/stats/mrtg/ftpd.html">(FTP processes)</ulink>
<ulink url="http://www.freebsd.cz/stats/mrtg/rsyncd.html">(Rsync processes)</ulink>
<ulink url="http://www.freebsd.cz/stats/mrtg/rsyncd.html">(rsync processes)</ulink>
</para>
</listitem>
<listitem>