Differenze per "Libre-Mesh"

Se sapete leggere l'inglese andate direttamente sulla Quick Starting Guide sul sito ufficiale, questa pagina potrebbe esser non aggiornata.

Scaricare il firmware già pronto

Il firmware LibreMesh può essere scaricato dai repository delle singole isole Ninux che usino LibreMesh.

Prodursi una immagine di LibreMesh

Come tutti i software open source è possibile creare il proprio file compilato partendo dal codice sorgente.

Devices supportati da LibreMesh

LibreMesh supporta tutti i router che siano supportati da OpenWrt, potrebbe essere instabile su router particolarmente scarsi.

Compilare

Compilare vuol dire creare il proprio file di installazione di LibreMesh 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 libssl-dev

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 queste liste di pacchetti utili.

Ottenere il codice sorgente di OpenWrt

Aprite un terminale e scaricate il codice sorgente della ultima release stabile di OpenWrt: la 15.05 aka ChaosCalmer:

git clone git://git.openwrt.org/15.05/openwrt.git

Aggiungere i sorgenti di LibreMesh

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 LibreMesh. Le varie isole Ninux potrebbero indicare una sorgente pre-configurata.

LibreMesh standard:

echo "src-git lime https://github.com/libremesh/lime-packages.git" >> feeds.conf

LibreMesh 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/libremesh/lime-packages.git;release/15.07" >> feeds.conf

Dunque scaricate e posizionate i sorgenti di LibreMesh:

scripts/feeds update -a
scripts/feeds install -a

Selezionare i moduli di LibreMesh

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 LibreMesh sostengono 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" si può selezionare "lime-full" per avere la raccolta standard dei pacchetti suggeriti dal team di LibreMesh, questa è la scelta raccomandata, altrimenti si può selezionare solo i pacchetti necessari per il caso specifico. Segue una tabella con la descrizione in inglese e italiano dei moduli selezionabili:

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:

config lime network
        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 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 mailing list degli sviluppatori di LibreMesh che qualcuno aggiunga il supporto.

Teoricamente sono supportabili tutti i 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 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/libremesh/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 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 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 LibreMesh adatta a quel router ed indicata come "factory".

In caso l'interfaccia web non accetti la nostra immagine è necessario seguire le istruzioni generiche descritte sul sito di OpenWrt per l'installazione di OpenWrt o le istruzioni specifiche indicate sulle pagine relative ai singoli router.

Prima connessione

Da interfaccia web

-- guida da scrivere --

Da terminale

Utilizzando il terminale Linux è comodo connettersi utilizzando l'IPv6 Link Local. Essendo connessi con un cavo ethernet al router lanciare il comando

ping6 ff02::1%eth0

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

Appena installato LibreMesh 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:

ssh root@fe80::de9f:dbff:fe31:c136%eth0

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

LibreMesh 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. Qui le istruzioni in italiano (quelle in inglese per ora mancano).

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 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 BATMAN-advanced e BMX6:

batctl o
bmx6 -c show=originators

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 degli sviluppatori e segnalate il problema preferibilmente in inglese.

Chat room: su Freenode abbiamo una chat room #libremesh, ci si può accedere tramite un client IRC oppure via web da qui.

Segnalazioni: si possono inviare alla mailing list degli sviluppatori oppure si può registrarsi sul sito di GitHub dunque segnalare il problema tramite questa pagina.

Altre guide

• Quick Starting Guide

• Guida Ninux Bologna

• Come ottenere il firmware [EN]