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.

• 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á.

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.

sudo apt update && sudo apt upgrade -y
sudo reboot

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

sudo rm /etc/apt/sources.list.d/raspberrypi.list

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

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

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.

sudo apt update
sudo apt dist-upgrade

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.

sudo rm /etc/apt/sources.list.d/unipi.list

• 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*

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.

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í:

sudo dpkg --audit

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ý:

dpkg -l | grep -e deb12 -e bookworm

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

cat /etc/os-release

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:

dpkg -l unipi-kernel unipi-u-boot

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

sudo reboot

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:

cat /etc/os-release
uname -r

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í:

sudo dmesg --level=err,warn

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

sudo apt update
sudo apt list --upgradable

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.

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

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

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