Sve brisanje se događa u remove_bloat()
[carnet-upgrade.git] / doc / carnet-upgrade-src.sgml
index 0432feb..de09942 100644 (file)
@@ -3,7 +3,7 @@
   <book>
 
     <titlepag>
-      <title>CARNet Debian 9 (stretch) nadogradnja</title>
+      <title>CARNET Debian 10 (buster) nadogradnja</title>
       <author>
         <name>Grupa za izradu paketa</name>
         <email>paketi@carnet.hr</email>
       <version>Verzija %PKG_VERSION%</version>
 
       <abstract>
-        CARNet Debian <em>stretch</em> je osma generacija CARNet Debian
-        distribucije i temelji se na Debian GNU/Linux <em>stretch</em>.
-        Ovaj priručnik opisuje postupak nadogradnje CARNet Debian
-        distribucije sa inačice 8 <em>jessie</em> na inačicu 9
-        <em>stretch</em>.  Priručnik je zamišljen kao pomoć CARNetovim
+        CARNET Debian <em>buster</em> je deseta generacija CARNET Debian
+        distribucije i temelji se na Debian GNU/Linux <em>buster</em>.
+        Ovaj priručnik opisuje postupak nadogradnje CARNET Debian
+        distribucije s inačice 9 <em>stretch</em> na inačicu 10
+        <em>buster</em>. Priručnik je zamišljen kao pomoć CARNET-ovim
         sistem inženjerima koji na svojim poslužiteljima imaju instaliran
-        CARNet Debian i trebao bi obuhvatiti cjelokupan postupak
+        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
-        9, koji se nalazi na CARNetovom FTP poslužitelju u <em>jessie</em>
+        10, koji se nalazi na CARNET-ovom FTP poslužitelju u <em>stretch</em>
         repozitoriju paketa.
       </abstract>
     </titlepag>
 
       <sect><heading>Datotečni sustav</heading>
         <p>
-        Prije bilo kakve veće instalacije ili nadogradnje, strogo 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, 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,
+        Prije bilo kakve veće instalacije ili nadogradnje, preporučuje se
+        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, 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 (<prgn>tar</prgn>), ili drukčije
         (<prgn>rsync</prgn>). Za ovu svrhu preporučujemo backup svih
-        podataka (<em>level 0 backup</em>).  Također je potrebno osigurati
+        podataka (<em>level 0 backup</em>). Također je potrebno osigurati
         ispravnost pohranjenih podataka, što znaci da baze podataka
-        (OpenLDAP, MySQL, PostgreSQL) treba backupirati na ispravan način,
+        (OpenLDAP, MariaDB, PostgreSQL) treba backupirati na ispravan način,
         jer backup datotečnog sustava za takve servise nije dovoljan i ne
         garantira ispravnost i konzistentnost podataka. Svaka baza podataka
         donosi zasebne programe koji omogućavaju izvoz sadržaja baze u oblik
       <sect><heading>OpenLDAP</heading>
         <p>
         Prije backupa OpenLDAP-a potrebno je spustiti FreeRADIUS i OpenLDAP
-        servise. FreeRADIUS je potrebno ugasiti da bi AAIEdu usluga nastavila
+        servise. FreeRADIUS je potrebno ugasiti da bi AAI@Edu 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:
 
 <example>
-# /etc/init.d/freeradius stop
-# /etc/init.d/slapd stop
+# service freeradius stop
+# service slapd stop
 </example>
         </p>
 
@@ -79,8 +79,8 @@
         u radno stanje:
 
 <example>
-# /etc/init.d/slapd start
-# /etc/init.d/freeradius start
+# service slapd start
+# service freeradius start
 </example>
         </p>
 
@@ -90,9 +90,9 @@
         </p>
       </sect>
 
-      <sect><heading>MySQL</heading>
+      <sect><heading>MariaDB</heading>
         <p>
-        Prilikom backupa MySQL baze, <prgn>mysqld</prgn> poslužitelj mora
+        Prilikom backupa MariaDB baze, <prgn>mysqld</prgn> poslužitelj mora
         biti pokrenut.  Backup možete izvršiti na sljedeći način:
 
 <example>
         </p>
 
         <p>
