==%hide Upgrade systému Debian ==
====== Upgrade Debian 12 (bookworm) na Debian 13 (trixie) ======

Tento návod popisuje přímou aktualizaci operačního systému Base OS z Debian 12 (bookworm) na Debian 13 (trixie) na zařízeních Unipi, bez přeinstalace systému. Postup je pro většinu produktových řad společný; kroky, které se u jednotlivých řad liší, jsou vyznačeny přímo u daného kroku a shrnuty v přehledu na konci stránky.

<WRAP group center round box 95%>
{{ :files:img_warning-line_b.png?nolink |}}
<WRAP half column 13%>
{{ :en:hw:01_safety-instructions_ISO-7010-W001.png?nolink |/!\}}
</WRAP>
<WRAP half column 83%>
**Upozornění:** \\
Tento postup není určen a není podporován pro platformu Mervis!
----
Aktualizace na Debian 13 zneplatní licenci Mervis na řadách Unipi Gate, Unipi Neuron a Unipi 1.1 / Lite. Řada Unipi Patron by měla zůstat touto změnou nedotčena. Před aktualizací zvažte dopad na zařízení provozovaná v prostředí Mervis.
</WRAP>
</WRAP>

<WRAP group center round box 95%>
{{ :files:img_warning-line_b.png?nolink |}}
<WRAP half column 13%>
{{ :en:hw:08_safety-instructions_pseudo-ISO-7010-info.png?nolink |(i)}}
</WRAP>
<WRAP half column 83%>
**Poznámka:** \\
Postup předpokládá standardní a plně aktualizovaný Base OS na Debian 12 (bookworm) bez vlastního jádra a bez cizích APT zdrojů. Kroky byly ověřeny na Base OS // *-base-os_12.20251103.1//.
</WRAP>
</WRAP>

===== Podporované produktové řady =====

  * Unipi Patron
  * Unipi Neuron
  * Unipi Gate

Unipi Edge se dodává pouze s Debianem 13 (trixie), a proto se ho tento návod netýká.

<WRAP group center round box 95%>
{{ :files:img_warning-line_b.png?nolink |}}
<WRAP half column 13%>
{{ :en:hw:08_safety-instructions_pseudo-ISO-7010-info.png?nolink |(i)}}
</WRAP>
<WRAP half column 83%>
**Poznámka:** \\
U řady Unipi 1.1 / Lite je aktualizace na Debian 13 rovněž možná, ale její funkčnost nezaručujeme. Při přechodu je nutné vyměnit jádro Raspberry Pi za jádro Unipi, s čímž je spojeno riziko, že zařízení nebude po aktualizaci fungovat správně.
</WRAP>
</WRAP>

===== Postup aktualizace =====

==== 1. Aktualizace stávajícího systému ====

Před přechodem na novou verzi je potřeba všechny balíčky aktualizovat na poslední verzi v rámci Debian 12. Tím se předejde zbytečným konfliktům během aktualizace vydání. Po dokončení je nutné zařízení restartovat.

<code>
sudo apt update && sudo apt upgrade -y
sudo reboot
</code>

==== 2. Odstranění zdroje raspberrypi.list (pouze Neuron) ====

Na řadách založených na Raspberry Pi se odstraní zdroj //raspberrypi.list//, který pro Debian 13 není k dispozici. Krok se týká řady **Unipi Neuron**; u řad Unipi Patron a Unipi Gate se vynechává.

<code>
sudo rm /etc/apt/sources.list.d/raspberrypi.list
</code>

==== 3. Přepnutí APT zdrojů na trixie ====

V APT zdrojích se název //bookworm// nahradí názvem //trixie//. Tím se aktualizace nasměruje na balíčky pro Debian 13.

<code>
sudo sed -i 's/bookworm/trixie/g' /etc/apt/sources.list /etc/apt/sources.list.d/debian-nonfree.list /etc/apt/sources.list.d/unipi.list
</code>

==== 4. Aktualizace vydání ====

Načte se seznam balíčků z nových zdrojů a provede se samotná aktualizace vydání na Debian 13. Aktualizace může trvat delší dobu.

<code>
sudo apt update
sudo apt dist-upgrade
</code>

==== 5. Odstranění zdroje Unipi a instalace jádra pro trixie ====

Zdroj //unipi.list// se odstraní a nainstaluje se jádro Unipi určené pro Debian 13. Přesná sada balíčků se liší podle produktové řady.

<code>
sudo rm /etc/apt/sources.list.d/unipi.list
</code>

  * **Unipi Patron** a **Unipi Neuron** – jádro i moduly: \\ ''sudo apt install unipi-kernel=6.12.101.0~trixie* unipi-kernel-modules=3.6~6.12.101.0~trixie*''
  * **Unipi Gate** – pouze jádro: \\ ''sudo apt install unipi-kernel=6.12.101.0~trixie*''

==== 6. Ověření před restartem ====

Před restartem se ověří, že aktualizace proběhla bez chyb a že jsou nainstalovány správné verze jádra a zavaděče. Zařízení se restartuje až po úspěšné kontrole.

