Progetto di Ingegneria del Software 2 SWIM v2 MANUALE DI INSTALLAZIONE Team: Professori: Christian Miranti (matr. 787042 ajbest@hotmail.it) Raffaella Mirandola Davide Falco (matr. 786899 davide.falco22@gmail.com) Luca Mottola Nazario Notaroberto (matr. 787088 naz689@gmail.com) 1
Indice dei Contenuti 1. Introduzione...3 1.1 Componenti Necessari...3 2. Operazioni Preliminari...4 3. Configurazione DataBase...5 3.1 Driver JDBC...5 3.2 DataSource...5 3.3 Creare il DataBase...5 4. JBoss...8...11 2
1. Introduzione Il presente documento, guiderà l'utente nell'installazione dell'applicazione web-based SwimV2. Saranno presentati i componenti necessari al corretto funzionamento e verrà spiegato come installarli sul proprio pc. La piattaforma del sistema è stata realizzata come applicazione Jboss con l'inclusione di un DataBase atto a gestire i dati permanenti. 1.1 Componenti Necessari I componenti necessari per installare il sistema, sono i seguenti: Applicazione: SwimV2, è l'elemento da inchiodare nella piattaforma Eclipse (N.B. Il codice sorgente è diviso in WT e BT); essi sono disponibili ai seguenti indirizzi BT: https://code.google.com/p/swimv2-miranti-falco-notaroberto/ WT: https://code.google.com/p/swimv2client-miranti-falco-notaroberto/ entrambi i progetti sono raggiungibili all'indirizzo indicato, seguendo il percorso Source Browse File Sql: SwimV2.sql necessario per l'importazione del DB. File Xml: mysql-ds.xml per rendere integrato il DB con l'applicazione. Driver JDBC : mysql-connector-java-5.1.22-bin per rendere possibile la comunicazione con il DB MySQL. Manuale Utente: manuale che guida l'utente nell'esplorazione dell'applicazione. Documento di Testing: documento che presenta le funzionalità offerte dal sistema. 3
2. Operazioni Preliminari Per poter installare l'applicativo è necessario preparare i componenti sul server che si utilizzerà. È importante assicurarsi che sia presente la presenza della piattaforma JBoss. Nel caso non sia presente sul pc, è possibile scaricarla dal seguente indirizzo: http://www.jboss.org/. La versione che il team consiglia di scaricare è la 5.1. È quindi necessario assicurarsi di avere installato MySQL Server, fondamentale per la gestione dei dati persistenti. Nel caso non sia presente sul pc, l'indirizzo da cui è possibile ottenerlo è: http://dev.mysql.com/downloads/. anche in questo caso il team consiglia una versione, in particolare la 5.1. Un ulteriore elemento necessario alla configurazione è la piattaforma Eclipse. La versione consigliata in questo caso è Indigo. Nel caso non sia presente, è possibile ottenerla dal seguente indirizzo: http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/indigosr2. In ultimo è necessario aver installato un browser web per la navigazione all'interno dell'applicazione. 4
3. Configurazione DataBase Per una corretta installazione del DB sono necessari i seguenti componenti: Driver JDBC DataSource (mysql-ds.xml) Schema del DB 3.1 Driver JDBC Per permettere la comunicazione tra l'applicazione e il database, va integrato il driver JDBC alla piattaforma JBoss. Il server che va utilizzato è quello di default e si trova nella cartella al percorso : Jboss\server\default\lib. 3.2 DataSource Per far si che JBoss possa interagire correttamente con il DB è necessario inserire il file mysql-ds.xml presente nella cartella deploy del server. È necessario modificare il suddetto file e inserire correttamente i parametri al suo interno. La configurazione corretta è la seguente Per il corretto funzionamento è necessario impostare la Password dell'utente di root del server MySQL nei rispettivi tag. 3.3 Creare il DataBase Per creare il DB è necessario lanciare in esecuzione MySQL. Le operazioni da compiere sono due: da linea di comando, eseguire il comando mysqld.exe; 5
In seguito, ridurre a icona il promt appena aperto e aprirne un secondo in cui va digitato il comando: mysql -h localhost -u root Ora è possibile creare il DB; da quest'ultimo terminale, è necessario creare il DB su cui si andrà a lavorare. Digitare il comando CREATE schema swimv2 Successivamente digitare -quit- per uscire da MySQL. Il passo successivo permette di importare il DB fornito dal team. Digitare mysql -h localhost -u root <C:\Users\Public\swimv2.sql.txt. Naturalmente il percorso mostrato è puramente indicativo. All'atto dell'installazione dovrà essere riadattato. Il file da importare contiene tutte le tabelle predisposte dal team ed in particolare sono fornite anche l'istanza dell'amministratore ed una serie di abilità. 6
Successivamente, digitando nell'ordine, i comandi: use swimv2; show tables; il risultato è il seguente: il DataBase è pronto per essere utilizzato. 7
4. JBoss È ora importante configurare correttamente JBoss e integrarlo in Eclipse. Dopo aver avviato quest'ultimo, bisogna creare i due progetti associati all'applicazione. Essi prendono i nomi di BT -che si occupa della gestione Business Tier- è WT -che si occupa della gestione Web Tier-. Creare ora il nuovo progetto attraverso il menù di Eclipse Indichiamo quindi le prioprietà e il nome del progetto, settandole in questo modo: 8
Terminata questa fase, è necessario creare il Web Tier. Anche in questo caso, sfruttiamo il menù di Eclipse per crearlo: Come prima, vanno settati nome e parametri: 9
Per il corretto funzionamento del sistema è ora necessario inserire il file persistence.xml nella cartella META INF del BT. È quindi importate predisporre i seguenti package: Package EntityBean in BT\ejbModule\ Package Sessions in BT\ejbModule\ Package Servlet in WT\Java Resources\src\ Fatto ciò, bisogna creare il Server su cui lanciare la nostra applicazione; posizionarsi nella scheda servers e premere il tasto destro del mouse e quindi new server 10
I parametri che andranno impostati sono: Premendo su next si dovrà inserire il percorso per arrivare alla cartella di JBoss (Specifico per ogni pc su cui si procederà con l'installazione). Premendo su finish la procedura guidata terminerà e il server sarà creato effettivamente. Recarsi quindi sul server creato e utlizzando il tasto destro aprire il seguente menù a tendina Selezionando l'opzione indicata, la finestra che si presenterà, permetterà di associare i due progetti svluppati al server creato 11
In ultimo, si consigli di modificare il timeout del server nel seguente modo, agendo con un doppio click del mouse sul server stesso Per poter usufruire del sistema è quindi sufficiente copiare il codice presente all'interno del repository, ponendo attenzione alla disposizione nei package creati precendemente. 12
Fondamentale per un corretto funzionamento è il file web.xml presente in WT\Web Content\WEB-INF\; esso deve essere sostituito con quello presente sul repository (o in alternativa, copiare il codice proposto all'interno del file generato automaticamente da Eclipse). Il server creato può essere ora fatto partire, agendo sul pulsante indicato L'applicazione è raggiungibile all'indirizzo http://localhost:8080/wt. 13