-        Za više informacija o backupu MySQL baze pogledajte
-        <url name="MySQL dokumentaciju" 
-        id="http://dev.mysql.com/doc/refman/5.1/en/backup-and-recovery.html">.
+        Za više informacija o backupu MariaDB baze pogledajte
+        <url name="MariaDB dokumentaciju" 
+        id="https://dev.mysql.com/doc/refman/8.0/en/backup-and-recovery.html">.
         </p>
       </sect>
 
       <sect>
         <heading>Prije početka</heading>
         <p>
-        Prije nadogradnje na <em>stretch</em> distribuciju, potrebno je
-        izvršiti nadogradnju <em>jessie</em> distribucije na najsvježije
-        pakete. To se najjednostavnije izvodi naredbom <prgn>apt-get</prgn>:
+        Prije nadogradnje na <em>buster</em> distribuciju, potrebno je
+        izvršiti nadogradnju <em>stretch</em> distribucije na najsvježije
+        pakete. To se najjednostavnije izvodi naredbom <prgn>apt</prgn>:
 
 <example>
-# apt-get update
-# apt-get dist-upgrade
+# apt update
+# apt full-upgrade
 </example>
         </p>
       </sect>
         ova dokumentacija. Paket se instalira na uobičajen način:
 
 <example>
-# apt-get update
-# apt-get install carnet-upgrade
+# apt update
+# apt install carnet-upgrade
 </example>
         </p>
 
         <p>
         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
+        repozitorij CARNET-ovih paketa u
         <file>/etc/apt/sources.list</file> datoteci:
 
 <example>
-deb http://ftp.carnet.hr/carnet-debian carnet-jessie main non-free
+deb http://ftp.carnet.hr/carnet-debian carnet-stretch main non-free
 </example>
         </p>
 
         <p>
-        To je uobičajena konfiguracija CARNet Debian <em>jessie</em>
+        To je uobičajena konfiguracija CARNET Debian <em>stretch</em>
         repozitorija. Ako tog retka nema, dodajte ga i ponovite
         postupak instalacije <package>carnet-upgrade</package> paketa.
         </p>
@@ -198,14 +198,14 @@ CN: run_actions (main) started...
 
 <example>
 +-----------------------------------------------------------------+
-| Nadogradnja CARNet Debian jessie -> stretch                     |
+| Nadogradnja CARNET Debian stretch -> buster                     |
 +-----------------------------------------------------------------+
 | PAZNJA! PAZNJA!                                                 |
 |                                                                 |
-| Pokrenuli ste proceduru nadogradnje CARNet Debian distribucije. |
-| Podsjecamo Vas da prije ove skripte svakako pokrenete 'apt-get  |
-| dist-upgrade'. Strogo preporucujemo i backup cijelog sustava, s |
-| posebnim naglaskom na instalirane baze podataka poput MySQL i   |
+| Pokrenuli ste proceduru nadogradnje CARNET Debian distribucije. |
+| Podsjecamo Vas da prije ove skripte svakako pokrenete 'apt      |
+| full-upgrade'. Strogo preporucujemo i backup cijelog sustava, s |
+| posebnim naglaskom na instalirane baze podataka poput MariaDB i |
 | PostgreSQL.                                                     |
 |                                                                 |
 | Takodjer pazljivo procitajte dokumentaciju za ovu nadogradnju   |
@@ -222,25 +222,25 @@ CN: run_actions (main) started...
 
         <p>
         U sljedećem koraku biti će izvršena provjera jesu li najvažniji
-        servisi nadograđeni na najnovije inačice u <em>jessie</em>
+        servisi nadograđeni na najnovije inačice u <em>stretch</em>
         distribuciji.  Ako neki od instaliranih servisa nije najnovija
         inačica, pojavit će se poruka:
 
 <example>
 +-----------------------------------------------------------------+
-| Nadogradnja CARNet Debian jessie -> stretch                     |
+| Nadogradnja CARNET Debian stretch -> buster                     |
 +-----------------------------------------------------------------+
 |                                                                 |
