Fix documentation.
[carnet-upgrade.git] / doc / carnet-upgrade-src.sgml
index f12c44f..ee5ceda 100644 (file)
@@ -3,7 +3,7 @@
   <book>
 
     <titlepag>
-      <title>CARNet Debian 4.0 (etch) nadogradnja</title>
+      <title>CARNet Debian 6.0 (squeeze) nadogradnja</title>
       <author>
         <name>Grupa za izradu paketa</name>
         <email>paketi@carnet.hr</email>
       <version>Verzija %PKG_VERSION%</version>
 
       <abstract>
-        CARNet Debian <em>etch</em> je treća generacija CARNet Debian
-        distribucije i temelji se na Debian GNU/Linux <em>etch</em>
-        distribuciji što je od sada vidljivo i iz inačice distribucije -
-        CARNet Debian 4.0 <em>etch</em>. Ovaj priručnik opisuje postupak
-        nadogradnje CARNet Debian distribucije sa inačice 2.1 <em>sarge</em>
-        na inačicu 4.0 <em>etch</em>.  Priručnik je zamišljen kao pomoć
-        CARNetovim sistem inženjerima koji na svojim poslužiteljima imaju
-        instaliran CARNet Debian i trebao bi obuhvatiti cjelokupan postupak
+        CARNet Debian <em>squeeze</em> je peta generacija CARNet Debian
+        distribucije i temelji se na Debian GNU/Linux <em>squeeze</em>.
+        Ovaj priručnik opisuje postupak nadogradnje CARNet Debian
+        distribucije sa inačice 5.0 <em>lenny</em> na inačicu 6.0
+        <em>squeeze</em>.  Priručnik je zamišljen kao pomoć CARNetovim
+        sistem inženjerima 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 <package>carnet-upgrade</package> inačice
-        4.0, koji se nalazi na CARNetovom FTP poslužitelju u <em>sarge</em>
+        6.0, koji se nalazi na CARNetovom FTP poslužitelju u <em>lenny</em>
         repozitoriju paketa.
       </abstract>
     </titlepag>
@@ -55,7 +54,7 @@
       <sect><heading>OpenLDAP</heading>
         <p>
         Prije backupa OpenLDAP-a potrebno je spustiti FreeRADIUS i OpenLDAP
-        servise. FreeRADIUS je potrebno ugasiti da bi CMU usluga nastavila
+        servise. FreeRADIUS je potrebno ugasiti da bi AAIEdu usluga nastavila
         funkcionirati za vrijeme backupa, jer lokalni FreeRADIUS daemon radi
         neispravno ukoliko je LDAP poslužitelj nedostupan. To radite na
         sljedeći način:
         <p>
         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">.
+        id="http://dev.mysql.com/doc/refman/5.1/en/backup-and-recovery.html">.
         </p>
       </sect>
 
         Backup PostgreSQL baze podataka možete napraviti na sljedeći način:
 
 <example>
-# su - postgres -c /usr/lib/postgresql/bin/pg_dumpall \
+# su - postgres -c pg_dumpall \
     >/var/lib/postgres/postgres.sql.carnet-upgrade
 # mv /var/lib/postgres/postgres.sql.carnet-upgrade /var/backups
 </example>
         <p>
         Za više informacija o backupu PostgreSQL baze podataka pogledajte
         <url name="PosgreSQL dokumentaciju"
-        id="http://www.postgresql.org/docs/7.4/static/backup.html">.
+        id="http://www.postgresql.org/docs/8.4/static/backup.html">.
         </p>
       </sect>
     </chapt>
       <sect>
         <heading>Prije početka</heading>
         <p>
-        Prije nadogradnje na <em>etch</em> distribuciju, potrebno je
-        izvršiti nadogradnju <em>sarge</em> distribucije na najsvježije
+        Prije nadogradnje na <em>squeeze</em> distribuciju, potrebno je
+        izvršiti nadogradnju <em>lenny</em> distribucije na najsvježije
         pakete. To se najjednostavnije izvodi naredbom <prgn>apt-get</prgn>:
 
 <example>
         </p>
 
         <p>
