Exchangefile 2.0 manuale utente Paolo Bison Claudio Cavaggion ISIB-CNR Rapporto Tecnico 02/12, ISIB-CNR Padova, Novembre 2012 ISIB-CNR Corso Stati Uniti 4 35100 Padova IT Versione 26/11/12 SOMMARIO Exchangefile è un servizio web, usufruibile attraverso un browser, di condivisione e scambio di file di grosse dimensioni per gli utenti dell'Area della Ricerca di Padova in possesso di credenziali di posta elettronica. Questo rapporto descrive le procedure utente per accedere e utilizzare il servizio. ABSTRACT Exchangefile is a web service to share and exchange files of large dimensions for the users of the Research Area of CNR in Padua. This report describes the operating procedures to access and use the service. 2 INDICE Generalità................................................................................................................ 4 Accesso al servizio....................................................................................................4 Uso del servizio........................................................................................................ 6 Login.......................................................................................................................................................... 6 Gestione workarea..................................................................................................................................... 9 Gestione file............................................................................................................................................... 9 upload....................................................................................................................................... 9 download................................................................................................................................ 10 cancellazione.......................................................................................................................... 10 invio link................................................................................................................................. 10 Gestione ospiti......................................................................................................................................... 10 Verifiche operative.................................................................................................10 Windows XP.............................................................................................................................................. 10 Windows 7................................................................................................................................................ 11 Windows 8................................................................................................................................................ 11 Fedora Core 16......................................................................................................................................... 11 Mac OS X Snow Leopard.......................................................................................................................... 11 Mac OS X Mountain Lion.......................................................................................................................... 11 APPENDICE A – Installazione di Java.........................................................................12 Generalità Exchangefile è un servizio web, usufruibile attraverso un browser, di condivisione e scambio di file di grosse dimensioni per gli utenti dell'Area della Ricerca di Padova in possesso di credenziali di posta elettronica. Ogni utente ha a disposizione un area disco su cui salvare i propri file che rimangono memorizzati per un periodo di tempo, allo scadere del quale vengono cancellati automaticamente. Funzionalità: • area disco divisibile in varie aree di lavoro • creazione di utenti ospiti associati ad un'area di lavoro, tali ospiti possono caricare e scaricare file ma non cancellarli • invio di un mail all'utente ed eventuali ospiti al termine del caricamento di un file con un link al file in modo da permettere il download diretto senza effettuare il login sul servizio • invio via email di un link per il download diretto di un file ad un qualunque indirizzo di posta elettronica • comunicazione crittografata mediante il protocollo SSL anche con accesso HTTP Per quanto riguarda la riservatezza relativa alle informazioni gestite dal servizio Exchangefile si deve notare che le comunicazioni tra il modulo utente e il server sono crittografate mediante il protocollo SSL, mentre i file memorizzati nel server non sono crittografati. Accesso al servizio Sul computer utente su cui sia stato installato il software desktop Java accedere con un browser ad una delle seguenti pagine: • http://exchangefile.pd.cnr.it • https://exchangefile.pd.cnr.it Inoltre, se si è installato sul computer utente il software JDK di Java, in aggiunta alla modalità browser o in alternativa se non funzionante, si può usare uno dei seguenti comandi che utilizzano la utility appletviewer: • Windows "C:\Program Files\java\jdk1.7.0_09\bin\appletviewer" JDjava.security.manager ^ JDjava.security.policy=http://exchangefile.pd.cnr.it/java.policy http://exchangefile.pd.cnr.it • Linux /usr/java/default/bin/appletviewer JDjava.security.manager \ JDjava.security.policy=http://exchangefile.pd.cnr.it/java.policy http://exchangefile.pd.cnr.it • Macintosh appletviewer JDjava.security.manager \ JDjava.security.policy=http://exchangefile.pd.cnr.it/java.policy http://exchangefile.pd.cnr.it Durante la fase di prima attivazione il browser potrebbe presentare una o più richieste di autorizzazione simili alla seguente: 4 Abilitare l'esecuzione per permettere al servizio di accedere al filesystem locale e se si vuole che non venga più richiesto abilitare la credibilità del certificato. 5 Uso del servizio Descrizione delle procedure per l'utilizzo del servizio exchangefile. Login Una volta attivato, il servizio visualizza la pagina di login dove si devono introdurre le proprie credenziali di posta elettronica (indirizzo email-password) se si è un utente dell'Area della Ricerca di Padova oppure le credenziali ricevute via mail se si è un ospite. Una volta verficata la correttezza delle credenziali introdotte, il servizio visualizza l'interfaccia utente che è leggermente diversa a seconda del tipo di utente (utente CNR o ospite) dato che un ospite ha delle limitazioni nell'uso del servizio (non può cancellare file o gestire ospiti). 6 Ad utente CNR viene mostrata la seguente interfaccia grafica con ovviamente valori diversi nelle tre liste che sono al primo login vuote: Tale interfaccia è essenzialmente divisa in quattro parti: • Intestazione per la visualizzazione dei dati relativi all'utente corrente e per il logout • gestione delle aree di lavoro 7 • gestione degli ospiti associati ad una area di lavoro • gestione dei file associati all'area di lavoro selezionata Ad un ospite viene mostrata la seguente interfaccia 8 dove appaiono solamente l'intestazione con i dati dell'ospite e la parte relativa alla gestione dei file contenuti all'area di lavoro a cui l'ospite è associato. L'ospite può solamente scaricare o caricare file. Non può cancellare file presenti nell'area di lavoro, ma può sovrascriverli. Gestione workarea La lista elenca il nome e l'identificativo numerico delle aree di lavoro disponibili mentre i due bottoni permettono di creare una nuova area e modificare/cancellare l'area selezionata nella lista. Per operare su un'area di lavoro si deve selezionarla sulla lista e i dati, ospiti e file, associati all'area selezionata verranno visualizzati nelle liste corrispondenti Gestione file La parte relativa alla gestione dei file visualizza le informazioni relative all'area di lavoro selezionata (nome, data di creazione e termine, tempo rimanente e quota disco diponibile) e l'elenco dei file memorizzati nell'area con i relativi bottoni per lo scaricamento, la cancellazione e l'invio di un link per lo scaricamento diretto. Il bottone “update file list” permette di aggiornare la lista dei file presenti nell'area di lavoro. upload Per caricare un file si può usare il pulsante “upload new file” che permette di caricare un unico file scelto attraverso un apposito dialogo, oppure si può utilizzare la tecnica del “drag & drop” scegliendo un insieme di file sul desktop e portandoli sull'area indicata dalla scritta. Quest'ultimo metodo permette di caricare un massimo di 10 file e non funziona sui sistemi macintosh. Al termine del caricamento il servizio invierà all'utente e agli ospiti associati all'area una mail contenente un link che permette di scaricare direttamente il file caricato senza la necessità di effettuare un login. Il link rimane attivo per 7 giorni dalla data del caricamento. 9 download Per scaricare un file utilizzare il bottone “DOWNLOAD” associato al file che aprirà un dialogo per scegliere il nome da utilizzare per salvare il file e la directory dove salvarlo. cancellazione Con il pulsante “DELETE” è possibile rimuovere un file dall'area di lavoro in cui risiede. Una volta dato l'OK al dialogo di conferma il file sarà cancellato e non sarà più possibile recuperarlo. I file vengono cancellati anche alla scadenza in maniera automatica senza alcuna richiesta o avviso all'utente CNR proprietario dei file. invio link Con il pulsante “INVIO LINK” è possibile inviare via email un link per il download diretto del file ad un qualunque indirizzo di posta elettronica permettendo al ricevente di scaricare il file senza la necessità di avere credenziali di accesso al servizio exchangefile. Il link rimane attivo per 7 giorni dalla data dell'invio. Gestione ospiti La parte relativa alla gestione degli ospiti associtai ad un'area di lavoro elenca i dati relativi agli ospiti esistenti (login, email, abilitazione all'acceso e data di scadenza) e permette di creare un nuovo ospite con il pulsante “NEW” e modificare/cancellare un ospite esistente con il pulsante”EDIT/DELETE”. All'atto della creazione un nuovo ospite riceverà vai email due messaggi contenenti il primo un messaggio di benvenuto con il nome di login, il secondo la password da utilizzare assieme al nome ricevuto precedentemente per accedere al servizio. Verifiche operative Data la notevole varietà di browser (IE Explorer, Firefox, Safari, Chrome) e di sistemi operativi (Windows, Linux, Mac OS) con le loro varianti a 32 e 64 bit sono stati fatti alcuni test per verificare il corretto funzionamento del software exchangefile. Windows XP SP 3 a 32bit con Java 1.7.0_09 e Explorer 8.0.6001.18702, Firefox 16.0.2/17.0 e Chrome 23.0.1271.64m Funzionante con tutti i browser elencati. 10 Windows 7 Versione a 64bit con Java 1.7.0_09 e Explorer 9.0.8112.6421, Firefox 16.0.2/17.0 e Chrome 23.0.1271.64m Funzionante con tutti i browser elencati. Windows 8 Release Preview 6.2.8400 a 32bit con Java 1.7.0_09 e Explorer 10 10.0.8400.0 Funziona in entrambi i modi (browser,appletviewer) ma solamente se in modalità desktop. Fedora Core 16 versione a 64bit con Java 1.7.0_07 e firefox 15.0.1 Funziona solamente in modalità appletviewer dato che non esiste il plugin java a 64 bit per firefox. Quello installato di default basato su IceTead genera un errore di protezione. Mac OS X Snow Leopard versione 10.6.8 con Java 1.6.0_37 e Safari 5.1.7 Funziona in entrambi in modi (browser,appletviewer) ma non funziona il metodo “drag & drop” per il caricamento dei file. Mac OS X Mountain Lion Versione 10.8.2 con Java 1.7.0 e Safari 6.0.2 Con il browser non funziona correttamente l'inserimento di dati via tastiera, mentre funziona utilizzando l'utility appletviewer 11 APPENDICE A – Installazione di Java Il software ExchangeFile è stato compilato con il software Java Version 6 Update 37 (javac 1.6.0_37) e dovrebbe funzionare anche con versioni successive di Java mentre non funziona con le versioni precedenti. Per installare il software Java per desktop utilizzare la pagina di download disponibile nel sito java http://www.java.com/it/download/ Una volta eseguita l'installazione verificarne il corretto funzionamento utilizzando il test disponibile al URL http://www.java.com/it/download/installed.jsp?detect=jre&try=1. Per l'esecuzione con la utility appletviewer si deve installare nel proprio computer il pacchetto software JDK di Java che contiene tale utility. Per sistemi Windows e Linux utilizzare il sito http://www.oracle.com/technetwork/java/javase/downloads/index.html per scaricare la versione relativa al sistema operativo utilizzato, mentre nei sistemi Mac non serve installare nessun pacchetto dato che tale utility è presente di default. 12