Documentation fixes.
authorValentin Vidic <vvidic@carnet.hr>
Tue, 15 Jan 2008 16:13:08 +0000 (17:13 +0100)
committerValentin Vidic <vvidic@carnet.hr>
Tue, 15 Jan 2008 16:13:08 +0000 (17:13 +0100)
Make Debian build rule depend on documentation source.

debian/rules
doc/carnet-upgrade.sgml

index 91ccbe6..a1c4f89 100755 (executable)
@@ -11,7 +11,7 @@
 
 build: build-stamp
 
-build-stamp:
+build-stamp: doc/carnet-upgrade.sgml
        dh_testdir
 
        # Build the package.
index a47feae..d9209eb 100644 (file)
@@ -4,18 +4,25 @@
   <book>
     <titlepag>
       <title>CARNet Debian 4.0 (etch) nadogradnja</title>
-      <author>Valentin Vidić</author>
+      <author>
+        <name>Zoran Dželalija</name>
+      </author>
+      <author>
+        <name>Ivan 'ico' Rako</name>
+      </author>
+      <author>
+        <name>Valentin Vidić</name>
+      </author>
       <version>Verzija 4.0.0</version>
 
       <abstract>
         Ovaj priručnik opisuje postupak nadogradnje CARNet Debian
         distribucije sa verzije 2.1 (sarge) na verziju 4.0 (etch).
         Priručnik je zamišljen kao pomoć CARNetovim sistem inženjerima
-        koji na svojim poslužiteljima imaju instaliran CARNet Debian 2.1
-        (sarge) i žele prijeći na CARNet Debian 4.0 (etch). Trebao bi
-        obuhvatiti cjelokupan postupak nadogradnje, kao i tipične probleme
-        na koje se može naići. Za tu svrhu pripremili smo paket
-        carnet-upgrade verzije 4.0, koji se nalazi na CARNetovom FTP
+        koji na svojim poslužiteljima imaju instaliran CARNet Debian i
+        trebao bi obuhvatiti cjelokupan postupak nadogradnje, kao i 
+        tipične probleme na koje se može naići. Za tu svrhu pripremili smo
+        paket carnet-upgrade verzije 4.0, koji se nalazi na CARNetovom FTP
         poslužitelju u Sarge repozitoriju paketa.
       </abstract>
     </titlepag>
         preporučuje izvršiti backup trenutnog stanja sustava, tako da u
         slučaju bilo kakvih problema bude moguć povratak na stanje prije
         nadogradnje. Nakon izvršenog backupa treba provjeriti mogu li se
-        vratiti podaci s takve kopije, na primjer vraćanjem sadržaja na neko
-        drugo računalo, rezervni disk, ili barem probom vraćanja nekoliko
+        vratiti podaci s takve kopije, npr. vraćanjem sadržaja na neko
+        drugo računalo, rezervni disk, ili barem probnim vraćanja nekoliko
         datoteka. Datotečni sustav se može backupirati na uobičajeni način,
         korištenjem tračnog uređaja (dump/restore, tar...), ili drukčije. Za
-        ovu svrhu preporučujemo full odnosno level 0 backup. Također je
-        potrebno osigurati ispravnost pohranjenih podataka, što znaci da
-        baze podataka poput OpenLDAP, MySQL ili PostgreSQL, treba
+        ovu svrhu preporučujemo backup svih podataka (level 0 backup).
+        Također je potrebno osigurati ispravnost pohranjenih podataka, što
+        znaci da baze podataka poput OpenLDAP, MySQL ili PostgreSQL, treba
         backupirati na ispravan način, jer backup datotečnog sustava za
         takve servise nije dovoljan i ne garantira ispravnost i
         konzistenciju podataka. Svaka baza podataka donosi zasebne programe
@@ -60,7 +67,7 @@
         </p>
 
         <p>
-        Backup OpenLDAPa napravite koristeći naredbu slapcat:
+        Backup OpenLDAPa napravite koristeći naredbu <prgn>slapcat</prgn>:
 
 <example>
 # slapcat -l /var/backups/slapcat.cn-upgrade
