Guida all'installazione di Jug4Tenda

Transcript

1 Indice generale Guida all'installazione di Jug4Tenda WORK IN PROGRESS di Andrea Del Bene Guida all'installazione di Jug4Tenda...1 Nota...2 1Prerequisiti software Installazione Java JDK Installazione MySql Test dell'installazione MySql Installazione di Tomcat Test dell'avvio di Tomcat L'installatore Jug4tenda Introduzione Utilizzo dell'installatore...12 Andrea Del Bene Progetto Jug4Tenda 1 / 18

2 Nota Come modello per questo documento è stato preso il template dei documenti Write di OpenOffice disponibile sul sito dello JUG Sardegna. Si ringrazia il JUG Sardegna per la cortese collaborazione. Per domande o dubbi sul progetto sono disponibili il forum (previa iscrizione) o mandando una mail alla mailing list di sviluppo jug4tendadev@googlegroups.com o ancora più comodamente ad andrea.on.web@libero.it. L'autore di questa guida (Andrea Del Bene) è presente anche su Facebook per coloro che vogliano interagire usando questo network. Andrea Del Bene Progetto Jug4Tenda 2 / 18

3 1 Prerequisiti software Il progetto Jug4Tenda è distribuito mediante un installatore disponibile per ambiente Windows o Linux che semplifica l'installazione e la configurazione del software. Tuttavia prima di iniziare il processo di l'installazione occorre assicurarsi che siano presenti nel sistema i seguenti programmi usati da Jug4tenda: 1. Java JDK (versione 5.0 o superiore) 2. MySql (versione 5.0 o superiore) 3. Tomcat (versione 5.5 o superiore) Se si dispone già di questi programmi sul proprio sistema si può leggere direttamente il paragrafo 2L'installatore Jug4tenda. Di seguito si forniscono le istruzioni per reperire ed installare i programmi necessari sotto ambiente Windows o Linux. Si noti che la scelta di Tomcat come application server non è obbligatoria e possono essere impiegati altri software equivalenti (es: Jetty). Tuttavia in questo manuale si verrà discussa la procedura di installazione considerando il solo Tomcat visto che è il software realmente impiegato dagli sviluppatori. NOTA: questo manuale per ovvi motivi di spazio non si propone di descrivere nel dettaglio le procedure di installazione dei programmi menzionati e presuppone che il lettore sia in possesso delle nozioni tecniche sufficienti per mettere in pratica i suggerimenti di installazione. Per ulteriori approfondimenti consultare i siti dei rispettivi produttori indicati nel documento. 1.1 Installazione Java JDK Sotto ambiente Windows Java è disponibile come installatore eseguibile all'indirizzo L'installatore propone la tipica interfaccia a wizard che guida l'utente attraverso i passi d'installazione. Immagine 1: Schermata di benvenuto dell'installatore Java Andrea Del Bene Progetto Jug4Tenda 3 / 18

4 Sotto ambiente Linux l'installazione del JDK avviene da shell. Di seguito riportiamo le istruzioni e i comandi per installare il JDK della Sun su un sistema Linux Debian (compreso Ubuntu). Il file.bin si può prelevare allo stesso indirizzo riportato per l'installatore Windows. Le istruzioni sono riprese dal sito dello Jug Sardegna Alla pagina del download si sceglie la distribuzioni a seconda del proprio hardware e del proprio sistema operativo. Nel nostro esempio useremo il file jdk-6u11-linux-i586.bin. Scaricato il file spostiamolo nella cartella di installazione, ad esempio /usr/local, usando il comando: sudo mv jdk-6u11-linux-i586.bin /usr/local Ora ci spostiamo nella cartella di installazione e lanciamo l'installatore dopo aver reso il file eseguibile: cd /usr/local chmod +x jdk-6u11-linux-i586.bin sudo sh jdk-6u11-linux-i586.bin L'installatore ci chiederà di accettare la licenza. Terminata l'installazione si può cancellare l file jdk-6u11-linux-i586.bin. L'installazione è completa ma occorre indicare al sistema che la distribuzione java da usare è quella appena installata. Il comando seguente serve proprio ad avvisare Linux che c'è una nuova distribuzione Java nel sistema: sudo update-alternatives --install /usr/bin/java java /usr/local/jdk1.6.0_11/bin/java 300 La sottocartella jdk1.6.0_11 è volutamente evidenziata perchè è stata creata dall'installatore e riporta la versione correntemente installata. Per concludere dobbiamo impostare il nuovo jdk come implementazione di default: sudo update-alternatives --config java Questo comando mostrerà tutte le installazioni di Java presenti nel sistema numerandole. Possiamo ora specificare il numero corrispondente al JDK appena installato per renderlo l'implementazione Java di default. Andrea Del Bene Progetto Jug4Tenda 4 / 18

