Update documentation graphics.
[carnet-upgrade.git] / doc / carnet-upgrade.sgml
index 682718e..1c9a1ef 100644 (file)
@@ -8,14 +8,15 @@
         <name>Grupa za izradu paketa</name>
         <email>paketi@carnet.hr</email>
       </author>
-      <version>Verzija 4.0.0</version>
+      <version>Verzija 4.0.6</version>
 
       <abstract>
-        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>. CARNet Debian <em>etch</em> je treća generacija
-        CARNet Debian distribucije i temelji se na Debian GNU/Linux
-        <em>etch</em> distribuciji.  Priručnik je zamišljen kao pomoć
+        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
         nadogradnje, kao i tipične probleme na koje se može naići. Za tu
@@ -184,6 +185,12 @@ deb http://ftp.carnet.hr/carnet-debian sarge main non-free
         Skripta će korištenjem naredbe <prgn>script</prgn> u datoteku
         <file>/var/log/carnet-upgrade.typescript</file> zabilježiti ispis
         svih izvršenih naredbi.
+
+<example>
+# carnet-upgrade
+Script started on Sun Mar 30 12:21:27 2008
+CN: run_actions (main) started...
+</example>
         </p>
         
         <p>
@@ -209,7 +216,33 @@ deb http://ftp.carnet.hr/carnet-debian sarge main non-free
 |                                                                 |
 | Zelite li nastaviti?                                            |
 +-----------------------------------------------------------------+
-|                 < Yes >            < No >                       |
+|                 < Da >             < Ne >                       |
++-----------------------------------------------------------------+
+</example>
+        </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>
@@ -230,16 +263,16 @@ deb http://ftp.carnet.hr/carnet-debian sarge main non-free
 |    amavisd-cn                                                   |
 |                                                                 |
 | Pokrenite:                                                      |
-|   'apt-get dist-upgrade'                                        |
+|   # apt-get update                                              |
+|   # apt-get dist-upgrade                                        |
 | ili:                                                            |
-|   'apt-get install amavisd-cn'                                  |
+|   # apt-get update                                              |
+|   # apt-get install amavisd-cn                                  |
 |                                                                 |
 | Nakon toga ponovno pozovite ovu skriptu.                        |
 |                                                                 |
-|                                                                 |
-|                                                                 |
 +-----------------------------------------------------------------+
-|                            <  OK  >                             |
+|                           < U redu >                            |
 +-----------------------------------------------------------------+
 </example>
         </p>
@@ -249,7 +282,56 @@ deb http://ftp.carnet.hr/carnet-debian sarge main non-free
         <prgn>carnet-upgrade</prgn> skriptu. Ako je sve uredno instalirano,
         skripta će otići na idući korak.
         </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.
+
+<example>
++-----------------------------------------------------------------+
+| Nadogradnja CARNet Debian Sarge->Etch                           |
++-----------------------------------------------------------------+
+|                                                                 |
+| Prije prelaska na Debian Etch potrebno je napraviti nadogradnju |
+| na najnoviji grsec kernel.                                      |
+|                                                                 |
+| Pokrenite:                                                      |
+|   # apt-get update                                              |
+|   # apt-get install kernel-2.6-cn                               |
+|   # reboot                                                      |
+|                                                                 |
+| Nakon toga ponovno pozovite ovu skriptu.                        |
+|                                                                 |
++-----------------------------------------------------------------+
+|                           < U redu >                            |
++-----------------------------------------------------------------+
+</example>
+        </p>
+
+        <p>
+        U slijedećem koraku nudi se brisanje grafičkih sučelja koja
+        su na poslužiteljskom računalu ponekad nepotrebno instalirana.
+
+<example>
++-----------------------------------------------------------------+
+| Nadogradnja CARNet Debian Sarge->Etch                           |
++-----------------------------------------------------------------+
+|                                                                 |
+| Na racunalu je pronadjena instalacija KDE, GNOME ili X Window   |
+| System grafickog okruzenja koji nisu nuzni za normalan rad      |
+| posluzitelja. Uklanjanje ovih aplikacija ubrzat ce proceduru    |
+| nadogradnje i smanjiti zauzece diskovnog prostora.              |
+|                                                                 |
+| Zelite li UKLONITI navedene aplikacije?                         |         
+|                                                                 |
++-----------------------------------------------------------------+
+|                 < Da >             < Ne >                       |
++-----------------------------------------------------------------+
+</example>
+        </p>
+
         <p>
         Standardna instalacija CARNet Debian <em>sarge</em> distribucije
         donosila je mnogo paketa koji nisu nužno potrebni za uobičajen rad
@@ -263,23 +345,21 @@ deb http://ftp.carnet.hr/carnet-debian sarge main non-free
 +-----------------------------------------------------------------+
 | Nadogradnja CARNet Debian Sarge->Etch                           |
 +-----------------------------------------------------------------+
