A.6. A CVSup használata

A.6.1. Bevezetés

A CVSup távoli szervereken található központi repositorykban levő forrásfák terjesztésére és a rajtuk keresztüli frissítésre alkalmas programcsomag. A FreeBSD forrásait egy CVS repositoryban tartják karban Kaliforniában egy fejlesztéseket tároló központi számítógépen. A CVSup segítségével a FreeBSD felhasználói könnyen szinkronban tudják vele tartani a saját forrásaikat.

A CVSup az ún. lehúzással frissít. Ilyenkor a kliensek csak akkor kérnek a szervertől frissítéseket, amikor szükségük van rá, miközben a szerver passzívan várja a frissítési kérelmeket. Ennek megfelelően tehát minden esetben a kliens kezdeményezi a frissítést, a szerver pedig önmagától sosem küld ilyeneket kéretlenül. A felhasználóknak így vagy maguknak kell meghívniuk a CVSup kliensét, vagy a frissítések rendszeres automatikus letöltéséhez be kell állítaniuk a cron rendszerprogramot.

A CVSup kifejezés ebben az írásmódban az egész programcsomagra utal. Fő alkotórészei a a felhasználó gépén futó cvsup nevű kliens, és a FreeBSD tüköroldalain futó cvsupd nevű szerver.

A FreeBSD dokumentációjának és levelezési listáinak fürkészése során rengeteg hivatkozást találhatunk egy sup nevű alkalmazásra. A sup a CVSup elődje volt, és hasonló célokat szolgált. A CVSup használat tekintetében nagyon hasonlít a sup-hoz, és ami azt illeti, a a sup konfigurációs állományaival visszafele kompatibilis formátumot használ. Mivel a CVSup sokkal gyorsabb és rugalmasabb, a supot már nem használja a FreeBSD Projekt.

A.6.2. Telepítés

A CVSup telepítésének legegyszerűbb módja a FreeBSD csomaggyűjteményében található előrefordított net/cvsup csomag használata. Ha viszont inkább forrásból akarjuk telepíteni a CVSupot, akkor helyette használjuk a net/cvsup portot. De legyünk elővigyázatosak: a net/cvsup portnak szüksége van a Modula-3 rendszerre, aminek letöltése és lefordítása pedig meglehetősen sok időt és tárhelyet igényel.

Ha a FreeBSD 6.1 vagy korábbi változatain szeretnénk telepíteni a csupot, használjuk a FreeBSD csomaggyűjteményében megtalálható net/csup csomagot. Ha viszont forrásból kívánjuk telepíteni a csup programot, akkor helyette használjuk a net/csup portot.

A.6.3. A CVSup beállítása

A CVSup működését a supfile elnevezésű állomány vezérli. A /usr/share/examples/cvsup/ könyvárban találhatunk néhány példát a supfile állományokra.

A supfile állományban szereplő információk a CVSup használatával kapcsolatban a következő kérdéseket válaszolják meg:

• Milyen állományokat akarunk letölteni?

• Milyen verzióikra van szükségünk?

• Honnan akarjuk ezeket beszerezni?

• Hova akarjuk rakni a számítógépünkön?

• Hova akarjuk rakni az állapotot tároló állományokat?

Az imént feltett kérdésekre a következő szakaszokban összeállítandó supfile segítségével fogunk válaszolni. Ehhez először bemutatjuk a supfile formátumú állományok általános szerkezetét.

A supfile állományok szöveget tartalmaznak. A megjegyzések # karakterrel kezdődnek és a sor végéig tartanak. A kizárólag csak megjegyzéseket tartalmazó vagy üres sorok nem kerülnek feldolgozásra.

Az összes többi fennmaradó sorban pedig azokat az állományokat írjuk le, amelyeket a felhasználó le akar tölteni. Az ilyen fajtájú sorok egy “gyűjtemény” (collection) nevével kezdődnek, ami állományok egy szerver által meghatározott logikai csoportjára utal. A gyűjtemény neve ennek megfelelően elárulja a szervernek, hogy pontosan milyen állományokra van szükségünk. Ezután következik whitespace-szel elválasztva nulla vagy több mező, amelyek a korábban feltett kérdéseinket válaszolják meg rendre. Ezeknek a mezőknek két típusa létezik: a beállításokat és a konkrét értéket tároló mezők. A beállításokat tároló mezők különböző kulcsszavakat tartalmaznak, például a delete (törlés) vagy compress (tömörítés). Az értéket tároló mezők is egy kulcsszóval kezdődnek, azonban utána közvetlenül egy = (egyenlőségjel) jön, amelyet egy második szó követ szorosan. Így például a release=cvs pontosan egy ilyen értékmező lesz.

