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.