<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>nnxx/firmware</title><revhistory><revision><revnumber>9</revnumber><date>2022-05-17 20:25:36</date><authorinitials>mob-5-91-110-179.net.vodafone.it</authorinitials></revision><revision><revnumber>8</revnumber><date>2019-07-14 15:04:03</date><authorinitials>host187-235-dynamic.32-79-r.retail.telecomitalia.it</authorinitials></revision><revision><revnumber>7</revnumber><date>2017-01-01 17:19:18</date><authorinitials>host239-105-dynamic.26-79-r.retail.telecomitalia.it</authorinitials></revision><revision><revnumber>6</revnumber><date>2016-12-31 10:27:51</date><authorinitials>net-47-53-50-180.cust.vodafonedsl.it</authorinitials></revision><revision><revnumber>5</revnumber><date>2016-12-29 17:11:55</date><authorinitials>BornAgain</authorinitials></revision><revision><revnumber>4</revnumber><date>2016-12-29 16:28:51</date><authorinitials>Nemesis</authorinitials><revremark>Aggiunte caratteristiche firmware</revremark></revision><revision><revnumber>3</revnumber><date>2016-12-29 15:51:29</date><authorinitials>Nemesis</authorinitials><revremark>Aggiunto indice e altri dettagli</revremark></revision><revision><revnumber>2</revnumber><date>2016-12-29 15:40:12</date><authorinitials>Nemesis</authorinitials><revremark>Debugging</revremark></revision><revision><revnumber>1</revnumber><date>2016-12-29 15:10:39</date><authorinitials>Nemesis</authorinitials><revremark>bozza</revremark></revision></revhistory></articleinfo><section><title>Firmware NNXXX</title><para>Seguendo questa guida è possibile installare il firmware e collegarsi all'infrastruttura <emphasis>nnxx</emphasis>. </para><para>Questo firmware ha le seguenti caratteristiche: </para><itemizedlist><listitem><para>permette di configurare il proprio apparato via interfaccia web </para></listitem><listitem><para>una volta effettuate le configurazioni minime si autoconfigura collegandosi a <emphasis role="strong">openwisp2</emphasis> </para></listitem><listitem><para>l'autoconfigurazione determina la connessione automatica alla rete <ulink url="http://wiki.ninux.org/nnxx">nnxx</ulink> via VPN (<emphasis role="strong">openvpn</emphasis>) </para></listitem><listitem><para>le rotte per gli altri nodi vengono installate grazie al demone di routing <emphasis role="strong">bird2</emphasis> </para></listitem></itemizedlist><para>Per qualsiasi dubbio non esitate a contattarci tramite la mailing list <ulink url="http://ml.ninux.org/mailman/listinfo/ninux-dev">ninux-dev</ulink> o il <ulink url="https://telegram.me/ninux_experimental">canale telegram</ulink>. </para><section><title>1. Flashare il firmware</title><para>Scaricare uno dei <ulink url="http://downloads.nnxx.ninux.org/firmware/">firmware disponibili</ulink> e flasharlo sull'apparato. (Spazio da ripristinare ma si può richiedere via telegram) </para><para>Se avete dubbi sulla procedura da seguire fate riferimento alla <ulink url="https://wiki.openwrt.org/doc/howto/generic.flashing">guida di installazione ufficiale di OpenWRT</ulink>. </para><para>Se sul vostro apparato è già installato OpenWRT, assicuratevi di fare un reset delle configurazioni. </para></section><section><title>2. Configurazione minima</title><para>Assicuratevi che l'apparato sia flashato correttamente e acceso e procedete con i passi seguenti: </para><itemizedlist><listitem><para>accedete tramite l'interfaccia web all'indirizzo <ulink url="https://192.168.1.1"/> </para></listitem><listitem><para>impostate un <emphasis>hostname</emphasis> per il vostro apparato andanto su <emphasis role="strong">&quot;system&quot;</emphasis> e poi ancora <emphasis role="strong">&quot;system&quot;</emphasis>, cambiate il campo hostname e cliccate su <emphasis role="strong">&quot;Save &amp; apply&quot;</emphasis>' in fondo alla pagina </para></listitem><listitem><para>configurate l'indirizzamento andando su <emphasis role="strong">&quot;network&quot;</emphasis>, poi <emphasis role="strong">&quot;interfaces&quot;</emphasis>, poi <emphasis role="strong">&quot;LAN&quot;</emphasis> e quindi <emphasis role="strong">&quot;Edit&quot;</emphasis>; quando avete terminato cliccate di nuovo su <emphasis role="strong">&quot;Save &amp; apply&quot;</emphasis> </para></listitem></itemizedlist><para>Una volta eseguito l'ultimo passo l'indirizzo ip del vostro router cambierà, quindi per rientrarci dovrete aggiornare l'indirizzo sul browser. </para><para>Assicuratevi che il router sia collegato ad internet. </para><para>Dopo qualche minuto l'apparato scaricherà la configurazione della VPN da internet e si collegherà alla rete NNXX. </para></section><section><title>3. Debugging</title><para>Questo tipo di operazioni si svolgono meglio entrando via SSH, ad esempio: </para><screen><![CDATA[# sostituite <vostro-ip> con l'ip che avete configurato nei passi precedenti.
ssh root@<vostro-ip>]]></screen><para>L'interfaccia della VPN è up? </para><screen><![CDATA[ifconfig vpnbas]]></screen><para>Per vedere se i processi chiave stanno funzionando correttamente potete usare i seguenti comandi shell: </para><screen><![CDATA[ps | grep openwisp
ps | grep openvpn
ps | grep bird]]></screen><para>Controllare il log della vpn: </para><screen><![CDATA[tail /var/log/vpnbas.log]]></screen><para>Controllare il comportamento di openwisp-config: </para><screen><![CDATA[logread | grep openwisp]]></screen><para>bird prende le rotte? </para><screen><![CDATA[birdc show route]]></screen></section></section><section><title>Informazioni tecniche sul firmware</title><para>Il firmware è basato su <ulink url="https://openwrt.org">OpenWRT</ulink>, è opensource, le configurazioni e le istruzioni di compilazione sono disponibili su <ulink url="https://github.com/ninuxorg/ansible-nnxx">github.com/ninuxorg/ansible-nnxx</ulink>. </para><para>Le configurazioni del firmware (pacchetti usati e altro) sono qui: <ulink url="https://github.com/ninuxorg/ansible-nnxx/blob/master/firmware.yml"/> </para><para>I comandi per compilare sono spiegati qui: <ulink url="https://github.com/ninuxorg/ansible-nnxx#compiling"/> </para><para>Il processo che viene eseguito automaticamente è spiegato qui: <ulink url="https://github.com/openwisp/ansible-openwisp2-imagegenerator#build-process"/> </para><para>Il firmware è dotato di 3 software aggiuntivi che lo caratterizzano </para><itemizedlist><listitem><para><ulink url="https://github.com/openwisp/openwisp-config">openwisp-config</ulink> </para></listitem><listitem><para><ulink url="https://github.com/openwisp/openwrt-openwisp-monitoring">openwisp-monitoring</ulink> </para></listitem><listitem><para><ulink url="https://bird.network.cz/">Bird2</ulink> </para></listitem><listitem><para><ulink url="https://community.openvpn.net/openvpn/wiki/Openvpn23ManPage">OpenVPN 2.4</ulink> </para></listitem></itemizedlist></section></article>