-        Ovime ste instalirali paket koji je potreban za upgrade. Ukoliko
+        Ovime ste instalirali paket koji je potreban za nadogradnju. Ukoliko
         paket nije dostupan, moguće je da nemate ispravne postavke za
         repozitorij CARNetovih paketa u
         <file>/etc/apt/sources.list</file> datoteci:
 
 <example>
-deb http://ftp.carnet.hr/carnet-debian sarge main non-free
+deb http://ftp.carnet.hr/carnet-debian carnet-lenny main non-free
 </example>
         </p>
 
         <p>
-        To je uobičajena konfiguracija CARNet Debian <em>sarge</em>
+        To je uobičajena konfiguracija CARNet Debian <em>lenny</em>
         repozitorija. Ako tog retka nema, dodajte ga i ponovite
         postupak instalacije <package>carnet-upgrade</package> paketa.
         </p>
@@ -188,7 +187,7 @@ deb http://ftp.carnet.hr/carnet-debian sarge main non-free
 
 <example>
 # carnet-upgrade
-Script started on Sun Mar 30 12:21:27 2008
+Script started on Sun Mar 30 12:21:27 2011
 CN: run_actions (main) started...
 </example>
         </p>
@@ -199,7 +198,7 @@ CN: run_actions (main) started...
 
 <example>
 +-----------------------------------------------------------------+
-| Nadogradnja CARNet Debian Sarge->Etch                           |
+| Nadogradnja CARNet Debian Lenny->Squeeze                        |
 +-----------------------------------------------------------------+
 | PAZNJA! PAZNJA!                                                 |
 |                                                                 |
@@ -222,44 +221,18 @@ CN: run_actions (main) started...
         </p>
 
         <p>
-        Prije nadogradnje na <em>etch</em>, potrebno je izvršiti
-        prijelaz sa Apache inačice 1.3 na Apache 2.0. Ukoliko je na
-        sustavu još uvijek instaliran Apache 1.3 pojavit će se
-        poruka:
-
-<example>
-+-----------------------------------------------------------------+
-| Nadogradnja CARNet Debian Sarge->Etch                           |
-+-----------------------------------------------------------------+
-|                                                                 |
-| Prije prelaska na Debian Etch potrebno je napraviti nadogradnju |
-| sa Apache 1.3 na Apache 2.0.                                    |
-|                                                                 |
-| Pokrenite:                                                      |
-|   # apt-get update                                              |
-|   # apt-get install apache2-cn                                  |
-|                                                                 |
-| Nakon toga ponovno pozovite ovu skriptu.                        |
-|                                                                 |
-+-----------------------------------------------------------------+
-|                           < U redu >                            |
-+-----------------------------------------------------------------+
-</example>
-        </p>
-
-        <p>
-        U sljedećem koraku biti će izvršena provjera dali su najvažniji
-        servisi nadograđeni na najnovije inačice u <em>sarge</em>
+        U sljedećem koraku biti će izvršena provjera jesu li najvažniji
+        servisi nadograđeni na najnovije inačice u <em>lenny</em>
         distribuciji.  Ako neki od instaliranih servisa nije najnovija
         inačica, pojavit će se poruka:
 
 <example>
 +-----------------------------------------------------------------+
-| Nadogradnja CARNet Debian Sarge->Etch                           |
+| Nadogradnja CARNet Debian Lenny->Squeeze                        |
 +-----------------------------------------------------------------+
 |                                                                 |
-| Prije prelaska na Debian Etch potrebno je napraviti nadogradnju |
-| ovih paketa:                                                    |
+| Prije prelaska na Debian Squeeze potrebno je napraviti          |
+| nadogradnju ovih paketa:                                        |
 |    amavisd-cn                                                   |
 |                                                                 |
 | Pokrenite:                                                      |
@@ -284,28 +257,24 @@ CN: run_actions (main) started...
         </p>
 
         <p>