Egy supfile általában egynél több gyűjtemény letöltését írja le. Ezért az ilyen állományok felépítésének egyik módja, ha az egyes gyűjteményhez explicite megadjuk a hozzá tartozó mezőket. Azonban így a supfile állományok gyorsan megnövekednek és kényelmetlenné válnak, mivel a legtöbb gyűjtemény esetén szinte ugyanazokat a mezőket kellene megadnunk. A CVSup az ilyen típusú bonyodalmak elkerülésére egy alapértelmezési megoldást javasol. A *default nevű álgyűjteménnyel kezdődő sorok segítségével meg tudunk adni olyan beállításokat és értékeket, amelyek az utána következő gyűjtemények számára alapértelmezésnek fognak számítani a supfile állományban. Az itt megadott alapértelmezések természetesen az egyes gyűjteményekben tetszőleges módon felülbírálhatóak, a mezők magán a gyűjteményen belüli megadásával. Az állományban az alapértelmezések is megváltoztathatóak vagy bővíthetőek további *default sorok hozzáadásával.

Mindezek tudatában most már megkezdhetjük a FreeBSD-CURRENT ág tartalmának letöltésére és frissen tartására alkalmas supfile állomány összeállítását.

• Milyen állományokat akarunk letölteni?

  A CVSupon keresztül elérhető állományok “gyűjteményeknek” hívott nevesített csoportokra bontva érhetőek el. A hivatkozható gyűjtemények leírását a következő szakaszban találjuk. Ebben a példában most szeretnénk letölteni az egész FreeBSD rendszer forrását. Ezt a src-all nevű gyűjteményre hivatkozva érhetjük el. A supfile állományunk létrehozásának első lépéseként soronként egyet megadva felsoroljuk a letölteni kívánt gyűjteményeket (jelen esetünkben csak egyetlen egyet):

  src-all

• Milyen verzióikra van szükségünk?

  A CVSup használatával tulajdonképpen a források összes valaha létezett verziójához hozzá tudunk férni. Ez annak köszönhető, hogy a cvsupd szerver közvetlenül a CVS repositoryból dolgozik, ami pedig az összes verziót tartalmazza. A tag= és date= értékmezők segítségével adhatjuk meg az igényelt verziókat.

  Figyelem: Legyünk óvatosak azonban a tag= mezők helyes megadásával. Egyes címkék ugyanis csak bizonyos állománygyűjtemények esetén élnek. Ha hibás vagy elírt címkét adunk meg, akkor a CVSup törölni fog olyan állományokat, amelyeket valószínűleg nem kellene. A ports-* gyűjtemények esetében pedig kifejezetten csak a tag=. mezők használhatóak!

  A tag= mezők a tárházban található szimbolikus címkéket nevezik meg. A címkéknek két típusa van: a revíziókhoz és az ágakhoz tartozó címkék. A revíziós címkék mindig egy adott revíziót hivatkoznak, jelentésük állandó. Ezzel szemben az ágak címkéi egy adott fejlesztési ág adott időpontjában elérhető revíziót címkézi. Mivel az ágak címkéi nem egy konkrét revízióra vonatkoznak, ezért akár olyanra is utalhatnak, ami pillanatnyilag még nem is létezik.

  Az A.7 Szakaszban megtalálhatjuk a fontosabb ágak címkéit. A CVSup konfigurációs állományában a címkéket a tag= előtaggal kell bevezetni (így tehát a RELENG_4 címke hivatkozása tag=RELENG_4 lesz). Ne felejtsük el, hogy a Portgyűjtemény esetében csak tag=. mező megadásának van értelme.

  Figyelem: Igyekezzünk pontosan lemásolni a címkék neveit, mivel a CVSup nem képes megkülönböztetni az érvényes és az érvénytelen címkéket. Ha véletlen elírjuk a címkét, akkor a CVSup úgy fog viselkedni, mintha olyan érvényes címkére hivatkozhatunk volna, amihez nem tartoznak állományok. Ennek következtében pedig egyszerűen letörli a már meglevő forrásainkat.

  Egy ág címkéjének megadása során általában az adott fejlesztési vonal legfrissebb verzióját kapjuk meg. Ha viszont az adott ág valamelyik korábbi változatára lenne szükségünk, akkor a date= értékmező felhasználásával meg tudjuk adni a hozzá tartozó dátumot. Ennek működéséről a cvsup(1) man oldala részletesebben értekezik.

  A példában mi most a FreeBSD-CURRENT verziót akarjuk letölteni. Ezért a következő sort tesszük a supfile állományunk elejére:

  *default tag=.

  Ha nem adunk meg sem tag=, sem pedig date= mezőket, akkor egy fontos eset következik be. Ilyenkor ugyanis egy konkrét verzió helyett közvetlenül a szerver CVS repositoryjából kapjuk meg az állományokat, az összes kiegészítő információjukkal együtt. A fejlesztők általában ezt a típusú megoldást kedvelik, mivel így a saját rendszerükön is könnyen karban tudnak tartani egy példányt, amiben tudnak keresni a revíziók között és ki tudják kérni akár az állományok korábbi változatait is. Természetesen ennek függvényében jóval több tárhelyre van szükségük.

