Kurznotiz: #UniFi #Switch #CLI konfigurieren via #SSH #Console

Wer sich verVLAN’t oder „vielleicht“ den Switch-Port vom Controller, oder ein VLAN verdengelt hat, will möglicherweise nicht den Switch resetten, sondern den Switch(port) per Konsole/zu Fuß konfigurieren.

In diesem fiktiven Szenario habe ich versehentlich einen Switchport (0/5) an einem US8-150W deaktiviert, an jenem sich der Controller befindet.

Dazu muss im Controller zuvor SSH auf den Switches erlaubt sein. Deswegen empfiehlt es sich, den SSH-Zugang vor einem möglichen Unfall zu aktivieren. Du findest die Konfiguration im Netzwerk-Controller unter //System/Advanced „Device SSH Authentication“, dort kannst Du einen Nutzernamen und ein Kennwort setzen (Referenz: Link).

Der Cloudkey kann über die Konsoleneinstellungen ebenfalls mit einem SSH-Zugang versehen werden.
Ich würde empfehlen, den Zugang zuvor zu testen.

Auf die CLI geht’s rückwärts durch die Brust in’s Auge. Zuvor baust Du die Verbindung mittels SSH auf, dann öffnest Du innerhalb Deiner Konsolensitzung per

telnet localhost 23

den eigentlichen Zugang zur Switch-Konsole:

Die Syntaxreferenz für die UniFi-Switches ist nicht existent, allerdings orientiert sich doch fast alles an der Edgeswitch-CLI-Referenz, welche Du hier findest: Link

mit

enable
config

kommst Du in den Config-Modus.

Dann kannst Du mit

interface 0/5
(=interface Slot/Port, i.d.R. immer Slot 0 bei den einfachen Switches)

den Switchport auswählen und Deine Konfigurationsaufgaben durchführen. Du findest im Handburch hier (Link) ab Seite 196 die entsprechenden Konfigurationssyntax. Um ein deaktiviertes Interface #5 wieder zu aktivieren (um dieses Szenario zu treffen), willst Du also nachfolgend

no shutdown

absetzen, dann ist Dein Interface wieder online.

Das CLI-Handbuch ist zwar verlinkt, ich packe es zur Sicherheit hier nochmal mit bei:

Edgeswitch CLI Guide