-        Slijedi provjera verzije trenutno pokrenutog kernela.
-        Ako nije pokrenuta najnovija verzija potrebno je instalirati
-        <package>kernel-2.6-cn</package> paket i ponovno pokrenuti
-        računalo.
+        Slijedi provjera inačice trenutno pokrenutog kernela. Prije
+        nastavka nadogradnje preporuča se pokrenuti računalo s najnovijom
+        instaliranom inačicom kernela (ako to već nije slučaj).
 
 <example>
 +-----------------------------------------------------------------+
-| Nadogradnja CARNet Debian Sarge->Etch                           |
+| Nadogradnja CARNet Debian Lenny->Squeeze                        |
 +-----------------------------------------------------------------+
 |                                                                 |
-| Prije prelaska na Debian Etch potrebno je napraviti nadogradnju |
-| na najnoviji grsec kernel.                                      |
+| Na racunalu je pronadjenja verzija kernela novija od trenutno   |
+| pokrenute. Prije pocetka nadogradnje paketa preporuceno je      |
+| pokrenuti racunalo s najnovijim dostupnim kernelom. Nakon toga  |
+| ponovno pozovite ovu skriptu.                                   |
 |                                                                 |
-| Pokrenite:                                                      |
-|   # apt-get update                                              |
-|   # apt-get install kernel-2.6-cn                               |
-|   # reboot                                                      |
-|                                                                 |
-| Nakon toga ponovno pozovite ovu skriptu.                        |
+| Zelite li rebootati racunalo prije pocetka nadogradnje?         |
 |                                                                 |
 +-----------------------------------------------------------------+
-|                           < U redu >                            |
+|                 < Da >             < Ne >                       |
 +-----------------------------------------------------------------+
 </example>
         </p>
@@ -316,7 +285,7 @@ CN: run_actions (main) started...
 
 <example>
 +-----------------------------------------------------------------+
-| Nadogradnja CARNet Debian Sarge->Etch                           |
+| Nadogradnja CARNet Debian Lenny->Squeeze                        |
 +-----------------------------------------------------------------+
 |                                                                 |
 | Na racunalu je pronadjena instalacija KDE, GNOME ili X Window   |
@@ -333,7 +302,7 @@ CN: run_actions (main) started...
         </p>
 
         <p>
-        Standardna instalacija CARNet Debian <em>sarge</em> distribucije
+        Standardna instalacija prethodnih inačica CARNet Debian distribucije
         donosila je mnogo paketa koji nisu nužno potrebni za uobičajen rad
         poslužiteljskog računala. Brisanjem tih paketa ubrzati ćete
         proceduru nadogradnje, kao i smanjiti zauzeće diskovnog prostora.
@@ -343,9 +312,9 @@ CN: run_actions (main) started...
 
 <example>
 +-----------------------------------------------------------------+
-| Nadogradnja CARNet Debian Sarge->Etch                           |
+| Nadogradnja CARNet Debian Lenny->Squeeze                        |
 +-----------------------------------------------------------------+
-| Prethodna inacica distribucije, CARNet Debian 2, donosila je    |
+| Prethodna inacica distribucije, CARNet Debian 5, donosila je    |
 | neke pakete koji nisu nuzni za normalan rad posluzitelja.       |
 | Uklanjanje ovih aplikacija ubrzat ce proceduru nadogradnje i    |
 | smanjiti zauzece diskovnog prostora. Ukoliko zelite zadrzati    |
@@ -366,6 +335,37 @@ CN: run_actions (main) started...
         </p>
 
         <p>