5 1.2 Installazione MySql Sotto ambiente Windows MySql è disponibile come installatore eseguibile all'indirizzo Anche in questo caso l'installatore guida l'utente attraverso le varie fasi di installazione del software. Se non si hanno particolari esigenze di configurazione è sufficiente accettare le impostazioni di default proposte dal wizard. Immagine 2: La schermata di benvenuto di Mysql Una guida completa (solo in inglese!) all'installazione sotto Windows è presente al seguente indirizzo. In ambiente Linux è possibile affidarsi al proprio gestore di pacchetti/programmi che si occupa in automatico di cercare MySql, scaricarlo, installarlo e configurarlo. Sotto Ubuntu il gestore di programmi si trova sotto Applicazioni Aggiungi/Rimuovi... Immagine 3: Installazione di MySql e della console di amministrazione dal package manager di Xubuntu Andrea Del Bene Progetto Jug4Tenda 5 / 18

6 Di default sia sotto Windows che sotto Linux a MySql viene assegnata la porta Occorre prendere nota di questo parametro se lo si è modificato perchè verrà richiesto in fase di installazione di Jug4Tenda. NOTA: si consiglia anche l'installazione del MySql Administrator per agevolare la gestione del database e le operazioni di routine. L'utility è disponibile come installatore per sistemi Windows o può essere installata tramite package manager in ambiente Linux. Il successivo paragrafo farà uso di questo strumento per verificare che MySql operi correttamente Test dell'installazione MySql Ora dobbiamo assicurarci di conoscere i parametri fondamentali per connetterci a MySql. Per fare ciò useremo l'utility MySql Administrator. I parametri fondamentali sono l'host su cui è stato installato MySql (può essere il nostro sistema locale localhost), la porta su cui è stato installato (di default la 3306) ed infine il profile utente (username e password) di MySql con cui vogliamo lavorare. Sul nostro sistema di sviluppo può essere comodo lavorare con l'username root per avere pieni diritti d'uso su MySql. La password di default dell'utente root è vuota. Se abbiamo fatto un'installazione locale senza specificare una password per l'utente root dovremmo avere una schermata simile all'avvio di MySql Administrator. Immagine 4: La maschera di login di MySql Administrator Se i parametri inseriti sono corretti premendo 'Connect' dovremmo effettivamente connetterci a MySql e accedere alla console di gestione: Immagine 5: La finestra principale di MySql Administrator Andrea Del Bene Progetto Jug4Tenda 6 / 18

7 1.3 Installazione di Tomcat Il sito ufficiale del progetto Tomcat si trova all'indirizzo Nella sezione download è possibile scaricare i binari dell'ultima versione disponibile che al momento è la numero 6. Nella pagina di download si vada in fondo alla sezione Binary distributions e scelga una delle distribuzioni Core. In questa guida le istruzioni di installazione si riferiscono alla versione Core distribuita come singolo file zip. Tale file va bene per qualsiasi sistema operativo si voglia utilizzare. Per i sistemi Windows è disponibile anche un installatore nativo che permette di avviare Tomcat in automatico all'apertura di Windows. Il file zip scaricato avrà come nome apache-tomcat-xxx.zip dove al posto di xxx c'è il numero di versione scaricato (es: apache-tomcat zip). Si estragga il contenuto del file zip in una cartella di propria scelta (es: c:\apache-tomcat sotto Windows o /home/myhome/apachetomcat sotto Linux). Per funzionare Tomcat ha bisogno che nel proprio sistema operativo sia stata impostata la variabile di ambiente JAVA_HOME. Variabili di ambiente sotto Windows: per impostare le variabili di ambiente sotto Windows si vada in Pannello di controllo e si faccia doppio click su Sistema. Ora si vada nella scheda Avanzate e si clicchi il pulsante Variabili di ambiente Immagine 6: Accesso alle variabili di ambiente sotto Windows Nella schermata successiva si clicchi sul pulsante Nuovo ne riquadro Variabili di sistema Andrea Del Bene Progetto Jug4Tenda 7 / 18