-| Prije prelaska na Debian stretch potrebno je napraviti          |
+| Prije prelaska na Debian buster potrebno je napraviti          |
 | nadogradnju ovih paketa:                                        |
 |    amavisd-cn                                                   |
 |                                                                 |
 | Pokrenite:                                                      |
-|   # apt-get update                                              |
-|   # apt-get dist-upgrade                                        |
+|   # apt update                                                  |
+|   # apt full-upgrade                                            |
 | ili:                                                            |
-|   # apt-get update                                              |
-|   # apt-get install amavisd-cn                                  |
+|   # apt update                                                  |
+|   # apt install amavisd-cn                                      |
 |                                                                 |
 | Nakon toga ponovno pozovite ovu skriptu.                        |
 |                                                                 |
@@ -263,7 +263,7 @@ CN: run_actions (main) started...
 
 <example>
 +-----------------------------------------------------------------+
-| Nadogradnja CARNet Debian jessie -> stretch                     |
+| Nadogradnja CARNET Debian stretch -> buster                     |
 +-----------------------------------------------------------------+
 |                                                                 |
 | Na racunalu je pronadjenja verzija kernela novija od trenutno   |
@@ -280,12 +280,12 @@ CN: run_actions (main) started...
         </p>
 
         <p>
-        U slijedećem koraku nudi se brisanje grafičkih sučelja koja
+        U sljedećem koraku nudi se brisanje grafičkih sučelja koja
         su na poslužiteljskom računalu ponekad nepotrebno instalirana.
 
 <example>
 +-----------------------------------------------------------------+
-| Nadogradnja CARNet Debian jessie -> stretch                     |
+| Nadogradnja CARNET Debian stretch -> buster                     |
 +-----------------------------------------------------------------+
 |                                                                 |
 | Na racunalu je pronadjena instalacija KDE, GNOME ili X Window   |
@@ -302,7 +302,7 @@ CN: run_actions (main) started...
         </p>
 
         <p>
-        Standardna instalacija prethodnih inačica CARNet Debian 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.
@@ -312,9 +312,9 @@ CN: run_actions (main) started...
 
 <example>
 +-----------------------------------------------------------------+
-| Nadogradnja CARNet Debian jessie -> stretch                     |
+| Nadogradnja CARNET Debian stretch -> buster                     |
 +-----------------------------------------------------------------+
-| Prethodna inacica distribucije, CARNet Debian 6, donosila je    |
+| Prethodne inacice distribucije CARNET Debiana donosile su       |
 | neke pakete koji nisu nuzni za normalan rad posluzitelja.       |
 | Uklanjanje ovih aplikacija ubrzat ce proceduru nadogradnje i    |
 | smanjiti zauzece diskovnog prostora. Ukoliko zelite zadrzati    |
@@ -340,9 +340,9 @@ CN: run_actions (main) started...
 
 <example>
 +-----------------------------------------------------------------+
-| Nadogradnja CARNet Debian jessie -> stretch                     |
+| Nadogradnja CARNET Debian stretch -> buster                     |
 +-----------------------------------------------------------------+
-| Standardna instalacija CARNet Debian distribucije donosi        |
+| 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    |
@@ -374,7 +374,7 @@ CN: run_actions (main) started...
 
 <example>
 +-----------------------------------------------------------------+
-| Nadogradnja CARNet Debian jessie -> stretch                     |
+| Nadogradnja CARNET Debian stretch -> buster                     |
 +-----------------------------------------------------------------+
 | Napravljen backup slapd baze u /var/backups/slapcat.cn9-upgrade.|
 |                                                                 |
@@ -400,7 +400,7 @@ CN: run_actions (main) started...
         
 <example>
 +-----------------------------------------------------------------+
-| Nadogradnja CARNet Debian jessie -> stretch                     |
+| Nadogradnja CARNET Debian stretch -> buster                     |
 +-----------------------------------------------------------------+
 | Napravljen backup /etc direktorija u                            |
 | /var/backups/etc.cn9-upgrade.tar.gz.                            |
@@ -420,27 +420,27 @@ CN: run_actions (main) started...
 
         <p>
         Slijedi instalacija <file>/etc/apt/sources.list</file> datoteke
-        podešene za CARNet Debian <em>stretch</em> i osvježavanje baze paketa.
+        podešene za CARNET Debian <em>buster</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.cn9-upgrade</file>.
 
 <example>
 +-----------------------------------------------------------------+
