UDM Pro Upgrade von 1.2.37 auf 3.2.7

Die Unifi OS Version meiner UDM Pro ist immer noch auf Version 1.2.38, obwohl mittlerweile schon zwei Major Releases veröffentlicht wurden. In diesem Artikel fasse ich meine Erfahrungen mit dem Update zusammen, vor allem, ob es mir gelungen ist meine individuellen Anpassungen (onboot-Scripte, Netzwerksegmentierung etc.) mit migrieren konnte...

01| Backup

Falls beim Upgrade etwas schief läuft sollten zunächst alle Einstellungen gesichert werden.

01.1| Backup über die GUI

Über die Web-Oberfläche der UDM Pro sollte zunächst die Unifi OS Konfiguration gesichert werden:

Danach sollten die Einstellungen der jeweiligen Anwendungen gesichert werden. Da ich nur Unifi Network und Unifi Protect nutze exportiere ich die beiden Konfigurationen.

Wenn Du auch noch andere Unifi Anwendungen nutzt, wäre jetzt ein guter Zeitpunkt diese Einstellungen ebenfalls zu speichern.

01.2| Backup der individuellen Einstellungen per SSH (optional)

Diese Schritte sind nur erforderlich, wenn die Konfiguration der UDM Pro im Verzeichnis /mnt/data angepasst wurde (z.B. per onboot-Script).

01.1.1| Anpassungen in /mnt/data

Damit ich beim Sichern keine Anpassungen vergesse, packe ich zunächst das ganze Verzeichnis /mnt/data in ein tar-Archiv:

cd /mnt
tar cvfz data_ext/20231219-udmpro-data-backup.tgz data

01.1.2| Backup der Firewall-Regeln

Für den Fall, dass die Firewall-Regeln verloren gehen, erstelle ich auch noch einen Dump der IPv4- und IPv6-Regeln und der zugehörigen ipsets in jeweils zwei unterschiedlichen Formaten:

# IPv4 Regeln exportieren
xtables-multi save4 > /mnt/data_ext/20231219-udmp-iptables-save.txt
iptables -L -v > /mnt/data_ext/20231219-udmp-iptables-Lv.txt

# IPv6 Regeln exportieren
xtables-multi save6 > /mnt/data_ext/20231219-udmp-ip6tables-save.txt
ip6tables -L -v > /mnt/data_ext/20231219-udmp-ip6tables-Lv.txt

# ipsets exportieren
ipset -o save list > /mnt/data_ext/20231219-udmp-ipset-save.txt
ipset list > /mnt/data_ext/20231219-udmp-ipset.txt

Die erstellten Backups müssen jetzt nur noch per SSH gezogen und sicher verwahrt werden:

scp root@<IP-der-UDMP>:/mnt/data_ext/20231219* .

02| Update auf Version 2.x

Nachdem alle Einstellungen gesichert sind, kann nun der eigentliche Update-Vorgang starten.