Progetto di Ingegneria del Software 2. SWIMv2

Transcript

1 Progetto di Ingegneria del Software /2013 SWIMv2 Guida di installazione Docente: Prof. Luca Mottola Davide Brambilla Antonio Caputo Paolo Caputo 1

2 Introduzione La piattaforma è stata sviluppata come applicazione per JBoss e include un database per gestire i dati necessari. 1.1 Pacchetto di installazione Il pacchetto di installazione contiene: Il manuale utente, per aiutare l utilizzatore finale nell'interazione con la piattaforma; Il datasource del progetto ( MySQL-ds.xml ); File profile.xml che sarà necessario per eventuali problemi con JBoss; File swim2brambillacaputocaputo.ear necessario per far partire l applicazione; Cartella dei progetti swim2 e swim2web da importare nel caso si utilizzasse eclipse per eseguire l applicazione; PER QUALSIASI PROBLEMA CONTATTARE caps90@tiscali.it (o cercare su facebook caps90@tiscali.it) 2

3 Programmi necessari Completare le installazioni dei programmi necessari al corretto funzionamento di swim seguendo i punti dell elenco seguente: 1: Installazione di JDK 7 ( preferibile ) o JDK 6 E possibile effettuare il download della JDK 7 seguendo questo link: html. Si raccomanda attenzione nella scelta del download corrispondente al sistema operativo giusto ( windows bit o mac OS). 2: Installazione di JBoss La versione di JBoss consigliata è la Nel caso non fosse già installata una versione di JBoss è possibile effettuare il download direttamente dall indirizzo: Si raccomanda anche in questo caso attenzione nella scelta del corretto software in relazione al proprio sistema operativo. 3: Installazione di MySql Community Server: Come ultimo è necessario munirsi di questo software per la gestione del Database Server. Verificare di averlo installato, in caso contrario è possibile scaricarlo liberamente dal seguente link : ATTENZIONE: durante l installazione di questo software prestare molta attenzione ad inserire i seguenti parametri quando richiesti: Quando verrà chiesto il Nome e la Password dell amministratore bisognerà inserire il valore : root ad entrambi i campi; Controllare che la My SQL server port sia 3306; Verificare che mysql command sia inserito nelle variabili PATH ( Spuntare il check button quando richiesto); 4: Web Browser consigliati: E necessaria una versione recente di un browser web. I due software da noi caldeggiati sono Firefox 9 oppure Chrome 24. 3

4 Configurazione di jboss Preme innanzitutto verificare che il JBoss che abbiamo scaricato sia correttamente funzionante. Estrarre il file jboss ga-jdk6.zip in una cartella a piacimento. Ora dobbiamo far partire il server per la prima volta: recarci in %la directory in cui hai installato il tuo jboss%/bin/ e lanciare l esecuzione del file run.bat (run.sh per i sistemi operativi unix). Se attendendo la fine del procedimento vi troverete di fronte a questa schermata il server non ha riscontrato errori. In caso contrario sarà necessario sostituire il file profile.xml posto in : %La tua directory di JBoss%/server/default/conf/bootstrap/ con quello incluso nel pacchetto di istallazione. 4

5 Installazione del database A questo punto dovremmo trovarci nella situazione seguente: JBoss è installato sul nostro sistema ( e quindi il server è presente ) e anche MySql è a sua volta installato. Non ci resta che creare un database e metter le basi per far sì che il nostro database e il nostro server collaborino. A tale scopo andare su : % La tua cartella di installazione di MySQL %/bin/ e lanciare l esecuzione di mysql command ( per utenti Windows, il mysql command è presente anche nello start menu). Quando si apre la finestra di comando verrà richiesta la password dell amministratore del sistema. Inserire root come impostato durante l installazione. 5

6 Inserire ora il comando : CREATE DATABASE swimv2; ( prestare attenzione al ; ): Digitare ora USE swimv2; : 6

