DonkeyCode. Manuale amministratore di sistema. Versione 1.0.0

Transcript

1 DonkeyCode RescueMe: globale per la gestione di catastrofi naturali Manuale amministratore di Versione Ingegneria Del Software AA

2 DonkeyCode - RescueMe Informazioni documento Titolo documento: Manuale amministratore di Data creazione: 22 Marzo 2011 Data rilascio: 25 Marzo 2011 Versione attuale: Utilizzo: Esterno Nome file: Manuale-amministratore-di pdf Redazione: Bonotto Sara Revisione: Malorgio Antonio Approvazione: Bonotto Sara Distribuito da: DonkeyCode Destinato a: Prof. Vardanega Tullio Miriade S.p.A. Sommario Il seguente documento ha lo scopo di illustrare come utilizzare le funzionalità messe a disposizione per l amministratore di dall applicazione RescueMe. Manuale amministratore di v1.0.0 I

3 DonkeyCode - RescueMe Registro delle modifiche Versione Data Persone coinvolte Descrizione Verificatore: Malorgio Antonio Approvatore: Bonotto Sara Redattore: Bonotto Sara Redattore: Malorgio Antonio Verificatore: Bonotto Sara Approvatore: Malorgio Antonio Redattore: Malorgio Antonio Verificatore: Vazzoler Raffaele Approvatore: Malorgio Antonio Verificatore: Sotomayor Jorge Approvatore: Tronchin Luca Redattore: Tronchin Luca Rilascio per revisione di progetto. Aggiunto capitolo consuntivo e pianificazione a finire. Modificata pianificazione con relativo gantt e tabella di rotazione dei ruoli. Aggiunto paragrafo Cambiamento pianificazione rispetto alla versione Correzioni degli errori emersi dalla Revisione dei Requisiti, aggiunta appendice A e successivo rilascio. Rilascio per revisione dei requisiti. Prima stesura documento. Manuale amministratore di v1.0.0 II

4 DonkeyCode - RescueMe INDICE Indice 1 Introduzione Scopo del documento Come leggere il manuale Definizione dell utente Reperibilità del manuale Come riportare problemi e malfunzionamenti Descrizione generale 3 3 Installazione dell applicazione Linux Mac OSX Windows Istruzioni per l uso Gestione delle autorità Creare un autorità Creare un amministratore di autorità Abilitare un autorità Disabilitare un autorità Visualizzazione indicatori sintetici Modifica password A Messaggi 10 A.1 Avvisi all amministratore di A.2 Messaggi d errore B Glossario 12 Manuale amministratore di v1.0.0 III

5 DonkeyCode - RescueMe 1 INTRODUZIONE 1 Introduzione 1.1 Scopo del documento Il documento illustra come l amministratore di deve utilizzare il RescueMe ([g]). Verranno descritte dettagliatamente le varie funzionalità messe a disposizione, ed il corretto utilizzo di queste. 1.2 Come leggere il manuale Il presente documento è strutturato in capitoli, ognuno dei quali affronta uno specifico tema: Capitolo 1: introduzione e informazioni generali sull applicazione web; Capitolo 2: descrizione generale dell applicazione web; Capitolo 3: istruzioni per l uso relative all amministratore di ; Appendice A: elenco e descrizione dei messaggi di errore; Appendice B: glossario dei termini incontrati all interno del presente documento contrassegnati con [g] a pedice. Per una maggiore chiarezza nella lettura le descrizioni delle operazioni disponibili saranno accompagnate da illustrazioni. 1.3 Definizione dell utente Il presente manuale è rivolto all amministratore di che si occupa di gestire le autorità. Come prerequisito il non richiede specifiche conoscenze a meno di una minima famigliarità con uno degli attuali browser [g], come Google Chrome r78498 [g] o superiore, Safari [g], Mozilla Firefox [g] o superiore, Opera [g] o superiore e Internet Explorer [g] 7 o superiore. 1.4 Reperibilità del manuale Il presente manuale è reperibile in formato pdf anche dall applicazione web tramite la voce Aiuto del menu. Manuale amministratore di v / 13

