FreeBSD hub administrators guide to mirroring.
Purpose: To have a centralized location for all information relating to mirroring FreeBSD. This document will be worked on and maintained by me, and members of freebsd-hubs@. Written by:i Jun Kuriyama <kuriyama@FreeBSD.org> Converted by: Valentino Vaschetto <logo@FreeBSD.org>
This commit is contained in:
parent
f9a863759b
commit
a821118a25
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=12041
2 changed files with 144 additions and 0 deletions
16
en_US.ISO8859-1/articles/hubs/Makefile
Normal file
16
en_US.ISO8859-1/articles/hubs/Makefile
Normal file
|
@ -0,0 +1,16 @@
|
||||||
|
# $FreeBSD$
|
||||||
|
|
||||||
|
DOC?= article
|
||||||
|
|
||||||
|
FORMATS?= html
|
||||||
|
|
||||||
|
INSTALL_COMPRESSED?=gz
|
||||||
|
INSTALL_ONLY_COMPRESSED?=
|
||||||
|
|
||||||
|
JADEFLAGS+= -V %generate-article-toc%
|
||||||
|
|
||||||
|
SRCS= article.sgml
|
||||||
|
|
||||||
|
DOC_PREFIX?= ${.CURDIR}/../../..
|
||||||
|
|
||||||
|
.include "${DOC_PREFIX}/share/mk/doc.project.mk"
|
128
en_US.ISO8859-1/articles/hubs/article.sgml
Normal file
128
en_US.ISO8859-1/articles/hubs/article.sgml
Normal file
|
@ -0,0 +1,128 @@
|
||||||
|
<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
|
||||||
|
<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
|
||||||
|
%man;
|
||||||
|
<!ENTITY % authors PUBLIC "-//FreeBSD//ENTITIES DocBook Author Entities//EN">
|
||||||
|
%authors;
|
||||||
|
<!ENTITY % not.published "IGNORE">
|
||||||
|
]>
|
||||||
|
|
||||||
|
<article>
|
||||||
|
<articleinfo>
|
||||||
|
<title>Mirroring FreeBSD</title>
|
||||||
|
<pubdate>$FreeBSD$</pubdate>
|
||||||
|
<authorgroup>
|
||||||
|
<author>
|
||||||
|
<firstname>Jun</firstname>
|
||||||
|
<surname>Kuriyama</surname>
|
||||||
|
<affiliation>
|
||||||
|
<address><email>kuriyama@FreeBSD.org</email></address>
|
||||||
|
</affiliation>
|
||||||
|
</author>
|
||||||
|
<author>
|
||||||
|
<firstname>Valentino</firstname>
|
||||||
|
<surname>Vaschetto</surname>
|
||||||
|
<affiliation>
|
||||||
|
<address><email>logo@FreeBSD.org</email></address>
|
||||||
|
</affiliation>
|
||||||
|
</author>
|
||||||
|
</authorgroup>
|
||||||
|
<abstract>
|
||||||
|
<para>An in-progress article on how to mirror FreeBSD, aimed at
|
||||||
|
hub administrators</para>
|
||||||
|
</abstract>
|
||||||
|
</articleinfo>
|
||||||
|
|
||||||
|
<sect1 id="mirror-howtomirror">
|
||||||
|
<title>How to mirror FreeBSD</title>
|
||||||
|
<sect2 id="mirror-ftp">
|
||||||
|
<title>FTP</title>
|
||||||
|
<para>At this time (just before 4.5-RELEASE), full mirror
|
||||||
|
requires 65GB disk space. For safety, 70-80GB will be
|
||||||
|
required</para>
|
||||||
|
<para>An anonymous ftp mirror requires network bandwidth.
|
||||||
|
It is not encouraged if your site does not have enough
|
||||||
|
spare bandwidth</para>
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para>Choose favorite ftp mirror tool (such as
|
||||||
|
<port>ftp/mirror</port>, <port>ftp/ftpmirror</port>
|
||||||
|
, <port>ftp/spegla</port> and so on.)</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>Select upstream. First candidate is your
|
||||||
|
local mirror (ftpX.XX.FreeBSD.org). If there is no
|
||||||
|
official mirror in your country, use ftpX.FreeBSD.org
|
||||||
|
instead. (X stands for a number, and XX stands for
|
||||||
|
your local country code)</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>Setting up your mirror configuration.</para>
|
||||||
|
</listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
</sect2>
|
||||||
|
<sect2 id="mirror-cvsup">
|
||||||
|
<title>CVSup</title>
|
||||||
|
<para>At this time (01/29/2002), full CVSup mirror requires
|
||||||
|
3GB disk space. For safety, 4-5GB will be required.</para>
|
||||||
|
<para>Public CVSup mirror requires high disk activity. It
|
||||||
|
is encouraged to use RAID-0 or RAID-5.</para>
|
||||||
|
<para>You can setting up CVSup mirror configuration by
|
||||||
|
<port>net/cvsup-mirror</port> port.</para>
|
||||||
|
<para>Upstream selection is same as ftp. First candidate is
|
||||||
|
your local CVSup mirror (ftp?.??.FreeBSD.org). Next is
|
||||||
|
ftp?.FreeBSD.org.</para>
|
||||||
|
</sect2>
|
||||||
|
<sect2 id="mirror-www">
|
||||||
|
<title>WWW</title>
|
||||||
|
<para>At this time (01/29/2002), full www mirror requires
|
||||||
|
150MB disk space. For safety, 200MB will be required</para>
|
||||||
|
</sect2>
|
||||||
|
</sect1>
|
||||||
|
|
||||||
|
<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>
|
||||||
|
<listitem>
|
||||||
|
<para>ftp-master.FreeBSD.org: <email>peter@FreeBSD.org</email></para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>cvsup-master.FreeBSD.org: <email>jdp@FreeBSD.org</email></para>
|
||||||
|
</listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
<sect2 id="mirror-ftpmaster">
|
||||||
|
<title>About ftp-master.FreeBSD.org</title>
|
||||||
|
<para>ftp-master.FreeBSD.org provides rsync and CVSup
|
||||||
|
access rather in addition to ftp protocol.</para>
|
||||||
|
<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
|
||||||
|
*default base=/ftp-master
|
||||||
|
*default prefix=/ftp-master/pub
|
||||||
|
*default delete use-rel-suffix
|
||||||
|
|
||||||
|
FreeBSD-archive release=all preserve</programlisting>
|
||||||
|
</sect2>
|
||||||
|
</sect1>
|
||||||
|
</article>
|
||||||
|
|
||||||
|
<!--
|
||||||
|
Local Variables:
|
||||||
|
mode: sgml
|
||||||
|
sgml-indent-data: t
|
||||||
|
sgml-omittag: nil
|
||||||
|
sgml-always-quote-attributes: t
|
||||||
|
End:
|
||||||
|
-->
|
Loading…
Reference in a new issue