NetworkManager/KeyFile

NetworkManager (jäljempänä NM) tallentaa yhteysasetuksensa tiedostoihin, joita se käsittelee backend-pluginien avulla. Plugineita on eri tyyppisiä eri tiedostoformaatteja varten ja siten jakelupaketin oletus-backend ja plugin vaihtelee jakelun mukaan. Pluginit asetetaan pääasetustiedostossa /etc/NetworkManager/NetworkManager.conf, jossa voi olla seuraavat rivit:

[main]
plugins=ifcfg-rh

Jolloin NM käyttää Fedora-leirin mukaisia asetustiedostoja /etc/sysconfig/network-scripts/ hakemistosta. NM:n natiivi formaatti on keyfile jonka voi lisätä plugins riville pilkulla erotettuna tai käyttää sitä ainoana formaattina jolloin kaikki yhteydet tulee määritellä sillä.

Yhteys - Connection

• id
• uuid
• type
• autoconnect - true tai false

Yhteystyypit type

Connection osion type kentän mahdolliset arvot:

• 802-3-ethernet
• vlan - 802.1Q virtuaaliverkot
• 802-11-wireless
• gsm

Yhteystyyppi vlan

Mahdolliset asetukset:

• parent - esim eth0
• id - VLAN id, kokonaisluku

Yhteystyyppi 802-11-wireless

• ssid - SSID
• mode - infrastructure tai ?
• mac-address - sovittimen L2 tason osoite.
• security - 802-11-wireless-security

802-11-wireless-security

• key-mgmt - wpa-psk
• wep-key-flags - 1
• psk-flags - 1
• leap-password-flags - 1

Verkkoprotokollat

ipv4

• method - auto, manual ja mahdollisesti disabled.
• addresses1 - ip osoitteet puolipilkulla (;) eroteltuna ja lopetettuna.

ipv6

• method - auto, manual ja mahdollisesti disabled.

Esimerkkejä

Wifi asetukset

Salaamattoman wifi-verkon yhteysasetukset:

[connection]
id=tuju-w3
uuid=07a5fd03-267f-4dc7-84d8-146e3f9d8364
type=802-11-wireless
permissions=user:tuju:;
autoconnect=true
timestamp=123131

[802-11-wireless]
ssid=tuju-w3
mode=infrastructure
security=802-11-wireless-security

[802-11-wireless-security]
key-mgmt=none
wep-key-flags=1
psk-flags=1
leap-password-flags=1

[ipv4]
method=auto

[ipv6]
method=auto

Mobiiliverkon GPRS asetukset

Keyfile asetustiedostot sijaitsevat /etc/NetworkManager/system-connections/ hakemistossa. Tiedoston nimellä ei ole väliä, sillä voi olla tarkennin tai olla olematta. Esimerkkitiedoston Elisa sisältö voi olla:

[connection]
id=Elisa
uuid=67d91271-9280-4ad2-88b6-ad333709cfe7
type=gsm
permissions=user:tuju:;
autoconnect=false
timestamp=0

[gsm]
number=*99#
apn=internet

[ipv4]
method=auto

[serial]
baud=115200

Lista mahdollisista asetuksista löytyy nm-0.8 asetusmäärityksistä. Muutosten jälkeen prosesseja ei tarvitse potkia sillä NM seuraa hakemistoja ja asetustiedostoja ja päivittää itsensä tilanteen muuttuessa, heti tiedoston kirjoittamisen jälkeen.

Komennot

Laitteiden listaus

Mobiiliverkon sovittimet näkyvät nykyisin useimmiten USB-liitäntöinä kuten esimerkin tapauksessa:

$ nmcli dev 
DEVICE     TYPE              STATE        
usb0       gsm               disconnected 
eth1       802-3-ethernet    unavailable  
eth0       802-3-ethernet    connected 

nmcli dev list iface usb0
GENERAL.DEVICE:                         usb0
GENERAL.TYPE:                           gsm
GENERAL.VENDOR:                         HP
GENERAL.PRODUCT:                        HP hs2340 HSPA+ MobileBroadband
GENERAL.DRIVER:                         cdc_acm
GENERAL.HWADDR:                         (unknown)
GENERAL.STATE:                          30 (disconnected)
GENERAL.REASON:                         0 (No reason given)
GENERAL.UDI:                            /org/freedesktop/ModemManager/Modems/2
GENERAL.IP-IFACE:                       
GENERAL.NM-MANAGED:                     yes
GENERAL.FIRMWARE-MISSING:               no
GENERAL.CONNECTION:                     not connected
CAPABILITIES.CARRIER-DETECT:            no
CAPABILITIES.SPEED:                     unknown