-| Prethodna verzija distribucije, CARNet Debian 2, donosila je    |
-| mnostvo paketa koji nisu potrebni za normalan rad serverskog    |
-| racunala. Brisanje ovih aplikacija ubrzati ce proceduru         |
-| nadogradnje i smanjiti zauzece diskovnog prostora. Ukoliko      |
-| zelite zadrzati neku od navedenih aplikacija, iskljucite oznaku |
-| pored njenog imena. Slijedece aplikacije biti ce OBRISANE:      |
+| Prethodna inacica distribucije, CARNet Debian 2, 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    |
+| neku od navedenih aplikacija, iskljucite oznaku                 |
+| pored njenog imena. Sljedece aplikacije bit ce UKLONJENE:       |
 | +-------------------------------------------------------------+ |
-| |                        [X] Autoconf                         | |
-| |                        [X] Automake                         | |
-| |                        [X] Expect                           | |
-| |                        [X] GCC                              | |
-| |                        [X] GDB                              | |
-| |                        [X] Gettext                          | |
-| |                        [X] Make-cn                          | |
+| |               [X] gobjc gpc gcj gij chill g77               | |
+| |               [X] nessus                                    | |
+| |               [X] prelude piwi                              | |
+| |               [X] snort                                     | |
+| |               [X] stari CN paketi                           | |
 | +-------------------------------------------------------------+ |
 +-----------------------------------------------------------------+
-|                            <  OK  >                             |
+|                           < U redu >                            |
 +-----------------------------------------------------------------+
 </example>
         </p>
@@ -307,7 +387,7 @@ deb http://ftp.carnet.hr/carnet-debian sarge main non-free
 |                                                                 |
 |                                                                 |
 +-----------------------------------------------------------------+
-|                            <  OK  >                             |
+|                           < U redu >                            |
 +-----------------------------------------------------------------+
 </example>
         </p>
@@ -332,7 +412,7 @@ deb http://ftp.carnet.hr/carnet-debian sarge main non-free
 |                                                                 |
 |                                                                 |
 +-----------------------------------------------------------------+
-|                            <  OK  >                             |
+|                           < U redu >                            |
 +-----------------------------------------------------------------+
 </example>
         </p>
@@ -361,7 +441,7 @@ deb http://ftp.carnet.hr/carnet-debian sarge main non-free
 | deb ftp://ftp.srce.hr/srce-debian/ srce-etch main                |
 |                                                                  |
 +------------------------------------------------------------------+
-|                            <  OK  >                              |
+|                           < U redu >                             |
 +------------------------------------------------------------------+
 </example>
         </p>
@@ -411,13 +491,12 @@ deb http://ftp.carnet.hr/carnet-debian sarge main non-free
           <item><file>/etc/default/*</file>
           <item><file>/etc/dovecot/dovecot.conf</file>
           <item><file>/etc/init.d/*</file>
+          <item><file>/etc/login.defs</file>
           <item><file>/etc/logrotate.d/*</file>
           <item><file>/etc/mysql/my.cnf</file>
           <item><file>/etc/ntp.conf</file>
           <item><file>/etc/pam.d/*</file>
-          <item><file>/etc/php4/apache/php.ini</file>
-          <item><file>/etc/php4/cgi/php.ini</file>
-          <item><file>/etc/php4/cli/php.ini</file>
+          <item><file>/etc/php4/*</file>
           <item><file>/etc/postgresql/postmaster.conf</file>
           <item><file>/etc/postgresql/postgresql.conf</file>
           <item><file>/etc/proftpd.conf</file>
@@ -451,7 +530,7 @@ deb http://ftp.carnet.hr/carnet-debian sarge main non-free
 |                                                                 |
 |                                                                 |
 +-----------------------------------------------------------------+
-|                            <  OK  >                             |
+|                           < U redu >                            |
 +-----------------------------------------------------------------+
 </example>
         </p>
@@ -471,6 +550,21 @@ deb http://ftp.carnet.hr/carnet-debian sarge main non-free
     <chapt id="izvanredne">
       <heading>Izvanredne situacije</heading>
 
+      <sect><heading>Premalo mjesta na <file>/</file> particiji</heading>
+
+        <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
+        nalaze se na <url name="portalu za sistemce"
+        id="http://sistemac.carnet.hr/node/401">.
+      </sect>
+
       <sect><heading>Premalo mjesta na <file>/var</file> particiji</heading>
 
         <p>
@@ -585,13 +679,12 @@ deb http://ftp.carnet.hr/carnet-debian sarge main non-free
           <item><file>/etc/default/*</file>
           <item><file>/etc/dovecot/dovecot.conf</file>
           <item><file>/etc/init.d/*</file>
+          <item><file>/etc/login.defs</file>
           <item><file>/etc/logrotate.d/*</file>
           <item><file>/etc/mysql/my.cnf</file>
           <item><file>/etc/ntp.conf</file>
           <item><file>/etc/pam.d/*</file>
-          <item><file>/etc/php4/apache/php.ini</file>
-          <item><file>/etc/php4/cgi/php.ini</file>
-          <item><file>/etc/php4/cli/php.ini</file>
+          <item><file>/etc/php4/*</file>
           <item><file>/etc/postgresql/postmaster.conf</file>
           <item><file>/etc/postgresql/postgresql.conf</file>
           <item><file>/etc/proftpd.conf</file>