Muokataan sivua 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:

<pre>
[main]
plugins=ifcfg-rh
</pre>

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:

<pre>
[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
</pre>

=== 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:
<pre>
[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
</pre>
Lista mahdollisista asetuksista löytyy [http://projects.gnome.org/NetworkManager/developers/api/08/settings-spec-08.html 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:
<pre>$ nmcli dev 
DEVICE     TYPE              STATE        
usb0       gsm               disconnected 
eth1       802-3-ethernet    unavailable  
eth0       802-3-ethernet    connected </pre>

<pre>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
</pre>

=== Yhteyksien listaus ===
<pre>$ 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
</pre>

=== Järjestelmän yleistila ===

Seuraava listaus osoittaa eri yhteyksien hallinnollisen yleistilan. Listauksesta ilmenee, että mobiiliverkko (''WWAN - wiress wide area network''') on sallittu.
<pre>
$ nmcli nm
RUNNING         STATE           WIFI-HARDWARE   WIFI       WWAN-HARDWARE   WWAN      
running         connected       enabled         enabled    enabled         disabled 
</pre>

Seuraava komento aktivoi mobiiliverkon hallinnollisesti:
<pre>
$ nmcli nm wwan on
$ nmcli nm
RUNNING         STATE           WIFI-HARDWARE   WIFI       WWAN-HARDWARE   WWAN      
running         connected       enabled         enabled    enabled         enabled
</pre>


=== 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:

<pre>
$ nmcli con status id Elisa
Error: 'Elisa' is not an active connection.
</pre>

<pre>$ 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
</pre>

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 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 ==
* [http://live.gnome.org/NetworkManager/SystemSettings live.gnome.org - NetworkManager/SystemSettings]
* [http://projects.gnome.org/NetworkManager/developers/settings-spec-08.html gnome.org - NetworkManager-0.8 settings specification]
* [http://projects.gnome.org/NetworkManager/developers/api/09/ref-settings.html gnome.org - NetworkManager-0.9 settings specification]

[[Luokka:Verkko]]