Yhteyksien listaus

$ nm con list
System eth1               3f2c2b44-1c1f-48d0-971c-227340826ea4   802-3-ethernet    never                             
Boot Disk                 c9a0ecd1-9a91-43a2-b0ad-73cc4441aaa8   802-3-ethernet    Tue 17 Feb 2009 05:33:06 AM EET   
Elisa                     67d91271-9280-4ad2-88b6-ad333709cfe7   gsm               Wed 21 Sep 2011 09:31:41 PM EEST

Järjestelmän yleistila

Seuraava listaus osoittaa eri yhteyksien hallinnollisen yleistilan. Listauksesta ilmenee, että mobiiliverkko (WWAN - wiress wide area network') on sallittu.

$ nmcli nm
RUNNING         STATE           WIFI-HARDWARE   WIFI       WWAN-HARDWARE   WWAN      
running         connected       enabled         enabled    enabled         disabled 

Seuraava komento aktivoi mobiiliverkon hallinnollisesti:

$ nmcli nm wwan on
$ nmcli nm
RUNNING         STATE           WIFI-HARDWARE   WIFI       WWAN-HARDWARE   WWAN      
running         connected       enabled         enabled    enabled         enabled

Yhteyden aktivointi

Kun yhteydet on luotu ja sallittu hallinnollisesti, niitä voidaan aktivoida käsin tai antaa järjestelmän huolehtia siitä automaattisesti asettamalla tämä asetuksista. Järjestelmää testatessa voi yhteyden aktitvoida käsin seuravasti:

$ nmcli con status id Elisa
Error: 'Elisa' is not an active connection.

$ nmcli con up id Elisa
$ nmcli con status id Elisa
GENERAL.NAME:                           Elisa
GENERAL.UUID:                           67d91271-9280-4ad2-88b6-ad333709cfe7
GENERAL.DEVICES:                        usb0
GENERAL.STATE:                          activated
GENERAL.DEFAULT:                        no
GENERAL.DEFAULT6:                       no
GENERAL.VPN:                            no
GENERAL.ZONE:                           not set
GENERAL.DBUS-PATH:                      /org/freedesktop/NetworkManager/ActiveConnection/1
GENERAL.CON-PATH:                       /org/freedesktop/NetworkManager/Settings/2
GENERAL.SPEC-OBJECT:                    not set
GENERAL.MASTER-PATH:                    not set
IP4.ADDRESS[1]:                         ip = 10.21.21.212/29, gw = 10.21.21.210
IP4.DNS[1]:                             194.204.0.1
IP4.DNS[2]:                             194.204.18.244
DHCP4.OPTION[1]:                        expiry = 1234988574
DHCP4.OPTION[2]:                        dhcp_client_identifier = 1:2:80:37:ec:2:0
DHCP4.OPTION[3]:                        broadcast_address = 10.21.21.215
DHCP4.OPTION[4]:                        dhcp_message_type = 5
DHCP4.OPTION[5]:                        dhcp_lease_time = 86400
DHCP4.OPTION[6]:                        ip_address = 10.21.21.212
DHCP4.OPTION[7]:                        subnet_mask = 255.255.255.248
DHCP4.OPTION[8]:                        routers = 10.21.21.210
DHCP4.OPTION[9]:                        domain_name_servers = 194.204.0.1 194.204.18.244
DHCP4.OPTION[10]:                       interface_mtu = 1500
DHCP4.OPTION[11]:                       network_number = 10.21.21.208
DHCP4.OPTION[12]:                       dhcp_server_identifier = 10.21.21.209

$ route -n
Kernel IP routing table
Destination     Gateway         Genmask         Flags Metric Ref    Use Iface
0.0.0.0         172.16.1.254    0.0.0.0         UG    0      0        0 eth0
10.21.21.208    0.0.0.0         255.255.255.248 U     0      0        0 usb0
172.16.1.0      0.0.0.0         255.255.255.0   U     0      0        0 eth0

Lopun reititintaulun listauksessa näkyy aktiivinen yhteys mobiiliverkon USB-liitännässä, mutta oletus yhdyskäytävä osoittaa vielä lähiverkon liitäntään.

Jakelukohtaisia ohjeita

Fedora ja Red Hat:in RHEL käyttävät pluginia ifcfg-rh.

Suse ja OpenSuse voivat käyttää pluginia ifcfg-suse, joskin on suositeltavaa käyttää natiivia keyfile-formaattia koska sen toiminnassa on rajoituksia.

Aiheesta muualla

• live.gnome.org - NetworkManager/SystemSettings
• gnome.org - NetworkManager-0.8 settings specification
• gnome.org - NetworkManager-0.9 settings specification