Flashen eines Ubiquity UniFi Access Point (UAP) AC MESH PRO

Die vorliegende Anleitung habe ich mit Trial and Error aus folgenden verschiedenen Anleitungen zu anderen Ubiquity UAP's zusammengesetzt:

/1/ https://forum.freifunk-lippe.de/t/ubiquiti-unifi-ac-mesh/157
/2/ https://wiki.darmstadt.freifunk.net/Unifi_AC
/3/ https://wiki.freifunk-franken.de/w/Anleitung:UbiquitiUnifiACMesh
/4/ https://forum.freifunk.net/t/unifi-ac-mesh-lite-pro/13863/106
/5/ https://forum.freifunk-lippe.de/t/ubiquiti-unifi-ac-mesh/157

Auf diese Quellen wird nachfolgend mit den voranstehenden Nummern in Slashes Bezug genommen.

Sollte etwas beim Flashen schief gehen (Softbrick) kann man die UAP AC MESH PRO in einen „TFTP RECOVERY MODE“ versetzen und dann mittels TFTP mit der Stock-FW mit folgenden Schritten retten (siehe auch: UniFi-TFTP-Recovery-for-Bricked-Access-Points):

1. UAP AC MESH PRO mit gerückter RESET-Taste einschalten
   
2. RESET-Taste gedrückt halten, bis LED abwechselnd blau-weiß-aus blinkt (ca. 20s, jetzt haben wir den „TFTP RECOVERY MODE“ erreicht)
   
3. auf dem Computer den LAN-Anschluß auf statische IP mit IP: 192.168.1.100 und NETMASK: 255.255.255.0 konfigurieren
   
4. den Computer mit dem LAN-Anschluß „PRIMARY LAN“ der UAP AC MESH PRO verbinden
   
5. mit einem geeignet TFTP CLIENT die Stock-FW wieder aufspielen, hierzu folgende Parameter verwenden:
   

   Adress:   192.168.1.20 
   Password: ubnt

   (detailliertere Beschreibung hierzu für LINUX, MAC OS und WINDOWS siehe unten unter Punkt „III.2. Ubiquity Stock-FW Version 3.7.58 auf die UAP AC MESH PRO aufspielen“)

6. Nach dem TFTP startet die UAP AC MESH PRO selbstätig neu und ist, sobald die LED dauerhaft weiß leuchtet, wieder unter der IP 192.168.1.20 für einen ssh-Zugriff erreichbar:

   ssh [email protected]
   Passwort: ubnt

Das Überspielen von Firmware (FW) auf die UAP AC MESH PRO mittels TFTP funktioniert nur mit Ubiquity Stock-Firmware (Stock-FW). Daher kann die Freifunk-Firmware (FF-FW) leider nicht einfach mittels TFTP aufgespielt werden. Statt dessen ist es notwendig, ausgehend von einer geeigneten Stock-FW die FF-FW innerhalb eines SSH-Zugriffs mittels „MTD“ (Memory Technology Devices; vgl. auch http://www.linux-mtd.infradead.org/doc/general.html) zu überspielen, wie nachfolgend näher beschrieben wird.

Vor dem Flashen muss unbedingt darauf geachtet werden, dass die vorinstallierte originale Ubiquity Firmware (Stock-FW) die Version 3.7.58 ist! Gemäß /5/ führen Ubiquiti Firmware Versionen abwärts beim Aufspielen und Updaten mit unserer Freifunk Firmware (ab Version 0.9.4 / GLUON 2017.1.7) zum Soft-Brick! Ab neueren Versionen der Stock-FW von Ubiquity (3.8.6 und neuer) ist leider kein “MTD” mehr dabei und ein Flashen wird so unmöglich. Nachfolgend wird beschrieben, wie man die vorinstallierte FW auf der UAP AC MESH PRO prüfen und ggf.
up-/downgraden kann, um dann anschließend die FF-FW zu überspielen.

Die UAP AC MESH PRO hat zwei Netzwerkanschlüsse: „PRIMARY LAN“ und „SECONDARY LAN“. Es ist wichtig für die jeweiligen Schritte den Computer mit dem „passenden“ LAN-Anschluß zu verbinden, dies wird nachfolgend jeweils angegeben. Der PoE-Anschluß für die UAP AC MESH PRO ist der Anschluß „PRIMARY LAN“.

Bei den nachfolgenden Angaben von Befehlen, die in ein Terminalfester einzugeben sind, bezeichnet das Symbol :~# das Eingabeprompt im Terminalfenster und muss nicht mit eingegeben werden. Es soll damit veranschaulicht werden, dass man bis zur Eingabe dieses Befehls auf dieses Eingabeprompt warten soll.

WICHTIG:
Falls die UAP AC MESH PRO im Außenbereich (Outdoor) eingesetzt werden soll (wofür sie ja eigentlich auch gemacht ist) muss man nach der Einrichtung im Config-Mode für das WLan auf der Konsole per ssh-Zugriff noch einige Einstellungen hinsichtlich Erkennung von Flugradar (radar detect) ausführen (sogen. DFS Mode für 5GHz) und die Sendeleistung anpassen (5 GHz und 2.4 GHz). Dies wird am Ende dieser Anleitung unter dem Punkt „VI. UAP AC MESH PRO für den Einsatz im Außenbereich (Outdoor) einrichten“ beschrieben.

coming soon …