UniFi Allgemein | CLI Command Reference: ubnt-systool

  • Was wollen wir?

    Manuelles Ausführen der ubnt-systool (vormals ubnt-tools) auf dem Cloud Key am Beispiel des UC-CK



    Warum wollen wir das?

    Es ist nicht mehr möglich, das Eine oder Andere (hier: Update des Cloud Key) via Web-GUI durchzuführen oder es soll ein Parameter gesetzt werden, was auf einem anderen Weg nicht (mehr) möglich ist.



    Und wie geht das genau?

    Als erstes müsst ihr euch natürlich per SSH auf die Console verbinden. Nachdem das erfolgreich war könnt ihr das ubnt-systool aufrufen:


    ubnt-systool <command> [<arguments>] Verfügbarkeit Erklärung
    ubnt-systool adminemail <newemail> Cloud Key Gen 1 | Cloud Key Gen 2 | UDM(-P) tbd
    ubnt-systool adminname <newname> Cloud Key Gen 1 | Cloud Key Gen 2 | UDM(-P) tbd
    ubnt-systool anonid UDM(-P) tbd
    ubnt-systool chpasswd Cloud Key Gen 1 | Cloud Key Gen 2 | UDM(-P) tbd
    ubnt-systool cleanup Cloud Key Gen 1 | Cloud Key Gen 2 | UDM(-P) tbd
    ubnt-systool cputemp UDM(-P) zeigt die CPU-Temperatur an
    ubnt-systool fwupdate <updatefile> Cloud Key Gen 1 | Cloud Key Gen 2 | UDM(-P) Firmware-Update durchführen (s.u.)
    ubnt-systool fwupdatestatus Cloud Key Gen 1 | Cloud Key Gen 2 | UDM(-P) tbd
    ubnt-systool hostname <newhostname> Cloud Key Gen 1 | Cloud Key Gen 2 | UDM(-P) setzen des Hostnames auf den angegebenen Wert
    ubnt-systool led
    <ledname> <action> <action-arg1> <action-arg2> <action-arg3>
    Cloud Key Gen 1 | Cloud Key Gen 2 | UDM(-P) tbd
    ubnt-systool network <networkinterfacefile> Cloud Key Gen 1 | Cloud Key Gen 2 | UDM(-P) tbd
    ubnt-systool portstatus UDM(-P) tbd
    ubnt-systool poweroff Cloud Key Gen 1 | Cloud Key Gen 2 | UDM(-P) Herunterfahren des CloudKey (der UDM?)
    ubnt-systool pwcheck Cloud Key Gen 1 | Cloud Key Gen 2 | UDM(-P) tbd
    ubnt-systool reboot Cloud Key Gen 1 | Cloud Key Gen 2 | UDM(-P) Reboot des CloudKey (der UDM?)
    ubnt-systool reset2defaults Cloud Key Gen 1 | Cloud Key Gen 2 | UDM(-P) auf Werkseinstellungen zurücksetzen
    ubnt-systool resetbutton [<true|false>] Cloud Key Gen 1 | Cloud Key Gen 2 | UDM(-P) ohne Argument wird die aktuelle Konfiguration angezeigt, mit gesetzt
    ubnt-systool sshd [<true|false>] Cloud Key Gen 1 | Cloud Key Gen 2 | UDM(-P) ohne Argument wird die aktuelle Konfiguration angezeigt, mit gesetzt
    ubnt-systool sshd-authkeys [<new authkey file>] Cloud Key Gen 1 ohne Argument wird die aktuelle Konfiguration angezeigt, mit gesetzt
    ubnt-systool sshd-passwdauth [<true|false>] Cloud Key Gen 1 ohne Argument wird die aktuelle Konfiguration angezeigt, mit gesetzt
    ubnt-systool sshd-port [<port number>] Cloud Key Gen 1 ohne Argument wird die aktuelle Konfiguration angezeigt, mit gesetzt
    ubnt-systool support UDM(-P) tbd
    ubnt-systool supportinfo [<outputfile>] Cloud Key Gen 1 Support-File erzeugen
    ubnt-systool timezone <newtimezone> Cloud Key Gen 1 | Cloud Key Gen 2 | UDM(-P) s.u.


    Zum Thema fwupdate:

    Es ist unbedingt auf die Hinweise von UniFi zu achten, ob z.B. eine besondere Controller-Version installiert werden sollte oder ob durch das Update auch ein neuer Controller installiert wird / wurde. Es sollte unbedingt ein aktuelles Backup existieren, am besten nicht nur auf dem CloudKey. :winking_face:

    Zum Thema timezone:

    Nach einem Blick in die Datei /sbin/ubnt-systool ist hier offensichtlich der Pfad zur Zeitzonen-Datei ab /usr/share/zoneinfo/ anzugeben, z.B. Europe/Berlin oder auch US/Hawaii, um die entsprechende Zeitzone zu konfigurieren. Das kenne ich auch von vollwertigen Linux-Distributionen so. Es ist u.U. ein Reboot nötig, um die Änderungen zu übernehmen.


    :exclamation_mark:Ich versuche noch die offizielle / eine Übersicht zu finden. Das ist mir aber bisher leider nicht gelungen.


    Disclaimer: Alle Anleitungen/Tutorials sind nach bestem Wissen und Gewissen verfasst, gehen immer von den definierten Software/Firmware-Versionen aus und sind auf das englische GUI ausgelegt.

    Es gibt keine Garantien auf Erfolg. Im Falle eines Misserfolges hilft die Community hier gern weiter.

    Keiner der Autoren oder Betreiber des Forums ist für die aus der Nutzung resultierenden Probleme / Herausforderungen verantwortlich.

    Jegliche hier beschriebenen Schritte erfolgen ausnahmslos in eigener Verantwortung. Eltern haften für ihre Kinder.:winking_face_with_tongue: