Manuale Installazione Manuale Installazione FlossLab s.r.l. Viale Elmas 142, 09122 Cagliari (Italy) Tel: +39 070 240149 Fax: +39 070 2128955 E-mail: [email protected] - Web: www.flosslab.it C.F./P.I. 03096510924 - REA 246140 1/6 Manuale Installazione Questo documento è distribuito secondo la licenza Creative Commons “Attribution-NonCommercial-ShareAlike 2.5 Italy“, disponibile all'indirizzo http://creativecommons.org/licenses/by-nc-sa/2.5/it/ 2/6 Manuale Installazione 1 SCOPO DEL DOCUMENTO Scopo del presente documento è quello di descrivere le principali azioni da seguire per una corretta installazione del sistema e-prot. 3/6 Manuale Installazione 2 INSTALLAZIONE 2.1 Descrizione pacchetto Il pacchetto di installazione di e-prot 2.0 è composto dai seguenti elementi: • eprot.war : web application • eprot.sql : database script • doc/eprot.xml: file di configurazione del database all'interno della webapp • doc/titolario-sample.xls: file esempio di titolario da importare 2.2 Pre-requisiti L'installazione di e-prot all'interno del server presuppone l'installazione e la corretta configurazione delle seguenti componenti Open Source: • PostgreSQL 8.x o 9.x • Java 1.6.x o 1.7.x • Apache Tomcat 6.x o 7.x • OpenOffice 3.x o 4.x (in alternativa LibreOffice 3.x o 4.x) 2.3 Installazione Database • Avviare postgres • Creare un utente eprot • Creare un database eprot con owner eprot • Avviare sul database eprot lo script eprot.sql (vedi paragrafo 2.1) 2.4 Installazione WebApp Nelle istruzioni seguenti sono state usate queste convenzioni: <tomcat>: root directory nella quale è stato installato Apache Tomcat <openoffice_path>: nome dell'eseguibile con cui viene avviato OpenOffice (o LibreOffice) • Copiare il file eprot.war (vedi paragrafo 2.1) in <tomcat>/webapps • Copiare il file eprot.xml in <tomcat>/conf/Catalina/localhost configurando i dati del database creato • Avviare openoffice in modalità server utilizzando la stringa • • <openoffice_command> "-accept=socket,host=localhost,port=8100;urp;StarOffice.ServiceManager" -nologo -headless Avviare tomcat 4/6 Manuale Installazione 2.5 • Stoppare tomcat (si crea una cartella eprot sotto <tomcat>/webapps) • Modificare il file <tomcat>/webapps/eprot/WEB-INF/classes/systemParams.properties inserendo i path relativi al proprio sistema • Inserire il driver di postgres sotto la cartella <TOMCAT_HOME>/lib se non presente • Avviare tomcat • Accedere tramite browser all'indirizzo http://<url_server_tomcat>:8080/eprot • Autenticarsi mediante credenziali: • username: admin • password: admin Configurazione systemParams.properties Per quanto riguarda la configurazione del file systemParams.properties di seguito la spiegazione del significato dei diversi parametri: • configuration_path = <tomcat_path>/webapps/eprot/WEB-INF/classes/systemParams.properties -> in questa voce deve sostituire <tomcat_path> con la directory corretta del tomcat su cui è installato e-prot • file_system_path_protocollo = <tomcat_path>/webapps/eprot/repos/ -> directory dove verranno inseriti i file relativi al protocollo • file_system_path_documentale = <tomcat_path>/webapps/eprot/repos/ -> directory dove verranno inseriti i file relativi al modulo documentale • file_system_index_path_protocollo = <tomcat_path>/webapps/eprot/index/ -> directory dove verranno inseriti i file relativi all'indicizzazione dei documenti di protocollo (utili alla ricerca full-text) • file_system_index_path_documentale = <tomcat_path>/webapps/eprot/indexDocumentale/ -> directory dove verranno inseriti i file relativi all'indicizzazione dei documenti del modulo documentale (utili alla ricerca full-text) • openoffice_host = <openoffice_host> -> ip o nome del server su cui è installato openoffice (presumibilmente lo stesso di e-prot, dunque va bene localhost) • openoffice_port = <openoffice_port> -> porta del servizio di openoffice (normalmente è la porta 8100) Di seguito un esempio di configurazione per server windows: configuration_path = c:\\Programmi\\Apache Foundation\\Tomcat 6.0\\webapps\\eprot\\WEB-INF\\classes\\systemParams.properties file_system_path_protocollo = c:\\Programmi\\Apache Foundation\\Tomcat 6.0\\webapps\\eprot\\repos file_system_path_documentale = c:\\Programmi\\Apache Foundation\\Tomcat 6.0\\webapps\\eprot\\repos file_system_index_path_protocollo = c:\\Programmi\\Apache Foundation\\Tomcat 6.0\\webapps\\eprot\\index file_system_index_path_documentale = c:\\Programmi\\Apache Foundation\\Tomcat 6.0\\webapps\\eprot\\indexDocumentale openoffice_host = localhost openoffice_port = 8100 2.6 Configurazione log4j-config.xml All'interno della webapp è presente un file di configurazione delle operazioni di logging applicativo (utili per 5/6 Manuale Installazione monitorare eventuali problematiche che si possono manifestare nella fase di installazione e di utilizzo). • Accedere al file <tomcat>/webapps/eprot/WEB-INF/classes/log4j-config.xml • Modificare i path relativi alle voci: • ERROR_DAILY • EVENT_DAILY • ERROR_DAILY_MIGRATION • EVENT_DAILY_MIGRATION Di default (ovvero senza la modifica del file) il sistema salva i file di log all'interno della HOME dell'utente con cui viene avviato tomcat. 3 CONFIGURAZIONE INIZIALE Di seguito vengono riportati gli step di configurazione applicativa minimali (per maggiori dettagli riferirsi al manuale utente): • Accedere al menu Amministrazione → Dati amministrazione e configurare il path documenti su una directory opportuna • Configurare la AOO • Creare eventuali uffici • Configurare il titolario (mediante import di un file xls, di cui è presente un esempio nel pacchetto in doc/titolario-sample.xls, oppure crearlo manualmente) • Creare un profilo di permessi • Creare gli utenti del sistema associandogli i permessi relativi agli uffici di afferenza 6/6