@@ -68,9 +75,9 @@
         </p>
 
         <p>
-        Umjesto /var/backups/slapcat.cn-upgrade možete upisati bilo koje ime
-        za izlaznu datoteku. Nakon toga možete vratiti servise u radno
-        stanje:
+        Umjesto <file>/var/backups/slapcat.cn-upgrade</file> možete upisati
+        bilo koje ime za izlaznu datoteku. Nakon toga možete vratiti servise
+        u radno stanje:
 
 <example>
 # /etc/init.d/slapd start
@@ -80,7 +87,7 @@
 
         <p>
         Za više informacija o backupu OpenLDAP baze pogledajte man stranicu
-        naredbe slapcat.
+        naredbe <prgn>slapcat</prgn>.
         </p>
       </sect>
 
         </p>
 
         <p>
-        Za više informacija o backupu MySQL baze pogledajte MySQL priručnik,
-        poglavlje 4.4.1 Database backups. Priručnik se nalazi u paketu
-        mysql-doc.
+        Za više informacija o backupu MySQL baze pogledajte
+        <url name="MySQL dokumentaciju" 
+        id="http://dev.mysql.com/doc/refman/4.1/en/disaster-prevention.html">.
         </p>
       </sect>
 
 # mv /var/lib/postgres/postgres.sql.cn-upgrade /var/backups
 </example>
 
-        Ovo je samo općenita uputa. Za više informacija o backupu PostgreSQL
-        baze za inačicu 7.2, pogledajte sljedeću adresu:
-        http://www.postgresql.org/docs/7.2/static/app-pg-dumpall.html
+        Za više informacija o backupu PostgreSQL baze podataka pogledajte
+        <url name="PosgreSQL dokumentaciju"
+        id="http://www.postgresql.org/docs/7.2/static/backup.html">.
         </p>
       </sect>
     </chapt>
         <p>
         Prije instalacije paketa za nadogradnju i same nadogradnje, potrebno
         je izvršiti nadogradnju tekuće inačice distribucije na najsvježije
-        pakete. To se najjednostavnije izvodi sa naredbom apt-get:
+        pakete. To se najjednostavnije izvodi sa naredbom
+        <prgn>apt-get</prgn>:
 
 <example>
 # apt-get update
 
       <sect><heading>Paket carnet-upgrade</heading>
         <p>
-        U paketu carnet-upgrade nalazi se istoimena skripta, koja služi za
-        nadogradnju poslužitelja. Skripta carnet-upgrade zapisuje izvršene
-        radnje u datoteku /var/log/carnet-upgrade.log, koju možete
-        konzultirati u slučaju nepredviđenih problema da bi ustanovili do
-        koje faze je skripta stigla s radom. Pored skripte, u paketu se
-        nalazi i kompletna dokumentacija. Paket se instalira na uobičajen
-        način:
+        U paketu <prgn>carnet-upgrade</prgn> nalazi se istoimena skripta,
+        koja služi za nadogradnju poslužitelja. Skripta carnet-upgrade
+        zapisuje izvršene radnje u datoteku
+        <file>/var/log/carnet-upgrade.log</file>, koju možete konzultirati u
+        slučaju nepredviđenih problema da bi ustanovili do koje faze je
+        skripta stigla s radom. Pored skripte, u paketu se nalazi i
+        kompletna dokumentacija. Paket se instalira na uobičajen način:
 
 <example>
-# apt-get update *
+# apt-get update
 # apt-get install carnet-upgrade
 </example>
         </p>
         <p>
         Time ste instalirali paket koji je potreban za upgrade. Ukoliko
         paket nije dostupan, postoji mogućnost da nemate ispravne postavke
-        za repozitorij CARNetovih paketa u /etc/apt/sources.list datoteci,
-        koja treba sadržavati sljedeći redak:
+        za repozitorij CARNetovih paketa u
+        <file>/etc/apt/sources.list</file> datoteci, koja treba sadržavati
+        sljedeći redak:
 
 <example>
 deb http://ftp.carnet.hr/carnet-debian carnet-sarge main non-free
