Copyright (C) 2004 Jody Marca.

Installazione

In questo documento si tratterà l’installazione e la configurazione dell’applicazione 
realizzata e di tutti i software di cui necessita per una corretta esecuzione. 
Il software sviluppato richiede un Servlet container e un database; mentre 
l’applicazione stessa è scaricabile dal sito http://crab.sourceforge.net/. 
I software scelti per soddisfare queste richieste sono Apache Tomcat (versione 5.0.16) 
con la JVM di Sun Microsystems (versione 1.4.2) e come database Mysql (versione 4.0.17). 
L’istallazione di questi software è molto semplice poiché si può usufruire di pacchetti 
precompilati che facilitano l’istallazione attraverso un’interfaccia grafica che 
richiede le informazioni all’utente. Si consiglia agli utenti più esperti, di 
utilizzare pacchetti sorgente per l’installazione di Apache Tomcat e di compilarli al 
momento per avere un software più ottimizzato. Il sistema operativo che si adotta non è 
vincolante, l’applicazione è stata infatti testata con esito positivo sia su Microsoft 
Windows, Linux e MacOS. Se si volesse installare il software su un altro sistema 
operativo per il quale non è disponibile Mysql bisognerebbe modificare le chiamate al 
driver del database dei servizi Web sostituendo il driver di Mysql con quello del 
database adottato. L’impossibilità di adottare Apache Tomcat non causa alcun problema, 
infatti basta sostituirlo con un altro Servlet container senza apportare alcuna 
modifica al codice. Durante l’istallazione di Apache Tomcat l’unico importante 
parametro da definire è la porta di ascolto che deve avere il valore 8080; la mancata 
o l’errata definizione comporterà l’impossibilità d’uso dell’applicazione. Installato 
Tomcat, per verificarne il funzionamento basterà avviarlo e digitare sul browser Web 
l’indirizzo http://localhost:8080, se sarà mostrata la pagina di benvenuto significa 
che il server è funzionante. Per quanto riguarda l’installazione di Mysql bisogna anche 
qui definire la porta di ascolto del database, che è stata lasciata quella di default 
(3306). La creazione dal database, delle tabelle e dell’utente che sarà utilizzato 
dall’applicazione, è facilitata da uno script sql inserito nella distribuzione. 
Lo script può essere eseguito solo e unicamente dopo aver avviato il database ed essere 
entrati in esso con il comando mysql. Per eseguirlo basta lanciare il comando: 
“ \. Percorso_del_file/Crab.sql ”. Ora possiamo passare all’ installazione dei servizi 
e della web application. Per velocizzare e semplificare il procedimento agli utenti
 meno esperti, è presente un file nella distribuzione dal nome crab.war, 
questo è un formato speciale di archivio che contiene tutta la Web application e 
i servizi sviluppati. Per la sua installazione è sufficiente inserirlo nella cartella 
“webapps” di Tomcat e quando si esegue il comando di avvio del server, si può osservare 
la creazione di una cartella “crab” con all’interno tutti i file necessari per il 
funzionamento del software compresi Apache Axis, Apache Struts, Apache Log4J e il 
driver di Mysql. Ora ci resta solamente la configurazione di Apache Axis. 
L’esecuzione dello schieramento (deploy) dei servizi non è necessario, infatti è 
presente un file dal nome “server-config.wsdd” nella cartella “webapps\crab\WEB-INF” 
con tutte le informazioni utili ad Axis per eseguire i servizi. Bisogna però settare 
le variabili d’ambiente necessarie al funzionamento di Axis. 
Il settaggio delle variabili per Microsoft Windows è il seguente: 

set AXIS_HOME=c:\axis 

set AXIS_LIB=%AXIS_HOME%\lib
set AXISCLASSPATH=%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discovery.jar;%AXIS_LIB%\commons-logging.jar;%AXIS_LIB%\jaxrpc.jar;%AXIS_LIB%\saaj.jar;%AXIS_LIB%\log4j-1.2.8.jar;%AXIS_LIB%\xml-apis.jar;%AXIS_LIB%\xercesImpl.jar;%AXIS_LIB%\wsdl4j.jar;%AXIS_LIB%\servlet-api.jar

Il settaggio delle variabili per Linux e MacOs è invece il seguente: 

set AXIS_HOME=/usr/axis 

set AXIS_LIB=$AXIS_HOME/lib 

set AXISCLASSPATH=$AXIS_LIB/axis.jar:$AXIS_LIB/commons-discovery.jar:$AXIS_LIB/commons-logging.jar:$AXIS_LIB/jaxrpc.jar:$AXIS_LIB/saaj.jar:$AXIS_LIB/log4j-1.2.8.jar:$AXIS_LIB/xml-apis.jar:$AXIS_LIB/xercesImpl.jar:$AXIS_LIB/wsdl4j.jar:$AXIS_LIB/servlet-api.jar

export AXIS_HOME; export AXIS_LIB; export AXISCLASSPATH

Ora l’installazione della Web application è completata ed è possibile utilizzare il 
software riavviando il server e digitando nel browser l’indirizzo 
http://localhost:8080/crab. Durante l’esecuzione, verrà creata una cartella denominata 
“crab-log” che contiene tutti i log generati dall’applicazione. Il livello di log è 
settato a DEBUG ma è modificabile facilmente cambiandolo nella classe “Log.java” 
che si trova nel package “tesi.servizi”. Modificata  e ricompilata la classe, 
bisogna sostituirla a quella in uso; qui ci si accorgerà che la cartella 
“webapps\crab\WEB-INF\classes” non contiene classi, infatti tutte le classi delle 
action di Struts e dei servizi sono archiviate in un file jar denominato “tesi.jar” 
e contenuto nella cartella “webapps\crab\WEB-INF\lib”.
Il file jar può essere estratto come un semplice archivio zip e può essere ricreato 
con l’istruzione: “jar cvf tesi.jar *”.
Per l’utilizzo del client sviluppato per il cellulare è necessario un simulatore che 
supporti la J9, la JVM di IBM. È possibile scaricare gratuitamente dal sito di IBM il 
software di sviluppo WebSphere Studio Device Developer che contiene un ottimo simulatore. 
Per l’esecuzione del client è sufficiente utilizzare il jad e il jar associato, 
presenti nella distribuzione. 


Copyright (C) 2004 Jody Marca.