                       Podderzhka zerkal FreeBSD

  Jun Kuriyama

   <kuriyama@FreeBSD.org>

  Valentino Vaschetto

   <logo@FreeBSD.org>

  Daniel Lang

   <dl@leo.org>

  Ken Smith

   <kensmith@FreeBSD.org>

  Dmitrij Morozovskij

   $FreeBSD: doc/ru_RU.KOI8-R/articles/hubs/article.sgml,v 1.15
   2010/07/15 08:47:10 taras Exp $

   FreeBSD `eto zaregistrirovannaya torgovaya marka FreeBSD
   Foundation.

   CVSup `eto zaregistrirovannaya torgovaya marka John D. Polstra.

   Mnogie iz oboznachenij, ispol'zuemye proizvoditelyami i prodavcami
   dlya oboznacheniya svoih produktov, zayavlyayutsya v kachestve
   torgovyh marok. Kogda takie oboznacheniya poyavlyayutsya v `etom
   dokumente, i Proektu FreeBSD izvestno o torgovoj marke, k
   oboznacheniyu dobavlyaetsya znak ''(TM)'' ili ''(R)''.

   Rabochij variant stat'i, opisyvayuschej process sozdaniya i
   podderzhki zerkala FreeBSD i adresovannoj administratoram zerkal.

     --------------------------------------------------------------

1. Kontaktnaya informaciya

   Koordinatory sistemy zerkal dostupny po `elektronnoj pochte po
   adresu <mirror-admin@FreeBSD.org>. Pomimo `etogo, suschestvuet
   Spisok rassylki, posvyaschionnyj zerkalirovaniyu FreeBSD.

     --------------------------------------------------------------

2. Trebovaniya k zerkalam FreeBSD

  2.1. Diskovoe prostranstvo

   Odnim iz naibolee vazhnyh trebovanij yavlyaetsya diskovoe
   prostranstvo. V zavisimosti ot nabora relizov, arhitektur i
   stepeni polnoty zerkala vam mozhet potrebovat'sya ogromnyj ob"em
   diska. Ne lishnim budet pomnit', chto oficial'noe zerkalo, skoree
   vsego, dolzhno byt' polnym. Repozitorij CVS i veb-stranicy vsegda
   dolzhny zerkalirovat'sya polnost'yu. Krome togo, uchtite, chto
   privodimye ocenki ob"ema otnosyatsya k sostoyaniyu na moment
   poslednego redaktirovaniya dannoj stat'i
   (7.3-RELEASE/8.1-RELEASE). Dal'nejshij process razrabotki i
   posleduyuschie relizy tol'ko uvelichat trebuemyj ob"em. Krome
   togo, razumno budet zarezervirovat' nekotoroe (10-20%)
   dopolnitel'noe prostranstvo spokojstviya radi. Vot nekotorye
   ocenki ob"ema:

     * Polnoe zerkalo FTP: 899 GB

     * Repozitorij CVS: 5.4 GB

     * Komplekt izmenenij CTM: 3.2 GB

     * Veb-stranicy: 463 MB

   Tekuschee ispol'zovanie diska zerkalom FTP mozhno posmotret' na
   ftp://ftp.FreeBSD.org/pub/FreeBSD/dir.sizes.

     --------------------------------------------------------------

  2.2. Trebovaniya k setevoj svyaznosti i propusknoj sposobnosti

   Razumeetsya, u vas dolzhno byt' podklyuchenie k internet.
   Trebuemaya propusknaya sposobnost' vashih kanalov zavisit ot
   predpolagaemogo profilya ispol'zovaniya vashego zerkala. Esli vy
   sobiraetes' kopirovat' nekotorye chasti FreeBSD dlya lokal'nogo
   ispol'zovaniya na vashej mashine ili v intranete, trebovaniya
   mogut byt' mnogo myagche, chem dlya publichnogo zerkala. Dlya
   oficial'nogo zerkala neobhodimaya propusknaya sposobnost'
   uvelichivaetsya esche bol'she. My mozhem dat' lish' ochen' grubye
   ocenki:

     * Zerkalo dlya lokal'nogo dostupa: fakticheski minimum ne
       opredelen, no kanal shirinoj menee 2 Mbps mozhet sdelat'
       process obnovleniya muchitel'no medlennym.

     * Neoficial'noe publichnoe zerkalo: 34 Mbps vyglyadit neploho
       dlya nachala.

     * Oficial'noe zerkalo: rekomenduetsya kanal shirinoj bolee 100
       Mbps; krome togo, vasha mashina dolzhna stoyat' kak mozhno
       blizhe k granichnym marshrutizatoram vashej seti.

     --------------------------------------------------------------

  2.3. Sistemnye trebovaniya, processor i pamyat'

   `Eti trebovaniya v pervuyu ochered' opredelyayutsya maksimal'nym
   ozhidaemym kolichestvom klientov (ustanavlivaetsya administratorom
   servera). Takzhe, na trebuemye resursy vliyaet spisok servisov,
   kotorye vy budete predostavlyat'. Zerkalo FTP i/ili HTTP ne
   trebuyut osobenno mnogo resursov; znachitel'no bol'she pamyati i
   vychislitel'noj proizvoditel'nosti potreblyayut CVSup, rsync ili
   AnonCVS. Osobenno "prozhorlivym" po pamyati yavlyaetsya rsync;
   CVSup trebuet dostatochnoj proizvoditel'nosti processora. Dlya
   predostavleniya dostupa po AnonCVS horoshej ideej budet sozdanie
   virtual'noj fajlovoj sistemy v pamyati (MFS) po krajnej mere 300
   MB razmerom, tak chto uchtite `eto pri planirovanii. Vot nekotorye
   sovety po konfiguracii apparatnoj chasti servera:

   Dlya umerenno poseschaemogo sajta, predostavlyayuschego Rsync,
   mozhno ispol'zovat' processor s chastotoj 800MHz - 1 GHz i po
   krajnej mere 512MB pamyati. Skoree vsego, dannaya konfiguraciya
   mozhet schitat'sya minimal'noj dlya oficial'nogo zerkala.

   Dlya regulyarno poseschaemogo sajta vam potrebuetsya bol'she
   pamyati (horoshim startom budet 2GB) i bol'she processornoj
   moschnosti, chto mozhet oznachat' trebovanie mnogoprocessornoj
   (SMP) platformy.

   Krome togo, vam potrebuetsya bystraya diskovaya podsistema, v
   pervuyu ochered', dlya raboty s repozitoriem CVS (krajne
   rekomenduem RAID). Kontroller SCSI, oborudovannyj sobstvennoj
   pamyat'yu, takzhe mozhet oschutimo uskorit' process, poskol'ku
   bol'shaya chast' servisov svyazana s bol'shim kolichestvom
   diskovyh zaprosov nebol'shogo razmera.

     --------------------------------------------------------------

  2.4. Predostavlyaemye servisy

   Vsyakoe zerkalo dolzhno predostavlyat' nabor osnovnyh servisov.
   Pomimo trebuemogo minimal'nogo nabora, suschestvuyut
   dopolnitel'nye servisy, kotorye administrator servera mozhet
   pozhelat' predostavlyat'. `Etot razdel opisyvaet, kakie servisy vy
   mozhete predostavlyat', i kakie dejstviya dlya `etogo
   potrebuyutsya ot vas.

     --------------------------------------------------------------

    2.4.1. FTP (trebuetsya dlya FTP zerkala)

   `Eto odin iz naibolee bazovyh servisov; ego predostavlenie
   trebuetsya dlya kazhdogo zerkala, rasprostranyayuschego fajly
   FreeBSD po FTP. Dostup po FTP dolzhen byt' anonimnym, i ne dolzhny
   primenyat'sya kakie-libo ogranicheniya po sootnosheniyu ob"ema
   peredano/prinyato (chto voobsche yavlyaetsya, na nash vzglyad,
   strannym podhodom). Zakachka (upload) fajlov na server ne
   trebuetsya (i dolzhna byt' zapreschena v razdele FreeBSD). Krome
   togo, arhiv fajlov FreeBSD dolzhen byt' dostupen s putem
   /pub/FreeBSD.

   Dlya predostavleniya anonimnogo FTP dostupa mozhet byt'
   ispol'zovan celyj ryad programm (perechisleny v alfavitnom
   poryadke):

     * /usr/libexec/ftpd: bazovyj FTP-daemon FreeBSD. Ne zabud'te
       prochitat' ftpd(8).

     * ftp/ncftpd: kommercheskij paket, svoboden dlya ispol'zovaniya
       v uchebnyh celyah.

     * ftp/oftpd: FTP-daemon, napisannyj v osnovnom s tochki zreniya
       zaschischennosti.

     * ftp/proftpd: Modul'nyj i ochen' gibkij FTP-daemon.

     * ftp/pure-ftpd: Esche odin FTP-daemon, razrabotannyj s pozicij
       zaschischennosti.

     * ftp/twoftpd: Sm. predyduschij punkt.

     * ftp/vsftpd: ''ochen' zaschischennyj'' (''very secure'') ftpd.

     * ftp/wu-ftpd: ftpd ot Vashingtonskogo Universiteta (Washington
       University). Neskol'ko poteryal populyarnost' iz-za bol'shogo
       kolichestva najdennyh v proshlom oshibok zaschity. Esli vy
       reshite ispol'zovat' ego, pomnite o neobhodimosti
       otslezhivaniya obnovlenij.

   ftpd, proftpd, wu-ftpd i, vozmozhno, ncftpd yavlyayutsya naibolee
   chasto vstrechayuschimisya FTP serverami. Prochie rasprostraneny
   sredi suschestvuyuschih zerkal v suschestvenno men'shej stepeni.
   Dopolnitel'nym povodom dlya rassmotreniya mozhet yavlyat'sya
   vozmozhnost' gibko ogranichivat' kolichestvo odnovremennyh
   soedinenij, chto pomozhet vam uderzhat' v nuzhnyh ramkah
   potreblenie propusknoj sposobnosti vashih kanalov i mashinnye
   resursy.

     --------------------------------------------------------------

    2.4.2. Rsync (neobyazatel'nyj servis dlya FTP zerkala)

   Rsync chasto ispol'zuetsya dlya predostavleniya dostupa k
   FTP-oblasti FreeBSD, chtoby drugie zerkala mogli
   sinhronizirovat'sya po vashemu. Protokol rsync vo mnogom
   otlichaetsya ot FTP, v chastnosti, on gorazdo gumannee s tochki
   zreniya propusknoj sposobnosti kanalov, poskol'ku ne trebuet
   peredachi izmenennogo fajla celikom (peredayutsya lish'
   razlichiya). Vzamen Rsync trebuet znachitel'nyh ob"emov pamyati.
   Razmer kazhdogo processa zavisit ot razmera sinhroniziruemogo
   modulya (v osnovnom ot kolichestva direktorij i fajlov). Rsync
   mozhet ispol'zovat' v kachestve transportnogo protokola rsh ili
   ssh (po umolchaniyu); takzhe, mozhet ispol'zovat'sya vnutrennij
   protokol rsync (`etot metod predpochtitelen dlya publichnyh
   rsync-serverov). Podderzhivaetsya avtorizaciya klientov i
   razlichnye ogranicheniya. Dlya protokola rsync suschestvuet
   edinstvennyj paket:

     * net/rsync

     --------------------------------------------------------------

    2.4.3. HTTP (trebuetsya dlya veb-stranic, dopolnitelen dlya FTP
    zerkal)

   Esli vy hotite podderzhivat' zerkalo veb-stranic FreeBSD, vam
   potrebuetsya ustanovit' veb-server. Dopolnitel'no, vy mozhete
   predostavlyat' HTTP dostup k FTP-naboru fajlov FreeBSD. Vybor
   veb-servera ostaetsya na usmotrenie administratora zerkala.
   Nekotorye iz naibolee populyarnyh veb-serverov perechisleny nizhe.

     * www/apache13: Apache -- samyj shiroko rasprostranionnyj v
       Internete veb-server, aktivno ispol'zuemyj proektom FreeBSD.
       Vy mozhete takzhe ispol'zovat' veb-server Apache sleduyuschego
       pokoleniya, dostupnyj v kollekcii portov kak www/apache22.

     * www/thttpd: Dlya obsluzhivaniya bol'shogo kolichestva zaprosov
       k staticheskim dokumentam server thttpd mozhet okazat'sya
       bolee `effektivnym, chem Apache. thttpd otlichno optimizirovan
       po proizvoditel'nosti pri rabote pod FreeBSD.

     * www/boa: Boa -- esche odna al'ternativa thttpd i Apache. `Etot
       server dolzhen byt' oschutimo bolee vysokoproizvoditel'nym,
       chem Apache, dlya polnost'yu staticheskih stranic. Na vremya
       napisaniya dannogo dokumenta, vprochem, on ne tak horosho
       optimizirovan pod FreeBSD, kak thttpd.

     --------------------------------------------------------------

    2.4.4. CVSup (zhelatelen dlya zerkal repozitoriya CVS)

   CVSup predostavlyaet ochen' `effektivnyj mehanizm rasprostraneniya
   fajlov. On rabotaet podobno rsync i byl razrabotan special'no dlya
   ispol'zovaniya s repozitoriyami CVS. Esli vy planiruete
   predostavlyat' dostup k repozitoriyu CVS FreeBSD, stoit delat'
   `eto posredstvom CVSup. Pomimo `etogo, mozhno ispol'zovat'
   AnonCVS, FTP, rsync ili HTTP, no ispol'zovanie CVSup naibolee
   razumno. Avtorom CVSup yavlyaetsya John Polstra <jdp@FreeBSD.org>.
   CVSup neprosto ustanovit' na platforme, otlichnoj ot FreeBSD,
   poskol'ku on napisan na yazyke Modula-3 i trebuet
   sootvetstvuyuschego okruzheniya. Dzhon Polstra sozdal usechennuyu
   versiyu M3, dostatochnuyu dlya raboty CVSup, kotoruyu namnogo
   prosche ustanovit'. Podrobnosti mozhno prochitat' zdes': Ezm3.
   Otnosyaschiesya k teme pakety:

     * net/cvsup: Port CVSup (klient i server), trebuyuschij dlya
       sborki paket lang/ezm3.

     * net/cvsup-mirror: Nabor dlya CVSup-zerkala, trebuyuschij
       net/cvsup-without-gui, i konfiguriruyuschij ego v processe
       ustanovki. Vozmozhno, nekotorym administratoram potrebuetsya
       drugoj nabor ustanovok.

   Mozhet takzhe okazat'sya poleznym paket net/cvsup-without-gui.
   Esli vy predpochitaete paket, sobrannyj staticheski, zaglyanite po
   `etoj ssylke. `Eta stranica vse esche opisyvaet oshibku S1G.
   Vozmozhno, v buduschem Dzhon sozdast universal'nyj sajt dlya
   zagruzki staticheski sobrannyh variantov CVSup dlya razlichnyh
   platform.

   Pri pomoschi CVSup mozhno rasprostranyat' lyubye kollekcii fajlov
   (ne tol'ko repozitorii CVS), odnako ego konfiguraciya mozhet byt'
   neprostoj. Izvestno, chto CVSup potreblyaet oschutimoe kolichestvo
   processornogo vremeni kak na servere, tak i na kliente, poskol'ku
   sravnivaet bol'shoe kolichestvo fajlov.

     --------------------------------------------------------------

    2.4.5. AnonCVS (dopolnitelen dlya zerkal repozitoriya CVS)

   Esli vy kopiruete repozitorij CVS, mozhno dopolnitel'no
   predostavit' k nemu anonimnyj dostup. Dlya nachala,
   preduprezhdenie: spros na `etot servis ne tak uzh velik,
   podgotovka ego trebuet nekotorogo opyta, i, nakonec, vy dolzhny
   znat', chto delaete.

   Suschestvuet dva osnovnyh sposoba udalennogo dostupa k
   repozitoriyu CVS: cherez pserver i cherez ssh (dostup cherez rsh
   my rassmatrivat' ne budem). Dlya anonimnogo dostupa naibolee
   podhodit pserver; vprochem, nekotorye sajty dayut dostup i
   posredstvom ssh. Dlya poslednego budet poleznoj special'naya
   programma, prednaznachennaya dlya ispol'zovaniya v kachestve
   shella dlya uchetnoj zapisi anonimnogo ssh-dostupa. Ona ispol'zuet
   vyzov chroot, po`etomu repozitorij CVS dolzhen raspolagat'sya
   vnutri domashnego kataloga anonimnogo pol'zovatelya, chto
   priemlemo ne dlya vseh sajtov. Dannoe ogranichenie ne
   rasprostranyaetsya na dostup cherez pserver, odnako poslednij
   variant mozhet byt' svyazan s dopolnitel'nym riskom s tochki
   zreniya bezopasnosti. Nikakih dopolnitel'nyh programm dlya
   obespecheniya anonimnogo CVS-dostupa ne potrebuetsya, poskol'ku
   cvs(1) vhodit v bazovuyu postavku FreeBSD. Vam nuzhno budet
   razreshit' zapusk cvs iz inetd, dlya chego neobhodimo dobavit' v
   fajl /etc/inetd.conf stroku vida

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

   Obratites' k stranice spravochnika cvs(1) za dopolnitel'noj
   informaciej po opciyam. Krome togo, stranicy info po CVS
   opisyvayut, kak udostoverit'sya v tom, chto vy predostavlyaete
   dostup tol'ko dlya chteniya. Rekomenduetsya sozdat'
   neprivilegirovannuyu uchetnuyu zapis', zhelatel'no s imenem
   anoncvs. Potrebuetsya takzhe sozdat' fajl passwd v kataloge
   /home/ncvs/CVSROOT i ustanovit' parol' (pustoj ili anoncvs) dlya
   pol'zovatelya anoncvs. Sozdanie fajlovoj sistemy /anoncvstmp v
   pamyati ne neobhodimo, no rekomenduetsya dlya uskoreniya raboty: v
   nej cvs(1) budet sozdavat' vremennuyu strukturu katalogov,
   kotoraya ne ispol'zuetsya po zavershenii operacii, no sil'no
   zamedlyaet rabotu, esli trebuyutsya operacii zapisi na real'nyj
   disk. Primer opisaniya takoj fajlovoj sistemy v fajle /etc/fstab:

 /dev/da0s1b /anoncvstmp mfs rw,-s=786432,-b=4096,-f=512,-i=560,-c=3,-m=0,nosuid 0 0

   `Eti ustanovki (razumeetsya, tschatel'no podobrannye) predlozhil
   John Polstra <jdp@FreeBSD.org>.

     --------------------------------------------------------------

3. Kak vesti zerkalo FreeBSD

   Teper' vam izvestno, kakaya potrebuetsya mashina i kak
   predostavlyat' servisy, no ne kak poluchit' ih samomu. :-) V `etom
   razdele opisyvaetsya process vedeniya zerkala i podderzhaniya ego
   v aktual'nom sostoyanii, v tom chisle kakie instrumenty
   ispol'zovat' i kakie sajty vybirat' v kachestve istochnikov dlya
   sinhronizacii.

     --------------------------------------------------------------

  3.1. FTP

   Fajly, dostupnye po FTP, sostavlyayut bol'shuyu chast' zerkala.
   Oni vklyuchayut distributivnye nabory, neobhodimye dlya ustanovki
   po seti, vetvi (branches), v kotoryh otrazheno tekuschee
   sostoyanie ishodnyh tekstov, obrazy ISO dlya zapisi kompakt-diskov
   s distributivami dlya ustanovki, obrazami ''zhivyh'' fajlovyh
   sistem i paketami, derevo portov, ishodnye distributivy dlya
   sborki portov i kuchu gotovyh paketov. I, razumeetsya, vse
   vysheopisannoe -- dlya raznyh versij FreeBSD i razlichnyh
   arhitektur.

     --------------------------------------------------------------

    3.1.1. Pri pomoschi programm dlya FTP-zerkalirovaniya

   Dlya vykachivaniya fajlov vy mozhete ispol'zovat' programmu
   FTP-zerkalirovaniya. Vot nekotorye iz naibolee chasto
   ispol'zuyuschihsya:

     * ftp/mirror

     * ftp/ftpmirror

     * ftp/emirror

     * ftp/spegla

     * ftp/omi

     * ftp/wget

   Ranee naibolee populyarnym variantom byl ftp/mirror, hotya iz-za
   togo, chto `eta programma napisana na perl(1), suschestvuyut
   razlichnye ogranicheniya, v osobennosti pri zerkalirovanii
   bol'shih fajlovyh struktur, takih kak FreeBSD. Utverzhdaetsya,
   vprochem, chto v tekuschej versii poslednyaya problema ispravlena
   za schet dopolnitel'nogo algoritma sravneniya struktury katalogov.

   Voobsche govorya, protokol FTP ne luchshim obrazom podhodit dlya
   podderzhki zerkala. Izmenennyj fajl peredaetsya celikom; krome
   togo, nevozmozhno sozdanie edinogo potoka dannyh, kotoryj mog by
   povysit' `effektivnost' peredachi za schet bol'shogo TCP-okna.

     --------------------------------------------------------------

    3.1.2. Pri pomoschi rsync

   Bolee `effektivnym budet sinhronizaciya FTP-oblasti pri pomoschi
   rsync. Dlya `etogo sleduet ustanovit' paket net/rsync, kotoryj byl
   opisan v razdele Razd. 2.4.2. Poskol'ku dostup po protokolu rsync
   ne yavlyaetsya obyazatel'nym, vybrannyj vami sajt mozhet ego ne
   podderzhivat'. Vozmozhno, vam pridetsya nemnogo poiskat' v setevoj
   okrestnosti zerkalo, podderzhivayuschee rsync.

     Zamechanie: Poskol'ku ot kolichestva klientov rsync oschutimo
     zavisit zagruzka servera, bol'shinstvo administratorov vvodyat
     ogranicheniya dostupa. Dlya podderzhaniya zerkala vam sleduet
     svyazat'sya s administratorom sajta, s kotorym vy budete
     sinhronizirovat'sya, dlya utochneniya lokal'nyh pravil i,
     vozmozhno, dlya vneseniya v nih isklyucheniya dlya vas
     (poskol'ku vy takzhe podderzhivaete zerkalo).

   Stroka dlya sinhronizacii FreeBSD po rsync vyglyadit primerno tak:

 % rsync -vaz --delete ftp4.de.FreeBSD.org::FreeBSD/ /pub/FreeBSD/

   Zaglyanite v dokumentaciyu po rsync, takzhe dostupnuyu po adresu
   http://rsync.samba.org/ za dopolnitel'noj informaciej po
   razlichnym opciyam rsync. Obratite vnimanie, chto v sluchae
   sinhronizacii modulya celikom (a ne otdel'nogo kataloga)
   neobhodimo yavno ukazat' rezul'tiruyuschij katalog, potomu chto
   katalog s imenem modulya (v dannom sluchae "FreeBSD") ne
   sozdaetsya. Dlya podderzhaniya aktual'nosti vam potrebuetsya
   sozdat' skript dlya zapuska podobnoj komandy iz cron(8).

     --------------------------------------------------------------

    3.1.3. Pri pomoschi CVSup

   Nemnogie sajty, v pervuyu ochered' central'nyj
   ftp-master.FreeBSD.org predostavlyayut dlya sinhronizacii
   FTP-oblasti dostup po protokolu CVSup. Vam potrebuetsya klient
   CVSup, predpochtitel'no iz paketa net/cvsup (sm. takzhe Razd.
   2.4.4). Primer konfiguracionnogo fajla (supfile) dlya
   sinhronizacii s ftp-master.FreeBSD.org:

 #
 # FreeBSD archive supfile from master server
 #
 *default host=ftp-master.FreeBSD.org
 *default base=/usr
 *default prefix=/pub
 #*default release=all
 *default delete use-rel-suffix
 *default umask=002

 # If your network link is a T1 or faster, comment out the following line.
 #*default compress

 FreeBSD-archive release=all preserve

   Sudya po vsemu, sinhronizaciya pri pomoschi CVSup -- luchshij po
   `effektivnosti sposob podderzhki zerkala, odnako on dostupen lish'
   s nebol'shogo chisla sajtov.

     Zamechanie: Prochtite dokumentaciyu po CVSup, naprimer,
     cvsup(1), i obratite vnimanie na opciyu -s. Ona mozhet
     umen'shit' ob"em operacij vvoda-vyvoda, predpolagaya, chto
     zapisannaya informaciya o kazhdom fajle korrektna.

     --------------------------------------------------------------

  3.2. Zerkalirovanie CVS repozitoriya

   Suschestvuet neskol'ko sposobov sinhronizacii CVS repozitoriya.
   CVSup naibolee obschij metod.

     --------------------------------------------------------------

    3.2.1. Ispol'zovanie CVSup

   Programma CVSup nemnogo opisana v (Razd. 2.4.4 i Razd. 3.1.3).

   Nastroit' CVSup zerkalo ochen' prosto. Ustanovka net/cvsup-mirror
   proverit, chto vse nuzhnye programmy ustanovleny i zatem soberet
   vsyu neobhodimuyu informaciyu dlya konfigurirovaniya zerkala.

     Zamechanie: Ne zabud'te pochitat' poleznuyu podskazku zdes'.

     --------------------------------------------------------------

    3.2.2. Drugie metody

   Ispol'zovanie metodov, otlichnyh ot CVSup, ne rekomenduetsya. Tem
   ne menee, my kratko upomyanem ih. Poskol'ku bol'shaya chast'
   zerkal daet dostup k repozitoriyu CVS v chisle prochih fajlov,
   dostupnyh po FTP, po puti /pub/FreeBSD/development/FreeBSD-CVS,
   mogut byt' ispol'zovany:

     * FTP

     * Rsync

     * HTTP

     Vazhno: AnonCVS ne mozhet ispol'zovat'sya dlya zerkalirovaniya
     CVS repozitoriya, tak kak CVS ne razreshaet sam dostup k
     repozitoriyu, a tol'ko k izvlechionnym versiyam modulej.

     --------------------------------------------------------------

  3.3. Zerkalirovanie stranic WWW

   Luchshim sposobom budet izvlechenie (check out) iz repozitoriya
   CVS modulya www. Pri uslovii nalichiya u vas kopii repozitoriya,
   vse, chto dlya `etogo potrebuetsya -- vypolnit' komandu

 % cvs -d /home/ncvs co www

   i sformirovat' zadanie dlya cron, kotoroe budet regulyarno
   vypolnyat' operaciyu cvs up -d -P, naprimer, kazhdyj raz posle
   obnovleniya kopii repozitoriya. Razumeetsya, fajly dolzhny
   nahodit'sya v ierarhii, dostupnoj dlya publichnogo veb-dostupa. My
   soznatel'no ne budem obsuzhdat' zdes' process ustanovki i
   konfiguracii veb-servera dlya `etih celej.

   Esli u vas net lokal'noj kopii repozitoriya, mozhno ispol'zovat'
   CVSup dlya sinhronizacii kopii veb-stranic. Primer konfiguracii
   mozhno najti v fajle /usr/share/examples/cvsup/www-supfile.
   Privedem ego zdes':

 #
 # WWW module supfile for FreeBSD
 #
 *default host=cvsup3.de.FreeBSD.org
 *default base=/usr
 *default prefix=/usr/local
 *default release=cvs tag=.
 *default delete use-rel-suffix

 # If your network link is a T1 or faster, comment out the following line.
 *default compress

 # This collection retrieves the www/ tree of the FreeBSD repository
 www

   Ispol'zovanie paketa ftp/wget ili inyh instrumentov dlya sozdaniya
   veb-zerkal ne rekomenduetsya.

     --------------------------------------------------------------

    3.3.1. Zerkala dokumentacii FreeBSD

   Poskol'ku mnogie veb-stranicy ssylayutsya na dokumentaciyu,
   horoshej ideej yavlyaetsya podderzhka zerkala dokumentacii FreeBSD
   sovmestno s prochimi zerkalami. Nado otmetit', chto `etot process
   ne stol' trivialen, kak podderzhka zerkala veb-stranic samih po
   sebe.

   Dlya nachala vy dolzhny sozdat' kopiyu ishodnyh tekstov
   dokumentacii (kak i vo mnogih drugih sluchayah, dlya `etogo
   predpochtitelen CVSup). Vot primer fajla konfiguracii:

 #
 # FreeBSD documentation supfile
 #
 *default host=cvsup3.de.FreeBSD.org
 *default base=/usr
 *default prefix=/usr/share
 *default release=cvs tag=.
 *default delete use-rel-suffix

 # If your network link is a T1 or faster, comment out the following line.
 #*default compress

 # This will retrieve the entire doc branch of the FreeBSD repository.
 # This includes the handbook, FAQ, and translations thereof.
 doc-all

   Zatem, vam potrebuetsya neskol'ko paketov. K schast'yu, special'no
   dlya `etogo suschestvuet meta-port textproc/docproj. Takzhe,
   neobhodimo ustanovit' nekotorye peremennye okruzheniya, naprimer
   SGML_CATALOG_FILES, i peremennye v fajle /etc/make.conf, glavnym
   obrazom peremennuyu DOC_LANG (ispol'zujte fajl
   /usr/share/examples/make.conf kak shablon). Posle `etogo mozhno
   vydat' komandu make v glavnom kataloge dokumentacii (po
   umolchaniyu `eto /usr/share/doc). Kak i prezhde, `eti katalogi
   dolzhny byt' dostupny dlya vashego veb-servera (prover'te, chto
   ssylki vedut v nuzhnye mesta).

     Vazhno: Process podgotovki i postroeniya dokumentacii, a takzhe
     mnogie soputstvuyuschie voprosy, podrobno opisan v dokumente
     Uchebnik po Proektu Dokumentirovaniya FreeBSD. Prochtite `etot
     dokument, v osobennosti esli u vas voznikli problemy so sborkoj
     standartnogo komplekta dokumentacii.

     --------------------------------------------------------------

  3.4. Kak chasto sinhronizirovat'sya?

   Kazhdoe zerkalo dolzhno regulyarno obnovlyat'sya. Vam potrebuetsya
   kakoj-to nabor skriptov, vypolnyaemyh posredstvom cron(8).
   Poskol'ku kazhdyj administrator, kak pravilo, pishet takie skripty
   sam i na svoj lad, my ne mozhem vydat' konkretnyh ukazanij.
   Obschie zhe sovety vyglyadyat tak:

    1. Sozdajte skript s komandoj, kotoraya zapustit nuzhnoe
       prilozhenie dlya obnovleniya zerkala. Rekomenduem ispol'zovat'
       skript na yazyke obychnogo /bin/sh.

    2. Dobav'te komand perenapravleniya vyvoda, chtoby zapisat'
       diagnostiku raboty v fajl.

    3. Poprobujte, kak vash skript rabotaet. Po zavershenii prover'te
       logi.

    4. Pri pomoschi utility crontab(1) dobav'te vash skript v tablicu
       regulyarnyh zadanij crontab(5) sootvetstvuyuschego
       pol'zovatelya. `Eto dolzhen byt' pol'zovatel', otlichnyj ot
       pol'zovatelya FTP-daemona, chtoby fajly v FTP-oblasti bez
       atributa "chtenie dlya vseh" ne byli dostupny anonimnym
       FTP-pol'zovatelyam. Dannoe svojstvo ispol'zuetsya dlya
       testirovaniya pered vyhodom novyh relizov, dlya togo chtoby
       udostoverit'sya, chto vse oficial'nye zerkala soderzhat vse
       neobhodimye fajly k momentu oficial'nogo ob"yavleniya reliza.

   Nekotorye rekomenduemye ustanovki chastoty obnovleniya:

     * FTP-nabor: raz v sutki

     * repozitorij CVS: raz v chas

     * WWW-stranicy: raz v sutki

     --------------------------------------------------------------

4. S kakogo servera sinhronizirovat'sya

   `Eto vazhnyj vopros, tak chto my popytaemsya poyasnit', otkuda
   berutsya otvety. Dlya nachala povtorim esche neskol'ko raz:
   nikogda ne sinhronizirujtes' s ftp.FreeBSD.org .

     --------------------------------------------------------------

  4.1. Organizaciya sistemy zerkal

   Zerkala organizuyutsya po stranam. Imena hostov vseh oficial'nyh
   zerkal postroeny po principu ftpN.CC.FreeBSD.org, gde CC (country
   code) -- domen verhnego urovnya strany, gde raspolozheno zerkalo,
   N -- nomer zerkala v dannoj strane. `Etot zhe princip primenim k
   imenam hostov cvsupN.CC.FreeBSD.org, wwwN.CC.FreeBSD.org i t.p.
   Krome togo, est' zerkala bez domennoj chasti, oboznachayuschej
   stranu. Vse oni imeyut ochen' horoshie vneshnie kanaly i
   obsluzhivayut bol'shoe chislo odnovremennyh soedinenij. Imya
   ftp.FreeBSD.org na samom dele ukazyvaet na dve mashiny, odna iz
   kotoryh v nastoyaschee vremya nahoditsya v Danii, a drugaya v
   SSHA. Ni odna iz `etih mashin NE yavlyaetsya osnovnym sajtom, i
   potomu ne dolzhna ispol'zovat'sya dlya sinhronizacii. Massa
   dokumentacii dlya ''zhivyh'' pol'zovatelej ukazyvaet na
   ftp.FreeBSD.org, tak chto avtomaticheskim sistemam vedeniya zerkal
   sleduet vybirat' drugie istochniki sinhronizacii.

   Krome togo, suschestvuet ierarhiya zerkal v terminah ih
   udalennosti ot centra, ili sloyah. Osnovnye sajty mogut byt'
   opisany kak Zerkala nulevogo sloya. Zerkala,
   sinhroniziruyuschiesya po nim, schitayutsya sloem 1,
   sleduyuschie -- sloem 2 i t.d. Oficial'nye sajty priglashayutsya
   na nizkie sloi, odnako sleduet pomnit', chto chem men'she nomer
   sloya, tem vyshe trebovaniya k zerkalu, kak bylo opisano v Razd.
   2. Pomimo togo, dostup k zerkalam 1 sloya mozhet byt' ogranichen;
   bezuslovno ogranichen dostup k osnovnym sajtam. Ierarhiya sloev ne
   otrazhaetsya v DNS i, voobsche govorya, nigde (krome
   master-sajtov) ne dokumentirovana. Tem ne menee, oficial'nye
   zerkala s malymi (1-4, kak pravilo) nomerami obychno
   predstavlyayut pervyj sloj. (`Eto grubaya ocenka, i ni v koem
   sluchae ne pravilo).

     --------------------------------------------------------------

  4.2. Tak otkuda zhe mne sinhronizirovat'sya?

   Glavnoe -- NE s ftp.FreeBSD.org. Korotkij otvet: s zerkala,
   kotoroe raspolozheno nedaleko ot vas v terminah Internet, i/ili
   dostup k kotoromu nailuchshij.

     --------------------------------------------------------------

    4.2.1. YA hochu poluchit' kopiyu zerkala hot' otkuda-nibud'!

   Esli u vas net kakih-libo special'nyh predpochtenij ili
   trebovanij, sm. Razd. 4.2. `Eto oznachaet:

    1. Posmotrite na spisok dostupnyh zerkal v vashej strane. Vam
       mozhet pomoch' Baza dannyh zerkal FreeBSD.

    2. Vyberite te iz nih, s kotorymi vam rabotat' bystree vsego
       (men'shee chislo promezhutochnyh uzlov i vremya otklika), i
       kotorye predostavlyayut nuzhnye vam servisy (takie kak rsync
       ili CVSup).

    3. Svyazhites' s administratorami vybrannogo servera, opishite
       vashi zaprosy i utochnite ih pravila.

    4. Skonfigurirujte vashe zerkalo, kak opisyvalos' vyshe.

     --------------------------------------------------------------

    4.2.2. YA podderzhivayu oficial'noe zerkalo, kakoj sajt mne vybrat'?

   V osnovnom, pravila, opisannye v Razd. 4.2.1, primenimy.
   Dopolnitel'no mozhno ubedit'sya, chto vybrannyj sajt prinadlezhit
   nizkomu sloyu. Drugie soobrazheniya otnositel'no oficial'nyh
   zerkal opisany v Razd. 5.

     --------------------------------------------------------------

    4.2.3. Mne nuzhen dostup k osnovnym sajtam!

   Pri nalichii dostatochnyh prichin vy mozhete poluchit' dostup k
   odnomu iz osnovnyh sajtov. Dostup k nim ogranichen; suschestvuyut
   special'nye pravila ih ispol'zovaniya. Nalichie u vas statusa
   oficial'nogo zerkala, bezuslovno, yavlyaetsya horoshim podspor'em.
   V protivnom sluchae ubedites', chto vasha strana dejstvitel'no
   nuzhdaetsya esche v odnom zerkale. Esli ih uzhe tri ili bolee,
   snachala svyazhites' s administratorom sootvetstvuyuschej zony DNS
   (<hostmaster@CC.FreeBSD.org>) ili napishite v Spisok rassylki,
   posvyaschionnyj zerkalirovaniyu FreeBSD.

   Dostup k odnomu iz master-sajtov ili podhodyaschemu zerkalu 1
   urovnya vam pomogut obespechit' te zhe, kto pomogal vam poluchit'
   status oficial'nogo zerkala. V sluchae neudachi svyazhites' s
   <mirror-admin@FreeBSD.org> i poprosite pomoschi u nih.

   Suschestvuet tri osnovnyh sajta dlya sinhronizacii nabora fajlov
   FTP i odin dlya repozitoriya CVS. Veb-stranicy i dokumentaciya
   hranyatsya v CVS, po`etomu ne imeyut otdel'nyh osnovnyh sajtov.

     --------------------------------------------------------------

      4.2.3.1. ftp-master.FreeBSD.org

   `Eto osnovnoj server dlya sinhronizacii FTP nabora.

   ftp-master.FreeBSD.org podderzhivaet dostup po rsync i CVSup, v
   dopolnenie k FTP. Ispol'zovanie `etih protokolov opisano v
   razdelah Razd. 3.1.2 i Razd. 3.1.3.

   Privetstvuetsya predostavlenie zerkalami 1 urovnya dostupa k
   FTP-oblasti po protokolu rsync.

     --------------------------------------------------------------

      4.2.3.2. cvsup-master.FreeBSD.org

   `Eto osnovnoj server dlya sinhronizacii repozitoriya CVS.

   cvsup-master.FreeBSD.org obespechivaet dostup tol'ko po protokolu
   CVSup. Detali sm. v Razd. 3.2.1.

   Dlya polucheniya dostupa k `etomu serveru vam nuzhno svyazat'sya s
   Koordinator Seti Serverov CVSup <cvsup-master@FreeBSD.org>. Ne
   zabud'te snachala prochitat' Pravila dostupa k central'nomu CVSup
   serveru FreeBSD!

   Podgotov'te parametry avtorizacii, kak opisano zdes'. Ne zabud'te,
   chto v kachestve imeni servera komande cvpasswd nuzhno ukazat'
   freefall.FreeBSD.org, nesmotrya na to, chto ustanavlivat'
   soedinenie vy budete s cvsup-master.FreeBSD.org.

     --------------------------------------------------------------

5. Oficial'nye zerkala

   Oficial'nye zerkala obladayut sleduyuschim svojstvami:

     * a) imeyut zapis' v domene FreeBSD.org (obychno tipa CNAME).

     * b) prisutstvuyut v spiske oficial'nyh zerkal v Rukovodstve po
       FreeBSD i drugoj dokumentacii.

   Na nastoyaschij moment `eto vse, chto otlichaet ih ot prochih
   zerkal. Oficial'nye zerkala ne obyazatel'no prinadlezhat k Pervomu
   urovnyu, odnako, vryad li mozhno najti zerkalo urovnya 1, ne
   yavlyayuscheesya oficial'nym.

     --------------------------------------------------------------

  5.1. Otdel'nye trebovaniya k oficial'nym zerkalam 1 urovnya

   Opisat' trebovaniya dlya vseh oficial'nyh zerkal ne tak prosto,
   poskol'ku proekt FreeBSD dostatochno myagok v `etom otnoshenii.
   Neskol'ko prosche ukazat', chto trebuetsya ot oficial'nyh zerkal
   urovnya 1. Prochie oficial'nye zerkala dolzhny rassmatrivat' `etot
   spisok kak nastojchivye pozhelaniya.

     Zamechanie: Sleduyuschee otnositsya v osnovnom k naboru fajlov
     FTP, poskol'ku repozitorij CVS vsegda dolzhen zerkalirovat'sya
     polnost'yu, a veb-stranicy predstavlyayut soboj neskol'ko osobyj
     sluchaj.

   Zerkala 1 urovnya dolzhny:

     * podderzhivat' polnyj spisok fajlov

     * predostavlyat' dostup dlya drugih zerkal

     * obespechivat' dostup po protokolam FTP i rsync.

   Krome togo, administrator takogo zerkala dolzhen byt' podpisan na
   Spisok rassylki, posvyaschionnyj zerkalirovaniyu FreeBSD. Sm.
   zdes' dlya dopolnitel'noj informacii o podpiske.

     Vazhno: Administratory zerkal, v osobennosti 1 urovnya, dolzhny
     ochen' vnimatel'no sledit' za grafikom relizov. `Eto pomozhet
     podgotovit'sya k krupnym vspleskam nagruzki na zerkalo, kotorye
     vsegda proishodyat posle ocherednogo reliza.

     Krome togo, vazhno podderzhivat' aktual'nost' zerkal (v
     osobennosti zerkal urovnya 1). Esli Zerkalo1 ne
     sinhronizirovalos' v techenie dlitel'nogo vremeni, to zerkala
     sleduyuschego urovnya budut sinhronizirovat'sya po ustarevshej
     informacii i t.d. Podderzhivajte aktual'nost' vashih zerkal!

     --------------------------------------------------------------

  5.2. Kak stat' oficial'nym zerkalom?

   Nebezynteresnyj vopros, v osobennosti esli uchityvat' posledstviya
   stanovleniya oficial'nym zerkalom, naprimer, uvelichivshiesya
   scheta za internet ot vashego provajdera (ved' nagruzka na vash
   server neizbezhno uvelichitsya). Status oficial'nogo zerkala
   mozhet byt' klyuchevym trebovaniem dlya dostupa k osnovnomu sajtu.

   Prezhde chem otpravlyat' zayavku, ubedites' v neobhodimosti
   dopolnitel'nogo oficial'nogo zerkala v vashem regione. Sprav'tes'
   u administratora vashej zony (<hostmaster@CC.FreeBSD.org>) ili, v
   sluchae, esli vam ne otvechayut, zdes': Spisok rassylki,
   posvyaschionnyj zerkalirovaniyu FreeBSD.

   Sobstvenno procedura takova:

    1. Obespech'te rabotosposobnost' i aktual'nost' zerkala (skoree
       vsego, sinhroniziruyas' ne po osnovnomu sajtu).

    2. Podpishites' zdes' na Spisok rassylki, posvyaschionnyj
       zerkalirovaniyu FreeBSD.

    3. Posle uspeshnogo zaversheniya predyduschih punktov, napishite
       administratoru DNS vashego regiona (strany) i poprosite ego
       sozdat' zapis' v zone dlya vashego sajta. Pochtovyj adres
       administratora <hostmaster@CC.FreeBSD.org>, gde CC -- kod
       vashej strany (i suffiks domena verhnego urovnya). Format
       vashej zapisi v DNS opisan v Razd. 4.1.

       Esli dlya vashej strany poka ne sozdano poddomena, svyazhites'
       s <mirror-admin@FreeBSD.org> ili snachala napishite v Spisok
       rassylki, posvyaschionnyj zerkalirovaniyu FreeBSD.

    4. Persona, pomogavshaya vam poluchit' status oficial'nogo
       zerkala, dolzhna poslat' pis'mo <mirror-admin@FreeBSD.org>,
       chtoby vash sajt byl vklyuchen v spisok oficial'nyh zerkal v
       Rukovodstve FreeBSD.

     --------------------------------------------------------------

6. Statistika nekotoryh zerkal

   Vot neskol'ko ssylok na statistiku ispol'zovaniya zerkal

     --------------------------------------------------------------

  6.1. Statistika FTP sajtov

     * ftp.is.FreeBSD.org - <hostmaster@is.FreeBSD.org> - (zagruzka
       kanala) (FTP processy) (HTTP processy)

     * ftp.cz.FreeBSD.org - <cejkar@fit.vutbr.cz> - (zagruzka kanala)
       (FTP processy) (rsync processy)

     * ftp2.ru.FreeBSD.org - <mirror@macomnet.ru> - (Bandwidth) (HTTP
       and FTP users)

     --------------------------------------------------------------

  6.2. Statistika CVSup sajtov

     * cvsup[23456].jp.FreeBSD.org - <kuriyama@FreeBSD.org> - (CVSup
       processy)

     * cvsup.cz.FreeBSD.org - <cejkar@fit.vutbr.cz> - (CVSup
       processy)

     * cvsup4.ru.FreeBSD.org - <maxim@FreeBSD.org> - (CVSup processy)

     --------------------------------------------------------------

            `Etot, i drugie dokumenty, mogut byt' skachany s
                ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/.

  Po voprosam, svyazannym s FreeBSD, prochitajte dokumentaciyu prezhde
                 chem pisat' v <questions@FreeBSD.org>.
         Po voprosam, svyazannym s `etoj dokumentaciej, pishite
                           <doc@FreeBSD.org>.
  Po voprosam, svyazannym s russkim perevodom dokumentacii, pishite v
                    rassylku <frdp@FreeBSD.org.ua>.
  Informaciya po podpiske na `etu rassylku nahoditsya na sajte proekta
                               perevoda.