+        Sljedeći korak nadogradnje nudi mogućnost brisanja nekorištenih
+        servisa sa poslužitelja:
+
+<example>
++-----------------------------------------------------------------+
+| Nadogradnja CARNet Debian Lenny->Squeeze                        |
++-----------------------------------------------------------------+
+| Standardna instalacija CARNet Debian distribucije donosi        |
+| podrsku za veci broj razlicitih servisa. U ovom koraku nudi     |
+| se mogucnost uklanjanja nekoristenih servisa sa vaseg           |
+| posluzitelja. Uklanjanjem nekoristenih servisa smanjit ce se    |
+| mogucnost problema i ubrzati procedura nadogradnje. Ukoliko     |
+| zelite ukloniti neki od navedenih servisa ukljucite oznaku      |
+| ispred imena odgovarajuceg paketa.                              |
+|                                                                 |
+| Odaberite servise koje zelite UKLONITI:                         |
+| +-------------------------------------------------------------+ |
+| |               [ ] amavisd-cn                                | |
+| |               [ ] bind9-cn                                  | |
+| |               [ ] clamav-cn                                 | |
+| |               [ ] dovecot-cn                                | |
+| |               [ ] mailman-cn                                | |
+| |               [ ] munin-cn                                  | |
+| +-------------------.(+)--------------------------------------+ |
++-----------------------------------------------------------------+
+|                           < U redu >                            |
++-----------------------------------------------------------------+
+</example>
+        </p>
+
+        <p>
         S obzirom na važnost podataka u LDAP imeniku, skripta radi backup
         OpenLDAP (<prgn>slapd</prgn>) baze. Nove inačice paketa bi trebale
         neometano nastaviti raditi sa postojećim sadržajem baze, pa ovaj
@@ -374,9 +374,9 @@ CN: run_actions (main) started...
 
 <example>
 +-----------------------------------------------------------------+
-| Nadogradnja CARNet Debian Sarge->Etch                           |
+| Nadogradnja CARNet Debian Lenny->Squeeze                        |
 +-----------------------------------------------------------------+
-| Napravljen backup slapd baze u /var/backups/slapcat.cn4-upgrade.|
+| Napravljen backup slapd baze u /var/backups/slapcat.cn6-upgrade.|
 |                                                                 |
 |                                                                 |
 |                                                                 |
@@ -400,10 +400,10 @@ CN: run_actions (main) started...
         
 <example>
 +-----------------------------------------------------------------+
-| Nadogradnja CARNet Debian Sarge->Etch                           |
+| Nadogradnja CARNet Debian Lenny->Squeeze                        |
 +-----------------------------------------------------------------+
 | Napravljen backup /etc direktorija u                            |
-| /var/backups/etc.cn4-upgrade.tar.gz.                            |
+| /var/backups/etc.cn6-upgrade.tar.gz.                            |
 |                                                                 |
 |                                                                 |
 |                                                                 |
@@ -420,30 +420,31 @@ CN: run_actions (main) started...
 
         <p>
         Slijedi instalacija <file>/etc/apt/sources.list</file> datoteke
-        podešene za CARNet Debian <em>etch</em> i osvježavanje baze paketa.
+        podešene za CARNet Debian <em>squeeze</em> i osvježavanje baze paketa.
         Eventualne dodatne repozitorije nakon nadogradnje možete kopirati iz
         stare <file>sources.list</file> datoteke, koja će biti spremljena
-        kao <file>/etc/apt/sources.list.cn4-upgrade</file>.
+        kao <file>/etc/apt/sources.list.cn6-upgrade</file>.
 
 <example>