• Honnan akarjuk ezeket beszerezni?

  A host= mező beállításával közöljük a cvsup klienssel, honnan töltse le a frissítéseket. A CVSup tükrözések közül bármelyik megfelel erre a célra, habár leginkább azt érdemes választani, ami a kibertérben a hozzánk legközelebb esik. A példában most egy kitalált FreeBSD terjesztési oldalt választunk, a cvsup99.FreeBSD.org-ot:

  *default host=cvsup99.FreeBSD.org

  A CVSup futtatása előtt tehát ne felejtsük el megváltoztatni ezt a létező számítógép hálózati nevére. A cvsup futtatásakor a -h hálózati név opció megadásával lehetőségünk ennek felülbírálására.

• Hova akarjuk rakni a számítógépünkön?

  A prefix= mező adja meg a cvsup számára, hogy hova tegye a kapott állományokat. A példában a forrásokat közvetlenül a forrásokat tároló központi könyvtárba, a /usr/src könyvtárba tettük. Mivel a src könyvtár neve már hallgatólagosan benne foglaltatik a letöltésre kiválasztott gyűjtemény nevében, ezért itt csak ennyit kell megadnunk:

  *default prefix=/usr

• Hova akarjuk rakni az állapotot tároló állományokat?

  A CVSup kliens egy “bázisnak” (base) nevezett könyvtárban folyamatosan fenntart bizonyos állományokban állapotokat (status file). Ezek a már letöltött állományok nyilvántartásával segítik a CVSup hatékony munkavégzését. Mi most a szabványos bázist, a /var/db könyvtárat fogjuk használni:

  *default base=/var/db

  Amennyiben még nem létezne a bázisként használni kívánt könyvtár, ideje létrehoznunk. A cvsup ugyanis egy nem létező könyvtár esetén nem lesz hajlandó működni.

• További beállítások a supfile állományban:

  Általában még egy sor szokott szerepelni a supfile állományokban:

  *default release=cvs delete use-rel-suffix compress

  A release=cvs mező jelzi, hogy a szervernek a FreeBSD fő CVS repositoryból kell kikeresnie az információkat. Tulajdonképpen majdnem mindig erről van szó, és az itt megadható többi lehetőség ismertetése most egyébként is meghaladná a szakasz határait.

  A delete hatására a CVSup képes lesz állományokat törölni. Mindig érdemes megadnunk, hiszen a CVSup csak így tudja teljes mértékben frissentartani a forrásokat. A CVSup természetesen csak azokat az állományokat igyekszik letörölni, amelyek miatt valóban felelős. A kóbor állományokat nem fogja bántani.

  A use-rel-suffix hatása egy igazi... Rejtély. Ha tényleg érdekel minket a működése, lapozzuk fel bátran a cvsup(1) man oldalát. Nyugodtan adjuk meg és különösebben ne törődjünk vele.

  A compress beállítás segítségével a kommunikációs csatornán vándorló adatokat tudjuk gzip-szerű módon tömöríteni. Ha a hálózati kapcsolatunk sebessége meghaladja a 1,5 Mbitet másodpercenként (T1), akkor ezt már nem érdemes használni, viszont minden más esetben lényeges gyorsulást hozhat.

• Összegezzük az eddigieket:

  Íme a példaként összerakott supfile állományunk teljes tartalma:

  *default tag=.
  *default host=cvsup99.FreeBSD.org
  *default prefix=/usr
  *default base=/var/db
  *default release=cvs delete use-rel-suffix compress
  
  src-all

doc/bn_*
doc/da_*
doc/de_*
doc/el_*
doc/es_*
doc/fr_*
doc/hu_*
doc/it_*
doc/ja_*
doc/mn_*
doc/nl_*
doc/no_*
doc/pl_*
doc/pt_*
doc/ru_*
doc/sr_*
doc/tr_*
doc/zh_*

A.6.4. A CVSup futtatása

Most már készen állunk egy próba frissítés elvégzésére. A parancssorban nem sok mindent kell beírnunk ehhez:

# cvsup supfile

ahol a supfile a frissen létrehozott supfile állományunk neve lesz. Feltételezve, hogy a parancsot X11 alatt adtunk ki, az cvsup erre feldob egy grafikus ablakot néhány gombbal. Nyomjuk meg a go feliratú gombot és dőljünk hátra.

