From 21211c8229d23372f7c095cacdd85e8dc796770f Mon Sep 17 00:00:00 2001 From: Valentin Vidic Date: Tue, 15 Jan 2008 17:13:08 +0100 Subject: [PATCH] Documentation fixes. Make Debian build rule depend on documentation source. --- debian/rules | 2 +- doc/carnet-upgrade.sgml | 182 +++++++++++++++++++++++++---------------------- 2 files changed, 99 insertions(+), 85 deletions(-) diff --git a/debian/rules b/debian/rules index 91ccbe6..a1c4f89 100755 --- a/debian/rules +++ b/debian/rules @@ -11,7 +11,7 @@ build: build-stamp -build-stamp: +build-stamp: doc/carnet-upgrade.sgml dh_testdir # Build the package. diff --git a/doc/carnet-upgrade.sgml b/doc/carnet-upgrade.sgml index a47feae..d9209eb 100644 --- a/doc/carnet-upgrade.sgml +++ b/doc/carnet-upgrade.sgml @@ -4,18 +4,25 @@ CARNet Debian 4.0 (etch) nadogradnja - Valentin Vidić + + Zoran Dželalija + + + Ivan 'ico' Rako + + + Valentin Vidić + Verzija 4.0.0 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. @@ -31,13 +38,13 @@ 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 @@

- Backup OpenLDAPa napravite koristeći naredbu slapcat: + Backup OpenLDAPa napravite koristeći naredbu slapcat: # slapcat -l /var/backups/slapcat.cn-upgrade @@ -68,9 +75,9 @@

- 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 /var/backups/slapcat.cn-upgrade možete upisati + bilo koje ime za izlaznu datoteku. Nakon toga možete vratiti servise + u radno stanje: # /etc/init.d/slapd start @@ -80,7 +87,7 @@

Za više informacija o backupu OpenLDAP baze pogledajte man stranicu - naredbe slapcat. + naredbe slapcat.

@@ -95,9 +102,9 @@

- 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 + .

@@ -111,9 +118,9 @@ # mv /var/lib/postgres/postgres.sql.cn-upgrade /var/backups - 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 + .

@@ -126,7 +133,8 @@

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 + apt-get: # apt-get update @@ -137,16 +145,16 @@ Paket carnet-upgrade

- 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 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: -# apt-get update * +# apt-get update # apt-get install carnet-upgrade

@@ -154,8 +162,9 @@

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 + /etc/apt/sources.list datoteci, koja treba sadržavati + sljedeći redak: deb http://ftp.carnet.hr/carnet-debian carnet-sarge main non-free @@ -212,9 +221,10 @@ Script started, file is upgrade.log

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 + (amavisd-cni, bind9-cn, + clamav-cn, nessus-cn). Ako neki od njih + najnovije inačice, pojavit će se poruka: 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

- 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 + /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.

@@ -254,18 +265,18 @@ CARNet Debian 2.1 ­ Nadogradnja distribucije sa CARNet Debian 1.x str. 9/14

- 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 /etc. Ako + će biti potrebna neka stara konfiguracijska datoteka, potražite je + pomoću naredbe tar u arhivi /var/backups/cn4-etc.tar.gz.

- 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 /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.

@@ -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 + /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.

@@ -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 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"): /etc/apache/httpd.conf @@ -340,7 +351,8 @@ CARNet Debian 2.1 ­ Nadogradnja distribucije sa CARNet Debian 1.x str. 9/14

Nakon uspješne nadogradnje možete obrisati skinute pakete koji - zauzimaju diskovni prostor na /var particiji. To napravite naredbom: + zauzimaju diskovni prostor na /var particiji. To + napravite naredbom: # apt-get clean @@ -352,14 +364,15 @@ CARNet Debian 2.1 ­ Nadogradnja distribucije sa CARNet Debian 1.x str. 9/14 Izvanredne situacije - Premalo mjesta na /var particiji + Premalo mjesta na /var particiji

- 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 /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): # 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

- 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 /home particiju, na kojoj + ima više mjesta. Nakon uspješne nadogradnje, vratite cache + direktorij na staro mjesto: # 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 Problemi sa apt-get

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: + apt-get pukne i instalacija se prekine. U tom slučaju, + za početak treba dovršiti instalaciju već otpakiranih paketa: # 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 -Ima li cca 600MB slobodno na /var? A nakon apt-get clean? Ako nema, +Ima li cca 600MB slobodno na /var? A nakon apt-get +clean? Ako nema, # 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 -Odgovoriti sa [Y], odn. "install package maintainer's version": +Odgovoriti sa Y, 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 lilo.conf (ali provjeriti radi +li nakon reboota) dpkg --configure -a @@ -486,8 +500,8 @@ Ako instalacija pukne: # # # # # apt-get clean - Ako ste premjestili /var/cache/apt/archives, možete ga sada vratiti na - staro mjesto. ... i to je to! + Ako ste premjestili /var/cache/apt/archives, možete ga + sada vratiti na staro mjesto. ... i to je to!

-- 1.7.10.4