<firstname>Valentino</firstname>  

        <firstname>Valentino</firstname>  

        <surname>Vaschetto</surname>

        <surname>Vaschetto</surname>

        <affiliation>

        <affiliation>

        </affiliation>

        </affiliation>

      </author>

      </author>

      <author>

      <author>

          <address><email>dl@leo.org</email></address>

          <address><email>dl@leo.org</email></address>

        </affiliation>

        </affiliation>

      </author>

      </author>

    </authorgroup>

    </authorgroup>

    <abstract>

    <abstract>

      <para>An in-progress article on how to mirror FreeBSD, aimed at

      <para>An in-progress article on how to mirror FreeBSD, aimed at

    </abstract>

    </abstract>

  </articleinfo>

  </articleinfo>

  <sect1 id="mirror-requirements">

  <sect1 id="mirror-requirements">

    <title>Requirements for FreeBSD mirrors</title>

    <title>Requirements for FreeBSD mirrors</title>

    <sect2 id="mirror-diskspace">

    <sect2 id="mirror-diskspace">

      <para>

      <para>

        Disk space is one of the most important requirements.

        Disk space is one of the most important requirements.

        Depending on the set of releases, architectures,

        Depending on the set of releases, architectures,

        that <emphasis>official</emphasis> mirrors are probably required to be

        that <emphasis>official</emphasis> mirrors are probably required to be

        complete. The CVS repository and the web pages should

        complete. The CVS repository and the web pages should

        releases will only increase the required amount.

        releases will only increase the required amount.

        Here are some approximate figures:

        Here are some approximate figures:

      </para>

      </para>

      <itemizedlist>

      <itemizedlist>

        <listitem><para>Webpages: 300 MB</para></listitem>

        <listitem><para>Webpages: 300 MB</para></listitem>

      </itemizedlist>

      </itemizedlist>

    </sect2>

    </sect2>

        Of course, you need to be connected to the Internet.

        Of course, you need to be connected to the Internet.

        The required bandwidth depends on your intended use

        The required bandwidth depends on your intended use

        of the mirror. If you just want to mirror some

        of the mirror. If you just want to mirror some

        estimates here:

        estimates here:

      </para>

      </para>

      <itemizedlist>

      <itemizedlist>

         <listitem><para>Local site, no public access: basically no minimum,

         <listitem><para>Local site, no public access: basically no minimum,

         <listitem><para>Unofficial public site: 34 Mbps is probably a good start.</para></listitem>

         <listitem><para>Unofficial public site: 34 Mbps is probably a good start.</para></listitem>

           should be connected as close as possible to your border router.</para></listitem>

           should be connected as close as possible to your border router.</para></listitem>

      </itemizedlist>

      </itemizedlist>

    </sect2>

    </sect2>

    <sect2 id="mirror-system">

    <sect2 id="mirror-system">

      <title>System Requirements, CPU, RAM</title>

      <title>System Requirements, CPU, RAM</title>

      <para>

      <para>

        also affected by the types of services you want to offer.

        also affected by the types of services you want to offer.

        Plain FTP or HTTP services may not require a huge

        Plain FTP or HTTP services may not require a huge

        CVSup, rsync or even AnonCVS. This can have a huge

        CVSup, rsync or even AnonCVS. This can have a huge

        impact on CPU and memory requirements. Especially

        impact on CPU and memory requirements. Especially

        rsync is considered a memory hog, and CVSup does 

        rsync is considered a memory hog, and CVSup does 

        are just examples to give you a very rough hint.

        are just examples to give you a very rough hint.

      </para>

      </para>

      <para>

      <para>

        consider a current CPU with around 800MHz - 1 GHz,

        consider a current CPU with around 800MHz - 1 GHz,

        and at least 512MB RAM. This is probably the

        and at least 512MB RAM. This is probably the

        minimum you want for an <emphasis>official</emphasis>

        minimum you want for an <emphasis>official</emphasis>

        site.

        site.

      </para>

      </para>

      <para>

      <para>

        that you need to go for a SMP system.

        that you need to go for a SMP system.

      </para>

      </para>

      <para>

      <para>

        You also want to consider a fast disk subsystem.

        You also want to consider a fast disk subsystem.

        Operations on the CVS repository require a fast

        Operations on the CVS repository require a fast

        controller that has a cache of its own can also

        controller that has a cache of its own can also

      </para>

      </para>

      <para>You can also experiment with enlarging the portion

      <para>You can also experiment with enlarging the portion

        of system memory which is used for the file system buffer cache.

        of system memory which is used for the file system buffer cache.

      <title>Services to offer</title>

      <title>Services to offer</title>

      <para>

      <para>

        Every mirror site is required to have a set of core services

        Every mirror site is required to have a set of core services

        server administrators may choose to offer.  This section explains

        server administrators may choose to offer.  This section explains

        which services you can provide and how to go about implementing them.

        which services you can provide and how to go about implementing them.

      </para>

      </para>

        <title>FTP (required for FTP fileset)</title>

        <title>FTP (required for FTP fileset)</title>

        <para>

        <para>

          This is one of the most basic services, and

          This is one of the most basic services, and

          FTP distributions. FTP access must be

          FTP distributions. FTP access must be

          anonymous, and no upload/download ratios

          anonymous, and no upload/download ratios

          are allowed (a ridiculous thing anyway).

          are allowed (a ridiculous thing anyway).

          FreeBSD's <application>ftpd</application>, <application>proftpd</application>,

          FreeBSD's <application>ftpd</application>, <application>proftpd</application>,

          <application>wu-ftpd</application> and maybe <application>ncftpd</application>

          <application>wu-ftpd</application> and maybe <application>ncftpd</application>

          are among the most commonly ones.

          are among the most commonly ones.

        </para>

        </para>

      </sect3>

      </sect3>

      <sect3 id="mirror-serv-rsync">

      <sect3 id="mirror-serv-rsync">

        <title>RSYNC (optional for FTP fileset)</title>

        <title>RSYNC (optional for FTP fileset)</title>

        <para>

        <para>

          bandwidth friendly, as only differences between files

          bandwidth friendly, as only differences between files

          each instance. The size depends on the size of

          each instance. The size depends on the size of

          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,

          <command>ssh</command> (now default) as a transport,

          or use it's own protocol for stand-alone access

          or use it's own protocol for stand-alone access

            <listitem>

            <listitem>

              <para><filename role="package">www/thttpd</filename>:

              <para><filename role="package">www/thttpd</filename>:

                you may find that using an application such as tHttpd is more

                you may find that using an application such as tHttpd is more

                efficient than Apache. It is optimized for excellent performance

                efficient than Apache. It is optimized for excellent performance

                on FreeBSD.</para>

                on FreeBSD.</para>

        <title>CVSup (desired for CVS repository)</title>

        <title>CVSup (desired for CVS repository)</title>

        <para>

        <para>

          <application>CVSup</application> is a very efficient way of distributing files.

          <application>CVSup</application> is a very efficient way of distributing files.

          the CVS repository via <application>AnonCVS</application>, FTP,

          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. 

          people would benefit much more from <application>CVSup</application> access. 

          It is a bit tricky to install on non-FreeBSD platforms, 

          It is a bit tricky to install on non-FreeBSD platforms, 

          since it is written in Modula-3 and therefore requires

          since it is written in Modula-3 and therefore requires

          a Modula-3 environment. John Polstra has built a 

          a Modula-3 environment. John Polstra has built a 

          run <application>CVSup</application>, and can be installed much easier. 

          run <application>CVSup</application>, and can be installed much easier. 

          See <ulink url="http://www.polstra.com/projects/freeware/ezm3/">Ezm3</ulink>

          See <ulink url="http://www.polstra.com/projects/freeware/ezm3/">Ezm3</ulink>

          for details. Related ports are:

          for details. Related ports are:

            </listitem>

            </listitem>

            <listitem>

            <listitem>

              <para><filename role="package">net/cvsup-mirror</filename>: The CVSup mirror kit, which requires

              <para><filename role="package">net/cvsup-mirror</filename>: The CVSup mirror kit, which requires

              </para>

              </para>

            </listitem>

            </listitem>

          </itemizedlist>

          </itemizedlist>

          <filename role="package">net/cvsup-without-gui</filename> you might want to have

          <filename role="package">net/cvsup-without-gui</filename> you might want to have

          a look at. If you prefer a static binary package, take a look 

          a look at. If you prefer a static binary package, take a look 

          <ulink url="http://people.FreeBSD.org/~jdp/s1g/">here</ulink>.

          <ulink url="http://people.FreeBSD.org/~jdp/s1g/">here</ulink>.

          in <application>CVSup</application>. Maybe

          in <application>CVSup</application>. Maybe

          John will setup a generic download-site to get

          John will setup a generic download-site to get

          static binaries for various platforms.

          static binaries for various platforms.

        </para>

        </para>

        <para> 

        <para> 

          It is possible to use CVSup to offer

          It is possible to use CVSup to offer

          client, since it needs to compare lots of files.

          client, since it needs to compare lots of files.

        </para>

        </para>

      </sect3>

      </sect3>

      <sect3 id="mirror-anoncvs">

      <sect3 id="mirror-anoncvs">

        <title>AnonCVS (optional for CVS repository)</title>

        <title>AnonCVS (optional for CVS repository)</title>

        <para>

        <para>

          anonymous CVS access. A short warning first:

          anonymous CVS access. A short warning first:

          what you are doing.

          what you are doing.

        </para>

        </para>

        <para>

        <para>

          to access a CVS repository remotely: via

          to access a CVS repository remotely: via

          <emphasis>pserver</emphasis> or via <command>ssh</command>

          <emphasis>pserver</emphasis> or via <command>ssh</command>

          (we don't consider <command>rsh</command>).

          (we don't consider <command>rsh</command>).

          in the CVS repository, to be used as a login-shell for the

          in the CVS repository, to be used as a login-shell for the

          anonymous ssh account. It does a chroot, and therefore

          anonymous ssh account. It does a chroot, and therefore

          requires the CVS repository to be available under the

          requires the CVS repository to be available under the

          for all sites. If you just offer <emphasis>pserver</emphasis>

          for all sites. If you just offer <emphasis>pserver</emphasis>

          this restriction does not apply, but you may run with

          this restriction does not apply, but you may run with

          more security risks. You don't need to install any special

          more security risks. You don't need to install any special

          <programlisting>

          <programlisting>

cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --allow-root=/home/ncvs pserver

cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --allow-root=/home/ncvs pserver

          </programlisting>

          </programlisting>

          preferably called <username>anoncvs</username>.

          preferably called <username>anoncvs</username>.

          Also you need to create a file <filename>passwd</filename>

          Also you need to create a file <filename>passwd</filename>

          in your <filename>/home/ncvs/CVSROOT</filename> and assign a 

          in your <filename>/home/ncvs/CVSROOT</filename> and assign a 

          CVS password (empty or <literal>anoncvs</literal>) to that user.

          CVS password (empty or <literal>anoncvs</literal>) to that user.

          The directory <filename>/anoncvstmp</filename> is a special

          The directory <filename>/anoncvstmp</filename> is a special

          purpose memory based file system. It is not required but

          purpose memory based file system. It is not required but

          structure in your <filename>/tmp</filename> which is

          structure in your <filename>/tmp</filename> which is

          Here is an excerpt from <filename>/etc/fstab</filename>,

          Here is an excerpt from <filename>/etc/fstab</filename>,

          how to set up such a MFS:

          how to set up such a MFS:

          <programlisting>

          <programlisting>

   </sect2>

   </sect2>

  </sect1>

  </sect1>

  <sect1 id="mirror-howto">

  <sect1 id="mirror-howto">

    <para>

    <para>

      the services, but not how to get it. :-)

      the services, but not how to get it. :-)

      This section explains how to actually mirror

      This section explains how to actually mirror

      the various parts of FreeBSD, what tools to use,

      the various parts of FreeBSD, what tools to use,

    <sect2 id="mirror-ftp">

    <sect2 id="mirror-ftp">

    <title>FTP</title>

    <title>FTP</title>

      <para>

      <para>

        of checked-out source trees, the <emphasis>ISO Images</emphasis>

        of checked-out source trees, the <emphasis>ISO Images</emphasis>

        to write CD-ROMs with the installation distribution,

        to write CD-ROMs with the installation distribution,

      </para>

      </para>

      <sect3 id="mirror-ftp-ftp">

      <sect3 id="mirror-ftp-ftp">

        <title>With FTP mirror</title>

        <title>With FTP mirror</title>

        <para>

        <para>

          You can use a <application>FTP mirror</application>

          You can use a <application>FTP mirror</application>

          <itemizedlist>

          <itemizedlist>

            <listitem><para><filename role="package">ftp/mirror</filename></para></listitem>

            <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/ftpmirror</filename></para></listitem>

          <filename role="package">ftp/mirror</filename> was very popular, but seemed

          <filename role="package">ftp/mirror</filename> was very popular, but seemed

          to have some drawbacks, as it is written in &man.perl.1;,

          to have some drawbacks, as it is written in &man.perl.1;,

        </para>

        </para>

        <para>

        <para>

          a large TCP congestion window. 

          a large TCP congestion window. 

        </para>

        </para>

      </sect3>

      </sect3>

      <sect3 id="mirror-ftp-rsync">

      <sect3 id="mirror-ftp-rsync">

        <title>With RSYNC</title>

        <title>With RSYNC</title>

        <para>

        <para>

          You can install the port <filename role="package">net/rsync</filename> and then use

          You can install the port <filename role="package">net/rsync</filename> and then use

          rsync to sync with your upstream host. 

          rsync to sync with your upstream host. 

          <application>rsync</application> is already mentioned

          <application>rsync</application> is already mentioned

          in <xref linkend="mirror-serv-rsync">.

          in <xref linkend="mirror-serv-rsync">.

          Since <application>rsync</application> access is not 

          Since <application>rsync</application> access is not 

          <note>

          <note>

            <para>

            <para>

              Since the number of <application>rsync</application> 

              Since the number of <application>rsync</application> 

              clients will have a significant impact on the server

              clients will have a significant impact on the server

              machine, most admins impose limitations on their

              machine, most admins impose limitations on their

              an exception for your host (since you are a mirror).

              an exception for your host (since you are a mirror).

            </para>

            </para>

          </note>

          </note>

		  be aware that the module-directory (here "FreeBSD")

		  be aware that the module-directory (here "FreeBSD")

		  will not be created, so you cannot omit the target directory.

		  will not be created, so you cannot omit the target directory.

          Also you might

          Also you might

          via &man.cron.8;.

          via &man.cron.8;.

        </para>

        </para>

      </sect3>

      </sect3>

          A few sites, including the one-and-only <hostid>ftp-master.FreeBSD.org</hostid>

          A few sites, including the one-and-only <hostid>ftp-master.FreeBSD.org</hostid>

          even offer <application>CVSup</application> to mirror the contents of 

          even offer <application>CVSup</application> to mirror the contents of 

          the FTP space. You need to install a <application>cvsup</application>

          the FTP space. You need to install a <application>cvsup</application>

          (Also reread <xref linkend="mirror-serv-cvsup">.)

          (Also reread <xref linkend="mirror-serv-cvsup">.)

          looks like this:

          looks like this:

          <programlisting>

          <programlisting>

          #

          #

          </programlisting>

          </programlisting>

          It seems <application>CVSup</application> would be the best

          It seems <application>CVSup</application> would be the best

          <note id="mirror-cvsup-s-option">

          <note id="mirror-cvsup-s-option">

            <para>

            <para>

              Please have look at the <application>CVSup</application> documentation

              Please have look at the <application>CVSup</application> documentation

    <sect2 id="mirror-cvs">

    <sect2 id="mirror-cvs">

      <title>Mirroring the CVS repository</title>

      <title>Mirroring the CVS repository</title>

      <para>

      <para>

      </para>

      </para>

      <sect3 id="mirror-cvs-cvsup">

      <sect3 id="mirror-cvs-cvsup">

        <title>Using CVSup</title>

        <title>Using CVSup</title>

        </para>

        </para>

        <note>

        <note>

          <para>

          <para>

            mentioned in <link linkend="mirror-cvsup-s-option">this note</link>

            mentioned in <link linkend="mirror-cvsup-s-option">this note</link>

            above.

            above.

          </para>

          </para>

            <listitem><para>maybe even <application>HTTP</application></para></listitem>

            <listitem><para>maybe even <application>HTTP</application></para></listitem>

          </itemizedlist>

          </itemizedlist>

          and it's deficiencies caused John Polstra to develop

          and it's deficiencies caused John Polstra to develop

          it is clearly not recommended.

          it is clearly not recommended.

          <important>

          <important>

            <para>

            <para>

              You can <emphasis>NOT</emphasis> use AnonCVS to 

              You can <emphasis>NOT</emphasis> use AnonCVS to 

              you to access the repository itself, but only checked

              you to access the repository itself, but only checked

              out versions of the modules.

              out versions of the modules.

            </para>

            </para>

    <sect2 id="mirror-www">

    <sect2 id="mirror-www">

      <title>Mirroring the WWW pages</title>

      <title>Mirroring the WWW pages</title>

      <para>

      <para>

        distribution from CVS. If you have a local mirror of the

        distribution from CVS. If you have a local mirror of the

        <screen>&prompt.user; <userinput>cvs -d /home/ncvs co www</userinput></screen>

        <screen>&prompt.user; <userinput>cvs -d /home/ncvs co www</userinput></screen>

        and a <emphasis>cronjob</emphasis>, that calls <command>cvs up -d -P</command>

        and a <emphasis>cronjob</emphasis>, that calls <command>cvs up -d -P</command>

        on a regular basis, maybe just after your repository was updated.

        on a regular basis, maybe just after your repository was updated.

        for public WWW access. The installation and configuration of a 

        for public WWW access. The installation and configuration of a 

        webserver is not discussed here.

        webserver is not discussed here.

      </para>

      </para>

      <note><para>For the website to be visible, users must execute the &man.make.1;

      <note><para>For the website to be visible, users must execute the &man.make.1;

        command in the main <filename>www</filename> directory.  This command

        command in the main <filename>www</filename> directory.  This command

        will create the standard <filename>*.html</filename> files for web

        will create the standard <filename>*.html</filename> files for web

        <filename role="package">textproc/docproj</filename> port must be

        <filename role="package">textproc/docproj</filename> port must be

        installed.</para></note>

        installed.</para></note>

      <para>

      <para>

        </programlisting>

        </programlisting>

     </para>

     </para>

     <para>

     <para>

       probably not recommended.

       probably not recommended.

     </para>

     </para>

     <sect3 id="mirror-www-doc">

     <sect3 id="mirror-www-doc">

       <title>Mirroring the FreeBSD documentation</title>

       <title>Mirroring the FreeBSD documentation</title>

       <para>

       <para>

         FreeBSD documentation as well. However, this is not

         FreeBSD documentation as well. However, this is not

       </para>

       </para>

       <para>

       <para>

         First of all, you should get the doc sources,

         First of all, you should get the doc sources,

       </para>

       </para>

       <para>

       <para>

         Then you need to install a couple of ports.

         Then you need to install a couple of ports.

         <filename role="package">textproc/docproj</filename> to do the work

         <filename role="package">textproc/docproj</filename> to do the work

         environment variables, like

         environment variables, like

         (copy <filename>/etc/defaults/make.conf</filename> if

         (copy <filename>/etc/defaults/make.conf</filename> if

         <literal>DOC_LANG</literal> variable.

         <literal>DOC_LANG</literal> variable.

         Now you are probably ready to run <command>make</command>

         Now you are probably ready to run <command>make</command>

         in you doc directory (<filename>/usr/share/doc</filename>

         in you doc directory (<filename>/usr/share/doc</filename>

         by default) and build the documentation.

         by default) and build the documentation.

         Again you need to make it accessible for your webserver

         Again you need to make it accessible for your webserver

         <important>

         <important>

           <para>

           <para>

             The building of the documentation, as well as lots

             The building of the documentation, as well as lots

             of side issues, is documented itself in:

             of side issues, is documented itself in:

             <ulink url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/fdp-primer/">fdp-primer</ulink>.

             <ulink url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/fdp-primer/">fdp-primer</ulink>.

             Please read this piece of documentation, especially if you

             Please read this piece of documentation, especially if you

           </para>

           </para>

         </important>

         </important>

         <note>

         <note>

     <para>

     <para>

       Every mirror should be updated on a regular

       Every mirror should be updated on a regular

       basis. You will certainly need some script

       basis. You will certainly need some script

       &man.cron.8;. Since nearly every admin

       &man.cron.8;. Since nearly every admin

       does this his own way, we cannot give

       does this his own way, we cannot give

       specific instructions. It could work

       specific instructions. It could work

       </step>

       </step>

       <step>

       <step>

         <para>

         <para>

           messages are logged to a file.

           messages are logged to a file.

         </para>

         </para>

       </step>

       </step>

       <step>

       <step>

         <para>

         <para>

         </para>

         </para>

       </step>

       </step>

       <step>

       <step>

         <para>

         <para>

         </para>

         </para>

       </step>

       </step>

     </procedure>

     </procedure>

    <title>Where to mirror from</title>

    <title>Where to mirror from</title>

    <para>

    <para>

      This is an important issue. So this section will

      This is an important issue. So this section will

    </para>

    </para>

    <sect2 id="mirror-where-organization">

    <sect2 id="mirror-where-organization">

      <title>A few words about the organization</title>

      <title>A few words about the organization</title>

      <para>

      <para>

        Mirrors are organized by country. All

        Mirrors are organized by country. All

        official mirrors have a DNS entry of the form

        official mirrors have a DNS entry of the form

        telling that the host would be the <emphasis>Nth</emphasis>

        telling that the host would be the <emphasis>Nth</emphasis>

        mirror in that country.

        mirror in that country.

        (Same applies to <hostid>cvsupN.CC.FreeBSD.org</hostid>,

        (Same applies to <hostid>cvsupN.CC.FreeBSD.org</hostid>,

        <hostid>wwwN.CC.FreeBSD.org</hostid>, etc.)

        <hostid>wwwN.CC.FreeBSD.org</hostid>, etc.)

        There are mirrors with no <emphasis>CC</emphasis> part.

        There are mirrors with no <emphasis>CC</emphasis> part.

      </para>

      </para>

      <para>

      <para>

        Additionally there exists a hierarchy of mirrors, which

        Additionally there exists a hierarchy of mirrors, which

        described as <emphasis>Tier-0</emphasis>. Mirrors

        described as <emphasis>Tier-0</emphasis>. Mirrors

        that mirror from these sites can be considered

        that mirror from these sites can be considered

        <emphasis>Tier-1</emphasis>, mirrors of <emphasis>Tier-1</emphasis>-mirrors,

        <emphasis>Tier-1</emphasis>, mirrors of <emphasis>Tier-1</emphasis>-mirrors,

        are <emphasis>Tier-2</emphasis>, etc. 

        are <emphasis>Tier-2</emphasis>, etc. 

        Official sites are encouraged to be of a low <emphasis>tier</emphasis>,

        Official sites are encouraged to be of a low <emphasis>tier</emphasis>,

        terms as described in <xref linkend="mirror-requirements">.

        terms as described in <xref linkend="mirror-requirements">.

        access to master sites is definitely restricted.

        access to master sites is definitely restricted.

        The <emphasis>tier</emphasis>-hierarchy is not reflected

        The <emphasis>tier</emphasis>-hierarchy is not reflected

        like 1-4, are usually <emphasis>Tier-1</emphasis>

        like 1-4, are usually <emphasis>Tier-1</emphasis>

      </para>

      </para>

    </sect2>

    </sect2>

    <sect2 id="mirror-where-where">

    <sect2 id="mirror-where-where">

      <title>Ok, but where should I get the stuff now?</title>

      <title>Ok, but where should I get the stuff now?</title>

      <para>

      <para>

        The short answer is: from the

        The short answer is: from the

        the fastest access. 

        the fastest access. 

      </para>

      </para>

      <sect3 id="mirror-where-simple">

      <sect3 id="mirror-where-simple">

          </step>

          </step>

          <step>

          <step>

            <para>

            <para>

              (number of hops, round-trip-times)

              (number of hops, round-trip-times)

              and offer the services you intend to

              and offer the services you intend to

              use (like <application>rsync</application>

              use (like <application>rsync</application>

          </step>

          </step>

          <step>

          <step>

            <para>

            <para>

              policies.

              policies.

            </para>

            </para>

          </step>

          </step>

        <para>

        <para>

          In general the description in <xref linkend="mirror-where-simple">

          In general the description in <xref linkend="mirror-where-simple">

          still applies. Of course you may want to put some

          still applies. Of course you may want to put some

          a low tier.

          a low tier.

          There are some other considerations about <emphasis>official</emphasis>

          There are some other considerations about <emphasis>official</emphasis>

        </para>

        </para>

      </sect3>

      </sect3>

      <sect3 id="mirror-where-master">

      <sect3 id="mirror-where-master">

        <title>I want to access the master sites!</title>

        <title>I want to access the master sites!</title>

        <para>

        <para>

          you may want and get access to one of the 

          you may want and get access to one of the 

          master sites. Access to these sites is 

          master sites. Access to these sites is 

          generally restricted, and there are special policies

          generally restricted, and there are special policies

          for access. If you are already an <emphasis>official</emphasis>

          for access. If you are already an <emphasis>official</emphasis>

          In any other case make sure your country really needs another mirror.

          In any other case make sure your country really needs another mirror.

        </para>

        </para>

        <para>

        <para>

          one for the CVS repository (the webpages and docs are

          one for the CVS repository (the webpages and docs are

        </para>

        </para>

        <sect4 id="mirror-where-master-ftp">

        <sect4 id="mirror-where-master-ftp">

          <title>ftp-master.FreeBSD.org</title>

          <title>ftp-master.FreeBSD.org</title>

            access for the FTP contents, since they are

            access for the FTP contents, since they are

            <emphasis>Tier-1</emphasis>-mirrors.

            <emphasis>Tier-1</emphasis>-mirrors.

          </para>

          </para>

        </sect4>

        </sect4>

        <sect4 id="mirror-where-master-cvsup">

        <sect4 id="mirror-where-master-cvsup">

          <title>cvsup-master.FreeBSD.org</title>

          <title>cvsup-master.FreeBSD.org</title>

      <important>

      <important>

        <para>It is <emphasis>very</emphasis> important for a hub administrator, especially

        <para>It is <emphasis>very</emphasis> important for a hub administrator, especially

          Tier-1 hub admins, to check the

          Tier-1 hub admins, to check the

          for the next FreeBSD release. This is important because it will tell you when the

          for the next FreeBSD release. This is important because it will tell you when the

          next release is scheduled

          next release is scheduled

          to come out, and thus giving you time to prepare for the big spike of traffic which follows it.

          to come out, and thus giving you time to prepare for the big spike of traffic which follows it.

        </para>

        </para>

        <para>

        <para>

          possible (again, even more crucial for Tier-1 mirrors). If Mirror1 doesn't update for a

          possible (again, even more crucial for Tier-1 mirrors). If Mirror1 doesn't update for a

          while, lower tier mirrors will begin to mirror old data from Mirror1 and thus begins

          while, lower tier mirrors will begin to mirror old data from Mirror1 and thus begins

          a downward spiral... Keep your mirrors up to date!

          a downward spiral... Keep your mirrors up to date!

      <para>

      <para>

        An interesting question, especially, since the state

        An interesting question, especially, since the state

        of being official comes with some benefits, like a much

        of being official comes with some benefits, like a much

        to a master site.

        to a master site.

      </para>

      </para>

      <para>

      <para>

        another official mirror is really needed for

        another official mirror is really needed for

      </para>

      </para>

      <para>Ok, here is how to do it:</para>

      <para>Ok, here is how to do it:</para>

      <procedure>

      <procedure>

        </step>

        </step>

        <step>

        <step>

          <para>

          <para>

            site. The admin should able to be contacted via

            site. The admin should able to be contacted via

            in <xref linkend="mirror-where-organization">.

            in <xref linkend="mirror-where-organization">.

          </para>

          </para>

          <para>

          <para>

          </para>

          </para>

        </step>

        </step>

        <step>

        <step>

          <para>

          <para>

            <ulink url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook">FreeBSD

            <ulink url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook">FreeBSD

          </para>

          </para>

        </step> 

        </step> 

      </procedure>

      </procedure>

    </sect2>

    </sect2>

  </sect1>

  </sect1>

  <sect1 id="mirror-statpages">

  <sect1 id="mirror-statpages">