7 Come ultimo, scrivere CREATE SCHEMA swimv2; Così facendo abbiamo creato un database con uno schema vuoto pronto ad esser usato dal nostro sistema. *ATTENZIONE : non chiudere questa finestra di comando che ci sarà utile in seguito. 7

8 Installazione MySql Java Connector Come detto, abbiamo bisogno di uno strumento che faccia cooperare database e server di cui siamo già provvisti. Munirsi di un MySQL Java Connector ( se non già presente nel nostro sistema) seguendo il link : Attendere il completamento del download e estrarre il pacchetto.zip appena scaricato nella cartella di deploy del server: % La directory in cui hai istallato jboss %/server/default/deploy/. Il prossimo passo prevede di copiare il file MySQL-ds.xml ( che si trova nel pacchetto di istallazione fornito) nella cartella di deploy (vedi sopra). ATTENZIONE: aprire con un editor di testo il file MySQL-ds.xml e accertarsi che i parametri corrispondenti al nome del database ( swimv2 ), alla porta di mysql ( 3306 ), all username e alla password ( entrambi root ) siano settati in maniera corretta ( come mostrato in figura ). 8

9 Installare l applicazione in JBoss Ci siamo quasi: gli ultimi passaggi sono quelli che riguardano l applicazione vera e propria. Copiare il file swim2brambillacaputocaputo.ear nella solita cartella di deploy di JBoss: ( % La directory in cui hai istallato jboss %/server/default/deploy/ ). Ora dobbiamo far partire il server come detto in precedenza ( % La directory in cui hai istallato jboss %/bin / ed eseguire run.bat ). Per far partire l applicazione aprire il Web Browser e inserire l URL : localhost:8080/swim2web /. ATTENZIONE: è necessario, prima di iniziare a usare il sistema, creare una prima istanza di amministratore manualmente: bisogna quindi far partire una prima volta il programma e chiuderlo senza utilizzarlo. Abbiamo fatto questo per far in modo che il primo avvio crei le tabelle nello schema vuoto precedentemente inserito nel database(*vedi pag. 6). Digitare nella finestra di comando che abbiamo lasciato aperta in precedenza la seguente query: INSERT INTO `swimv2`.`admin` (`Id`, `Password`, `Username`) VALUES ('1', 'admin', 'admin'); Abbiamo così creato l istanza di amministratore. Da ora in poi se un qualunque utente volesse loggarsi come amministratore dovrà utilizzare come Username e Password : admin admin. Note Finali Per un corretto utilizzo del sistema si consiglia di consultare il manuale di utilizzo fornito con il sistema. 9

10 Procedura alternativa ( da utilizzare soltanto come ultima spiaggia ) : nel caso in cui tutti i tentativi fatti non funzionino e i tentativi di esecuzione dell applicazione siano vani, è possibile procedere in questo modo: Mantenere le installazioni di JBoss, MySql e MySql connector fatte in precedenza e tutte le procedure seguite a riguardo in precedenza ( copia file MySql-DS.xml nella cartella di deploy, creazione database, unzipping del connector nella cartella di deploy ); Installare ( se non già installato ) Eclipse indigo; Includere nelle librerie di eclipse la JDK 1.7.0: aprire eclipse, cliccare su window/preferences/java/installedjres e selezionare la jdk 1.7.0; Nel caso non fosse presente scaricarla dal sito: Quindi cliccare su add e aggiungere manualmente la jdk appena scaricata; 10

11 Importare i progetti che si trovano nel pacchetto di installazione ( Swim2 e Swim2Web: aprire eclipse, cliccare su file/import project ); Includere swim2 nel buildpath di swim2web; Creare un nuovo server ( File/new/other/server selezionare JBoss 5.0); Cliccare due volte sul nuovo server ( Window/Show view/servers) e impostare i nuovi timeout a 300 e 300; Cliccare col destro sul server, poi Add and Remove e aggiungere al server swim2 e swim2web; Eseguire ora il progetto swim2web. 11