8 Immagine 7: Riquadro "Variabili di sistema" A questo punto come Nome variabile inseriamo JAVA_HOME e il suo valore è la cartella di installazione del JDK (vedi il paragrafo Installazione Java JDK): Immagine 8: La nuova variabile JAVA_HOME Andrea Del Bene Progetto Jug4Tenda 8 / 18

9 Variabili di ambiente sotto Ubuntu: le variabili di ambiente sotto ambiente debian/ubuntu possono essere impostate nel file di testo /etc/bash.bashrc o nel file /home/myhome/.bashrc se vogliamo che valgano solo per un singolo utente. In entrambi i casi si aggiunga in fondo al file il seguente comando: export JAVA_HOME=/<percorso di installazione JDK> Il percorso di installazione del jdk può essere ottenuto tramite il comando locate javac che identifica il compilatore Java nella sottocartella bin. Una volta impostate le variabili di ambiente possiamo andare nella cartella bin che troviamo nella cartella in cui abbiamo estratto l'archivio di Tomcat. Per avviare l'application server dobbiamo lanciare il file startup.bat se siamo sotto Windows o startup.sh se siamo sotto Linux: Immagine 9: Contenuto della cartella bin di Tomcat Sui sistemi operativi Windows potrebbe essere attivo il firewall di sistema. In questi casi l'esecuzione di Tomcat provocherà un avviso di sicurezza che richiede all'utente il consenso per lasciare che Tomcat (o meglio Java) usi le porte di rete del pc: Andrea Del Bene Progetto Jug4Tenda 9 / 18

10 Immagine 10: Il firewall di Windows richiede il consenso per l'esecuzione di Tomcat Per consentire a Tomcat di operare correttamente cliccare su 'Sblocca' o aggiungere Java tra le eccezioni del firewall Test dell'avvio di Tomcat Quando sarà terminata l'esecuzione del file startup.sh (startup.bat sotto Windows) possiamo assicurarci che Tomcat sia in esecuzione aprendo il browser e digitando come indirizzo Si noti che il numero 8080 identifica la porta del nostro pc su cui è in esecuzione Tomcat. Questo valore è il default usato da Tomcat. Se in fase di esecuzione di Tomcat è stata impostata una porta diversa occorre sostituire 8080 con il valore della porta usata. Immagine 11: La pagina principale di Tomcat Andrea Del Bene Progetto Jug4Tenda 10 / 18

11 2 L'installatore Jug4tenda 2.1 Introduzione e note tecniche Il software Jug4tenda è distribuito come installatore eseguibile che ha lo scopo di rendere il più semplice possibile l'installazione e la configurazione del programma nel proprio ambiente di lavoro. L'installatore è stato costruito usando InstallJammer, un costruttore di installatori open source usato anche dal popolare programma CMS Alfresco. InstallJammer crea un file di progetto per l'installatore che si vuole realizzare. Il file di progetto di jug4tenda è presente nella cartella Installer e si chiama Jug4tenda.mpi. Immagine 12: Il file di progetto dell'installatore Jug4Tenda.mpi L'utilizzo di InstallJammer permette di creare installatori multipiattaforma (il supporto per Mac è atteso a breve) con un'interfaccia a wizard di immediato utilizzo. Nel seguito le figure si riferiranno alla versione windows ma modalità di utilizzo è la medesima. 2.2 Download dell'installatore L'installatore in versione Linux e Windows può essere scaricato all'indirizzo &folderid=6014. Prima di lanciare l'installatore è bene riassumere le operazioni che esso svolge quando viene utilizzato. Cosa NON fa l'installatore: Non installa in automatico i software elencati nel paragrafo 1Prerequisiti software. Non riavvia l'application server (es: Tomcat) su cui si installa Jug4Tenda. Occorre riavviare a mano l'application server al termine dell'installazione. Cosa fa l'installatore: Effettua il deploy di Jug4Tenda in modo che possa essere eseguito dall'application server in uso (es: Tomcat) Imposta i parametri per la connessione al database di lavoro su MySql. Crea o aggiorna il database di lavoro. Andrea Del Bene Progetto Jug4Tenda 11 / 18

