1. Domande generiche
1.1. Che cos'è Neubot?
Neubot è un progetto di ricerca sulla neutralità della rete del Centro
NEXA su Internet & Società del Politecnico di Torino. Il progetto si
basa su un programma leggero e open source che gli utenti interessati
possono scaricare e installare sul proprio computer. Il programma funziona
in background ed effettua periodicamente prove di trasmissione con alcuni
server di prova, ospitati dalla piattaforma distribuita Measurement Lab,
e (in futuro) con altre istanze del programma stesso. Queste prove di
trasmissione testano la Rete utilizzando diversi protocolli di livello
applicativo e i risultati dei test sono salvati sia localmente sia sui
test server. Il set di dati raccolti contiene campioni provenienti da
diversi Providers e viene pubblicato sul web, consentendo a chiunque di
analizzare i dati per finalità di ricerca.
1.2. Che cos'è Measurement Lab?
Measurement Lab (M-Lab) è una piattaforma server distribuita che fornisce
connettività e server in giro per il mondo a progetti che si propongono
di misurare la qualità e/o la neutralità delle connession a banada larga a
Internet, verificando il comportamento della Rete con test attivi.
A partire dalla versione 0.4.6, Neubot è stato incluso nella piattaforma
Measurement Lab, e, dalla versione 0.4.8, la maggior parte dei test insiste
sui server di Measurement Lab. I vecchi client utilizzano ancora il server
centrale del progetto Neubot, ma la percentuale di questi test è molto
piccola.
1.3. Che cos'è la neutralità della rete?
La neutralità della rete è il principio secondo cui Internet non
dovrebbe fornire un servizio migliore ad alcuni tipi di applicazioni,
ad alcuni mittenti o destinatari. In altre parole, una rete è neutrale
quando i router instradano i pacchetti usando una strategia first
come, first served. E non è neutrale quando certi pacchetti ricevono
un trattamento privilegiato.
La Internet delle origini era strettamente neutrale, essendo stata
progettata per minimizzare le interazioni tra le applicazioni e la rete
(vedi RFC3439). Questa scelta progettuale rese possibile l'instradamento
dei pacchetti ad alta velocita` e rese Internet una piattaforma aperta
dove chiunque poteva innovare senza chiedere il permesso. Di conseguenza
Internet è diventato il volano per l'innovazione che tutti conosciamo. E
il luogo dove cittadini, associazioni e imprese di tutto il mondo si
possono confrontare a parità di condizioni.
Oggigiorno, Internet non è sempre neutrale per via di tecnologie che
permettono di discriminare in modo fine i flussi di traffico. Quando i
pacchetti entrano nella rete di un Internet Service Provider, vengono
classificati, cioè assegnati ad una classe di traffico come web,
video o file-sharing. Tipicamente, gli algoritmi di classificazione
ispezionano gli header e la porzione iniziale del contenuto dei pacchetti
Internet per cercare di "indovinare" la classe. Ma i pacchetti che
appartengono ad un flusso possono anche ereditare la classificazione
dai pacchetti precedenti, se questi sono gia' stati classificati. Una
volta che un pacchetto e' stato classificato, riceve dai router che
si trovano all'interno della rete il servizio associato alla classe di
traffico assegnata.
Il dibatto di policy riguardo la neutralità della rete si chiede se sia
preferibile (dal punto di vista tecnico, giuridico e per quanto concerne
l'innovazione) continuare a lasciar fare gli operatori o se la
neutralità della rete debba essere garantita per legge. Per saperne di
piu' ti consigliamo di fare riferimento alla pagina Wikipedia sulla
neutralità della rete.
1.5. Perchè è cruciale monitorare la neutralità della rete?
Monitorare la neutralità della rete è cruciale perchè permette una più
profonda comprensione del comportamento degli operatori. Questo è
fondamentale ex-ante, specie nel momento in cui si apre un ampio
dibattito sulle modifiche nelle politiche di neutralità della rete. La
disponibilità di serie di dati quantitativi raccolti da ricercatori
indipendenti dovrebbe riequilibrare, almeno in parte, la profonda
asimmetria informativa tra Internet Service Providers e altri soggetti
interessati (regolatori e cittadini compresi), e dovrebbe fornire una
base più affidabile per discutere le politiche sul tema.
Monitorare la neutralità della rete sarebbe cruciale anche in uno
scenario ex-post. Infatti, consentirebbe di verificare il
comportamento degli operatori, alla luce delle decisioni normative in
materia di neutralità.
1.6. Perchè potrei voler installare Neubot?
Potresti voler installare Neubot se tieni alla neutralità della rete,
se desideri sostenere questo lavoro di ricerca, e se sei disponibile a
donare a questo progetto una frazione della tua capacità di rete per
eseguire test periodici di qualità e neutralità. Potrai contribuire
a costruire un set di dati quantitativi sulla neutralità della rete,
e la disponibilità di questo set di dati indipendenti condurrà
probabilmente a un processo decisionale più democratico di Internet,
una delle infrastrutture chiave delle nostre società.
Un'altra ragione per cui potresti voler installare Neubot è che i
risultati dei test forniscono un breve quadro del funzionamento della tua
connessione Internet, in ore diverse ed utilizzando protocolli diversi.
Puoi confrontare questi risultati locali con i risultati ottenuti con
altri test, al fine di ottenere una comprensione più approfondita
del comportamento della tua rete domestica e del comportamento del
tuo provider.
Se sei interessato, non esitare a installarlo, perché il successo di
questo progetto di ricerca dipende in larga misura da quanti utenti
installano Neubot.
1.7. Quali sono i test implementati dall'ultima versione?
L'ultima versione di Neubot implementa i seguenti test di trasmissione:
- Speedtest
- Questo test di trasmissione, originariamente ispirato al test di
speedtest.net, è un test client-server HTTP che misura il round
trip time e il goodput in upload e download.
- BitTorrent
- Questo test di trasmissione effettua misurazioni client-server del
round trip time e del goodput in upload e download, emulando
il protocollo BitTorrent.
Se sei interessato, puoi trovare maggiori dettagli sui test di
trasmissione nella sezione 4. Domande tecniche.
1.8. Qual'è la roadmap per arrivare a Neubot/1.0?
Neubot/1.0 sarà in grado di eseguire test di trasmissione client-server
e peer-to-peer, utilizzando vari protocolli di livello applicativo.
Inizialmente, avevamo suddiviso il percorso per arrivare a Neubot/1.0 in
quattro fasi:
- implementare un semplice test di trasmissione client-server basato su
HTTP;
- implementare un semplice test di trasmissione client-server basato su
BitTorrent;
- modificare il test BitTorrent affinche` funzioni in modalità
peer-to-peer;
- implementare ulteriori test peer-to-peer per ulteriori protocolli;
In seguito la roadmap e' stata aggiornata ed estesa per tenere conto
di difficolta` e opportunita` incontrate durante il processo di sviluppo
e, adesso, e' possibile leggere la roadmap e la TODO list, aggiornate
e gestite utilizzando il wiki di github.
1.9. Quando è prevista la prossima release di Neubot?
Il processo di rilascio si propone di rilasciare presto, rilasciare
spesso per massimizzare il feedback. Il repository git pubblico
viene aggiornato frequentemente e si cerca di distribuire una nuova
versione del software ogni mese.
In generale, la maggior parte delle release sono patch release,
che aggiungono nuove funzionalita` e/o corregono bachi. Tipicamente,
dopo un certo numero di patch release, si raggiunge una massa critica
di funzionalita` e viene rilasciata una milestone release.
La politica di versioning riflette direttamente la distinazione tra
patch e milestone release, come spiega la FAQ successiva.
1.10. Qual'è la vostra politica di versioning?
Neubot segue la ben-nota convenzione che prevede di utilizzare tre
numeri di versione: major, minor e patch. Ad esempio, Neubot
0.4.8 ha numero major 0, numero minor 4 e numero patch 8.
Una milestone release ha numero patch 0 e numero major e minor che
corrisponde a una milestone nella roadmap. Le release patch,
invece, hanno numero patch diverso da zero. Di conseguenza, 1.0.0
e 0.4.0 sono milestone release, mentre 0.3.1 e' una patch release.
1.11. Qual'è la versione migliore di Neubot?
La versione migliore di Neubot sarà sempre quella con il numero di
versione più alto, ad esempio, 0.3.1 è meglio di 0.3.0. Le patch
releases potrebbero includere caratteristiche sperimentali, ma queste
caratteristiche non saranno abilitate di default fino a quando non
matureranno e diventeranno stabili.
1.12. Per quanto tempo devo tenere installato Neubot?
Più a lungo possibile. Neubot non è un progetto di portata limitata, ma
piuttosto un impegno continuo.
1.13. Quanto testate Neubot prima di ogni release?
Tipicamente una nuova funzionalita` sperimentale viene inclusa in
una patch release e non viene abilitata di default finche` non
matura e diventa stabile. Quando viene rilasciata una milestone
release, la maggior parte delle feature sono state testate per
almeno un ciclo di release, cioe` da due a quattro settimane.
1.16. Quanto costa Neubot?
Zero. Neubot è disponibile gratuitamente.
2. Installare Neubot
2.1. Su quali sistemi funziona Neubot?
Neubot è scritto in Python e dovrebbe pertanto funzionare su tutti
i sistemi supportati da Python.
Il team di sviluppo fornisce pacchetti per Ubuntu >= 10.04 (e
Debian), MacOSX >= 10.6, Windows >= XP SP3. Neubot e' incluso
nella FreeBSD Ports Collection e funziona senza problemi su
OpenBSD 5.1 current.
2.2. Come installo Neubot?
Il team di sviluppo di Neubot fornisce pacchetti binari per MacOSX,
Windows, Debian, e distribuzioni basate su Debian (come Ubuntu).
Neubot è parte del FreeBSD port collection. Se non c'è un pacchetto
binario per il tuo sistema, puoi comunque installare Neubot dai
sorgenti.
Le voci successive del FAQ riguarderanno tutte queste opzioni.
2.3. Come installo Neubot su FreeBSD?
Neubot è parte della FreeBSD Ports Collection. Quindi può essere
installato facilmente, sia usando pkg_add sia compilando il
pacchetto dal port tree. Certamente, se sei in dubbio, puoi far
riferimento alla documentazione FreeBSD e alle FreeBSD manpages.
In particolare, la pagina autorizzata del port è:
http://www.freshports.org/net/neubot/
Per la tua comodità, elenchiamo i due comandi base per
aggiungere Neubot al tuo sistema FreeBSD. Per aggiungere il pacchetto
precompilato al tuo sistema, devi lanciare il seguente comando come
root:
pkg_add -r neubot
Per compilare e installare il port, ancora come root, devi eseguire il
seguente comando:
cd /usr/ports/net/neubot/ && make install clean
Per favore, non chiedere agli sviluppatori di Neubot domande relative al
port di FreeBSD perchè potrebbero non essere capaci di rispondere. Noi
invece suggeriamo di rivolgere le domande alla FreeBSD ports mailing
list. I bugs dovrebbero essere riportati usando l'interfaccia
send-pr.
3. Usare Neubot
3.1. Neubot è installato. Cosa devo fare adesso?
Neubot scarica e installa automaticamente gli aggiornamenti su tutte
le piattaforme tranne Microsoft Windows (e ovviamente non ci sono
autoaggiornamenti se hai installato Neubot partendo dai sorgenti).
Se non stai usando Windows, dovresti periodicamente controllare che
si sia automaticamente aggiornato all'ultima versione. A spanne,
se sono passate piu` di due settimane dall'ultima release e non si
e' autoaggiornato, allora c'e` qualche bug.
Se stai usando Windows, l'interfaccia web (vedi 7. Web user
interface) verra` aperta
automaticamente nel browser quando c'e` un aggiornamento disponibile.
Comparirà un messaggio come quello contenuto nell'immagine seguente.
Clicca sul link, segui le istruzioni, ed è fatta.
Potresti anche voler confrontare i risultati ottenuti con Neubot
con quelli di altri test e tool disponibili online. In tal caso,
sarebbe cosa gradita se tu condividessi i risultati di altri test
e tool con il team di sviluppo di Neubot, specie se vengono fuori
risultati che non sono consistenti con quelli di Neubot.
3.2. Di quante risorse ha bisogno Neubot?
Neubot ha un impatto minimo sul carico del sistema e della rete. Passa
la maggior parte del suo tempo a riposo o aspettando il suo turno per
eseguire un test. Durante il test Neubot consuma molte risorse di
sistema e di rete, tuttavia il programma cerca di assicurare che ogni
upload/download duri meno di sette secondi.
Qui ci sono un paio di immagini prese da un portatile che fa girare
Ubuntu 9.10 attaccato ad una connessione del Politecnico di Torino.
Nella prima immagine puoi vedere l'utilizzo delle risorse durante un
test on-demand invocato dalla riga di comando. La fase di init del test
è quella in cui Neubot genera i dati casuali da inviare durante la fase
di upload. (L'utilizzo delle risorse è molto più basso se lanci il test
da casa, dato che la connessione del Politecnico è 5x/10x più veloce
della maggior parte delle connsessioni ADSL).
La seconda immagine mostra quante risorse (soprattutto memoria) vengono
consumate quando Neubot è inattivo.
3.3. Come posso riportare bugs, fare domande, dare suggerimenti?
Ti preghiamo di usare la nostra mailing list per riportare bugs e fare
domande. Le lingue ufficiali della mailing list sono l'inglese e
l'italiano.
Nota che devi essere iscritto alla mailing list, altrimenti il tuo
messaggio non verra` accettato. Per iscriverti:
http://www.neubot.org/cgi-bin/mailman/listinfo/neubot
La pagina di iscrizione alla mailing list non ha un certificato SSL
valido e il tuo browser probabilmente si lamentera` di questo. Non
farti spaventare dal messaggio di warning, in fondo si tratta solo
della pagina per registrarti alla mailing list di Neubot e non del
sito della tua banca.
Prima di inviare un messaggio ti consigliamo di consultare l'archivio
pubblico, visto che è possibile che qualcun'altro abbia già fatto la
stessa domanda o riportato lo stesso bug. Tutti i messaggi inviati alla
mailing list sono archiviati qui:
http://www.neubot.org/pipermail/neubot/
Grazie per la collaborazione!
3.4. Che problemi ci sono se uso mobile broadband, 3G modem, Internet key?
Un possibile problema con mobile broadband può essere il seguente. Se
usi Windows, hai installato Neubot, non sei connesso, e Neubot inizia un
test, è possibile che Windows ti chieda di connetterti. Se questo
comportamento ti disturba, arresta Neubot dal menu start.
Nelle future versioni progettiamo di verificare se ci sia una
connessione Internet o meno, e iniziare un test solo se questa sia
disponibile.
3.5. Devo modificare la configurazione del mio router?
No.
3.6. Come leggo i log di Neubot?
In tutti i sistemi operativi puoi leggere i log attraverso la
Tabella log dell'interfaccia web (vedi 7. Web user interface),
disponibile a partire dalla
versione 0.3.7. L'immagine seguente fornisce un esempio:
Inoltre, in UNIX Neubot salva i log con syslog(3) e LOG_DAEMON
facility. I log finiscono in /var/log, tipicamente in
daemon.log. Per capire quale sia il file in cui davvero finiscano
i log, quando sono in un sistema nuovo, lancio il seguente comando
(da root):
# grep neubot /var/log/* | awk -F: '{print $1}' | sort | uniq
/var/log/daemon.log
/var/log/syslog
In questo esempio, ci sono log interessanti sia in /var/log/daemon.log
sia in /var/log/syslog. Una volta che conosco i nomi dei file,
posso estrarre i log da ogni file, come di seguito:
# grep neubot /var/log/daemon.log | less
3.7. Devo ruotare periodicamente i file log?
No. Su qualsiasi piattaforma, i log vengono salvati nel database,
ma periodicamente Neubot cancella i log vecchi. Nei sistemi UNIX,
i log vengono anche salvati utilizzando syslog(3), che dovrebbe
automaticamente occuparsi di ruotare i file di log.
3.8. Devo ruotare periodicamente il database?
Si. Il database di Neubot dovrebbe crescere lentamente per dimensione
rispetto al tempo di utilizzo. (Il database della mia workstation pesa 2
MBytes dopo 8 mesi, e io lancio di frequente un test ogni 30 secondi per
esigenze di monitoraggio.) Per eliminare i risultati vecchi lancia il
seguente comando (da root):
# neubot database prune
4. Domande tecniche
4.1. Come funziona Neubot?
Neubot viene eseguito in background. In Linux, BSD e altri sistemi Unix
Neubot viene avviato al momento del boot, diventa un demone, e abbandona
i privilegi di root. In Windows Neubot viene avviato quando l'utente
accede per la prima volta (gli accessi successivi non avviano ulteriori
istanze di Neubot).
Neubot ha un impatto minimo sul carico della rete e del sistema. Passa
la maggior parte del suo tempo dormendo o aspettando il suo turno per
eseguire un test. Durante un test Neubot consuma molte risorse di
sistema e di rete, ma il programma cerca di garantire che ogni test non
richieda troppo tempo.
Periodicamente, Neubot scarica dal server centrale le informazioni sul
prossimo test da eseguire, incluso il nome del test, il server cui
connettersi e eventualmente altri parametri. Se ci sono aggiornamenti
disponibili, la risposta del server centrale include anche le
informazioni per eseguire l'aggiornamento, come l'URI da cui scaricare
gli aggiornamenti.
In seguito, Neubot si connette al server specificato, attende
l'autorizzazione per eseguire il test selezionato, effettua il test, e
salva i risultati. Neubot può attendere anche per un tempo abbastanza
lungo perché i server non gestiscono più di uno (o pochi) test
contemporaneamente. Nel complesso, il test può durare alcuni secondi, ma
Neubot cerca di garantire che il test non richieda troppo tempo. Alla
fine del test, i risultati vengono salvati in un database locale e
inviati ai server del progetto.
Infine, dopo il test, Neubot rimane in sleep per un lungo periodo di
tempo, prima di connettersi nuovamente al server centrale.
A partire dalla versione 0.4.2, Neubot utilizza il seguente algoritmo
per contenere la durata del test. La quantità predefinita di bytes da
trasferire è tale da ottenere una durata ragionevole del test con
connessioni ADSL lente. Dopo il test, Neubot adatta il numero di bytes
da trasferire in modo che il test seguente richieda circa cinque
secondi, nelle attuali condizioni. Inoltre, ripete il test fino a sette
volte se questo non ha richiesto almeno tre secondi.
(Le versioni future di Neubot utilizzeranno anche una modalità di test
peer-to-peer, ossia eseguiranno i test anche tra istanze di Neubot.)
4.2. Che cosa misura il test speedtest?
Il test speedtest utilizza il protocollo HTTP e misura: il
round trip time e il goodput in download e upload. È ispirato
al test speedtest.net, da cui il nome. Il test stima il round
trip time misurando il tempo medio richiesto per connettersi e
il tempo medio necessario per richiedere e scaricare una risorsa
di lunghezza zero. Stima inoltre il goodput in download e upload
dividendo il numero di bytes trasferiti per il tempo richiesto a
trasferirli.
4.3. In che modo Neubot modifica il registro di sistema di Windows?
Il programma di installazione scrive le seguente due chiavi di registro:
HKCU "Software\Microsoft\Windows\CurrentVersion\Uninstall\neubot"
HKCU "Software\Microsoft\Windows\CurrentVersion\Run" "Neubot"
La prima fa si' che Windows sia a conoscenza dell'uninstaller, mentre
la seconda fa si' che Neubot sia avviato quando fai login.
Le due chiavi vengono rimosse dall'uninstaller.
4.4. Qual'è il percorso del database di Neubot?
In UNIX, se esegui Neubot come utente root il percorso del database
è /var/neubot/database.sqlite3. Invece, se esegui Neubot come
utente non privilegiato, il percorso del database è
$HOME/.neubot/database.sqlite3.
In Windows, il percorso del database è sempre
%APPDATA%\neubot\database.sqlite3.
Con Neubot >= 0.3.7 puoi richiedere la posizione del database usando
il comando neubot database info, ad esempio:
$ neubot database info
/home/simone/.neubot/database.sqlite3
# neubot database info
/var/neubot/database.sqlite3
4.5. Come posso scaricare i contenuti del database?
Puoi scaricare i contenuti del database utilizzando il comando
neubot database dump. L'output sarà un file JSON che contiene i
risultati. (Nota che in UNIX devi essere root per scaricare i contenuti
del system-wide database: se lanci questo comando come utente senza
privilegi scaricherai invece l'user-specific database.)
4.6. Che cosa misura il test bittorrent?
Il test bittorrent emula il protocollo BitTorrent e misura:
il round trip time e il goodput in download e upload. Il test
stima il round trip time misurando il tempo necessario a
connettersi.
Dato che BitTorrent utilizza messaggi piccoli, non è possibile
trasferire un file di grosse dimensioni e dividere il numero di bytes
trasmessi per il tempo del trasferimento. Pertanto, il test effettua
inizialmente numerose richieste successive per riempire lo spazio tra
client e server di numerose risposte "in volo". La misurazione inizia
solo quando il richiedente ritiene che il numero di risposte "in volo"
sia sufficiente per approssimare un trasferimento continuo.
4.7. Che significa misurare la banda disponibile?
I test di Neubot non misurano la velocità della tua connessione
Internet, ma piuttosto il goodput, cioè la banda che si riesce
ad ottenere a livello applicativo nel momento in cui si esegue la
misura. Il risultato, quindi, potrebbe essere penalizzato dalle
seguenti condizioni sfavorevoli:
- stai scaricando un grosso file;
- il tuo coinquilino sta scaricando un grosso file;
- hai una cattiva connessione wireless che perde molti pacchetti;
- c'è congestione nella rete del tuo provider;
- non vivi vicino ai nostri server;
- il nostro server è sovraccarico.
In altre parole, i risultati di Neubot vanno presi cum grano salis.
4.8. È possibile confrontare i risultati dei test speedtest e bittorrent?
Il test bittorrent è stato rilasciato con la versione 0.4.0. In
quel periodo il confronto non era sempre possibile perchè il test
speedtest utilizzava due connessioni mentre bittorrent ne utilizzava
solo una, con il risultato che le prestazioni erano peggiori in
caso di reti con elevato prodotto banda-ritardo o in caso ci fosse
moderata congestione in rete. Neubot 0.4.2 ha risolto questo
problema e modificato speedtest in modo da usare una sola connessione.
Questa modifica non basta e ci sono modifiche in cantiere per rendere
comparabili i due test. Queste modifiche dovrebbero essere incluse
in Neubot 0.5.0.
5. Domande sulla privacy
5.1. Quali dati personali salva Neubot?
Neubot non cattura il tuo traffico, non controlla i siti che hai
visitato, ecc. Neubot utilizza una frazione della capacità della
tua connessione per eseguire dei test di trasmissione e questi test
utilizzano dati casuali o dati provenienti dai nostri server.
Neubot salva l'indirizzo Internet del computer nel quale è in
esecuzione. Dobbiamo salvare il tuo indirizzo Internet (che è un
dato personale), perché questo ci permette di sapere il tuo Internet
Service Provider e (approssimativamente) la tua posizione. Entrambe
le informazioni sono funzionali al nostro obiettivo di monitorare
la neutralità della rete.
Identifichiamo ogni istanza di Neubot con un identificativo univoco
casuale. Usiamo questo identificativo per eseguire analisi di serie
temporali e per verificare se ci sono tendenze ricorrenti. Crediamo che
questo identificativo non violi la tua privacy: nel peggiore dei casi,
saremmo in grado di dire che una determinata istanza di Neubot ha
cambiato indirizzo Internet (e, quindi Provider e/o posizione).
Tuttavia, se sei veramente preoccupato per questo identificativo univoco
casuale e stai facendo girare Neubot >= 0.3.7, puoi generare un nuovo
identificativo univoco lanciando il seguente comando:
# neubot database regen_uuid
Le versioni future di Neubot monitoreranno e raccoglieranno anche
informazioni riguardanti il carico del computer (come la quantità di
memoria libera, il carico medio, l'utilizzo medio della rete).
Monitoreremo il carico per evitare di iniziare test quando stai
utilizzando il computer a pieno carico. Raccoglieremo i dati di carico
al fine di esaminare l'effetto del carico sui risultati.
5.2. Pubblicherete il mio indirizzo IP?
Si`. Neubot pubblica il tuo indirizzo IP per permettere ad altri
individui e istituzioni di portare avanti studi alternativi e/o
verificare la metodologia di raccolta e di analisi dei dati.
Ovviamente, Neubot non puo` pubblicare il tuo indirizzo IP senza
avere il tuo consenso informato, come previsto dalle leggi europee
in materia di privacy. Percio`, ti chiede il permesso di farlo
durante l'installazione, se possibile, oppure, se non e' possibile,
mentre e' in esecuzione. Non c'e' bisogno di dire che ovviamente
Neubot non comincia alcun test finche` non hai letto la privacy
policy e gli hai fornito il permesso di pubblicare il tuo indirizzo
IP.
Una ulteriore ragione per cui Neubot non puo` eseguire alcun test
finche` non gli fornisci il permesso di pubblicare il tuo indirizzo
IP e' che questo non sarebbe compliant con la policy della piattaforma
distribuita Measurement Lab (M-Lab), che fornisce i server al
progetto Neubot e richiede che tutti i risultati siano rilasciati
come open data.
Per maggiori informazioni, fai riferimento alla privacy policy.
7. Web user interface
7.1. Che cos'è la web user interface?
La web user interface è una interfaccia web-based che permette
di controllare neubot e di vedere i risultati recenti. Per
impostazione predefinita, quando neubot viene avviato, si
associa alla porta 9774 su 127.0.0.1 e attende richieste
web.
Gli utenti possono richiedere dati grezzi, usando una API
JSON, oppure normali pagine web. Se non viene specificata
alcuna pagina web, neubot ritorna il contenuto della pagina
status. A sua volta, questa pagina usa javascript per
inviare richieste alla API JSON e popolare la pagina stessa.
Allo stesso modo, le altre pagine web usano javascript e
la API JSON per inserire al proprio interno contenuti
dinamici, come, ad esempio, la configurazione, i risultati
recenti, o i log.
7.2. Come apro la web user interface?
Su Windows, il comando Neubot nello start menu dovrebbe aprire
la web user interface nel browser predefinito.
Su MacOSX, l'applicazione Neubot (/Applications/Neubot.app)
dovrebbe aprire la web user interface nel browser predefinito.
Su Ubuntu e Debian, se l'utente ha installato il pacchetto
neubot (e non il pacchetto neubot-nox), il comando Neubot
nel menu applicazioni dovrebbe aprire la web user interface in
una applicazione ad-hoc, basata su Gtk+ e WebKit, utilizzata
per accedere alla web user interface.
Su UNIX, se i binding Gtk+ e WebKit per Python sono installati,
il seguente comando:
neubot viewer
apre una applicazione ad-hoc, basata su Gtk+ e WebKit,
utilizzata per accedere alla web user interface.
Su qualsiasi sistema, ovviamente, l'utente può aprire il suo
web browser preferito e farlo puntare alla seguente URI:
http://127.0.0.1:9774/
7.3. Cosa contiene la pagina status?
La pagina status (che è quella predefinita) fa vedere lo stato
di Neubot, e il risultato dell'ultimo test di trasmissione.
7.4. Cosa contiene la pagina speedtest?
La pagina speedtest mostra i risultati recenti del test speedtest,
vale a dire latenza, goodput in download e in upload, sia in forma
grafica sia in forma tabulare.
7.5. Cosa contiene la pagina bittorrent?
La pagina bittorrent mostra i risultati recenti del test bittorrent,
vale a dire latenza, goodput in download e in upload, sia in forma
grafica sia in forma tabulare.
7.6. Cosa contiene la pagina log?
La pagina log fa vedere i log recenti. Il colore di ciascuna log
entry indica la gravità del messaggio di log. In particolare, la
pagina utilizza:
- il rosso per i messaggi di errore;
- il giallo per i messaggi di warning;
- il blu per i messaggi informativi;
- il grigio per i messaggi di debug.
Cliccando sul link Refresh page è possibile aggiornare la pagina
dei log.
7.7. Cosa contiene la pagina privacy?
La pagina privacy fa vedere la privacy policy e permette di fornire
a neubot i permessi relativi alla privacy. Vedi 5. Domande sulla
privacy per maggiori informazioni.
7.8. Cosa contiene la pagina settings?
La pagina settings permette di vedere e cambiare le impostazioni
di Neubot. Bisogna cliccare sul bottone Save per rendere permanenti
le modifiche.
7.9. Come cambio la lingua della web user interface?
Cambiando il valore dell'opzione www.lang, che può essere
modificato utilizzando la pagina settings. Al momento, questa
opzione può assumere uno dei seguenti valori:
- default
- Usa la lingua predefinita del browser.
- en
- Usa l'inglese.
- it
- Usa l'italiano.