-| Nadogradnja CARNet Debian jessie -> stretch                     |
+| Nadogradnja CARNET Debian stretch -> buster                     |
 +-----------------------------------------------------------------+
 | Novi sadrzaj datoteke /etc/apt/sources.list:                    |
 |                                                                 |
 | # See sources.list(5) for more information                      |
-| deb http://ftp.hr.debian.org/debian/ stretch main contrib non-fr|
-| deb http://ftp.hr.debian.org/debian/ stretch-updates main contri|
-| deb http://security.debian.org/ stretch/updates main contrib non|
+| deb http://ftp.hr.debian.org/debian/ buster main contrib non-fr|
+| deb http://ftp.hr.debian.org/debian/ buster-updates main contri|
+| deb http://security.debian.org/ buster/updates main contrib non|
 |                                                                 |
-| # CARNet Debian Linux                                           |
-| deb http://ftp.carnet.hr/carnet-debian/ carnet-stretch main non-|
+| # CARNET Debian Linux                                           |
+| deb http://ftp.carnet.hr/carnet-debian/ carnet-buster main non-|
 |                                                                 |
 | # SRCE AAI@EduHr                                                |
-| deb http://ftp.srce.hr/srce-debian/ srce-stretch main           |
+| deb http://ftp.srce.hr/srce-debian/ srce-buster main           |
 |                                                                 |
 +-----------------------------------------------------------------+
 |                           < U redu >                            |