12 Richiede per essere eseguito i privilegi di amministratore. Questo a si che se ad esempio eseguiamo l'installazione sotto Ubuntu ci verrà richiesta la password dell'utente root. Immagine 13: L'installatore richiede la password root Analogamente sotto Windows Vista la protezione UAC ci chiederà la password di amministratore di sistema. 2.3 Utilizzo dell'installatore Appena avviato l'installatore chiederà quale lingua si intende utilizzare. Si scelga l'italiano. Immagine 14: scelta della lingua La schermata successiva sarà mostrata in lingua e occorre dare l'assenso per iniziare l'installazione: Immagine 15: conferma per l'installazione Nella schermata di benvenuto si clicchi su Avanti Andrea Del Bene Progetto Jug4Tenda 12 / 18

13 Immagine 16: La schermata di benvenuto dell'installatore Ora per poter procedere occorre accettare i termini di contratto della licenza open source con cui è distribuito il software, ossia la LGPL 1 : Immagine 17: Finestra di accettazione della licenza LGPL 1 Andrea Del Bene Progetto Jug4Tenda 13 / 18

14 Immagine 18: Selezione della cartella di installazione Nella finestra successiva occorre scegliere la cartella di destinazione di Jug4Tenda. Si tratta della cartella di deploy in cui verranno copiati i file del progetto. La posizione di questa cartella cambia a seconda dell'application server che si intende utilizzare. Nel caso di Tomcat occorre specificare una posizione all'interno della sua cartella webapps, ad esempio C:\apachetomcat\webapps\Jug4Tenda sotto Windows o /home/myhome/tomcat/webapps/jug4tenda sotto Linux. Terminata l'installazione e riavviato il proprio application server il nome della cartella di deply dovrà essere aggiunto all'indirizzo di prova visto nel paragrafo per identificare Jug4Tenda. Sempre in base a quanto visto come esempio otterremo l'indirizzo web (attenzione alla differenza tra maiuscole e minuscole!). Premendo 'Avanti' ci viene mostrata una finestra riassuntiva delle scelte fatte. Premere nuovamente 'Avanti' per iniziare la copia dei file nella cartella precedentemente scelta: Immagine 19: Finestra riassuntiva che precede la copia dei file Andrea Del Bene Progetto Jug4Tenda 14 / 18

15 Terminata la copia dei file nella cartella di deploy è il momento di configurare la connessione al database di lavoro. Questa operazione è svolta nella finestra successiva che richiede all'utente i parametri necessari a stabilire una connessione con MySql e a creare o scegliere un database di lavoro. Immagine 20: La finestra di configurazione della connessione al database Oltre ai parametri per stabilire una connessione con il database (ossia 'Server URL', 'Porta', 'User name' e 'Password') ènecessario anche specificare il nome del database di lavoro che si intende utilizzare. Quest'ultimo può essere un database già esistente o un database creato sul momento. Questa scelta viene espressa con l'opzione 'Nuovo database'. Il pulsante 'Test' serve verificare la correttezza dei dati forniti per la connessione e si attiva solo quando vengono inseriti almeno 'Server URL', 'Porta', 'User name'. Il messaggio che si ottiene premendo 'Test' indica se i dati inseriti sono corretti o se non è stato possibile connettersi con MySql. Solo nel primo caso il pulsante 'Avanti' si attiverà permettendo all'utente di confermare i dati inseriti e di procedere con l'installazione: Andrea Del Bene Progetto Jug4Tenda 15 / 18

16 Immagine 21: L'esito positivo del test sui parametri di connessione Nel caso l'utente abbia indicato di creare un nuovo database (scegliendo l'opzione 'Nuovo database') l'installatore controllerà che su MySql non esista già un database con lo stesso nome notificando un eventuale conflitto tra il nome espresso per il nuovo database e quello di database già esistenti: Immagine 22: L'installatore avverte dell'esistenza del database specificato Analogamente se si sceglie di usare un database già esistente l'installatore controllerà l'effettiva esistenza di quest'ultimo: Andrea Del Bene Progetto Jug4Tenda 16 / 18

17 Immagine 23: L'installatore verifica l'esistenza del database indicato Una volta impostati i parametri di connessione corretti possiamo premere 'Avanti e terminare l'installazione premendo Fine nella finestra finale: Immagine 24: L'installazione è giunta al termine Termina l'installazione dobbiamo ricordarci di riavviare il nostro application server per poter utilizzare la nuova installazione di Jug4Tenda. Terminato la procedura di riavvio possiamo vedere la nostra applicazione aprendo il browser all'indirizzo (come spiegato nel passo precedente a pagina 14). Andrea Del Bene Progetto Jug4Tenda 17 / 18

18 Immagine 25: Home page di Jug4Tenda Andrea Del Bene Progetto Jug4Tenda 18 / 18