Make Debian build rule depend on documentation source.
+build-stamp: doc/carnet-upgrade.sgml
dh_testdir
# Build the package.
dh_testdir
# Build the package.
<book>
<titlepag>
<title>CARNet Debian 4.0 (etch) nadogradnja</title>
<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
<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>
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
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
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
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
- Backup OpenLDAPa napravite koristeći naredbu slapcat:
+ Backup OpenLDAPa napravite koristeći naredbu <prgn>slapcat</prgn>:
<example>
# slapcat -l /var/backups/slapcat.cn-upgrade
<example>
# slapcat -l /var/backups/slapcat.cn-upgrade
- 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
<example>
# /etc/init.d/slapd start
<p>
Za više informacija o backupu OpenLDAP baze pogledajte man stranicu
<p>
Za više informacija o backupu OpenLDAP baze pogledajte man stranicu
+ naredbe <prgn>slapcat</prgn>.
- 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">.
# mv /var/lib/postgres/postgres.sql.cn-upgrade /var/backups
</example>
# 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>
Prije instalacije paketa za nadogradnju i same nadogradnje, potrebno
je izvršiti nadogradnju tekuće inačice distribucije na najsvježije
<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
<example>
# apt-get update
<sect><heading>Paket carnet-upgrade</heading>
<p>
<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:
# apt-get install carnet-upgrade
</example>
</p>
# 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
<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
<example>
deb http://ftp.carnet.hr/carnet-debian carnet-sarge main non-free
<p>
U sljedećem koraku biti će izvršena provjera nadogradnje na zadnju
<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
<example>
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
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
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
- 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.
- 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>.
- 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>.
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
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.
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
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>
<list>
<item>/etc/apache/httpd.conf</item>
<p>
Nakon uspješne nadogradnje možete obrisati skinute pakete koji
<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
<example>
# apt-get clean
<chapt id="izvanredne">
<heading>Izvanredne situacije</heading>
<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>
- 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/
<example>
# mv /var/cache/apt/archives /home/apt-archives/
- 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
<example>
# rm /var/cache/apt/archives # mv /home/apt-archives
<sect><heading>Problemi sa apt-get</heading>
<p>
U slučaju greške u nekom paketu, može se dogoditi da kod instalacije
<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
<example>
# dpkg -configure -a
# apt-get install carnet-upgrade
</example>
# 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
<example>
# mv /var/cache/apt/archives /home/apt-archives
# carnet-upgrade
</example>
# 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
/etc/init.d/*
sendmail, sve sto ima veze s njim
/etc/xinetd.conf
/etc/services
/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
<example>
dpkg --configure -a
# apt-get clean
</example>
# 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!