@@ -212,9 +221,10 @@ Script started, file is upgrade.log
 
         <p>
         U sljedećem koraku biti će izvršena provjera nadogradnje na zadnju
-        inačicu prethodne distribucije za kritične servise (amavisd-cn,
-        bind9-cn, clamav-cn, nessus-cn). Ako neki od njih najnovije inačice,
-        pojavit će se poruka:
+        inačicu prethodne distribucije za kritične servise
+        (<prgn>amavisd-cni</prgn>, <prgn>bind9-cn</prgn>,
+        <prgn>clamav-cn</prgn>, <prgn>nessus-cn</prgn>). Ako neki od njih
+        najnovije inačice, pojavit će se poruka:
 
 <example>
 CARNet Debian 2.1 ­ Nadogradnja distribucije sa CARNet Debian 1.x str. 7/14
@@ -225,7 +235,7 @@ CARNet Debian 2.1 ­ Nadogradnja distribucije sa CARNet Debian 1.x str. 7/14
         Izvršite navedene upute, napravite dist-upgrade, te ponovno
         pokrenite skriptu. Ako je sve uredno instalirano, skripta će otići
         na idući korak. Instalacija prethodne inačice CARNetove
-        distribucije, CARNet Linux 1, donosila je mnoštvo programskih paketa
+        distribucije, CARNet Linux 2, donosila je mnoštvo programskih paketa
         koji nisu nužno potrebni za uobičajen rad poslužiteljskog računala.
         Brisanjem tih aplikacija ubrzati ćete proceduru nadogradnje, kao i
         smanjiti zauzeće diskovnog prostora. Sve aplikacije koje ostanu
@@ -235,10 +245,11 @@ CARNet Debian 2.1 ­ Nadogradnja distribucije sa CARNet Debian 1.x str. 7/14
         </p>
 
         <p>
-        U sljedećem koraku skripta će provjeriti da li u /etc/dpkg/dpkg.cfg
-        postoji opcija force-overwrite koja nije preporučljiva za uobičajen
-        rad. Ako postoji, zakomentirat će je, i krenuti dalje. Ukoliko je
-        želite koristiti, nakon nadogradnje je odkomentirajte.
+        U sljedećem koraku skripta će provjeriti da li u
+        <file>/etc/dpkg/dpkg.cfg</file> postoji opcija
+        <tt>force-overwrite</tt> koja nije preporučljiva za uobičajen rad.
+        Ako postoji, zakomentirat će je, i krenuti dalje. Ukoliko je želite
+        koristiti, nakon nadogradnje je odkomentirajte.
         </p>
 
         <p>
@@ -254,18 +265,18 @@ CARNet Debian 2.1 ­ Nadogradnja distribucije sa CARNet Debian 1.x str. 9/14
         </p>
 
         <p>
-        Ova skripta će napraviti i backup direktorija /etc. Ako će biti
-        potrebna neka stara konfiguracijska datoteka, potražite je pomoću
-        naredbe tar u arhivi /var/backups/etc.tar.gz.
+        Ova skripta će napraviti i backup direktorija <file>/etc</file>. Ako
+        će biti potrebna neka stara konfiguracijska datoteka, potražite je
+        pomoću naredbe tar u arhivi <file>/var/backups/cn4-etc.tar.gz</file>.
         </p>
 
         <p>
-        Slijedi instalacija /etc/apt/sources.list datoteke podešene za
-        CARNet Debian 4.0, s uključenim repozitorijima za CARNetove i Debian
-        Etch pakete, te obnova apt baze paketa. Vaše dodatne repozitorije
-        nakon završetka rada ove skripte možete kopirati u tu datoteku iz
-        stare datoteke, koja će biti spremljena kao
-        /etc/apt/sources.list.cn-upgrade.
+        Slijedi instalacija <file>/etc/apt/sources.list</file> datoteke
+        podešene za CARNet Debian 4.0, s uključenim repozitorijima za
+        CARNetove i Debian Etch pakete, te obnova apt baze paketa. Vaše
+        dodatne repozitorije nakon završetka rada ove skripte možete
+        kopirati u tu datoteku iz stare datoteke, koja će biti spremljena
+        kao <file>/etc/apt/sources.list.cn-upgrade</file>.
         </p>
 
         <p>
