Differenze tra le versioni 50 e 64 (in 14 versioni)
|
Dimensione: 18977
Commento:
|
← Versione 64 del 2020-12-15 15:29:49 ⇥
Dimensione: 8930
Commento: update
|
| Le cancellazioni sono segnalate in questo modo. | Le aggiunte sono segnalate in questo modo. |
| Linea 1: | Linea 1: |
| ||<style="padding-right: 50px; width: 50%; border: none; vertical-align: bottom;"> Il [[http://libre-mesh.org/projects/libre-mesh|firmware Libre-Mesh]] è il nuovo sistema operativo per router pensato per le community wireless nato dagli sforzi congiunti di italiani, spagnoli ed argentini riuniti sotto il nome di, appunto, [[http://libre-mesh.org|Libre-Mesh]]. Precisamente il firmware Libre-Mesh è un insieme di moduli da aggiungere a [[ http://openwrt.org/ | OpenWrt ]] per gestire il routing dinamico e altre funzioni necessarie per gestire una rete wireless mesh. <<BR>> <<BR>> Libre-Mesh viene attualmente utilizzato in Ninux da: <<BR>> - [[ http://verona.ninux.org/ | NinuxVerona ]] <<BR>> - [[ http://wiki.bologna.ninux.org | NinuxBO ]]|| <<TableOfContents()>> || == Scaricare il firmware già pronto == Il firmware libre-mesh può essere scaricato dai repository delle singole isole Ninux che usino Libre-Mesh. == Prodursi una immagine di Libre-Mesh == Come tutti i software open source è possibile creare il proprio file compilato partendo dal codice sorgente. === Devices supportati da Libre-Mesh === Libre-Mesh supporta tutti i router che siano [[ http://wiki.openwrt.org/toh/start | supportati da OpenWrt ]], potrebbe essere instabile su router particolarmente scarsi. === Compilare === Compilare vuol dire creare il proprio file di installazione di Libre-Mesh partendo dal codice sorgente scritto dai suoi sviluppatori e reperibile pubblicamente. ==== Prerequisiti ==== Procuratevi un computer con GNU/Linux che abbia una decina di GB liberi sull'hard disk ed installate i pacchetti contenenti le dipendenze necessarie alla compilazione, ad esempio se state usando una distribuzione Linux che sia Debian-based potrete installarle dal terminale (dopo aver ottenuto i privilegi di amministratore): {{{ apt-get install git build-essential libncurses5-dev zlib1g-dev gawk subversion }}} oppure selezionando gli stessi pacchetti dall'apposito software grafico. Se avete altre distro GNU/Linux e non trovate i nomi corretti dei pacchetti da installare, provate a compilare lo stesso, se incontrate errori tornate a questo punto e date un'occhiata a [[ http://wiki.openwrt.org/doc/howto/buildroot.exigence#examples_of_package_installations | queste liste ]] di pacchetti utili. ==== Ottenere il codice sorgente di OpenWrt ==== Aprite un terminale e scaricate il sorgente della release BarrierBreaker 14.07 di OpenWrt (stiamo lavorando al supporto dell'ultima release stabile, per ora usate la penultima): {{{ git clone git://git.openwrt.org/14.07/openwrt.git }}} ==== Aggiungere i sorgenti di Libre-Mesh ==== Sempre da terminale entrate nella cartella appena scaricata, copiate il file esempio con le fonti supplementari di sorgenti {{{ cd openwrt cp feeds.conf.default feeds.conf }}} ed aggiungete gli indirizzi dei sorgenti di Libre-Mesh. Le varie isole Ninux potrebbero indicare una sorgente pre-configurata. Libre-Mesh standard: {{{ echo "src-git lime https://github.com/libre-mesh/lime-packages.git" >> feeds.conf }}} Libre-Mesh preconfigurato per NinuxVerona: {{{ echo "src-git lime https://github.com/VeronaWirelessCommunity/lime-packages.git" >> feeds.conf }}} Se volete testare un branch particolare di lime-packages, ad esempio il branch "15.07", aggiungete ";15.07", ad esempio, invece della riga precedente, potete fare così: {{{ echo "src-git lime https://github.com/libre-mesh/lime-packages.git;release/15.07" >> feeds.conf }}} Dunque fate scaricare e mettere nel giusto posto i sorgenti appena indicati: {{{ scripts/feeds update -a scripts/feeds install -a }}} ==== Selezionare i moduli di Libre-Mesh ==== Aprite il menù di selezione dei software da compilare e da inserire nell'immagine. {{{ make menuconfig }}} Entra nella voce "Base system" e deseleziona la voce "dnsmasq" e seleziona "dnsmasq-dhcpv6" (che a differenza del precedente supporta sia IPv4 che IPv6) e la voce "firewall" (perché alcuni sviluppatori di Libre-Mesh insinuano che dia più problemi che vantaggi) premendo il bottone spazio, esci premendo Esc per due volte e entra nella sezione "Network", dunque deseleziona "odhcpd" (da non confondere con "odhcp6c" che si può lasciare, il problema con "odhcpd" è la coesistenza con "dnsmasq": avendoli entrambi si possono avere due server dhcp con lo stesso compito), esci premendo Esc per due volte ed entra nella sezione "LiMe". Nel menù "LiMe" seleziona quel che ti serve, l'esempio di un Libre-Mesh che fa routing solo a layer2 può essere "lime-system, lime-proto-batadv, lime-debug". Segue una tabella con la descrizione in inglese e italiano dei moduli selezionabili: || Modulo || Descr. Inglese || Descr. Italiano || ||batman-adv-auto-gw-mode || Changes batman-adv gw_mode to reflect internet availability || Mah. Cambia il fatto che batman-adv consideri il nodo come gateway in base alla presenza di connettività verso internet sua e degli altri nodi || ||bmx6-auto-gw-mode|| bmx6 auto Internet gateway module || Mah. Cambia il fatto che batman-adv consideri il nodo come gateway in base alla presenza di connettività verso internet || ||dnsmasq-lease-share|| dnsmasq lease sharing accross batman-adv mesh || Condivide la lista dei lease (IP assegnati dal DHCP) a tutti i nodi con Alfred (presente in Batman-adv) || ||lime-altermesh|| AlterMesh metapackage using LiMe codebase || No. || ||lime-debug|| libre-mesh debug utils || Sì! Un paio di script utili (batctl e sprunge) || ||lime-eb-ip-tables|| libre-mesh iptables/ebtables support || Mah. || ||lime-full|| libre-mesh metapackage || No. || ||lime-hwd-ground-routing|| Manage 8021q VLANs for ground routing || Supporto per il routing a terra || ||lime-hwd-openwrt-wan|| Respect openwrt wan interface as default || Sì! La classica porta WAN dei router si comporterà da porta WAN || ||lime-hwd-usbradio|| LiMe hardware detection usb radio support || Per usare antenne connesse via USB || ||lime-map-agent|| LiMe LibreMap agent || No. || ||lime-proto-anygw|| LiMe anygw proto support || Se usate routing a layer 3 come BMX6 o OLSR (?) potrebbe servirvi. Tutte le antenne annunciano lo stesso gateway fittizio ai client per poi dirigere i dati verso il gateway più conveniente. || ||lime-proto-batadv|| LiMe batman-adv proto support || Supporto al routing layer 2 tramite Batman advanced || ||lime-proto-bmx6|| LiMe Bmx6 proto support || Supporto al routing layer 3 tramite BMX6 || ||lime-proto-eigennet|| LiMe eigennet legacy compatibility proto support || No. || ||lime-proto-olsr|| LiMe OLSR proto support (IPv4) || Supporto al routing layer 3 tramite OLSR v1 per IPv4 || ||lime-proto-olsr6|| LiMe OLSR proto support (IPv6) || Supporto al routing layer 3 tramite OLSR v1 per IPv6 || ||lime-proto-qmp|| LiMe qmp proto legacy compatibility support || No. || ||lime-proto-wan|| LiMe wan proto support || Supporta la possibilità di impostare una porta a scelta del router come "porta WAN" || ||lime-system|| libre-mesh system files || Si! Questo è il cuore di Libre-Mesh || ||lime-webui|| libre-mesh web user interface based on LUCI || Aggiunge una tabella per Libre-Mesh alla interfaccia web || ||reghack|| Regulatory domain unlocker || No. || Se si vuole limitare le immagini che verranno prodotte a solo quelle che servono, si può selezionare il proprio router nei menù "Target system" e "Target profile", altrimenti basta lasciare i target di default e tutte le immagini (almeno quelle per ar71xx) verranno prodotte. Salvare la configurazione premendo Esc fino a vedere una richiesta di "esci salvando?" salva ed esci. ==== Configurare pre-compilazione (opzionale) ==== Alcune configurazioni possono essere inserite già nell'immagine, questo è comodo nel caso si dovesse mettere questa immagine su molti router e non si volesse configurarli poi uno ad uno dopo l'installazione. Modificare, con il proprio editor di testo preferito, il file in {{{ feeds/lime/packages/lime-system/files/etc/config/lime-defaults }}} Le righe che iniziano con cancelletto non hanno effetto. Ad esempio, se volessi preimpostare i prefissi di IP, il canale wireless e il nome della rete, il contenuto potrebbe essere: |
||<style="padding-right: 50px; width: 50%; border: none; vertical-align: bottom;"> Il [[http://libremesh.org/|firmware LibreMesh]] (precedentemente "Libre-Mesh") è il nuovo sistema operativo per router pensato per le community wireless nato dagli sforzi congiunti di italiani, spagnoli/catalani (Guifi.net) ed argentini (Altermundi) riuniti sotto il nome di, appunto, [[https://libremesh.org|LibreMesh]]. Precisamente il firmware LibreMesh è un insieme di moduli da aggiungere a [[ https://openwrt.org/ | OpenWrt ]] per gestire il routing dinamico e altre funzioni necessarie ad una rete wireless mesh. <<BR>> <<BR>> LibreMesh viene attualmente utilizzato in Ninux da: <<BR>> - [[ http://verona.ninux.org/ | NinuxVerona ]] <<BR>> - [[ http://wiki.bologna.ninux.org | NinuxBO ]]|| <<TableOfContents()>> || '''Questa pagina potrebbe esser non aggiornata, in caso di dubbi fate riferimento alla guida ufficiale in [[ http://libremesh.org/docs/en_quick_starting_guide.html | inglese ]].''' == Devices supportati da LibreMesh == Per andare sul sicuro è possibile consultare [[https://libremesh.org/docs/hardware/index.html|la pagina]] dei router che sono stati ampiamente utilizzati con LibreMesh dando buoni risultati. Sulla stessa pagina son riportati i criteri che assicurano un buon funzionamento di LibreMesh su altri routers. == Prodursi una immagine di LibreMesh == Come tutti i software open source è possibile creare il proprio file compilato partendo dal codice sorgente. Seguire le istruzioni sulla pagina https://libremesh.org/development.html Il prossimo passo è installare, anche detto flashare, l'immagine adatta sul proprio router, come far questo viene accennato più avanti nella sezione "Flashing". == Flashing == È necessario seguire le [[ https://openwrt.org/toh/start | istruzioni specifiche per ogni modello di router descritte sul sito di OpenWrt ]] per l'installazione di OpenWrt. == Prima connessione == === Da interfaccia web === -- guida da scrivere -- === Da terminale === Utilizzando il terminale Linux è comodo connettersi utilizzando l'indirizzo ''thisnode.info'' che è impostato in tutti i router LibreMesh. Appena installato LibreMesh non ha una password di amministratore, dunque ci si connette via SSH a ''thisnode.info'' tramite interfaccia web su [[http://thisnode.info]] per impostarla. Da interfaccia web è presente un banner che aiuta a impostare la password di amministratore, da terminale invece ci si connette con: {{{ ssh root@thisnode.info }}} e si imposta la password tramite il comando {{{ passwd }}} dunque si riavvia con {{{ reboot && exit }}} e si può proseguire con la configurazione. == Configurazione == === Da interfaccia web === -- guida da scrivere -- === Da terminale === La configurazione da utilizzare può essere leggermente differente tra le diverse isole, la configurazione di default va bene in generale. Date un'occhiata al contenuto del file "/etc/config/lime-node": {{{ cat /etc/config/lime-node }}} Il file dovrebbe essere piuttosto vuoto, dunque le opzioni di default sono quelle in uso. Tutte le opzioni commentate si possono trovare nel router in "/docs/lime-example.txt" {{{ less /docs/lime-example.txt }}} o, sempre sul router, su http://thisnode.info/docs/lime-example.txt o online qui: https://github.com/libremesh/lime-packages/blob/master/packages/lime-docs/files/www/docs/lime-example.txt Per modificare il file di configurazione "/etc/config/lime-node" si usa solitamente l'editor di testo vim: {{{ vim /etc/config/lime-node }}} si abilita la modalità di modifica in vim premendo ''i'', dopo aver modificato il file si esce dalla modalità di modifica premendo ''Esc'' e si salva premendo '':wq'' e Invio uno dopo l'altro. Ad esempio perché il nome della rete wireless access point sia "ninux.org" e il canale wireless sui 2.4GHz sia il numero 6, nel file "lime" ci deve essere: {{{ config lime wifi option channel_2ghz '6' option ap_ssid 'ninux.org' }}} oppure per impostare gli ip |
| Linea 136: | Linea 95: |
| option main_ipv4_address '198.51.100.%M6/24' # se l'ultimo campo è %M6 si autocompleta con il sesto campo del MAC address option main_ipv6_address '2001:db8:900d:c0de::%M5:%M6/64' # se gli ultimi campi sono %M5 e %M6 si autocompleta con il quinto e sesto campo del MAC address config lime wifi option channel_2ghz '3' option ap_ssid 'ninux.org' }}} ==== Lanciare la compilazione ==== Per iniziare il processo vero e proprio di compilazione dare il comando "make": {{{ make }}} ==== Recuperare il file prodotto ==== I file compilati si trovano nella cartella {{{ cartelladiopenwrt/bin/ar71xx/... }}} e solitamente hanno dei nomi indicativi per l'hardware a cui sono adatti. Il prossimo passo è installare, anche detto flashare, l'immagine adatta sul proprio router, come far questo viene accennato più avanti nella sezione "Flashing". == Alternativa: prodursi una immagine usando lime-build (deprecato) == === Devices supportati da lime-build === I devices supportati sono quelli elencati in [[ https://github.com/libre-mesh/lime-build/blob/master/targets.mk | questo ]] file. Attenzione, alcuni devices non sono citati esplicitamente ma sono equivalenti ad alcuni elencati, ad esempio una Ubiquiti PicoStation M2 è (secondo il wiki di OpenWrt) equivalente ad una Ubiquiti Bullet dunque è supportata. Se il vostro router non sembra supportato chiedete nella [[ https://lists.libre-mesh.org/mailman/listinfo/dev | mailing list degli sviluppatori di Libre-Mesh ]] che qualcuno aggiunga il supporto. Teoricamente sono supportabili tutti i [[ http://wiki.openwrt.org/toh/start | devices supportati da OpenWrt ]] ed aggiungere il supporto è molto semplice. === Compilare con lime-build (deprecato) === Procuratevi un computer con GNU/Linux che abbia una decina di GB liberi sull'hard disk ed installate i pacchetti contenenti le dipendenze necessarie alla compilazione, ad esempio se state usando una distribuzione Linux che sia Debian-based potrete installarle dal terminale (dopo aver ottenuto i privilegi di amministratore): {{{ apt-get install git build-essential libncurses5-dev zlib1g-dev gawk subversion }}} oppure selezionando gli stessi pacchetti dall'apposito software grafico. Se avete altre distro GNU/Linux e non trovate i nomi corretti dei pacchetti da installare, provate a compilare lo stesso, se incontrate errori tornate a questo punto e date un'occhiata a [[ http://wiki.openwrt.org/doc/howto/buildroot.exigence#examples_of_package_installations | queste liste ]] di pacchetti utili. Dunque scaricate lime-build, che successivamente si occuperà di scaricare tutto il resto e di compilarlo: {{{ git clone https://github.com/libre-mesh/lime-build.git }}} Controllate la lista dei router supportati da lime-build e trovate il vostro modello (o uno equivalente): {{{ make list_targets }}} Compilate l'immagine per il vostro target, indicandolo dopo T=. Ad esempio per compilare una immagine per una Ubiquiti NanoStation M5 potete lanciare: {{{ make T=nsm5 build }}} Per utilizzare un branch differente da quello di default (ad esempio per testare delle feature ancora non completate) si può scegliere il branch desiderato dalla apposita [[ https://github.com/libre-mesh/lime-packages/branches/all | lista dei branch ]] ed impostarlo con: {{{ make LIME_GIT_BRANCH="feature/blablabla" update_all }}} dunque compilare come indicato sopra. Le immagini prodotte si troveranno nella cartella "images". Altre opzioni per l'uso di lime-build possono essere trovate [[ https://github.com/libre-mesh/lime-build/blob/master/README.md | qui ]]. == Flashing == Per installare il firmware, come prima cosa è consigliato provar a utilizzare l'interfaccia web del firmware propinandogli, come fosse un aggiornamento, l'immagine di Libre-Mesh adatta a quel router ed indicata come "factory". In caso l'interfaccia web non accetti la nostra immagine è necessario seguire le [[ http://wiki.openwrt.org/doc/howto/generic.flashing | istruzioni generiche descritte sul sito di OpenWrt ]] per l'installazione di OpenWrt o le istruzioni specifiche indicate sulle [[ http://wiki.openwrt.org/toh/start | pagine relative ai singoli router ]]. == Prima connessione == |
option main_ipv4_address '10.10.10.11/21' option main_ipv6_address '2a00:1:1:1::11/64' }}} e questa impostazione avrà la priorità rispetto a quella corrispondente contenuta in "lime-defaults". Per applicare le modifiche effettuate nel file ''/etc/config/lime-node'' è necessario lanciare: {{{ lime-config }}} E riavviare l'apparato: {{{ reboot }}} ==== Routing a terra ==== LibreMesh supporta anche il routing a terra (chiamato anche ground routing) un esempio di configurazione è presente nel file ''/docs/lime-example.txt'' e consta di poche righe per ogni antenna da gestire. [[http://wiki.ninux.org/Libre-Mesh/Ground%20routing |Qui]] le istruzioni in italiano. == Aggiornamento == |
| Linea 223: | Linea 119: |
| Linea 226: | Linea 121: |
| Linea 229: | Linea 123: |
| Utilizzando il terminale Linux è comodo connettersi utilizzando l'IPv6 Link Local. Essendo connessi con un cavo ethernet al router lanciare il comando | Per aggiornare LibreMesh su un device l'immagine contenente nel nome "sysupgrade" va copiata tramite scp o rsync usando ''thisnode.info''. {{{ scp nome_immagine-sysupgrade.bin root@thisnode.info:/tmp }}} Dunque si entra sull'antenna con ssh: {{{ ssh root@thisnode.info }}} si verifica che l'immagine si sia copiata correttamente confrontandola con il file sha256sums presente nella cartella di compilazione: {{{ cd /tmp sha256sum nome_immagine-sysupgrade.bin }}} dunque si aggiorna il firmware installato sovrascrivendolo con l'immagine nuova. Ci son due modi per farlo, eliminando la precedente configurazione o preservandola. Eliminando la precedente configurazione: {{{ sysupgrade -n nome_immagine-sysupgrade.bin }}} Preservando la precedente configurazione: {{{ lime-sysupgrade nome_immagine-sysupgrade.bin }}} == Testing == Potete controllare che due nodi siano connessi controllando le tabelle di routing dei protocolli utilizzati, ossia [[ http://www.open-mesh.org/projects/batman-adv/wiki/Wiki | BATMAN-advanced ]] e [[ https://www.irif.fr/~jch/software/babel/ | Babeld ]]: {{{ batctl o echo dump | nc ::1 30003 }}} == Debugging == Essendo LibreMesh un firmware ancora sotto intenso sviluppo potrebbe presentare alcuni problemi, gli utenti sono incoraggiati a segnalare i problemi agli sviluppatori in modo che questi possano risolverli. I canali consigliati per la segnalazione e discussione di problemi sono: Mailing list: iscrivetevi alla [[ https://lists.libremesh.org/mailman/listinfo/lime-users | mailing list]] e segnalate il problema, preferibilmente ma non obbligatoriamente in inglese. Chat room: su Freenode abbiamo una chat room #libremesh-dev che si può più comodamente accedere tramite Element (una app di chat sicura), seguire i link su: https://libremesh.org/communication.html Segnalazioni: si può registrarsi sul sito di GitHub dunque segnalare il problema tramite [[ https://github.com/libremesh/lime-packages/issues/new | questa pagina ]]. == Connessione d'emergenza == Un metodo che non fallisce quasi mai per connettersi al router è utilizzando l'indirizzo IPv6 Link Local. Essendo connessi con un cavo ethernet al router lanciare il comando |
| Linea 235: | Linea 184: |
| si riceveranno risposte da tutte le interfacce, compresa la propria ed alcune interfacce virtuali sul router. L'IPv6 Link Local che ci interessa si può riconoscere perché contiene alla fine dell'indirizzo il MAC address del router solitamente indicato anche sul router stesso. Ad esempio nel caso il proprio router abbia un mac address dc:9f:db:31:c1:36, vedremo un IPv6 Link Local che lo contiene qui sotto: | ping6 potrebbe chiamarsi ping sul vostro sistema, ed eth0 potrebbe chiamarsi enp0s25 o qualcosa del genere. Si riceveranno risposte da tutte le interfacce, compresa la propria ed alcune interfacce virtuali sul router. L'IPv6 Link Local che ci interessa si può riconoscere perché contiene alla fine dell'indirizzo il MAC address del router solitamente indicato anche sul router stesso. Ad esempio nel caso il proprio router abbia un mac address dc:9f:db:31:c1:36, vedremo un IPv6 Link Local che lo contiene qui sotto: |
| Linea 249: | Linea 200: |
| ossia l'IPv6 corrispondente al mac address del nostro device è fe80::de9f:dbff:fe31:c136 Appena installato Libre-Mesh non ha una password, dunque ci si connette via telnet per impostarla, utilizzando l'IPv6 Link Local ed indicando l'interfaccia utilizzata per connettersi. {{{ telnet fe80::de9f:dbff:fe31:c136%eth0 }}} e si imposta la password tramite il comando {{{ passwd }}} dunque si riavvia con {{{ reboot && exit }}} e ci si connette utilizzando ssh: |
ossia l'IPv6 corrispondente al mac address del nostro device è fe80::de9f:dbff:fe31:c136 e ci si connette utilizzando ssh: |
| Linea 275: | Linea 206: |
| dunque si può proseguire con la configurazione. == Configurazione == === Da interfaccia web === -- guida da scrivere -- === Da terminale === La configurazione da utilizzare può essere leggermente differente tra le diverse isole, la configurazione di default va bene per il testing. Date un'occhiata al contenuto del file "/etc/config/lime-defaults", queste sono le configurazioni che vengono applicate sempre, questo file non va modificato: {{{ cat /etc/config/lime-defaults }}} se qualcuna delle impostazioni in questo files non vi piacesse potete inserirla modificata nel file "/etc/config/lime", ad esempio perché il nome della rete wireless access point sia "ninux.org" e il canale wireless sui 2.4GHz sia il numero 3, nel file "lime" andrà inserito: {{{ config lime wifi option channel_2ghz '3' option ap_ssid 'ninux.org' }}} oppure per impostare gli ip {{{ config lime network option main_ipv4_address '10.10.10.11/21' option main_ipv6_address '2a00:1:1:1::11/64' }}} e questa impostazione avrà la priorità rispetto a quella corrispondente contenuta in "lime-defaults". Dunque per modificare il file di configurazione "/etc/config/lime" si usa solitamente l'editor di testo vim: {{{ vim /etc/config/lime }}} entrare nella modalità modifica premendo "i", modificare il file e salvare premendo in successione il tasto "Esc" (per uscire dalla modalità di modifica) e dunque i tasti ":wq". Far leggere il contenuto del file "lime": {{{ lime-config }}} Infine applicare le modifiche pendenti nei file di configurazione di OpenWrt: {{{ uci commit }}} E riavviare l'apparato: {{{ reboot && exit }}} ==== Routing a terra ==== Libre-Mesh supporta anche il routing a terra (chiamato anche ground routing), tramite il pacchetto "lime-hwd-ground-routing", un esempio di configurazione è presente nel file "/etc/config/lime" e consta di poche righe per ogni antenna da gestire. [[http://wiki.ninux.org/Libre-Mesh/Ground%20routing |Qui]] le istruzioni in italiano e [[http://libre-mesh.org/projects/libre-mesh/wiki/Ground_routing |qui]] le istruzioni in inglese. == Aggiornamento == === Da interfaccia web === -- guida da scrivere -- === Da terminale === Per aggiornare Libre-Mesh su un device l'immagine contenente nel nome "sysupgrade" va copiata tramite scp o rsync usando ad esempio l'IPv6 Link Local del router da aggiornare. {{{ scp nome_immagine-sysupgrade.bin root@[fe80::de9f:dbff:fe31:c136%eth0]:/tmp }}} Dunque si entra sull'antenna con ssh: {{{ ssh root@fe80::de9f:dbff:fe31:c136%eth0 }}} si verifica che l'immagine si sia copiata correttamente confrontandola con il file md5sum presente nella cartella di compilazione: {{{ cd /tmp md5sum nome_immagine-sysupgrade.bin }}} dunque si aggiorna il firmware installato sovrascrivendolo con l'immagine nuova: {{{ sysupgrade nome_immagine-sysupgrade.bin }}} oppure con -n per cancellare i files di configurazione precedenti: {{{ sysupgrade -n nome_immagine-sysupgrade.bin }}} == Testing == Potete controllare che due nodi siano connessi controllando le tabelle di routing dei protocolli utilizzati, ossia [[ http://www.open-mesh.org/projects/batman-adv/wiki/Wiki | BATMAN-advanced ]] e [[ http://bmx6.net | BMX6 ]]: {{{ batctl o bmx6 -c show=originators }}} == Debugging == Essendo Libre-Mesh un firmware ancora sotto intenso sviluppo potrebbe presentare alcuni problemi, gli utenti sono incoraggiati a segnalare i problemi agli sviluppatori in modo che questi possano risolverli. I canali consigliati per la segnalazione e discussione di problemi sono: Mailing list: iscrivetevi alla [[ http://lists.libre-mesh.org/mailman/listinfo/dev | mailing list ]] degli sviluppatori e segnalate il problema preferibilmente in inglese. Chat room: su Freenode abbiamo una chat room #libre-mesh, ci si può accedere tramite un client IRC oppure via web da [[ https://webchat.freenode.net/ | qui ]]. Pagina delle segnalazioni: è necessario registrarsi sul sito di Libre-Mesh dunque segnalare il problema tramite [[ http://libre-mesh.org/projects/libre-mesh/issues/new | questo form ]]. |
|
| Linea 397: | Linea 209: |
| *[[ http://libremesh.org/docs/en_quick_starting_guide.html | Quick Starting Guide]] *[[ http://libremesh.org/docs/it_guida_rapida_per_iniziare.html | Guida rapida per iniziare]] |
|
| Linea 398: | Linea 212: |
| *[[ http://dev.libre-mesh.org/projects/libre-mesh/wiki/Compile_Manually | Guida ufficiale [EN] ]] | *[[ http://libremesh.org/getit.html | Come ottenere il firmware [EN] ]] |
Il firmware LibreMesh (precedentemente "Libre-Mesh") è il nuovo sistema operativo per router pensato per le community wireless nato dagli sforzi congiunti di italiani, spagnoli/catalani (Guifi.net) ed argentini (Altermundi) riuniti sotto il nome di, appunto, LibreMesh. Precisamente il firmware LibreMesh è un insieme di moduli da aggiungere a OpenWrt per gestire il routing dinamico e altre funzioni necessarie ad una rete wireless mesh. |
Indice
|
Questa pagina potrebbe esser non aggiornata, in caso di dubbi fate riferimento alla guida ufficiale in inglese.
Devices supportati da LibreMesh
Per andare sul sicuro è possibile consultare la pagina dei router che sono stati ampiamente utilizzati con LibreMesh dando buoni risultati. Sulla stessa pagina son riportati i criteri che assicurano un buon funzionamento di LibreMesh su altri routers.
Prodursi una immagine di LibreMesh
Come tutti i software open source è possibile creare il proprio file compilato partendo dal codice sorgente. Seguire le istruzioni sulla pagina https://libremesh.org/development.html
Il prossimo passo è installare, anche detto flashare, l'immagine adatta sul proprio router, come far questo viene accennato più avanti nella sezione "Flashing".
Flashing
È necessario seguire le istruzioni specifiche per ogni modello di router descritte sul sito di OpenWrt per l'installazione di OpenWrt.
Prima connessione
Da interfaccia web
-- guida da scrivere --
Da terminale
Utilizzando il terminale Linux è comodo connettersi utilizzando l'indirizzo thisnode.info che è impostato in tutti i router LibreMesh.
Appena installato LibreMesh non ha una password di amministratore, dunque ci si connette via SSH a thisnode.info tramite interfaccia web su http://thisnode.info per impostarla.
Da interfaccia web è presente un banner che aiuta a impostare la password di amministratore, da terminale invece ci si connette con:
ssh root@thisnode.info
e si imposta la password tramite il comando
passwd
dunque si riavvia con
reboot && exit
e si può proseguire con la configurazione.
Configurazione
Da interfaccia web
-- guida da scrivere --
Da terminale
La configurazione da utilizzare può essere leggermente differente tra le diverse isole, la configurazione di default va bene in generale.
Date un'occhiata al contenuto del file "/etc/config/lime-node":
cat /etc/config/lime-node
Il file dovrebbe essere piuttosto vuoto, dunque le opzioni di default sono quelle in uso. Tutte le opzioni commentate si possono trovare nel router in "/docs/lime-example.txt"
less /docs/lime-example.txt
o, sempre sul router, su http://thisnode.info/docs/lime-example.txt o online qui: https://github.com/libremesh/lime-packages/blob/master/packages/lime-docs/files/www/docs/lime-example.txt
Per modificare il file di configurazione "/etc/config/lime-node" si usa solitamente l'editor di testo vim:
vim /etc/config/lime-node
si abilita la modalità di modifica in vim premendo i, dopo aver modificato il file si esce dalla modalità di modifica premendo Esc e si salva premendo :wq e Invio uno dopo l'altro.
Ad esempio perché il nome della rete wireless access point sia "ninux.org" e il canale wireless sui 2.4GHz sia il numero 6, nel file "lime" ci deve essere:
config lime wifi
option channel_2ghz '6'
option ap_ssid 'ninux.org'oppure per impostare gli ip
config lime network
option main_ipv4_address '10.10.10.11/21'
option main_ipv6_address '2a00:1:1:1::11/64'e questa impostazione avrà la priorità rispetto a quella corrispondente contenuta in "lime-defaults".
Per applicare le modifiche effettuate nel file /etc/config/lime-node è necessario lanciare:
lime-config
E riavviare l'apparato:
reboot
Routing a terra
LibreMesh supporta anche il routing a terra (chiamato anche ground routing) un esempio di configurazione è presente nel file /docs/lime-example.txt e consta di poche righe per ogni antenna da gestire. Qui le istruzioni in italiano.
Aggiornamento
Da interfaccia web
-- guida da scrivere --
Da terminale
Per aggiornare LibreMesh su un device l'immagine contenente nel nome "sysupgrade" va copiata tramite scp o rsync usando thisnode.info.
scp nome_immagine-sysupgrade.bin root@thisnode.info:/tmp
Dunque si entra sull'antenna con ssh:
ssh root@thisnode.info
si verifica che l'immagine si sia copiata correttamente confrontandola con il file sha256sums presente nella cartella di compilazione:
cd /tmp sha256sum nome_immagine-sysupgrade.bin
dunque si aggiorna il firmware installato sovrascrivendolo con l'immagine nuova. Ci son due modi per farlo, eliminando la precedente configurazione o preservandola.
Eliminando la precedente configurazione:
sysupgrade -n nome_immagine-sysupgrade.bin
Preservando la precedente configurazione:
lime-sysupgrade nome_immagine-sysupgrade.bin
Testing
Potete controllare che due nodi siano connessi controllando le tabelle di routing dei protocolli utilizzati, ossia BATMAN-advanced e Babeld:
batctl o echo dump | nc ::1 30003
Debugging
Essendo LibreMesh un firmware ancora sotto intenso sviluppo potrebbe presentare alcuni problemi, gli utenti sono incoraggiati a segnalare i problemi agli sviluppatori in modo che questi possano risolverli. I canali consigliati per la segnalazione e discussione di problemi sono:
Mailing list: iscrivetevi alla mailing list e segnalate il problema, preferibilmente ma non obbligatoriamente in inglese.
Chat room: su Freenode abbiamo una chat room #libremesh-dev che si può più comodamente accedere tramite Element (una app di chat sicura), seguire i link su: https://libremesh.org/communication.html
Segnalazioni: si può registrarsi sul sito di GitHub dunque segnalare il problema tramite questa pagina.
Connessione d'emergenza
Un metodo che non fallisce quasi mai per connettersi al router è utilizzando l'indirizzo IPv6 Link Local.
Essendo connessi con un cavo ethernet al router lanciare il comando
ping6 ff02::1%eth0
ping6 potrebbe chiamarsi ping sul vostro sistema, ed eth0 potrebbe chiamarsi enp0s25 o qualcosa del genere.
Si riceveranno risposte da tutte le interfacce, compresa la propria ed alcune interfacce virtuali sul router. L'IPv6 Link Local che ci interessa si può riconoscere perché contiene alla fine dell'indirizzo il MAC address del router solitamente indicato anche sul router stesso. Ad esempio nel caso il proprio router abbia un mac address dc:9f:db:31:c1:36, vedremo un IPv6 Link Local che lo contiene qui sotto:
$ ping6 ff02::1%eth0 PING ff02::1%eth0(ff02::1) 56 data bytes 64 bytes from fe80::21e:8cff:fe66:1e2c: icmp_seq=1 ttl=64 time=0.023 ms 64 bytes from fe80::de9f:dbff:fe37:28a9: icmp_seq=1 ttl=64 time=0.606 ms (DUP!) 64 bytes from fe80::de9f:dbff:fe31:c136: icmp_seq=1 ttl=64 time=0.607 ms (DUP!) 64 bytes from fe80::a8aa:aaff:feaa:aaaa: icmp_seq=1 ttl=64 time=0.851 ms (DUP!) 64 bytes from fe80::de9f:dbff:feee:8bda: icmp_seq=1 ttl=64 time=1.01 ms (DUP!) 64 bytes from fe80::a8aa:aaff:feaa:aaaa: icmp_seq=1 ttl=64 time=1.08 ms (DUP!) 64 bytes from fe80::216:eaff:fec1:7553: icmp_seq=1 ttl=64 time=11.8 ms (DUP!)
ossia l'IPv6 corrispondente al mac address del nostro device è fe80::de9f:dbff:fe31:c136 e ci si connette utilizzando ssh:
ssh root@fe80::de9f:dbff:fe31:c136%eth0