-Imported jdp's "How to Become an Official FreeBSD CVSup Mirror Site"

from http://people.freebsd.org/~jdp/mirror/ so it can be part of our
 official documentation.
This commit is contained in:
Valentino Vaschetto 2002-02-02 09:54:07 +00:00
parent dafc837843
commit c56303d4df
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=12060

View file

@ -81,13 +81,6 @@
<sect1 id="mirror-becomingofficial">
<title>How to become an official FreeBSD mirror site</title>
<para>Check your country subdomain is exist or not. If not,
configure nameserver appropriately and then send your
details to <email>hostmaster@FreeBSD.org</email>. If exists,
contact hostmaster of your country subdomain. Hostmaster of
subdomain is listed in the
<ulink url="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/mirrors-ftp.html">
Handbook</ulink>.</para>
<para>Official mirrors may get access to <emphasis>master
</emphasis>sites:</para>
<itemizedlist>
@ -105,16 +98,82 @@
<para>Mirrors should be encouraged to also allow rsync
access for the FTP contents, especially Tier-1 mirrors.</para>
</sect2>
<sect2 id="mirror-cvsupmaster">
<title>About cvsup-master.FreeBSD.org</title>
<para>Sample supfile for cvsup-master:</para>
<programlisting>*default host=ftp-master.FreeBSD.org
<sect2 id="mirror-officialcvsup">
<title>CVSup</title>
<sect3 id="mirror-cvsupmaster">
<title>About cvsup-master.FreeBSD.org</title>
<para>Sample supfile for cvsup-master:</para>
<programlisting>*default host=ftp-master.FreeBSD.org
*default base=/ftp-master
*default prefix=/ftp-master/pub
*default delete use-rel-suffix
FreeBSD-archive release=all preserve</programlisting>
</sect3>
<sect3 id="mirror-cvsuprocedure">
<title>Procedure</title>
<para><emphasis>By <email>jdp@FreeBSD.org</email></emphasis>.</para>
<itemizedlist>
<listitem>
<para>Make sure your country really needs another mirror.
If it already has three or more, ask
<email>freebsd-hubs@FreeBSD.org</email> first.</para>
</listitem>
<listitem>
<para>Read the
<ulink url="http://people.freebsd.org/~jdp/cvsup-access/">
FreeBSD CVSup Access Policy</ulink></para>
</listitem>
<listitem>
<para><ulink url="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/eresources.html#ERESOURCES-MAIL">
Subscribe to freebsd-hubs@freebsd.org</ulink></para>
</listitem>
<listitem>
<para>Install CVSup using the <port>net/cvsup</port> port
or package. You may prefer to use the package, because it
eliminates the need to download and build the large PM3
ports. You can find the latest package <ulink
url="http://people.freebsd.org/~jdp/s1g/i386-nogui/cvsup-16.1e.tgz">
here.</ulink></para>
</listitem>
<listitem>
<para>Set up the required authentication by following <ulink
url="http://people.freebsd.org/~jdp/cvpasswd/">these
instructions</ulink>. Make sure you specify the server as
<hostid>freefall.freebsd.org</hostid> on the cvpasswd
command line.</para>
</listitem>
<listitem>
<para>Install the <port>net/cvsup-mirror</port> port. Specify
the master site as <hostid>cvsup-master.freebsd.org</hostid>
when it asks you.</para>
</listitem>
<listitem>
<para>Once you are sure your mirror site is working OK, ask the DNS
administrator of the <hostid>xx.freebsd.org</hostid> zone (where
"xx" is your country) to add a CNAME <hostid>cvsupN.xx.freebsd.org
</hostid> pointing to your mirror</para>
</listitem>
<listitem>
<para>Ask <email>freebsd-doc@freebsd.org</email>, or <email>
freebsd-hubs@freebsd.org</email> to add your mirror site to
the <ulink url="http://www.freebsd.org/handbook">FreeBSD
Handbook</ulink>. Make sure you tell them the email address
to list as the maintainer of the site</para>
</listitem>
<listitem>
<para>To get better performance and lower system loads during updates
from the master site, edit <filename>/etc/crontab</filename> and add
the option "-s" at the end of the command
<filename>/usr/local/etc/cvsup/update.sh</filename>. Make sure your
mirror is working well before you do this.</para>
</listitem>
</itemizedlist>
</sect3>
</sect2>
</sect1>
<sect1 id="mirror-statpages">
<title>Stat links</title>