-+------------------------------------------------------------------+
-| Nadogradnja CARNet Sarge->Etch                                   |
-+------------------------------------------------------------------+
-| Novi sadrzaj datoteke /etc/apt/sources.list:                     |
-|                                                                  |
-| # Osnovni Debian Etch paketi                                     |
-| deb http://ftp.carnet.hr/debian etch main contrib non-free       |
-| deb http://security.debian.org etch/updates main contrib non-free|
-|                                                                  |
-| # CARNet Debian Etch paketi                                      |
-| deb http://ftp.carnet.hr/carnet-debian carnet-etch main non-free |
-|                                                                  |
-| # SRCE AAI paketi                                                |
-| deb ftp://ftp.srce.hr/srce-debian/ srce-etch main                |
-|                                                                  |
-+------------------------------------------------------------------+
-|                           < U redu >                             |
-+------------------------------------------------------------------+
++-----------------------------------------------------------------+
+| Nadogradnja CARNet Debian Lenny->Squeeze                        |
++-----------------------------------------------------------------+
+| Novi sadrzaj datoteke /etc/apt/sources.list:                    |
+|                                                                 |
+| # See sources.list(5) for more information                      |
+| deb http://ftp.hr.debian.org/debian/ squeeze main contrib non-fr|
+| deb http://ftp.hr.debian.org/debian/ squeeze-updates main contri|
+| deb http://security.debian.org/ squeeze/updates main contrib non|
+|                                                                 |
+| # CARNet Debian Linux                                           |
+| deb http://ftp.carnet.hr/carnet-debian/ carnet-squeeze main non-|
+|                                                                 |
+| # SRCE AAI@EduHr                                                |
+| deb http://ftp.srce.hr/srce-debian/ srce-squeeze main           |
+|                                                                 |
++-----------------------------------------------------------------+
+|                           < U redu >                            |
++-----------------------------------------------------------------+
 </example>
         </p>
 
@@ -453,7 +454,7 @@ CN: run_actions (main) started...
         nekoliko sati, ovisno o brzini veze. Tipično trajanje na 2 Mbps
         linku je oko 40 minuta. Cijela nadogradnja velika je oko 300-700MB,
         ovisno o instaliranom softveru. U slučaju da nakon skidanja paketa
-        nemate dovoljno prostora za fazu nadogradnje (oko 200MB), skripta će
+        nemate dovoljno prostora za fazu nadogradnje (oko 300MB), skripta će
         prekinuti s radom. Kad oslobodite dovoljno prostora na
         <file>/var</file> particiji, ponovo pokrenite
         <prgn>carnet-upgrade</prgn>.
@@ -473,20 +474,20 @@ CN: run_actions (main) started...
         Navedeni redoslijed ne mora nužno pratiti redoslijed prilikom
         nadogradnje, kao što ni svi navedeni paketi ne moraju biti
         instalirani na sustavu.  Pitanja za dolje navedene datoteke će biti