Mivel a példában a /usr/src könyvtárunk frissítését állítottuk be, az állományok aktualizálásához szükséges jogosultságok biztosításához a cvsup programot root felhasználóként kell elindítanunk. Teljesen érthető, ha egy kicsit izgatottak vagyunk ezekben a pillanatokban, hiszen az előbb hoztunk létre egy általunk eddig ismeretlen programhoz egy konfigurációs állományt. Ezért megemlítenénk, hogy ilyenkor először mindig próbáljuk ki a konfigurációkat, mielőtt azok bármilyen módosítást végeznének a fontos állományainkon. Ehhez hozzunk létre valahol egy üres könyvtárat, majd adjuk meg a parancssorban ennek a nevét:

# mkdir /var/tmp/proba
# cvsup supfile /var/tmp/proba

Az így megadott könyvtárba kerülnek a frissítés eredményeképpen keletkező állományok. A CVSup először megvizsgálja a /usr/src könyvtárban található állományokat, viszont egyiküket sem módosítja vagy törli. A frissítések ehelyett a /var/tmp/proba/usr/src könyvtárba fognak kerülni. A CVSup emellett még a báziskönyvtárában tárolt állapotokat sem fogja megváltoztatni. A módosított állományok új változatai a megadott könyvtárba jönnek létre. Mivel a /usr/src könyvtárt ehhez csak olvasni fogjuk, a próba lefuttatásához még root felhasználónak sem kell lennünk.

Ha nem használunk X11-et vagy egyszerűen csak nincs szükségünk a grafikus felületre, a parancssorban pár további opció megadásával így is kiadhatjuk a cvsup parancsot:

# cvsup -g -L 2 supfile

A -g hatására a CVSup nem hozza be a grafikus felületét. Ha nem talál X11-et, akkor ez természetesen automatikus, de ellenkező esetben ezt is meg kell adnunk.

Az -L 2 megadásával a CVSup az összes elvégzendő frissítésről részletes értesítést ad. A részletességnek három foka van, -L 0-tól indulva egészen -L 2-ig. Itt az alapértelmezett érték a 0, amivel a hibaüzenetek kivételével egyetlen üzenetet sem kapunk.

Rengeteg egyéb beállítás adható még meg, ezeket a cvsup -H kiadásával kérdezhetjük le. A beállítások pontosabb leírását a man oldalon találjuk meg.

Miután elégedetten tapasztaltuk, hogy a frissítés remekül működik, a cron(8) segítségével próbáljuk meg az egész folyamatot önműködövé tenni a CVSup szabályos időközönkénti futtatásával. Ekkor viszont magától értetődik, hogy a CVSup számára ne engedjük használni a grafikus felületet.

A.6.5. A CVSup állománygyűjteményei

A CVSup révén elérhető állománygyűjtemények egy hierarchikus rendszert alkotnak. Van néhány nagyobb állománygyűjtemény, amelyek kisebb al-állománygyűjteményekre bonthatóak. A nagyobb gyűjtemények letöltése ezért a kisebb algyűjtemények letöltésével egyenlő. A gyűjtemények közt fennálló hierarchikus rendszer a lentebb szereplő lista behúzásaiban érhető tetten.

A leggyakrabban használt gyűjtemények a src-all és a ports-all neveket viselik. A többi gyűjteményt általában csak kevesen és csak speciális célokra használják, ezért egyes tükrözéseken nem feltétlenül találjuk meg mindegyiküket.

A.6.6. Bővebb információk

A CVSup részletesebb bemutatását és a hozzá tartozó GYIK-ot A CVSup honlapján találjuk meg.

A CVSup FreeBSD-re vonatkozó tárgyalása a FreeBSD technical discussions levelezési listan történik. Itt és az FreeBSD announcements levelezési listan jelentik be a szoftver újabb változatait.

A CVSup alkalmazással kapcsolatos kérdéseket és hibajelentéseket illetően a CVSup GYIK-ot érdemes megnéznünk.

A.6.7. CVSup oldalak

A FreeBSD CVSup szerverei az alábbi oldalakon érhetőek el:

Központi szerverek, Elsődleges tükrözések, Amerikai Egyesült Államok, Ausztrália, Ausztria, Brazília, Costa Rica, Cseh Köztársaság, Dánia, Dél-Afrika, Egyesült Királyság, Észtország, Finnország, Franciaország, Fülöp-szigetek, Görögország, Hollandia, Írország, Izland, Izrael, Japán, Kanada, Kína, Kirgizisztán, Korea, Kuvait, Lengyelország, Lettország, Litvánia, Magyarország, Németország, Norvégia, Olaszország, Örményország, Oroszország, Portugália, Románia, San Marino, Spanyolország, Svájc, Svédország, Szlovák Köztársaság, Szlovénia, Tajvan, Thaiföld, Törökország, Új-Zéland, Ukrajna.

(Dátum: UTC)