AIMdefense Unifi Migration Anleitung
Bitte zuerst alles durchlesen!
Falls das Unifi Modul gebucht und installiert ist, vor der Migration und vor dem Update unbedingt Folgendes ausführen, da:
das neue Unifi Modul wird auf die neueste Version geupdated wird und
im Zuge dazu die Datenbank ebenfalls geupdated wird.
Unifi Modul Support deswegen erst wieder ab Version 24.1.8 unterstützt.
Um eine reibungslose Migration zu gewährleisten, folgende Punkte durchführen:
Schritt 1: Backup in dem Unifi Controller erstellen und abspeichern (Unifi Oberfläche).
Schritt 2: Als root an der FW anmelden.
Schritt 3: Den Service stoppen:
- service unifi stop
Schritt 4: Backup von dem Daten Ordner erstellen, der Ordner ist unter diesem Pfad zu finden:
- /usr/local/share/java/unifi/data
Schritt 5: Unifi deinstallieren:
- pkg delete -y os-tgunifi
- pkg delete -y unifi7
Schritt 6: Autoremove ausführen um Abhängigkeiten von Unifi ebenfalls zu entfernen (diese bekommen auch alle eine neue Version):
- pkg autoremove
Schritt 7: Ab hier kann die Migration und der Update-Prozess gestartet werden.
Schritt 8: Sobald mindestens Version 24.1.8 von der AIMdefense erreicht wurden, kann das Unifi Modul wieder installiert werden:
- pkg install os-s2funifi
Schritt 9: Daraufhin das Backup vom Data Ordner wieder an den ursprünglichen Platz schieben.
Schritt 10: !!!ACHTUNG!!! Bei Nichtbeachtung wird der Unifi Controller resettet !!!ACHTUNG!!!
- In der Firewall Config – Pfad: /conf/config.xml – nachschauen ob im unifi Abschnitt is_default auf 0 gesetzt ist!
- !!!!! falls nein → auf 0 setzen !!!!!
- Im wiederhergestellten Unifi Data-Backup-Ordner, in dieser Datei – system.properties – ebenfalls überprüfen, ob is_default auf false gesetzt ist.
- !!!!! falls nein → auf false setzen !!!!!
Schritt 11: Service unifi start.
Schritt 12: Unifi Controller wie gewohnt öffnen und falls notwendig das Backup von Punkt 1 einspielen – während diesem Prozess die AIMdefense Oberfläche bitte geöffnet halten und sobald der Unifi Service gestoppt wurde, einfach wieder starten.
Weiter abwarten, die Seite lädt nach dem Einspielen vom Backup die gewohnte Login-Oberfläche.
Hinweis: Die offizielle OPNsense Updating-Anleitung zum Unifi Controller kann auch hier gefunden werden:
https://raw.githubusercontent.com/opnsense/ports/master/UPDATING
Abschnitte: 20230310, 20240318, 20240606