Ero sivun ”NetworkManager/KeyFile” versioiden välillä

Linux.fista
Siirry navigaatioon Siirry hakuun
(Ak: Uusi sivu: '''NetworkManager''' (jäljempänä NM) tallentaa yhteysasetuksensa tiedostoihin, joita se käsittelee backend-pluginien avulla. Plugineita on eri tyyppisiä eri tiedostoformaatteja v...)
 
 
(17 välissä olevaa versiota samalta käyttäjältä ei näytetä)
Rivi 6: Rivi 6:
</pre>
</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 listalle tai käyttää sitä ainoana formaattina.
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ä.


== Mobiiliverkon GPRS asetukset ==
 
== 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:
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:
Rivi 18: Rivi 98:
permissions=user:tuju:;
permissions=user:tuju:;
autoconnect=false
autoconnect=false
timestamp=1316629901
timestamp=0


[gsm]
[gsm]
Rivi 30: Rivi 110:
baud=115200
baud=115200
</pre>
</pre>
http://projects.gnome.org/NetworkManager/developers/settings-spec-08.html
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 ==
== Komennot ==


=== Laitteiden listaus===
Mobiiliverkon sovittimet näkyvät nykyisin useimmiten USB-liitäntöinä kuten esimerkin tapauksessa:
<pre>$ nmcli dev  
<pre>$ nmcli dev  
DEVICE    TYPE              STATE         
DEVICE    TYPE              STATE         
Rivi 58: Rivi 141:
</pre>
</pre>


=== Yhteyksien listaus ===
<pre>$ nm con list
<pre>$ nm con list
System eth1              3f2c2b44-1c1f-48d0-971c-227340826ea4  802-3-ethernet    never                             
System eth1              3f2c2b44-1c1f-48d0-971c-227340826ea4  802-3-ethernet    never                             
Rivi 64: Rivi 148:
</pre>
</pre>


<pre>$ nmcli con up id Elisa</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 ==
== Jakelukohtaisia ohjeita ==


Fedora ja Red Hat RHEL käyttävät pluginia ''ifcfg-rh''.
[[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 ==
== Aiheesta muualla ==
* [http://live.gnome.org/NetworkManager/SystemSettings live.gnome.org - NetworkManager/SystemSettings]
* [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/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]]
[[Luokka:Verkko]]

Nykyinen versio 7. toukokuuta 2013 kello 18.51

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[muokkaa]

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

Yhteystyypit type[muokkaa]

Connection osion type kentän mahdolliset arvot:

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

Yhteystyyppi vlan[muokkaa]

Mahdolliset asetukset:

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

Yhteystyyppi 802-11-wireless[muokkaa]

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

802-11-wireless-security[muokkaa]

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


Verkkoprotokollat[muokkaa]

ipv4[muokkaa]

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

ipv6[muokkaa]

  • method - auto, manual ja mahdollisesti disabled.

Esimerkkejä[muokkaa]

Wifi asetukset[muokkaa]

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[muokkaa]

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[muokkaa]

Laitteiden listaus[muokkaa]

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[muokkaa]

$ 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[muokkaa]

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[muokkaa]

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[muokkaa]

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[muokkaa]

Noudettu kohteesta ”https://www.linux.fi/w/index.php?title=NetworkManager/KeyFile&oldid=37481”