01/05/2013 Istruzioni per l installazione

Transcript

1 01/05/2013 Istruzioni per l installazione Il documento descrive le procedure rivolte a utenti esperti per l installazione del codice di ABCD SW su una macchina fisica che abbia funzioni di Server. Progetto Finanziato da:

2 ABCD Software Versione 1.0 Procedure per l installazione Sommario REQUISITI HARDWARE/SOFTWARE... 2 Requisiti hardware:... 2 Requisiti di rete:... 2 PROCEDURE... 0 Installazione di VirtualBox... 0 Installazione di ABCD SW... 0 Come far partire la macchina virtuale e usare ABCD SW... 1 RIEPILOGO CREDENZIALI... 6 IIT - CNR; ISTI - CNR; Univ. Pisa Pagina 1

3 REQUISITI HARDWARE/SOFTWARE L applicazione ABCD SW è un applicazione nata per essere fruita come applicazione web. La possibilità di scaricare il codice sorgente dell applicazione è stata pensata per permettere ad un utente esperto o comunità di utenti esperti (eventualmente presenti all interno di ASL, SCUOLE, ecc.) di poter allestire su una propria macchina fisica un server, visibile alla rete internet, con integrato ABCD SW (e gli ambienti ad esso collegati). A questo scopo viene reso disponibile un file con estensione.ova che rappresenta una macchina virtuale installabile su una macchina fisica dopo aver installato un applicazione free denominata VirtualBox reperibile in rete all indirizzo: Requisiti hardware: SISTEMA OPERATIVO: qualunque compatibile con VirtualBox Spazio libero sull HARD-DISK non inferiore a 8 Gb Memoria RAM non inferiore a 1024 Mb La macchina virtuale da installare richiede la connessione Internet per funzionare, perché ABCD SW è un applicazione Web. Requisiti di rete: Rete LAN Rete Wifi IIT - CNR; ISTI - CNR; Univ. Pisa Pagina 2

4 PROCEDURE Installazione di VirtualBox Una volta scaricato il file ABCD 1204LAMP.ova bisogna rendere operativa la macchina virtuale che esso rappresenta mediante la seguente procedura: 1. scaricare l applicativo VirtualBox dal link seguente (scegliendo il file più adatto alla propria macchina in base al sistema operativo attivo sulla stessa): NB: Il sistema operativo presente sulla macchina virtuale (Linux-Ubuntu) non influenza il sistema operativo presente sulla macchina fisica ma l applicazione VirtualBox deve essere scelta in base al sistema operativo presente sulla propria macchina FISICA non virtuale. 2. Lanciare il file eseguibile di VirtualBox e seguire le indicazioni per l installazione dell applicativo. Installazione di ABCD SW Una volta che VirtualBox è stato correttamente installato sulla propria macchina, l utente ha ora la possibilità di utilizzare il file ABCD 1204LAMP.ova. Per farlo, seguire la seguente procedura: Dall icona di VirtualBox (presumibilmente presente sul Desktop) lanciare il programma. Dalla schermata che si apre cliccare su File e poi su Importa Applicazione Virtuale per creare una nuova macchina virtuale usando il file scaricato, come mostrato nella finestra seguente: Nella finestra che si apre selezionare il bottone Apri applicazione virtuale che consente, tramite File System, la scelta del file ABCD 1204LAMP.ova precedentemente scaricato. Poi cliccare Avanti.

5 A questo punto la finestra riepiloga le caratteristiche hardware/software della nuova macchina virtuale. Se non ci sono particolari esigenze, lasciare le impostazioni così come sono. Poi premere Importa Come far partire la macchina virtuale e usare ABCD SW Una volta che la macchina virtuale è correttamente installata, bisogna accenderla premendo il tasto Avvia sull interfaccia di VirtualBox. Si aprirà una shell Linux (Ubuntu) che chiederà di fare il login. IIT - CNR; ISTI - CNR; Univ. Pisa Pagina 1

6 Usare le seguenti credenziali per il login sulla macchina: utente:cater2013abcd password:abcd2013 La macchina virtuale appena installata ed avviata rappresenta una macchina funzionante con sistema operativo Linux ospitata dalla propria macchina fisica. La macchina virtuale è dotata di un server LAMP (Linux/Apache/MySql/Php) Versione che gli permette di comportarsi come un Server. NB: all avvio della macchina virtuale rappresentante ABCD SW il software avvia le procedure di configurazione della rete internet in base al settaggio corrente della macchina. Se l utente ha necessità di far funzionare la macchina sia tramite LAN che tramite WiFi (non in contemporanea) occorre modificare volta per volta le impostazioni di rete dopo la procedura di import e prima dell avvio della macchina virtuale andando su Archiviazione - Rete Scheda1- Nome (nella finestra di VirtualBox) e scegliendo la scheda di Rete adatta. Come visibile nella figura seguente: IIT - CNR; ISTI - CNR; Univ. Pisa Pagina 2