@@ -498,12 +498,11 @@ 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/php5/*</file>
+          <item><file>/etc/php/7.3/*</file>
           <item><file>/etc/postgresql/postmaster.conf</file>
           <item><file>/etc/postgresql/postgresql.conf</file>
           <item><file>/etc/proftpd.conf</file>
           <item><file>/etc/security/limits.conf</file>
-          <item><file>/etc/squirrelmail/apache.conf</file>
           <item><file>/etc/sysctl.conf</file>
           <item><file>/etc/vsftpd.conf</file>
           <item><file>/etc/xinetd.conf</file>
@@ -514,12 +513,12 @@ CN: run_actions (main) started...
         U zadnjem koraku, skripta za nadogradnju provjerava da li su svi
         osnovni servisi uredno pokrenuti, te prijavljuje eventualne probleme.
         Ispravno <em>funkcioniranje</em> servisa potrebno je provjeriti
-        ručno kao i ispravan rad baza podataka (MySQL, PostgreSQL,
+        ručno kao i ispravan rad baza podataka (MariaDB, PostgreSQL,
         OpenLDAP).
 
 <example>
 +-----------------------------------------------------------------+
-| Nadogradnja CARNet Debian jessie -> stretch                     |
+| Nadogradnja CARNET Debian stretch -> buster                     |
 +-----------------------------------------------------------------+
 | Automatizirane ispravke su izvrsene. Provjerite jesu li svi     |
 | vasi kriticni servisi ispravno konfigurirani i pokrenuti.       |
@@ -543,7 +542,7 @@ CN: run_actions (main) started...
         particiji:
 
 <example>
-# apt-get clean
+# apt clean
 </example>
         </p>
       </sect>
@@ -563,7 +562,7 @@ CN: run_actions (main) started...
         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/795">.
+        id="http://sysportal.carnet.hr/node/795">.
       </sect>
 
       <sect><heading>Premalo mjesta na /var particiji</heading>
@@ -594,10 +593,10 @@ CN: run_actions (main) started...
         </p>
       </sect>
 
-      <sect><heading>Problemi sa <prgn>apt-get</prgn></heading>
+      <sect><heading>Problemi sa <prgn>apt</prgn></heading>
         <p>
         U slučaju greške u nekom paketu, može se dogoditi da prilikom
-        instalacije <prgn>apt-get</prgn> prijavi grešku i instalacija se
+        instalacije <prgn>apt</prgn> prijavi grešku i instalacija se
         prekine. U tom slučaju, za početak treba dovršiti instalaciju već
         otpakiranih paketa:
 
@@ -607,16 +606,16 @@ CN: run_actions (main) started...
         </p>
 
         <p>
-        Nakon toga treba pokušati ponovo pokrenuti <prgn>apt-get</prgn>
+        Nakon toga treba pokušati ponovo pokrenuti <prgn>apt</prgn>
         za slučaj da je greška vezana za međuovisnost paketa:
 
 <example>
-# apt-get -f install
+# apt -f install
 </example>
         </p>
 
         <p>
-        Ukoliko <prgn>apt-get</prgn> zahtijeva deinstalaciju nekih paketa,
+        Ukoliko <prgn>apt</prgn> zahtijeva deinstalaciju nekih paketa,
         možete ih instalirati nakon što ova naredba završi.  Nakon toga
         možete ponovo pokrenuti <prgn>carnet-upgrade</prgn> skriptu. Ovaj
         postupak ponovite ako se desi greška kod instalacije nekog drugog
@@ -646,7 +645,7 @@ CN: run_actions (main) started...
         </p>
 
         <p>
-        Ima li 600MB slobodno na <file>/var</file>?  A nakon <prgn>apt-get
+        Ima li 600MB slobodno na <file>/var</file>?  A nakon <prgn>apt
         clean</prgn>? Ako nema može se iskoristiti neka druga particija na
         kojoj ima dovoljno mjesta (<file>/home</file>).
 
@@ -661,15 +660,15 @@ CN: run_actions (main) started...
         skripte za nadogradnju.
 
 <example>
-# apt-get update
-# apt-get dist-upgrade
-# apt-get install carnet-upgrade
+# apt update (ili apt-get update)
+# apt full-upgrade (ili apt-get dist-upgrade)
+# apt install carnet-upgrade (ili apt-get install carnet-upgrade)
 # carnet-upgrade
 </example>
         </p>
 
         <p>
-        Odgovoriti sa <tt>Y</tt>, odnosno <em>install package maintainer's
+        Odgovoriti sa <tt>Y</tt>, odnosno <em>Install package maintainer's
         version</em> za sljedeće konfiguracijske datoteke:
 
         <list>
@@ -678,19 +677,18 @@ CN: run_actions (main) started...
           <item><file>/etc/bind/named.conf.options</file>
           <item><file>/etc/clamav/*</file>
           <item><file>/etc/default/*</file>
-          <item><file>/etc/dovecot/dovecot.conf</file>
+          <item><file>/etc/dovecot/*</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/php5/*</file>
+          <item><file>/etc/php/7.3/*</file>
           <item><file>/etc/postgresql/postmaster.conf</file>
           <item><file>/etc/postgresql/postgresql.conf</file>
           <item><file>/etc/proftpd.conf</file>
           <item><file>/etc/security/limits.conf</file>
-          <item><file>/etc/squirrelmail/apache.conf</file>
           <item><file>/etc/sysctl.conf</file>
           <item><file>/etc/vsftpd.conf</file>
           <item><file>/etc/xinetd.conf</file>
@@ -703,8 +701,8 @@ CN: run_actions (main) started...
 
 <example>
 # dpkg --configure -a
-# apt-get -f install
-# apt-get install obrisani-paketi
+# apt -f install
+# apt install obrisani-paketi
 </example>
         </p>
 
@@ -714,7 +712,7 @@ CN: run_actions (main) started...
         <list>
           <item>DNS (<prgn>host www.vasa-domena.hr localhost</prgn>),
           <item>slanje i primanje maila (sa poslužitelja, sa LAN-a, izvana),
-          <item>Freeradius (spojiti se na AAIEdu i provjeriti stanje),
+          <item>Freeradius (spojiti se na AAI@Edu 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>),
@@ -723,7 +721,7 @@ CN: run_actions (main) started...
           <item>POP3, IMAP
           <item>FTP,
           <item>SSH,
-          <item>MySQL, PostgreSQL
+          <item>MariaDB, PostgreSQL
           <item>aplikacije koje koriste te baze,
           <item>i sve ostalo...
         </list>
@@ -733,7 +731,7 @@ CN: run_actions (main) started...
         Obrisati arhive paketa korištene za nadogradnju.
 
 <example>
-# apt-get clean
+# apt clean
 </example>
         </p>