@@ -275,15 +286,15 @@ CARNet Debian 2.1 ­ Nadogradnja distribucije sa CARNet Debian 1.x str. 9/14
         40 minuta. Cijela nadogradnja je "teška" oko 400-700MB, ovisno o
         instaliranom softveru. U slučaju da nakon skidanja paketa nemate
         dovoljno prostora za fazu nadogradnje (cca 200MB), skripta će
-        prekinuti s radom. Kad oslobodite dovoljno prostora na /var
-        particiji, ponovo pokrenite carnet-upgrade. Nakon ovoga kreće
-        instalacija novih paketa, tj. sama nadogradnja. Prilikom procesa
-        nadogradnje Debianov paketni sustav će postaviti veći broj upita
-        vezanih za izmjenu konfiguracijskih datoteka. Radi optimalnog rada
-        sustava nakon nadogradnje, pripremili smo popis upita za koje
-        preporučujemo odgovore koji nisu podrazumni (eng. default). Najčešće
-        se radi o forsiranoj instalaciji novih inačica konfiguracijskih
-        datoteka.
+        prekinuti s radom. Kad oslobodite dovoljno prostora na
+        <file>/var</file> particiji, ponovo pokrenite
+        <prgn>carnet-upgrade</prgn>. Nakon ovoga kreće instalacija novih
+        paketa, tj. sama nadogradnja. Prilikom procesa nadogradnje Debianov
+        paketni sustav će postaviti veći broj upita vezanih za izmjenu
+        konfiguracijskih datoteka. Radi optimalnog rada sustava nakon
+        nadogradnje, pripremili smo popis upita za koje preporučujemo
+        odgovore koji nisu podrazumni (eng. default). Najčešće se radi o
+        forsiranoj instalaciji novih inačica konfiguracijskih datoteka.
         </p>
 
         <p>
@@ -293,13 +304,13 @@ CARNet Debian 2.1 ­ Nadogradnja distribucije sa CARNet Debian 1.x str. 9/14
         navedene datoteke će biti upućena ili putem debconf sučelja, ili
         putem tekstualnog sučelja. Ukoliko ste vlastoručno mijenjali neku od
         tih datoteka, možete pogledati razlike između stare i nove datoteke
