diff --git a/en_US.ISO8859-1/articles/hubs/article.sgml b/en_US.ISO8859-1/articles/hubs/article.sgml index 27030ef7dc..bece5d1642 100644 --- a/en_US.ISO8859-1/articles/hubs/article.sgml +++ b/en_US.ISO8859-1/articles/hubs/article.sgml @@ -25,10 +25,10 @@ - Valentino + Valentino Vaschetto -
logo@FreeBSD.org
+
logo@FreeBSD.org
@@ -120,10 +120,10 @@ which is determined by the server's policy. It is also affected by the types of services you want to offer. Plain FTP or HTTP services may not require a huge - amount of resources. Watch out if you provide + amount of resources. Watch out if you provide CVSup, rsync or even AnonCVS. This can have a huge 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 indeed consume some CPU. For AnonCVS it might be a nice idea to set up a memory resident file system (MFS) of at least 300 MB, so you need to take this into account @@ -222,14 +222,14 @@ RSYNC (optional for FTP fileset) rsync 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 + 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. rsync 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 + the synced module in terms of the number of directories and files. rsync can use rsh and ssh (now default) as a transport, or use its own protocol for stand-alone access @@ -290,13 +290,13 @@ offering it via CVSup. It is possible to offer the CVS repository via AnonCVS, FTP, Rsync or HTTP, but - people would benefit much more from CVSup access. + people would benefit much more from CVSup access. CVSup was developed by &a.jdp;. - 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 - a Modula-3 environment. John Polstra has built a + a Modula-3 environment. John Polstra has built a stripped down version of M3 that is sufficient to - run CVSup, and can be installed much easier. + run CVSup, and can be installed much easier. See Ezm3 for details. Related ports are: @@ -315,18 +315,18 @@ There are a few more like net/cvsup-without-gui 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 here. This page still refers to the S1G bug that was present in CVSup. Maybe John will set up a generic download-site to get static binaries for various platforms. - + It is possible to use CVSup to offer - any kind of fileset, not just CVS repositories, + any kind of fileset, not just CVS repositories, but configuration can be complex. - CVSup is known to eat some CPU on both the server and the + CVSup is known to eat some CPU on both the server and the client, since it needs to compare lots of files. @@ -364,14 +364,14 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all See the manpage for details of the options. Also see the CVS info page about additional ways to make sure access is read-only. - It is advised that you create an unprivileged account, + It is advised that you create an unprivileged account, preferably called anoncvs. Also you need to create a file passwd - in your /home/ncvs/CVSROOT and assign a + in your /home/ncvs/CVSROOT and assign a CVS password (empty or anoncvs) to that user. The directory /anoncvstmp is a special purpose memory based file system. It is not required but - advised since &man.cvs.1; creates a shadow directory + advised since &man.cvs.1; creates a shadow directory structure in your /tmp which is not used after the operation but slows things dramatically if real disk operations are required. @@ -399,7 +399,7 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all The FTP area is the largest amount of data that needs to be mirrored. It includes the distribution - sets required for network installation, the + sets required for network installation, the branches which are actually snapshots of checked-out source trees, the ISO Images to write CD-ROMs with the installation distribution, @@ -435,7 +435,7 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all In general FTP is not really good for mirroring. It transfers the whole file if it has changed, and does not create a single data stream which would benefit from - a large TCP congestion window. + a large TCP congestion window. @@ -443,16 +443,16 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all A better way to mirror the FTP area is rsync. You can install the port net/rsync and then use - rsync to sync with your upstream host. + rsync to sync with your upstream host. rsync is already mentioned in . - Since rsync access is not + Since rsync access is not required, your preferred upstream site may not allow it. You may need to hunt around a little bit to find a site that allows rsync access. - Since the number of rsync + Since the number of rsync clients will have a significant impact on the server machine, most admins impose limitations on their server. For a mirror, you should ask the site maintainer @@ -479,7 +479,7 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all With CVSup A few sites, including the one-and-only ftp-master.FreeBSD.org - even offer CVSup to mirror the contents of + even offer CVSup to mirror the contents of the FTP space. You need to install a cvsup client, preferably from the port net/cvsup. (Also reread .) @@ -561,7 +561,7 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all Using other methods Using other methods than CVSup is - generally not recommended. We describe them in short here + generally not recommended. We describe them in short here anyway. Since most sites offer the CVS repository as part of the FTP fileset under the path /pub/FreeBSD/development/FreeBSD-CVS, @@ -580,7 +580,7 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all - You can NOT use AnonCVS to + You can NOT 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. @@ -599,10 +599,10 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all and a cronjob, that calls cvs up -d -P on a regular basis, maybe just after your repository was updated. Of course, the files need to remain in a directory available - 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. - + For the website to be visible, users must execute the &man.make.1; command in the main www directory. This command will create the standard *.html files for web @@ -610,7 +610,7 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all textproc/docproj port must be installed. - If you don't have a local repository, you can use + If you don't have a local repository, you can use CVSup to maintain an up to date copy of the www pages. A sample supfile can be found in /usr/share/examples/cvsup/www-supfile and @@ -639,8 +639,8 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all Mirroring the FreeBSD documentation - Since the documentation is referenced a lot from the - webpages, it is recommended that you mirror the + Since the documentation is referenced a lot from the + webpages, it is recommended that you mirror the FreeBSD documentation as well. However, this is not as trivial as the www-pages alone. @@ -670,7 +670,7 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all Then you need to install a couple of ports. You are lucky, there is a meta-port: textproc/docproj to do the work - for you. You need to set up some + for you. You need to set up some environment variables, like SGML_CATALOG_FILES. Also have a look at your /etc/make.conf @@ -704,7 +704,7 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all Every mirror should be updated on a regular basis. You will certainly need some script - framework for it that will be called by + framework for it that will be called by &man.cron.8;. Since nearly every admin does this his own way, we cannot give specific instructions. It could work @@ -787,14 +787,14 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all Additionally there exists a hierarchy of mirrors, which - is described in terms of tiers. + is described in terms of tiers. The master sites are not referred to but can be described as Tier-0. Mirrors that mirror from these sites can be considered Tier-1, mirrors of Tier-1-mirrors, - are Tier-2, etc. + are Tier-2, etc. Official sites are encouraged to be of a low tier, - but the lower the tier the higher the requirements in + but the lower the tier the higher the requirements in terms as described in . Also access to low-tier-mirrors may be restricted, and access to master sites is definitely restricted. @@ -812,7 +812,7 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all role="fqdn">ftp.FreeBSD.org. The short answer is: from the site that is closest to you in Internet terms, or gives you - the fastest access. + the fastest access. I just want to mirror from somewhere! @@ -867,8 +867,8 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all I want to access the master sites! If you have good reasons and good prerequisites, - you may want and get access to one of the - master sites. Access to these sites is + you may want and get access to one of the + master sites. Access to these sites is generally restricted, and there are special policies for access. If you are already an official mirror, this certainly helps you getting access. @@ -891,7 +891,7 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all ftp-master.FreeBSD.org - This is the master site for the FTP fileset. + This is the master site for the FTP fileset. ftp-master.FreeBSD.org provides @@ -972,8 +972,8 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all The following applies mainly to the FTP fileset, - since a CVS repository should always be mirrored - completely, and the webpages are a case of + since a CVS repository should always be mirrored + completely, and the webpages are a case of its own. @@ -983,7 +983,7 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all carry the complete fileset allow access to other mirror sites - provide FTP and + provide FTP and RSYNC access @@ -1038,7 +1038,7 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all If everything works so far, contact the DNS administrator responsible for your region/country, and ask for a DNS entry for your site. The admin should able to be contacted via - hostmaster@CC.FreeBSD.org, where + hostmaster@CC.FreeBSD.org, where CC is your country code/TLD. Your DNS entry will be as described in . @@ -1058,7 +1058,7 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all FreeBSD Handbook. - + That is it. @@ -1078,7 +1078,7 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all - ftp.is.FreeBSD.org - hostmaster@is.FreeBSD.org - + ftp.is.FreeBSD.org - hostmaster@is.FreeBSD.org - (Bandwidth) (FTP processes) (HTTP processes) @@ -1124,7 +1124,7 @@ cvspserver stream tcp nowait root /usr/bin/cvs cvs -f -l -R -T /anoncvstmp --all -