7 Se la rete è stata correttamente configurata la macchina virtuale è visibile in rete tramite un indirizzo IP che le viene associato tramite DHCP. L indirizzo è estraibile usando il comando <ifconfig> sulla shell Linux. Questo indirizzo IP cambia ogni volta che la macchina viene accesa/spenta. Se si ha la possibilità di assegnare un indirizzo IP fisso contattando il proprio amministratore di Rete è buona norma farlo. Una volta che sia noto l indirizzo IP associato alla macchina usare questo indirizzo per localizzarla in rete e accedere ad ABCD SW. Sul proprio browser internet scrivere la url seguente: La prima schermata visibile sarà la pagina di login dalla quale si accede al SW come mostrato nella figura seguente: IIT - CNR; ISTI - CNR; Univ. Pisa Pagina 3

8 Al momento sono presenti sul SW, per comodità, 4 utenti standard ma se ne possono creare altri usando il link visibile sulla stessa pagina di login : Go to Registration Page dal quale è possibile scegliere un account attivando la generazione automatica della password che sarà inviata via (tramite il server di Posta virtuale installato sulla macchina virtuale) all indirizzo inserito. Sia lo username che la password potranno essere modificati come da indicazioni allegate alla . Gli utenti standard presenti sono i seguenti: Username: UtenteProva1 / password: UtenteProva1 con associato il bimbo: BimboProva1 Username: UtenteProva2 / password: UtenteProva2 con associato il bimbo: BimboProva2 Username: test/ password: test con associato il bimbo: bimbotest: AMMINISTRATORE: Username: admin / password: admin_admin Le credenziali indicate (escluse quelle di amministratore) sono quelle con cui si accede al software, vanno quindi usate nelle interfacce del software ABCD fino a ché non si creino altri account personali come detto sopra. Ognuno di questi utenti non ha dati associati perché non ha mai fatto sessioni al software, tranne l utente di test che è stato usato dal Team ABCD per fare i test di funzionamento della macchina virtuale. Le credenziali di amministratore permettono all utente esperto di gestire tutte le funzionalità dell ambiente di amministrazione, rappresentato da una installazione Drupal, presente sulla macchina virtuale, su cui il software ABCD si appoggia e raggiungibile dal link Access your Data presente sulla pagina di login. I dati raccolti durante l uso del software ABCD vengono salvati in un database MySQL anch esso integrato alla macchina virtuale. La gestione del Database, da parte di un utente esperto, è resa possibile dalla presenza (integrata nella macchina) di un tool (phpmyadmin) accessibile usando la seguente url: e con le seguenti credenziali: user: root password: abcd2013 L uso del software ABCD richiede preferibilmente un dispositivo tablet touchscreen nel quale il bambino svolge l esercizio. Anche questo dispositivo tablet accede all applicazione ABCD sincronizzandosi con essa tramite la rete internet. Come spiegato nel manuale utente di ABCD SW ( ogni tutor che lavori con il software deve crearsi un canale di accesso personale al software sulla home del dispositivo tramite icona (vedere pag. iv del manuale utente su indicato). In questo caso il link a cui collegarsi con il browser del proprio Tablet per la creazione di questo canale è il seguente: IIT - CNR; ISTI - CNR; Univ. Pisa Pagina 4

9 La schermata che si presenta richiederà le credenziali utente che sono quelle indicate a pagina 2 di questo documento. Salvando poi la pagina bianca (che si apre a quell indirizzo) sulla home del Tablet si genera una icona che d ora in poi rappresenterà il canale di accesso al software tramite Tablet. IIT - CNR; ISTI - CNR; Univ. Pisa Pagina 5

10 RIEPILOGO CREDENZIALI Credenziali accesso alla macchina virtuale: utente:cater2013abcd password:abcd2013 Credenziali di accesso al database MySql (per utente esperto): user: root password: abcd2013 Credenziali accesso ad ABCD SW: Username: UtenteProva1 / password: UtenteProva1 con associato il bimbo: BimboProva1 Username: UtenteProva2 / password: UtenteProva2 con associato il bimbo: BimboProva2 Username: test/ password: test con associato il bimbo: Credenziali accesso all ambiente di amministrazione di ABCD SW (non della macchina virtuale) come AMMINISTRATORE: Username: admin password: admin_admin (con underscore) IIT - CNR; ISTI - CNR; Univ. Pisa Pagina 6

11 IIT - CNR; ISTI - CNR; Univ. Pisa Pagina 7