-        upućena ili putem <prgn>debconf</prgn> 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 <tt>d</tt>, od eng. <em>differences</em> ­ 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 <em>install the package maintainer's version</em>):
+        upućena putem <prgn>debconf</prgn> ili tekstualnog sučelja. Ukoliko
+        ste vlastoručno mijenjali neku od tih datoteka, možete pogledati
+        razlike između stare i nove datoteke (odgovor <tt>d</tt>, od eng.
+        <em>differences</em> ­ 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 <em>install the package
+        maintainer's version</em>):
 
         <list>
           <item><file>/etc/amavis/*</file>
-          <item><file>/etc/apache/*</file>
+          <item><file>/etc/apache2/*</file>
           <item><file>/etc/bind/named.conf.options</file>
           <item><file>/etc/clamav/*</file>
           <item><file>/etc/default/*</file>
@@ -497,7 +498,7 @@ CN: run_actions (main) started...
           <item><file>/etc/mysql/my.cnf</file>
           <item><file>/etc/ntp.conf</file>
           <item><file>/etc/pam.d/*</file>
-          <item><file>/etc/php4/*</file>
+          <item><file>/etc/php5/*</file>
           <item><file>/etc/postgresql/postmaster.conf</file>
           <item><file>/etc/postgresql/postgresql.conf</file>
           <item><file>/etc/proftpd.conf</file>
@@ -518,7 +519,7 @@ CN: run_actions (main) started...
 
 <example>
 +-----------------------------------------------------------------+
-| Nadogradnja CARNet Sarge->Etch                                  |
+| Nadogradnja CARNet Debian Lenny->Squeeze                        |
 +-----------------------------------------------------------------+
 | Automatizirane ispravke su izvrsene. Provjerite jesu li svi     |
 | vasi kriticni servisi ispravno konfigurirani i pokrenuti.       |
@@ -556,14 +557,13 @@ CN: run_actions (main) started...
         <p>
         Ukoliko imate malu <file>/</file> particiju moguće je da instalacija
         kernel paketa neće uspjeti. Paket <package>kernel-2.6-cn</package>
-        donosi čak četiri inačice kernela i zauzima preko 100 MB.  Stare
-        inačice kernela se ne brišu iz <file>/boot</file> direktorija što
-        nakon nekoliko iteracija može dovesti do zapunjenja particije.
-        Rješenje je brisanje starih nekorištenih kernela iz
-        <file>/boot</file> direktorija i pripadnih modula iz
-        <file>/lib/modules</file> direktorija.  Detaljnije upute
+        zauzima oko 100 MB.  Stare inačice kernela se ne brišu iz
+        <file>/boot</file> direktorija što nakon nekoliko iteracija može
+        dovesti do zapunjenja particije.  Rješenje je brisanje starih
+        nekorištenih kernela iz <file>/boot</file> direktorija i pripadnih
+        modula iz <file>/lib/modules</file> direktorija.  Detaljnije upute
         nalaze se na <url name="portalu za sistemce"
-        id="http://sistemac.carnet.hr/node/401">.
+        id="http://sistemac.carnet.hr/node/795">.
       </sect>
 
       <sect><heading>Premalo mjesta na <file>/var</file> particiji</heading>
@@ -573,7 +573,7 @@ CN: run_actions (main) started...
         neće moći skinuti potrebne pakete i  nastaviti nadogradnju. To
         možete riješiti tako da direktorij
         <file>/var/cache/apt/archives</file> prebacite na neku drugu
-        particiju. Kratka kuharica za slučaju korištenja
+        particiju. Kratka kuharica za slučaj korištenja
         <file>/home</file> particije je:
 
 <example>
@@ -674,7 +674,7 @@ CN: run_actions (main) started...
 
         <list>
           <item><file>/etc/amavis/*</file>
-          <item><file>/etc/apache/*</file>
+          <item><file>/etc/apache2/*</file>
           <item><file>/etc/bind/named.conf.options</file>
           <item><file>/etc/clamav/*</file>
           <item><file>/etc/default/*</file>
@@ -685,7 +685,7 @@ CN: run_actions (main) started...
           <item><file>/etc/mysql/my.cnf</file>
           <item><file>/etc/ntp.conf</file>
           <item><file>/etc/pam.d/*</file>
-          <item><file>/etc/php4/*</file>
+          <item><file>/etc/php5/*</file>
           <item><file>/etc/postgresql/postmaster.conf</file>
           <item><file>/etc/postgresql/postgresql.conf</file>
           <item><file>/etc/proftpd.conf</file>
@@ -703,7 +703,7 @@ CN: run_actions (main) started...
         </p>
 
         <p>
-        Provjeriti dali je dovršena nadogradnja svih paketa, ta dali su neki
+        Provjeriti je li dovršena nadogradnja svih paketa, ta jesu li neki
         bitni paketi pri tome obrisani.
 
 <example>
@@ -718,11 +718,11 @@ CN: run_actions (main) started...
 
         <list>
           <item>DNS (<prgn>host www.vasa-domena.hr localhost</prgn>),
-          <item>slanje i primanje maila (sa stroja, sa LAN-a, izvana),
-          <item>Freeradius (spojiti se na CMU i provjeriti log datoteke),
-          <item>Apache (<tt>http://stroj</tt> i <tt>https://stroj</tt>),
-          <item>LDAP (<tt>http://stroj/ldap/</tt>),
-          <item>Webmail (<tt>https://stroj/webmail/</tt>),
+          <item>slanje i primanje maila (sa poslužitelja, sa LAN-a, izvana),
+          <item>Freeradius (spojiti se na AAIEdu i provjeriti stanje),
+          <item>Apache (<tt>http://domena.hr</tt> i <tt>https://domena.hr</tt>),
+          <item>LDAP (<tt>http://domena.hr/ldap/</tt>),
+          <item>Webmail (<tt>https://domena.hr/webmail/</tt>),
           <item>antivirus (poslati <file>eicar.com</file> datoteku i
           provjeriti mail log),
           <item>POP3, IMAP