Documentazione
Installazione
Requisiti
Su un sistema UNIX bisogna installare la libreria Sofia-SIP. Si puo' installare una distribuzione binaria:
-
su Debian sid:
# apt-get install libsofia-sip-ua-dev
o scaricare e installare i sorgenti. Istruzioni piu' dettagliate sono sul sito del progetto Sofia-SIP.
Per i SIPDHT tools e' necessario installare prima la libreria SIPDHT.
Libreria SIPDHT
La libreria SIPDHT si puo' scaricare dalle pagine del progetto su SourceForge come sorgenti (archivio compresso o repository CVS) o binari (pacchetto Debian).
NOTA: se gli utenti o gruppi del sistema non sono correttamente configurati, alcuni di questi passaggi richiederanno i privilegi di amministratore root.
Usando un archivio di sorgenti:
- scarica l'archivio col browser dalla pagina di download di SourceForge;
-
scompatta l'archivio in una directory adatta (e.g. /usr/local/src):
$ mv libsipdht-*.tar.gz /usr/local/src
$ cd /usr/local/src
$ tar zxvf libsipdht-*.tar.gz
$ cd libsipdht-*
-
esegui lo script
configure
:
$ ./configure
-
compila:
$ make
-
installa:
$ make install
Usando il branch HEAD dal repository CVS:
-
spostati in una directory adatta (e.g.
/usr/local/src
):
$ cd /usr/local/src
-
scarica il modulo:
$ cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/sipdht login
$ cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/sipdht co -P libsipdht
-
genera lo script di configurazione:
$ ./autogen.sh
-
esegui lo script
configure
:
$ ./configure
-
compila:
$ make
-
installa:
$ make install
Usando un pacchetto Debian:
- scarica il pacchetto Debian col browser dalla pagina di download di SourceForge;
-
installa:
$ dpkg -i libsipdht-*.deb
SIPDHT tools
I SIPDTH tools si possono scaricare dalle pagine del progetto su SourceForge come sorgenti (archivio compresso o repository CVS) o binari (pacchetto Debian).
La procedura per installarli e' identica a quella descritta per la libreria; l'unica differenza e' il nome del modulo: sipdht-tools invece di libsipdht.
Esempio DHT
Questo esempio mostra come avviare, esplorare e usare una semplice DHT usando i SIPDHT tools. Per semplicita' tutti i nodi verrrano eseguiti sullo stesso computer; un esempio piu' avanzato e' descritto nel README all'interno del pacchetto sipdth-tools.
-
avviamo alcuni nodi che partecipano alla DHT:
$ sipdht -p 6070 -s 10
$ sipdht -p 6080 -s 10 sip:localhost:6070
$ sipdht -p 6090 -s 10 sip:localhost:6080
-
dopo qualche secondo, esploriamo la DHT
partendo da un qualunque nodo:
$ sipdhtw sip:localhost:6070
Se tutto funziona correttamente, dovremmo vedere un report che mostra la lista dei successori e le tabelle di finger di tutti e tre i nodi; -
chiediamo a uno dei nodi di inserire una coppia "<sip:chiave, sip:valore>";
$ sipdhtp sip:key sip:value sip:localhost:6080
-
chiediamo a uno dei nodi di mostrare il valore associato a "sip:chiave":
$ sipdhtg sip:key sip:localhost:6080
Se tutto e' corretto, il risultato dovrebbe essere: "sip:valore".
Supporto
Il supporto e' fornito principalmente attraverso la mailing list sipdht-devel. Le sottoscrizioni e le preferenze si possono cambiare direttamente dalla pagina di mailman. Sono presenti anche gli archivi.
Gli sviluppatori sono spesso presenti sulla chat room sipdht@conference.tilab.com, alla quale ci si puo' collegare con un qualunque client Jabber (Gaim, PSI, Gtalk...). Questo e' il posto dove soddisfare ogni tipo di curiosita'.
Talvolta le decisioni sono prese in conferenze in diretta, nella stanza pubblica sipdht@sipfw.tilab.com. Questa stanza e' sempre attiva e per accedervi e' solo necessario un telefono SIP (Kphone, Linphone, X-Lite, o per connettivita' solo HTTP, Wengophone). Gli eventi di questa stanza sono annunciati sulla mailing list.