6 DonkeyCode - RescueMe 1 INTRODUZIONE Figura 1: Voce Aiuto del menu. 1.5 Come riportare problemi e malfunzionamenti È possibile comunicare problemi e malfunzionamenti del RescueMe inviando una mail all indirizzo donkeycode2010@gmail.com con oggetto Segnalazione anomalia e contenente le seguenti informazioni: nome e cognome del mittente; tipo di utente; data e ora in cui il problema si è verificato; informazioni sul browser utilizzato; risoluzione dello schermo qualora si trattasse di un anomalia grafica; descrizione dell anomalia riscontrata, dei messaggi d errore e delle eventuali operazioni che si stavano svolgendo prima del verificarsi del problema. Le segnalazioni saranno prese in considerazione il prima possibile e i problemi riscontrati saranno risolti al più presto dai membri del team DonkeyCode. Manuale amministratore di v / 13

7 DonkeyCode - RescueMe 2 DESCRIZIONE GENERALE 2 Descrizione generale Il progetto RescueMe si presenta all autorità come un applicazione web, il cui utilizzo non presenta particolari difficoltà. Tale sito è raggiungibile utilizzando un qualsiasi elaboratore connesso ad internet e munito di un browser qualsiasi. L applicazione web è raggiungibile all indirizzo internet rescueme-dc.appspot.com. Ogni pagina è composta da: Header: parte alta della pagina contente il nome del e il box di Login / Logout a seconda che l utente sia autenticato o meno; Path: posizionato sotto l Header serve per fornire all utente, in ogni momento della navigazione, la sua posizione; Menu: posizionato nella parte sinistra della pagina, serve per contenere un link alle varie viste che un utente può visualizzare. La sua composizione cambia a seconda dei privilegi posseduti dell utente che visualizza la pagina; Corpo: è la parte principale della vista ed occupa tutta la parte centrale. È la parte della pagina che cambia più frequentemente dato che i suoi cambiamenti sono legati alle operazioni richieste dall utente che sta utilizzando il. D ora in avanti si utilizzerà il termine vista per indicare il cambiamento di questa parte. Nel caso si volesse riferirsi al cambiamento di altre parti specifiche verrà indicato esplicitamente. Manuale amministratore di v / 13

8 DonkeyCode - RescueMe 3 INSTALLAZIONE DELL APPLICAZIONE 3 Installazione dell applicazione Di seguito vengono elencati i metodi per installare RescueMe su Appengine. I requisiti minimi per poter effettuare l installazione e utilizzare il sono i seguenti: Java Virtual Machine 6; Requisiti hardware dipendenti dal web browser utilizzato. 3.1 Linux È richiesto il gestore di finestre Gnome. Per installare RescueMe su App Engine è necessario utilizzare l SDK messo a disposizione da Google. La versione minima è la E possibile usare lo script automatico fornito con l applicazione eseguendo quest ultimo dalla shell di. Sul monitor saranno visualizzate le operazioni in esecuzione e i messaggi per inserire il path dell SDK. 3.2 Mac OSX 3.3 Windows Manuale amministratore di v / 13

9 DonkeyCode - RescueMe 4 ISTRUZIONI PER L USO 4 Istruzioni per l uso 4.1 Gestione delle autorità Nel presente capitolo sono spiegate le operazione a disposizione dell amministratore di che permettono la gestione delle autorità nel RescueMe Creare un autorità Figura 2: Modulo di creazione autorità. Selezionando la scheda Crea Autorità è possibile inserire nel una nuova autorità semplicemente dandole un nome. Il nome inserito deve essere significativo per indicare l autorità alla quale si riferisce. Una volta inserito il nome, cliccando sul pulsante Crea Autorità questa verrà inserita nel. È necessario associare successivamente un amministratore all autorita appena creata. Manuale amministratore di v / 13

10 DonkeyCode - RescueMe 4 ISTRUZIONI PER L USO Creare un amministratore di autorità Figura 3: Modulo di creazione amministratore di autorità. Selezionando la scheda Crea Amm. di Autorità è possibile inserire nel un nuovo amministratore di autorità. Questo deve essere necessariamente associato ad una autorità già presente nel, e deve essere fatto selezionandola dal menu a tendina Autorità associata. Per la creazione è necessario inoltre fornire lo username, in formato , e la password, di lunghezza compresa tra gli 8 e i 16 caratteri, del nuovo amministratore Abilitare un autorità Figura 4: Modulo per abilitare un autorità. Se l amministratore di ha disabilitato una autorità può riabilitarla selezionando la scheda Abilita Autorità. Selezionando quindi attraverso il menu a tendina Autorità da abilitare l autorità da abilitare e cliccando sul tasto Abilita quest ul- Manuale amministratore di v / 13

