Kabelverbindung konfigurieren¶

Der Befehl

#nmcli connection add type ethernet ifname GERÄT
nmcli connection add type ethernet ifname eth0 

erzeugt diese Datei /etc/NetworkManager/system-connections/ethernet-eth0:

[connection]
id=ethernet-eth0
uuid=1a7f80db-a616-44b2-abb8-b4ec1fbb3413
type=ethernet
interface-name=eth0
permissions=
secondaries=

[ethernet]
mac-address-blacklist=

[ipv4]
dns-search=
method=auto

[ipv6]
addr-gen-mode=stable-privacy
dns-search=
method=auto

Die leeren Zeilen sind für die Auswertung erforderlich! Die Zeilen in eckigen Klammern [ bzw. ] fassen die einzelnen Abschnitte zur Auswertung zusammen. Nachfolgend die wesentlichen Werte, soweit diese nicht selbsterklärend sind.

Zur Bedeutung weiterer Variablen sowie zur Verwendung des Abschnitts [ipv6] und weiterer Abschnitte siehe die Dokumentation von NetworkManager.

Konfigurationsdatei bearbeiten¶

Zur Bearbeitung kann man eine der folgenden Methoden anwenden:

1. Datei als root mit einen Texteditor^[2] bearbeiten:

   • Man sollte dies nicht bei laufendem NetworkManager machen, da man sonst inkonsistente Zustände provoziert.

   • Dies ist die mächtigste Methode, man kann aber auch leicht fehlerhafte Konfigurationen erstellen.

2. Verwendung des in mncli eingebauten interaktiven Verbindungs-Editor, dessen Bedienung exemplarisch hier im Abschnitt „Statische IP definieren“ erläutert wird.

   • Hierbei profitiert man von dem in nmcli eingebauten Hilfesystem, den direkt verfügbaren Erläuterungen zu den Optionen und deren Werten und auch wegen der automatischen Befehls-Vervollständigung und der eingebauten Befehls-Historie.

   • Alle Möglichkeiten von NetworkManager sind zugänglich.

   • Die Eingaben werden geprüft und syntaktisch falsche Eingaben werden abgewiesen.

3. Ab Ubuntu 16.04: Verwendung des halbgraphischen Editors nmtui, der mittels der NCURSES-Bibliothek die Daten aufbereitet:

   • Übersichtlicher als der interaktive Verbindungs-Editor von nmcli,

   • aber weniger mächtig.

4. Einsatz eines graphischen Konfigurierwerkzeuges:

   • Erfordert installierten Desktop,

   • noch übersichtlicher und schöner als nmtui,

   • aber noch weniger mächtig.

Statische IP definieren¶

Muss oder will man für IPv4 statische Adressen verwenden, so wird der Abschnitt [ipv4] angepasst, beispielsweise:

[ipv4]
address1=10.0.0.42/10,10.0.0.1
address2=192.0.2.42/32
dns=192.0.2.222;10.0.0.1;
dns-search=
method=manual

Man kann dies mit nmcli erledigen, indem man den interaktiven Verbindungs-Editor startet:

#nmcli connection edit VERBINDUNGSNAME
nmcli connection edit ethernet-eth0 

Der interaktive Verbindungs-Editor versteht eine ganze Reihe von Befehlen, die wichtigsten sind:

• help zum Aufruf von Hilfstexten.

• print zur Anzeige von Variablen und Werten.

• goto und back zum Navigieren zu einem Abschnitt und Verlassen des Abschnitts.

• set zum Setzen von Werten.

• save zur Speicherung der Datei.

• quit zum Verlassen des Editors.

Der Editor beherrscht die automatische Vervollständigung mit der Tab-Taste und führt eine Befehls-Historie.

Die o.g. Veränderung des Abschnitts [ipv4] erreicht man durch diese Befehlsfolge:

nmcli> goto ipv4
nmcli ipv4> set method manual 
nmcli ipv4> set addresses 10.0.0.42/10
nmcli ipv4> set addresses 192.0.2.42/32
nmcli ipv4> set gateway  10.0.0.1
nmcli ipv4> set dns 192.0.2.222
nmcli ipv4> set dns 10.0.0.1
nmcli ipv4> save
nmcli ipv4> quit

Beachte: Die Variablen im Editor weichen teilweise von den in der Datei hinterlegten Optionen ab, vgl. addresses und gateway im Editor mit address1 in der Datei.

Zum Löschen eines Wertes, auch einer Adressliste, gibt man einen leeren Wert durch zweimaliges Betätigen der Eingabetaste ein.

WLAN-Verbindung konfigurieren¶