-        (odgovor d, od eng. differences ­ razlike) i prenijeti izmjene u
-        novu datoteku ukoliko je potrebno. To se može učiniti odabirom
-        izbora z, koji će pokrenuti novu ljusku iz koje možete izvršiti
-        željene izmjene, i nakon njih se s naredbom exit vratiti u postupak
-        instalacije. Datoteke za koje preporučamo zamjenu novim inačicama su
-        sljedeće (preporučeni izbor je "install the package maintainer's
-        version"):
+        (odgovor <tt>d</tt>, od eng. differences ­ razlike) i prenijeti
+        izmjene u novu datoteku ukoliko je potrebno. To se može učiniti
+        odabirom izbora <tt>z</tt>, koji će pokrenuti novu ljusku iz koje
+        možete izvršiti željene izmjene, i nakon njih se s naredbom
+        <prgn>exit</prgn> vratiti u postupak instalacije. Datoteke za koje
+        preporučamo zamjenu novim inačicama su sljedeće (preporučeni izbor
+        je "install the package maintainer's version"):
 
         <list>
           <item>/etc/apache/httpd.conf</item>
@@ -340,7 +351,8 @@ CARNet Debian 2.1 ­ Nadogradnja distribucije sa CARNet Debian 1.x str. 9/14
 
         <p>
         Nakon uspješne nadogradnje možete obrisati skinute pakete koji
-        zauzimaju diskovni prostor na /var particiji. To napravite naredbom:
+        zauzimaju diskovni prostor na <file>/var</file> particiji. To
+        napravite naredbom:
 
 <example>
 # apt-get clean
@@ -352,14 +364,15 @@ CARNet Debian 2.1 ­ Nadogradnja distribucije sa CARNet Debian 1.x str. 9/14
     <chapt id="izvanredne">
       <heading>Izvanredne situacije</heading>
 
-      <sect><heading>Premalo mjesta na /var particiji</heading>
+      <sect><heading>Premalo mjesta na <file>/var</file> particiji</heading>
 
         <p>
-        Ako imate premalo mjesta na /var particiji, skripta neće moći skinuti
-        potrebne pakete, i neće htjeti nastaviti nadogradnju. To možete
-        riješiti tako da direktorij /var/cache/apt/archives prebacite na
-        neki drugi disk, te da to polinkate. Kratka kuharica je (u slučaju
-        /home particije):
+        Ako imate premalo mjesta na <file>/var</file> particiji, skripta
+        neće moći skinuti potrebne pakete, i neće htjeti nastaviti
+        nadogradnju. To možete riješiti tako da direktorij
+        <file>/var/cache/apt/archives</file> prebacite na neki drugi disk,
+        te da to polinkate. Kratka kuharica je (u slučaju <file>/home</file>
+        particije):
 
 <example>
 # mv /var/cache/apt/archives /home/apt-archives/
@@ -368,9 +381,9 @@ CARNet Debian 2.1 ­ Nadogradnja distribucije sa CARNet Debian 1.x str. 9/14
         </p>
 
         <p>
-        Time će se paketi skidati na /home particiju, na kojoj ima više
-        mjesta. Nakon uspješne nadogradnje, vratite cache direktorij na staro
-        mjesto:
+        Time će se paketi skidati na <file>/home</file> particiju, na kojoj
+        ima više mjesta. Nakon uspješne nadogradnje, vratite cache
+        direktorij na staro mjesto:
 
 <example>
 # rm /var/cache/apt/archives # mv /home/apt-archives
@@ -382,8 +395,8 @@ CARNet Debian 2.1 ­ Nadogradnja distribucije sa CARNet Debian 1.x str. 9/14
       <sect><heading>Problemi sa apt-get</heading>
         <p>
         U slučaju greške u nekom paketu, može se dogoditi da kod instalacije
-        apt-get pukne i instalacija se prekine. U tom slučaju, za početak
-        treba dovršiti instalaciju već otpakiranih paketa:
+        <prgn>apt-get</prgn> pukne i instalacija se prekine. U tom slučaju,
+        za početak treba dovršiti instalaciju već otpakiranih paketa:
 
 <example>
 # dpkg -configure -a
@@ -431,7 +444,8 @@ CARNet Debian 2.1 ­ Nadogradnja distribucije sa CARNet Debian 1.x str. 9/14
 # apt-get install carnet-upgrade
 </example>
 
-Ima li cca 600MB slobodno na /var? A nakon apt-get clean? Ako nema,
+Ima li cca 600MB slobodno na <file>/var</file>? A nakon <prgn>apt-get
+clean</prgn>? Ako nema,
 
 <example>
 # mv /var/cache/apt/archives /home/apt-archives
@@ -439,7 +453,7 @@ Ima li cca 600MB slobodno na /var? A nakon apt-get clean? Ako nema,
 # carnet-upgrade
 </example>
 
-Odgovoriti sa [Y], odn. "install package maintainer's version":
+Odgovoriti sa <tt>Y</tt>, odn. "install package maintainer's version":
 
 /etc/init.d/*
 sendmail, sve sto ima veze s njim
@@ -454,8 +468,8 @@ snort, sve /etc/snort/*
 /etc/xinetd.conf
 /etc/services
 
-Ignorirati poruke o izmjenama u lilo.conf (ali provjeriti radi li nakon
-reboota)
+Ignorirati poruke o izmjenama u <file>lilo.conf</file> (ali provjeriti radi
+li nakon reboota)
 
 <example>
 dpkg --configure -a
@@ -486,8 +500,8 @@ Ako instalacija pukne: # # # #
 # apt-get clean
 </example>
 
-      Ako ste premjestili /var/cache/apt/archives, možete ga sada vratiti na
-      staro mjesto. ... i to je to!
+      Ako ste premjestili <file>/var/cache/apt/archives</file>, možete ga
+      sada vratiti na staro mjesto. ... i to je to!
       </p>
     </appendix>