UDM Pro 1.x: Firmware aktualisieren

Hinweis: Diese Anleitung bezieht sich auf eine alte Version (1.x) von Unifi OS. Die Schritte und Vorgehensweisen können sich in Version 2.x oder 3.x teilweise deutlich unterscheiden.   

Werden die udm-utilities, wie z.B. das on-boot-script oder spezielle Kernelmodule eingesetzt, so sind bei der Aktualisierung der Unifi-Firmware einige Punkte zu beachten, damit nach dem Update alles weiterhin funktioniert.

01| Backup

Wie immer sollte vor einer Aktualisierung ein Backup gezogen werden, damit alles wieder Rückgängig gemacht werden kann, wenn etwas schief läuft. Auf der UDM-Pro werden die Backups für die einzelnen Anwendungen erstellt.

01.1| Backup Network

Um die Einstellungen in der Anwendung "Network" zu sichern muss in der aktuellen Version 6.2.26 zunächst in die Klassische Ansicht gewechselt werden:

Danach in die Einstellungen wechseln und im Menü Backup ein aktuelles Backup erstellen und über den Button "Download File" herunterladen:

01.2| Backup Protect

In der Anwendung "Protect" kann ein Backup über den Link "Create Backup of Current System" erstellt und anschließend über den Link "Download" heruntergeladen werden:

01.3| Backup der bestehenden Scripte und Anpassungen

Für den Fall, dass beim Upgrade was schief geht, sollte zusätzlich auch ein Backup von allen Anpassungen die bereits durchgeführt wurden erstellt werden. Die Daten liegen dabei üblicherweise im Verzeichnis /mnt/data und können einfach per SSH von einem beliebigen Host aus gesichert werden:

ssh root@<your-udm-pro> tar cvzf - /mnt/data/dir1 /mnt/data/dir2 > /destination/file.tar.gz

Ich habe mit dazu auf meinen Desktop-Rechner in der Bash folgenden Alias angelegt:

# alias to perform easy backup of UDM-Pro unifi-os settings
alias backup-unifi-os="ssh root@192.168.1.1 tar cvzf - /mnt/data/on_boot.d /mnt/data/cron-user /mnt/data/ssh /mnt/data/wireguard > ~/Backups/$(date +"%Y%m%d-%H%M%S")-unifi-os-backup.tgz"

Warnung: Es sollten ausschließlich die Dateien gesichert werden, die auch selbst angelegt bzw. angepasst wurden. Es kann sonst zu Problemen kommen, wenn im laufenden Betrieb auf die von Unif OS benötigten Dateien im Verzeichnis /mnt/data zugegriffen wird, so dass das System neu gestartet werden muss.

02| Fremdkomponenten aktualisieren

Wurden einige Custom-Komponenten installiert, so sollte vor dem Firmwareupdate geprüft werden, ob die installierten Version der Custom-Komponenten mit der neuen Firmware zusammenarbeiten.

02.1| on-boot-script 

Eines der wichtigsten Tools ist wohl das UDM / UDM Pro Boot Script von boostchicken. Daher sollten sichergestellt werden, dass das Toola auch nach dem Update nocoh funktioniert. Dazu wird zunächst die installierte Version ermittelt:

unifi-os shell
dpkg -l | awk '/udm-boot/ { print $2 " " $3 }'

In der Versionshistorie kann überprüft werden ob eine neue Version zum Download bereitsteht. Falls eine neue Version verfügbar ist, so kann diese in der bereits bestehenden unifi-os shell einfach über die aktuelle Version installiert werden:

curl -L https://udm-boot.boostchicken.dev -o udm-boot.deb
dpkg -i udm-boot.deb
exit

02.2| WireGuard Kernelmodule

Neben den on-boot-scripten habe ich auch das WireGuard-Kernelmodul von tusc installiert. Wird mit dem anstehenden Update der UDM-Pro Firmware auch der Kernel aktualisiert, so muss zuvor auch das Kernelmodul aktualisiert werden. Unter https://github.com/tusc/wireguard-kmod/releases kann überprüft werden, ob bereits eine aktualisierte Version der Kernelmodule bereitgestellt wurde, die zur aktuellen UDM-Pro-Firmware passt.

Falls eine entsprechende Datei existiert, so kann die neue Version heruntergeladen und über die bestehende Version installiert werden:

curl -LJo wireguard-kmod.tar.Z <URL_to_mos_recent_*.tar.Z>
tar -C /mnt/data -xvzf wireguard-kmod.tar.Z
cd /mnt/data/wireguard
./setup_wireguard.sh

03| Firmware Update

Nachdem die Custom-Module erfolgreich aktualisiert wurden, und sichergestellt ist, dass diese auch mit der neuen Firmware-Version kompatibel sind, kann das Update in den Systemeinstellungen der UDM-Pro aktualisiert werden.