Istruzioni per il deployment del prototipo.

Il prototipo è composto da una Applicazione Web (compatibile Java Servlet 2.4), che deve essere installata su di
un servlet container.

Per rendere attivo il sistema basta:
1) Eseguire il deployment di node.war su di un node container, 
per eseguire il programma client di test senza ricompilarlo bisogna che risponda alla URL http://localhost/node1/

2) Aprire la pagina web http://localhost/node1/ e verificare che l'applicazione effettivamente sia stata inizializzata (basta che si riesca a caricare la home page)

3) Eseguire il file test.bat (lo script suppone che Java sia nel PATH di sistema) e verificare nella amministrazione Web che venga creata una coda "coda1" e venga riempita di messaggi



Per verificare le qualità di replicazione 
1) installare node.war sullo stesso container in un altro contesto ad esempio /node2
2) Aprire la pagina di gestione del nodo ed indicare nella opzione "Join Group" l'URL base del primo nodo 
(se sono state seguite le istruzioni di prima il path indicato dovrebbe già andare bene)
3) Cliccare su "JOIN"
4) Verificare facendo un refresh che nella lista in basso dei nodi nel gruppo compaiano entrambi i nodi, ordinati per priorità decrescente.
5) Eseguire nuovamente il test.bat e verificare che la coda venga creata su entrambi i nodi ed i messaggi vengano conservati su entrambi i nodi con lo stesso ordinamento

Ovviamente si può provare con più di due nodi, si può anche provare a "spegnere" un nodo durante l'esecuzione del test per testare le capacità di fault-tolerance


L'API lato client si utilizza semplicemente includendo nel classpath il file qms.0.3.jar e instanziando un oggetto di classe qms.client.QMSClient, il cui utilizzo è molto semplice visti i nomi dei metodi.
Si faccia pure riferimento ai JavaDocs inclusi nel pacchetto.

Il file build.xml può essere utilizzato con Apache ANT per la ricompilazione del pacchetto e la generazione dei Javadocs


Enrico Olivelli

enrico.olivelli@tin.it
347 6407684