Für eine WLAN-Verbindung geht man im Prinzip genau so vor wie für eine Kabelverbindung, verwendet aber type wifi und muss die SSID des WLAN-Netzes angeben:

#nmcli connection add ifname GERÄT type wifi ssid SSID
nmcli connection add ifname wlan0 type wifi ssid UbuntuUsers 

Dieser Befehl erzeugt diese Datei /etc/NetworkManager/system-connections/wifi-wlan0:

[connection]
id=wifi-wlan0
uuid=d63bfffb-b4f1-465f-af8e-b4cb0786a3eb
type=wifi
interface-name=wlan0
permissions=
secondaries=

[wifi]
mac-address-blacklist=
mac-address-randomization=0
seen-bssids=
ssid=UbuntuUsers

[ipv4]
dns-search=
method=auto

[ipv6]
addr-gen-mode=stable-privacy
dns-search=
method=auto

Anstelle des Abschnitts [ethernet] bei der Kabelverbindung wird hier ein Abschnitt [wifi] erzeugt; alle Abschnitte können mit dem interaktiven Verbindungs-Editor wie vorstehend beschrieben mit Optionen ausgestaltet werden.

Ebenfalls bearbeitbar, jedoch nicht auslesbar, ist ein (in der frisch erzeugten Datei noch fehlender) Abschnitt [wifi-sec] zur Aufnahme der für eine verschlüsselte Kommunikation erforderlichen Angaben inklusive des Passwortes.

Zur Nutzung der so erzeugten Verbindungsdatei muss man noch im Abschnitt [wifi] die Variable mode und im Abschnitt [wifi-sec] die Variablen key-mgmt und psk setzen; dies kann man mit dem interaktiven Verbindungs-Editor erledigen:

#nmcli connection edit VERBINDUNGSNAME
nmcli connection edit wifi-wlan0

nmcli> goto wifi
nmcli 802-11-wireless> set mode infrastructure 
nmcli 802-11-wireless> back 
nmcli> goto wifi-sec 
nmcli 802-11-wireless-security> set key-mgmt wpa-psk 
nmcli 802-11-wireless-security> set psk Hier ist nichts geheim!
nmcli 802-11-wireless-security> save 
nmcli 802-11-wireless-security> quit 

Genereller Status¶

• Aktuelle Netzwerk-Konfiguration anzeigen:

nmcli general 

• Netzwerk generell ein- bzw. ausschalten:

nmcli networking on    # bzw. off statt on 

• Funk ein-/ausschalten: (wwan steht für Telefon-Netze, wifi für IEEE802-11.)

nmcli radio wwan off   # bzw. on statt off
nmcli radio wifi on    # bzw. off statt on 

Die drei letzten Befehle ändern in der Datei /var/lib/NetworkManager/NetworkManager.state den (auch über re-boot) gemerkten generellen Status von NetworkManager.

Ab/-Aufbau Verbindung¶

In den folgenden Befehlen sind natürlich VERBINDUNGSNAME bzw. GERÄT durch sinnvolle Angaben gemäß den Listen nmcli connection bzw. nmcli device zu ersetzen.

• Aktive Verbindung beenden:

nmcli connection down VERBINDUNGSNAME 

Beachte: Falls NetworkManager nach dem Abbau der Verbindung eine nutzbare Konfiguration für die Schnittstelle GERÄT findet, bei der autoconnect nicht ausgeschaltet wurde, so wird er automatisch mit der gefundenen Konfiguration die Schnittstelle wieder aktivieren. Das dauert einige Sekunden. Die „neue“ aktive Konfiguration kann durchaus wieder die gerade beendete alte oder eine andere sein.

• Alternative Methode zum Beenden einer Verbindung:

nmcli device disconnect GERÄT  

Beachte: Nach dem Abbau der über das GERÄT aktiven Verbindung wird NetworkManager nicht automatisch wieder eine Verbindung über dieses Gerät aufbauen.

• Verbindung aktivieren:

nmcli connection up VERBINDUNGSNAME 

• Alternative Methode zum Verbinden:

nmcli device connect GERÄT 

Falls für die zu aktivierende Schnittstelle bereits eine andere Verbindung aktiv ist, so wird diese vor dem Aufbau der neuen Verbindung beendet.

Konfiguration anzeigen¶

• Konfiguration der Schnittstelle GERÄT anzeigen:

nmcli device show GERÄT 

• Falls man die Ausgabe dieses Befehls in einem Skript verwenden möchte, verwendet man besser:

LANG=C nmcli -t device show GERÄT 

NetworkManager zeigt per nmcli Informationen zu allen im System vorhandenen – auch für die von ihm nicht verwalteten – Netzwerkschnittstellen an.