<WRAP group center round box 95%>
{{ :files:img_warning-line_b.png?nolink |}}
<WRAP half column 13%>
{{ :en:hw:01_safety-instructions_ISO-7010-W001.png?nolink |/!\}}
</WRAP>
<WRAP half column 83%>
**Upozornění:** \\
Zařízení nerestartujte, dokud kontroly neproběhnou v pořádku. Restart s poškozeným nebo nesprávným zavaděčem (u-boot) či jádrem může způsobit, že zařízení nenaběhne a bude nutné jej znovu naflashovat.
</WRAP>
</WRAP>

Kontrola stavu balíčků – ověří se, že žádný balíček nezůstal v rozpracovaném (poškozeném) stavu, tj. napůl nainstalovaný nebo nenakonfigurovaný. Výpis by měl být prázdný. Zbytky po odinstalovaných balíčcích (stav ''rc'', kdy zůstala pouze konfigurace) nevadí:

<code>
sudo dpkg --audit
</code>

Důležitější je ověřit, že na zařízení nezůstaly balíčky z Debian 12. Následující příkaz vypíše nainstalované balíčky, jejichž verze stále nese značku //deb12// nebo //bookworm// (např. ''1.2.3+deb12u1''); výpis by měl být prázdný:

<code>
dpkg -l | grep -e deb12 -e bookworm
</code>

Ověření, že se userspace přepnul na trixie – u položky ''VERSION_CODENAME'' se očekává //trixie//:

<code>
cat /etc/os-release
</code>

Kontrola verze jádra a zavaděče – u nainstalovaných balíčků //unipi-kernel// a //unipi-u-boot// musí verze obsahovat řetězec ''~trixie'' (přípona odpovídá produktové řadě, u řady Unipi Patron je to např. ''2026.01.6~trixie-patron''). Pokud u některého balíčku zůstává verze pro Debian 12, aktualizace jádra nebo zavaděče neproběhla a zařízení se **nesmí** restartovat. Na řadách bez zavaděče u-boot se balíček //unipi-u-boot// nevypíše:

<code>
dpkg -l unipi-kernel unipi-u-boot
</code>

==== 7. Restart ====

Po úspěšné kontrole se zařízení restartuje a nabíhá již v Debian 13.

<code>
sudo reboot
</code>

==== 8. Ověření po restartu ====

Po restartu se ověří, že systém naběhl do Debian 13, běží na novém jádře a že v systémovém logu nejsou žádné chyby.

Ověření verze systému a jádra – u položky ''VERSION_CODENAME'' se očekává //trixie// a u verze jádra řada //6.12//:

<code>
cat /etc/os-release
uname -r
</code>

Kontrola systémového logu na chyby a varování (např. problémy s ovladači nebo hardwarem) – výpis by měl být prázdný nebo bez závažných hlášení:

<code>
sudo dmesg --level=err,warn
</code>

Kontrola, že po aktualizaci nezbývají žádné neaktualizované balíčky – seznam by měl být prázdný (výjimkou bude jádro a moduly jádro, které je možné dodatečně aktualizovat na nejnovější verzi):

<code>
sudo apt update
sudo apt list --upgradable
</code>

===== Kompletní příkazy podle produktové řady =====

Následující bloky obsahují úplnou posloupnost příkazů pro jednotlivé řady k pohodlnému zkopírování. Před závěrečným restartem ověřte stav systému podle kroku 6.

==== Unipi Patron ====

<code>
sudo apt update && sudo apt upgrade -y
sudo reboot

sudo sed -i 's/bookworm/trixie/g' /etc/apt/sources.list /etc/apt/sources.list.d/debian-nonfree.list /etc/apt/sources.list.d/unipi.list
sudo apt update
sudo apt dist-upgrade
sudo rm /etc/apt/sources.list.d/unipi.list
sudo apt install unipi-kernel=6.12.101.0~trixie* unipi-kernel-modules=3.6~6.12.101.0~trixie*
# Před restartem ověřte stav systému (viz krok 6).
sudo reboot
</code>

==== Unipi Neuron ====

<code>
sudo apt update && sudo apt upgrade -y
sudo reboot

sudo rm /etc/apt/sources.list.d/raspberrypi.list
sudo sed -i 's/bookworm/trixie/g' /etc/apt/sources.list /etc/apt/sources.list.d/debian-nonfree.list /etc/apt/sources.list.d/unipi.list
sudo apt update
sudo apt dist-upgrade
sudo rm /etc/apt/sources.list.d/unipi.list
sudo apt install unipi-kernel=6.12.101.0~trixie* unipi-kernel-modules=3.6~6.12.101.0~trixie*
# Před restartem ověřte stav systému (viz krok 6).
sudo reboot
</code>

==== Unipi Gate ====

<code>
sudo apt update && sudo apt upgrade -y
sudo reboot

sudo sed -i 's/bookworm/trixie/g' /etc/apt/sources.list /etc/apt/sources.list.d/debian-nonfree.list /etc/apt/sources.list.d/unipi.list
sudo apt update
sudo apt dist-upgrade
sudo rm /etc/apt/sources.list.d/unipi.list
sudo apt install unipi-kernel=6.12.101.0~trixie*
# Před restartem ověřte stav systému (viz krok 6).
sudo reboot
</code>