11 DonkeyCode - RescueMe 4 ISTRUZIONI PER L USO tima e i suoi amministratori verranno abilitati nel Disabilitare un autorità Figura 5: Modulo per disabilitare un autorità. Nel caso l amministratore di desideri disabilitare una autorità può farlo selezionando la scheda Disabilità Autorità. Selezionando quindi attraverso il menu a tendina Autorità da disabilitare l autorità da disabilitare e cliccando sul tasto Disabilita quest ultima e i suoi amministratori verranno disabilitati dal. Manuale amministratore di v / 13

12 DonkeyCode - RescueMe 4 ISTRUZIONI PER L USO 4.2 Visualizzazione indicatori sintetici Figura 6: Modulo delle statistiche. Selezionando la voce Statistiche dal menu principale viene visualizzato un menu a tendina, in cui è possibile scegliere una autorità attiva nel. Selezionata l autorità desiderata vengono mostrate le statistiche relative a quest ultima. Attraverso Manuale amministratore di v / 13

13 DonkeyCode - RescueMe 4 ISTRUZIONI PER L USO i grafici è possibile analizzare la distribuzione delle segnalazioni sulle catastrofi e le risorse impegate. 4.3 Modifica password Figura 7: Modulo di modifica password. Per modificare la password si può raggiungere l apposita form [g] cliccando sulla voce Modifica password del menu. Dopo aver inserito la vecchia password e la nuova si può salvare il cambiamento cliccando sul tasto salva. Manuale amministratore di v / 13

14 DonkeyCode - RescueMe A MESSAGGI A Messaggi A.1 Avvisi all amministratore di Messaggio Autenticazione fallita La nuova password non deve essere vuota La nuova passwor deve essere compresa tra 8 e 16 caratteri Password di conferma errata Password attuale errata Lo username non deve essere vuoto Lo username deve essere un indirizzo La password non deve essere vuota Selezionare un autorità da associare Selezionare un autorità da disabilitare Selezionare un autorità da abilitare Descrizione A.2 Messaggi d errore Codice Messaggio Descrizione RM02 Errore nell aggiornamento Viene visualizzato quando l amministratore di RM03 Errore nella disabilitazione Viene visualizzato quando l amministratore di RM04 Errore nell abilitazione Viene visualizzato quando l amministratore di RM05 Lo username inserito non è Viene visualizzato quando l amministratore di disponibile Manuale amministratore di v / 13

15 DonkeyCode - RescueMe A MESSAGGI Codice Messaggio Descrizione RM08 Elemento già esistente Viene visualizzato quando l amministratore di RMs01 Errore nella creazione Viene visualizzato quando l amministratore di Manuale amministratore di v / 13

16 DonkeyCode - RescueMe B GLOSSARIO B Glossario B Browser: programma che consente di navigare sul World Wide Web ed usufruire dei servizi di connettività appoggiandosi sui protocolli di rete forniti dal operativo e permettendo di visualizzare i contenuti delle pagine dei siti web e di interagire con essi. D Dialog box: tipo di finestra usata per abilitare la comunicazione reciproca tra l elaboratore e l utente. Essa può comunicare informazione all utente, attendere una risposta o entrambe. F Form: letteralmente modulo. Termine usato per indicare l interfaccia di un applicazione che consente all utente di inviare uno o più dati liberamente inseriti dallo stesso. G Google Chrome: browser [g] web sviluppato da Google. I Internet Explorer: browser web grafico sviluppato da Microsoft e incluso in Windows a partire dal Manuale amministratore di v / 13

17 DonkeyCode - RescueMe B GLOSSARIO M Mozilla Firefox: browser web open source multipiattaforma prodotto da Mozilla Foundation. Firefox attualmente è usato da più di un internauta su cinque a livello mondiale, ciò lo rende il secondo browser più popolare della rete. O Opera: browser web prodotto da Opera Software, disponibile per i sistemi operativi Windows, Macintosh, Linux e molti altri. È uno dei 10 browser più utilizzati. R RescueMe: globale per la gestione di catastrofi naturali in sviluppo. S Safari: browser web sviluppato da Apple Inc. per il operativo Mac OS X e successivamente anche per Windows. È fornito di default con Mac OS X dalla versione 10.3 (Panther). Manuale amministratore di v / 13