Manuale Installazione ToscaMobile

Transcript

1 Manuale Installazione ToscaMobile Presentato da: ToscaMobile_Manuale_Installazione_V1.0.2.docx 1 / 28

2 ToscaMobile Cliente Progetto Regione Toscana Colline Metallifere ToscaMobile Redatto da Pasquale Paola Data 12/01/2012 Verificato da Pasquale Russo Data 25/01/2012 Approvato da Data 25/01/2012 Stato Bozza Versione Pagine 28 Nome File ToscaMobile_Manuale_Installazione_V1.0.2.docx ToscaMobile_Manuale_Installazione_V1.0.2.docx 2 / 28

3 Storia del documento Versione Data Autore Cambiamenti apportati /01/2012 Pasquale Paola Stesura iniziale documento /04/2012 Pasquale Paola Inserimento gestione civici, dovuto ad un esplicita richiesta evolutiva del cliente /05/2012 Pasquale Paola Inserimento paragrafo relativo alla compatibilità del prodotto con Oracle Tabella 1: Storia del documento Riferimenti N Riferimento Reperibile in 1 EL_8A1a_Manuale_Installazione_MI_ACSOR_v1.5 Allegato al pacchetto installazione 2 FEDFIS_MI_ACSOR_FREE_Manuale Installazione.doc Allegato al pacchetto installazione 3 FEDFIS_MU_ACSOR_FREE_Manuale Configurazione.doc Allegato al pacchetto installazione 4 EL_Manuale_Installazione_MI_Portale Integrato Catasto e Fiscalità Locale_v1.2.doc Allegato al pacchetto installazione 5 EL_8A1a_Manuale_Utente_MU_amministrazione_utenti_v1.0.doc Allegato al pacchetto installazione 6 MO_Elisa_Sinapsi.doc Allegato al pacchetto installazione 7 FED-FIS_Manuale_Installazione_V1.3.4 (VisorACI+CartoSCI) Allegato al pacchetto di installazione 8 EL_8A3_8A4_8A5_8A7_Manuale_Installazione_MI_Modulo_Bonifi ca_v2.6 Tabella 2: Documentazione di riferimento Allegato al pacchetto di installazione ToscaMobile_Manuale_Installazione_V1.0.2.docx 3 / 28

4 INDICE GENERALE 1 INTRODUZIONE OBIETTIVI DEL DOCUMENTO STRUTTURA DEL DOCUMENTO TERMINI E DEFINIZIONI PREREQUISITI REQUISITI DI SISTEMA PER L INSTALLAZIONE DI TM REQUISITI APPLICATIVI PER L INSTALLAZIONE DI TM Pacchetti Software Applicativi Parametri, Credenziali AAA, url e path di installazione SW di base MATRICE DI COMPATIBILITÀ DI TM SKILL MINIMI RICHIESTI PER PROCEDERE CON L INSTALLAZIONE E CONFIGURAZIONE COMPONENTI OGGETTO DI INSTALLAZIONE E CONFIGURAZIONE DATABASE TOSCAMOBILE: CREAZIONE E CARICAMENTO CREAZIONE DATABASE POSTGRES POPOLAMENTO <SCHEMA_ELISA_MOBILE_GIS> Prerequisiti struttura tabelle Popolamento DB GESTIONE GEOSERVER INSTALLAZIONE E CONFIGURAZIONE WEB DI TOSCAMOBILE REST SERVICE CONFIGURAZIONE BUSINESS.PROPERTIES CONFIGURAZIONE CONF.PROPERTIES CONFIGURAZIONE GEODB-DS.XML INSTALLAZIONE DELLA WEB APPLICATION PER LA DISTRIBUZIONE DI TOSCAMOBILE INSTALLAZIONE BACKEND DI GESTIONE CREAZIONE DATABASE PER IL BACKEND DI GESTIONE CONFIGURAZIONE SINAPSI CONFIGURAZIONI NECESSARIE AL BACKEND DI GESTIONE Configurazioni acsor.properties Configurazione acsorejb.properties Configurazione log4j.xml Creazione e configurazione del file elisamobile-ds.xml CARICAMENTO DOCFA E PLANIMETRIE ToscaMobile_Manuale_Installazione_V1.0.2.docx 4 / 28

5 INDICE DELLE TABELLE Tabella 1: Storia del documento... 3 Tabella 2: Documentazione di riferimento... 3 Tabella 3: Termini e definizioni... 7 Tabella 4: Requisiti di sistema... 8 Tabella 5: Pacchetti Software Applicativi... 9 Tabella 6: Matrice di Compatibilità... 9 Tabella 7: Componenti oggetto di installazione e configurazione ToscaMobile_Manuale_Installazione_V1.0.2.docx 5 / 28

6 1 Introduzione 1.1 Obiettivi del documento Il presente documento ha l obiettivo di installare e configurare ToscaMobile a partire da un installazione versionata, funzionante e correttamente configurata del portale ACSOR. La versione del portale ACSOR è fondamentale e fa da driver per procedere nell installazione di ToscaMobile in quanto, questa, essendo un estensione di tale portale, non può prescinderne. In aggiunta, l ambito di installazione prevede due ambienti AS Application Server distinti. Per rendere il documento fluido e semplice da utilizzare, è stata prevista l installazione di ToscaMobile su un AS Tomcat-jboss mentre, per l installazione su JBoss, sono state inserite appositi box Struttura del documento Il presente documento è strutturato come segue: Capitolo 1 : Introduzione Capitolo 2 : Prerequisiti Capitolo 3 : Componenti oggetto di installazione e configurazione Capitolo 4 : Database ToscaMobile: Creazione e Caricamento Capitolo 5 : Gestione GeoServer Capitolo 6 : Installazione e configurazione WEB di ToscaMobile REST Service Capitolo 7 : Installazione della web application per la distribuzione di ToscaMobile Capitolo 8 : Installazione backend di gestione Capitolo 9 : Caricamento DOCFA e Planimetrie 1.3 Termini e definizioni Nella tabella riportata di seguito sono elencati gli acronimi e le definizioni adottate nel presente documento. Termine AAA ACI ACSOR AS BBOX DB Definizione Autenticazione (Authentication), controllo degli accessi (Authorization) e tracciamento del consumo delle risorse da parte degli utenti (Accounting) Anagrafe Comunale Immobili Anagrafe Comunale Soggetti Oggetti Relazioni Application Server Bounding Box - rappresenta i limiti di un'immagine georefernziata ossia i 4 estremi della zona geografica in cui ricade uno specifico Ente. Database 1 Sarà utilizzato il seguente simbolo: ToscaMobile_Manuale_Installazione_V1.0.2.docx 6 / 28

7 DBTL EPSG GUI J2EE PATH_TO_SERVER SHAPE SRID TM TBD UIU WMS <value> Database Territoriale Locale Rappresenta il comitato European Petroleum Survey Group che ha assegnato i codici per identificare in modo univoco i sistemi di riferimento geodetici adottati nelle varie realtà nazionali. Graphic User Interface Java 2 Enterprise Edition Path assoluto alla directory del server del portale ACSOR ESRI Shape file Spatial Reference System Identifier (SRID) ToscaMobile To Be Defined Unità Immobiliare Urbana Web Map Service Definisce un informazione parametrica Tabella 3: Termini e definizioni ToscaMobile_Manuale_Installazione_V1.0.2.docx 7 / 28

8 2 Prerequisiti ToscaMobile (da ora TM ) è una componente del portale ACSOR, per questo motivo il prerequisito fondamentale è la presenza di un installazione versionata funzionante di tale portale che comprenda le componenti TM. Pertanto, partendo dalla matrice di compatibilità, va recuperata la corretta versione degli eseguibili war del portale con al suo interno le componenti TM. In merito, per la Regione Toscana, i pacchetti di installazione saranno rilasciati sulla Piattaforma per lo Sviluppo e Rilascio di Componenti Software al link nell ambito del progetto denominato toscamobile. 2.1 Requisiti di sistema per l installazione di TM Nella seguente tabella sono elencati i requisiti di sistema necessari all installazione di TM. L installazione di tali componenti non è previsto all interno di questo manuale, per cui si rimanda alle relative documentazioni di riferimento. E importante recepire che il database di installazione è PostgreSQL/PostGIS. Descrizione Versione Url Requsiti Software di Base ACSOR Inserire documentazione di riferimento GeoServer PostgreSQL 8.4 e PostGIS ANT 1.8.x JDK 1.6.x Android SDK r18 GDAL 1.x IP Pubblico Il server di deploy deve essere pubblicamente raggiungibile. Tabella 4: Requisiti di sistema 2 Controllare la corretta installazione del GeoServer e delle librerie JAI. Le librerie JAI esistono solo per sistemi 32bit, per sistemi 64bit non è necessaria la loro installazione. 3 Per la corretta esecuzione degli script di creazione del database PostGIS visoraci è necessaria l esistenza di un template PostGIS denominato template_postgtis con ENCODING UTF8. Nel caso non esista, ma ce ne sia un altro denominato in modo differente (ma con stesso Encoding) sarà necessario clonarlo e assegnarli il nome template_postgis, nel caso in cui l encoding è differente bisognerà creare un nuovo db template avente l encoding richiesto. Supponendo che il DB GIS esistente si chiami postgis il comando per creare il template_postgis, è il seguente: psql U postgres W CREATE DATABASE template_postgis WITH TEMPLATE postgis; ToscaMobile_Manuale_Installazione_V1.0.2.docx 8 / 28

9 2.2 Requisiti Applicativi per l installazione di TM Pacchetti Software Applicativi I requisiti in termini di software applicativi minimi e necessari, per poter procedere all installazione di TM sono riportati nella tabella seguente: Pacchetti Software ACSOR (con componenti Visoraci) Profilazione Sinapsi e CAS WAR QREncoder WAR MobileRest Descrizione Versione Free o a licenza secondo la matrice di compatibilità di TM Script sql per la creazione e configurazione dell accesso a TM war QR creator war di installazione di TM Rest Services e relative librerie Tabella 5: Pacchetti Software Applicativi Nota Oracle DBMS Nel caso di installazione di ACSOR su banca dati Oracle, TM continua ad essere compatibile con il sistema, in quanto l'accesso alle informazioni avviene mediante l'utilizzo di servizi. Resta comunque il vincolo, che debba esistere una banca dat Postges/Postgis per la rappresentazione dei dati geografici Parametri, Credenziali AAA, url e path di installazione SW di base Prima di procedere con l installazione e configurazione di TM è necessario recuperare quanto segue: i parametri di collegamento e credenziali accesso DB ACSOR; i parametri di collegamento e credenziali accesso amministrativo DB Postgres, dove sarà creato il database TM; le URL e le credenziali accesso al GeoServer (utente amministratore); il Path assoluto alla directory del server del portale ACSOR (di seguito PATH_TO_SERVER). 2.3 Matrice di compatibilità di TM La seguente tabella riporta una sintesi delle versioni del SW applicativo con cui TM è compatibile ed installabile. Descrizione ACSOR Free Tabella 6: Matrice di Compatibilità Versione Unica versione ToscaMobile_Manuale_Installazione_V1.0.2.docx 9 / 28

10 2.4 Skill minimi richiesti per procedere con l installazione e configurazione Il presente manuale è rivolto ad un utente che abbia forti conoscenze informatiche nell ambito delle installazioni di sistemi unix/linux, applicazioni web, database Postgres/Postgis, competenze in ambito GIS e relativi strumenti. ToscaMobile_Manuale_Installazione_V1.0.2.docx 10 / 28

11 3 Componenti oggetto di installazione e configurazione Di seguito sono indicati tutti i componenti che saranno installati e configurati con l ausilio del presente Manuale. Descrizione DB PostGIS ToscaMobile Caricamento Dati Installazione Componente Web ToscaMobile REST Service Installazione della web application per la distribuzione di ToscaMobile Installazione BACKEND di Gestione Caricamento DOCFA e Planimetrie Obiettivo Creazione e Configurazione del DB Popolamento del Database Modalità di Deploy del WAR Modalità di Deploy del WAR Modalità di Deploy dei WAR e JAR Modalità di conversione di specifici dati Tabella 7: Componenti oggetto di installazione e configurazione ToscaMobile_Manuale_Installazione_V1.0.2.docx 11 / 28

12 4 Database ToscaMobile: Creazione e Caricamento E bene ricordare che per procedere con l installazione e la configurazione del DB, vanno acquisiti tutti i riferimenti applicativi e di sistema esplicitati nel paragrafo 2-Prerequisiti. 4.1 Creazione database Postgres Appurato ciò, gli script per l installazione di ToscaMobile su Postgres, prevedono la creazione di un database <SCHEMA_ELISA_MOBILE_GIS>. A tale fine, va eseguita la connessione al database di postgres attraverso il client psql: psql -U postgres -p <porta_postgres> -W Una volta connessi bisogna creare l utente <USER_ELISA_MOBILE_GIS> con il seguente comando: CREATE ROLE <USER_ELISA_MOBILE_GIS> LOGIN PASSWORD '<PASSWORD_ELISA_MOBILE_GIS>' NOSUPERUSER NOINHERIT NOCREATEDB NOCREATEROLE; Ora creiamo il database <SCHEMA_ELISA_MOBILE_GIS> CREATE DATABASE <SCHEMA_ELISA_MOBILE_GIS> WITH OWNER = postgres ENCODING = 'UTF8' TABLESPACE = pg_default LC_COLLATE = 'en_us.utf-8' TEMPLATE=template_postgis LC_CTYPE = 'en_us.utf-8' CONNECTION LIMIT = -1; GRANT CONNECT, TEMPORARY ON DATABASE <SCHEMA_ELISA_MOBILE_GIS> TO public; GRANT ALL ON DATABASE <SCHEMA_ELISA_MOBILE_GIS> TO postgres; GRANT CONNECT ON DATABASE <SCHEMA_ELISA_MOBILE_GIS> TO <USER_ELISA_MOBILE_GIS>; 4.2 Popolamento <SCHEMA_ELISA_MOBILE_GIS> Prerequisiti struttura tabelle E importante precisare che il dato geometrico sia disponibile in WGS84 ed in formato SHP (Esri Shape). Pertanto, tale dato deve necessariamente possedere anche i riferimenti alla terna catastale (oltre che alla geometria). ToscaMobile_Manuale_Installazione_V1.0.2.docx 12 / 28

13 Tabelle e Layer informativi indispensabili per funzionamento di TM I layer informativi necessari a ToscaMobile sono i seguenti: 1. fabbricati per i Fabbricati (dalla tabella del DBTL S3_CT28G_CAMPITURE, nel caso si disponesse di un DBTL in WGS84); 2. particelle per i Terreni (dalla tabella del DBTL S3_CT24G_PARTICELLE, nel caso si disponesse di un DBTL in WGS84); 3. civici per i Civici forniti da ITER-NET in WGS Lista Tabelle DBTL in formato shp e relativa struttura dati Di seguito si riporta la lista delle tabelle del DBTL Oracle, la cui struttura dati, è vincolante ai fini del corretto popolamento del DB dai JOB. Fabbricati Nome tabella CT28_COD_COM CT28_SEZ CT28_FOGLIO CT28_NUMERO CT28_ALLEGATO CT28_SVILUPPO CT28_GEOMETRIA CT28_PROT_ULTIMO_AGG CT28_OBJECT_ID S3_CT28G_CAMPITURE Particelle Nome tabella CT24_COD_COM CT24_SEZ CT24_FOGLIO CT24_NUMERO CT24_ALLEGATO CT24_SVILUPPO CT24_AREA CT24_GEOMETRIA CT24_PROT_ULTIMO_AGG CT24_OBJECT_ID S3_CT24G_PARTICELLE Lista SHAPE datapack ITER-NET E stata prevista l acquisizione di SHAPE dal datapack ITER-NET, per i seguenti strati informativi: 1. CIVICI a. NUMERO_CIVICO ToscaMobile_Manuale_Installazione_V1.0.2.docx 13 / 28

14 Di seguito il contenuto del datapack ITER-NET da cui mancano i file PRJ i quali sono utili per la verifica della corretta ripropiezione del dato geometrico (EPSG:4326): ELEMENTO_STRADALE.shp (non oggetto di caricamento) ELEMENTO_STRADALE.shx (non oggetto di caricamento) ELEMENTO_STRADALE.dbf (non oggetto di caricamento) GIUNZIONE_STRADALE.dbf (non oggetto di caricamento) GIUNZIONE_STRADALE.shp (non oggetto di caricamento) GIUNZIONE_STRADALE.shx (non oggetto di caricamento) LIMITE_COMUNALE.dbf (non oggetto di caricamento) LIMITE_COMUNALE.shp (non oggetto di caricamento) LIMITE_COMUNALE.shx (non oggetto di caricamento) ACCESSO.dbf ACCESSO.shp ACCESSO.shx NUMERO_CIVICO.dbf TOPONIMO_STRADALE.dbf Nel datapack descritto le geometrie di interesse sono quelle contenute dal file ACCESSO, prima di essere trasferite, devono essere fuse con le feature contenute in NUMERO_CIVICO e TOPONIMO_STRADALE per avere un informazione sul civico consistente, di seguito un esempio di fusione, in due passi operativi: 1. ogr2ogr -update -append -sql "select * from ACCESSO acc LEFT JOIN 'NUMERO_CIVICO.dbf'.NUMERO_CIVICO num on acc.cod_acc=num.cod_acc_es" -f "ESRI ShapeFile" <temp.shp> ACCESSO.shp 2. ogr2ogr -update -append -sql "select civ.num_civ as NUM_CIV,top.COD_DUG as COD_DUG,top.DEN_UFF as DEN_UFF,top.COD_VIA as COD_VIA,civ.COD_COM as COD_COM from temp civ LEFT JOIN 'TOPONIMO_STRADALE.dbf'.TOPONIMO_STRADALE top on civ.cod_top=top.cod_top" -f "ESRI ShapeFile" <civici.shp> <temp.shp> Con questi due comandi è stato generato lo shape dei civici (civici.shp,.dbf, ) che sarà utilizzato per il popolamento del db Popolamento DB Dati fondamentali Supponiamo che il nostro file di input per la tabella fabbricati si chiami campiture.shp. Essendoci installato postgis, avremo a disposizione il comando shp2pgsql: A questo punto, digitiamo il comando: shp2pgsql -c -s i -I campiture.shp fabbricati > fabbricati.sql Verrà prodotto il file fabbricati.sql che dovrà essere passato in input al client di postgres in questo modo: ToscaMobile_Manuale_Installazione_V1.0.2.docx 14 / 28

15 psql U <USER_ELISA_MOBILE_GIS> p <PORTA_SERVER_POSTGRES> W f fabbricati.sql <SCHEMA_ELISA_MOBILE_GIS> La stessa procedura viene applicata per gli shape delle particelle (cc.dd. Terreni) e dei civici forniti dal datapack ITER-NET Dati costruiti a partire dai dati fondamentali Una volta create le tabelle fabbricati, particelle e civici è possibile proseguire con la creazione della tabella SATELLITI_CIVICI di cui si fornisce lo script satelliti_civici.sql. Recuperato tale script, bisogna lanciare il seguente comando: psql U <USER_ELISA_MOBILE_GIS> p <PORTA_SERVER_POSTGRES> W f satelliti_civici.sql <SCHEMA_ELISA_MOBILE_GIS> Una volta creata la tabella SATELLITI_CIVICI, bisogna procedere con un primo popolamento della suddetta, che avviene in due distinte fasi operative Prima fase La prima fase prevede la copia dei dati della tabella civici nella nuova tabella SATELLITI_CIVICI utilizzando il seguente comando SQL. N.B.: Il campo COD_COM contrassegnato con 4 asterischi, va sostituito con il codice belfiore del comune. Il popolamento per copia necessita che vengano riempite le colonne: "NUMCIV", "VIADL", "NOMEVIADL", "CODVIA5", "GEOMETRIA", "COD_COM" altrimenti è impossibile passare alla seconda fase del popolamento di questa sezione del DB. insert into "SATELLITI_CIVICI" ("NUMCIV", "VIADL", "NOMEVIADL", "CODVIA5", "GEOMETRIA","COD_COM") SELECT cast("num_civ" AS double precision), "COD_DUG" "DEN_UFF", "COD_DUG" "DEN_UFF", cast("cod_via" as integer), the_geom, '****' as COD_COM FROM <civici>; Bisogna prestare attenzione nell identificare i campi dalla tabella civici in maniera precisa in modo da copiarli correttamente nella tabella SATELLITI_CIVICI. Nell esempio riportato infatti si fa riferimento ad uno standard ITER-NET della nomenclatura, ma non è detto che il file shp che produce civici.sql sia fedele a questa nomenclatura. Ciò che è certo, è che la tabella di destinazione il cui script di creazione viene fornito, come già detto (satelliti_civici.sql), avrà sicuramente la struttura riportata di seguito: SATELLITI_CIVICI "GID" "ESPONENTIC" "NUMCIV" "VIADL" ToscaMobile_Manuale_Installazione_V1.0.2.docx 15 / 28

16 "NOMEVIADL" "CODVIA5" "DESCRIZIONE" "PRESENTE_IN_ACI" "ANAGRAFE_IMPRESE" "ANAGRAFE_POPOLAZIONE" "ANAGRAFE_TRIBUTARIA" "BONIFICI_DA_RISTRUTT" "NUMERO_UIU" "CONTRATTI_LOCAZIONE" "NUMERO_RESIDENTI" "LICENZE_COMMERCIALI" "PROCEDIMENTI_EDILIZI" "SUCCESSIONI" "TARIFFE_IGIENE_AMBIENTALE" "UTENZE_ELETTRICHE" "UTENZE_GAS" "UTENZE_ACQUA" "TRIBUTI_ICI" "TRIBUTI_TARSU" "PERCENT_PAGAMENTI_UTENZE_ELETTRICHE" "PERCENT_PAGAMENTI_UTENZE_GAS" "PERCENT_PAGAMENTI_UTENZE_ACQUA" "PERCENT_PAGAMENTI_ICI" "PERCENT_PAGAMENTI_TARSU" "NON_PAGANTI_UTENZE_ELETTRICHE" "NON_PAGANTI_UTENZE_GAS" "NON_PAGANTI_UTENZE_ACQUA" "NON_PAGANTI_ICI" "NON_PAGANTI_TARSU" "ULTIMO_AGG" "GEOMETRIA" "COD_COM" Seconda fase Una volta ottenuta una tabella SATELLITI_CIVICI opportunamente prepolata, è possibile lanciare il VisoraciDataImporter, il quale provvederà al completamento della popolazione della tabella di SATELLITI_CIVICI, prendendo i dati da ACSOR. Nel pacchetto di installazione rilasciato è presente anche il file importer.zip. Una volta decompresso, in una cartella bisogna editare il file VISORACI.properties (ne è presente uno di esempio nella cartella F551), che ha la seguente struttura: tipo_database_visoraci=postgres #tipo_database_visoraci=oracle ToscaMobile_Manuale_Installazione_V1.0.2.docx 16 / 28

17 #DATI CONNESSIONE ACSOR acsorurl= jdbc:postgresql://<ip_server_postgres>:<porta_server_postgres>/<schema_acsor> acsordriver=org.postgresql.driver acsorutentedb=<user_acsor> acsorpassworddb=<password_acsor> #DATI CONNESSIONE TOSCAMOBILE visoraciurl= jdbc:postgresql://<ip_server_postgres>:<porta_server_postgres>/<schema_elisa_m OBILE_GIS> visoracidriver=org.postgresql.driver visoraciutentedb=<user_elisa_mobile_gis> visoracipassworddb=<password_elisa_mobile_gis> VisoraciHost=<IP_SERVER_POSTGRES> VisoraciPort=<PORTA_SERVER_POSTGRES> VisoraciDB=<SCHEMA_ELISA_MOBILE_GIS> VisoraciUser=<USER_ELISA_MOBILE_GIS> VisoraciPswd=<PASSWORD_ELISA_MOBILE_GIS> VisoraciOraSID= Tale file va opportunamente configurato in modo che, da un lato punti al DB di ACSOR e dall altro al DB di ToscaMobile. Una volta modificato tale file di configurazione, bisogna posizionarsi, da shell, all interno della directory che contiene il file vdi.jar e lanciare lo stesso nel seguente modo (bisogna sostituire i quattro asterischi con il codice belfiore dell Ente specifico): java -jar vdi.jar -sc -l -ENTE:**** -PT:/path/al/file/di/properties ToscaMobile_Manuale_Installazione_V1.0.2.docx 17 / 28

18 5 Gestione GeoServer Per la gestione e la configurazione dei layer di GeoServer si fa riferimento al manuale di Visoraci+Cartosci (Rif: Tabella 2). ToscaMobile_Manuale_Installazione_V1.0.2.docx 18 / 28

19 6 Installazione e configurazione WEB di ToscaMobile REST Service Acquisiti i requisiti di cui ai paragrafi precedenti, si procede con l installazione e configurazione di TM. Nello specifico la configurazione della parte Web comprende: configurazione del file business.properties, all interno di ToscaMobile REST Service; configurazione conf.properties all interno del file ElisaMobilex.x.x.apk. Nel pacchetto di installazione di TM, vi sono i file elisa-mobile-services.zip ed ElisaMobilex.x.x.apk che rappresentano rispettivamente la web application ToscaMobile REST Service e l applicazione per Android(3.x). La web application va esplosa e copiata all interno del percorso PATH_TO_SERVER/webapps/ mentre il file ElisaMobilex.x.x.apk va copiato nel percorso PATH_TO_SERVER/webapps/ROOT/. Procediamo quindi, rispettivamente, con le configurazioni dei due artefatti. 6.1 Configurazione business.properties Nel file PATH_TO_SERVER/webapps/elisa-mobile-services/WEB-INF/classes/business.properties controllare che ci siano le seguenti righe. Properties server.name apk.name Valore <INDIRIZZO>:<PORTA> <Nome_file.apk> pathdocfa <PATH_ASSOLUTO_ALLA_CARTELLA_DEI_DOCFA> 4 fileextension driver url user password zip org.postgresql.driver jdbc:postgresql://<ip_server_postgres>: <PORTA_SERVER_POSTGRES>/<SCHEMA_ELISA_MOBILE> 5 pman pman max.query.result 100 ente postgis.datasource postgis.fabbricatitable postgis.fabbricatitable.foglio postgis.terrenitable.numero postgis.fabbricatitable.sezione <CODICE_ENTE> java:jdbc/geodb <NOME_TABELLA_FABBRICATI> <NOME_COLONNA_FOGLIO_FABBRICATI> <NOME_COLONNA_NUMERO_FABBRICATI> 4 Per la creazione di DOCFA compatibili si rimanda al capitolo 9 Caricamento DOCFA e Planimetrie. 5 La creazione dello <SCHEMA_ELISA_MOBILE> che è diverso dallo <SCHEMA_ELISA_MOBILE_GIS>, viene spiegato nel capitolo 8 Installazione backend di gestione ToscaMobile_Manuale_Installazione_V1.0.2.docx 19 / 28

20 postgis.fabbricatitable.geometria postgis.terrenitable postgis.terrenitable.foglio postgis.terrenitable.numero postgis.terrenitable.sezione postgis.terrenitable.geometria postgis.satellitecivici_table postgis.satellitecivici_table.geometria postgis.satellitecivici_table.nomevia postgis.satellitecivici_table.numciv postgis.satellitecivici_table.licenzecomm postgis.satellitecivici_table.numres postgis.satellitecivici_table.numuiu postgis.satellitecivici_table.contrattiloc postgis.satellitecivici_table.codicevia <NOME_COLONNA_GEOMETRIA_FABBRICATI> <NOME_TABELLA_PARTICELLE> <NOME_COLONNA_FOGLIO_PARTICELLE> <NOME_COLONNA_NUMERO_PARTICELLE> <NOME_COLONNA_GEOMETRIA_PARTICELLE> SATELLITI_CIVICI GEOMETRIA NOMEVIADL NUMCIV LICENZE_COMMERCIALI NUMERO_RESIDENTI NUMERO_UIU CONTRATTI_LOCAZIONE CODVIA5 Nota JBoss La directory in cui copiare i war o esplodere i.zip delle applicazioni è SERVER_JBOSS/server/default/deploy. 6.2 Configurazione conf.properties All interno del progetto ElisaMobile, nel percorso /res/raw/ vi è il file conf.properties con al seguente struttura: Properties geoserver.url rest.url layer.fabbricati layer.terreni layer.terreni.geometryfeaturename layer.fabbricati.geometryfeaturename layer.terreni.foglio layer.terreni.numero layer.fabbricati.foglio layer.fabbricati.numero layer.fabbricati.selectionstyle layer.terreni.selectionstyle Valore <GEOSERVER_WORKSPACE>:<LAYER_NAME> <GEOSERVER_WORKSPACE>:<LAYER_NAME> <GEOMETRY_FEATURE_NAME> <GEOMETRY_FEATURE_NAME> <GEOSERVER_WORKSPACE>:<FEATURE_NAME> <GEOSERVER_WORKSPACE>:<FEATURE_NAME> <GEOSERVER_WORKSPACE>:<FEATURE_NAME> <GEOSERVER_WORKSPACE>:<FEATURE_NAME> polygon polygon ToscaMobile_Manuale_Installazione_V1.0.2.docx 20 / 28

21 center.longitude center.latitude epsg.code elisa.codente rest.loginpath rest.login.link rest.login.param.login rest.login.param.password rest.login.param.link <LONGITUDINE_DEL_CENTRO> <LATITUDINE_DEL_CENTRO> EPSG:<CODICE_PROIEZIONE> <CODICE_ENTE> /login/auth/login user pass link rest.login.param.timeschedulegps rest.param.token rest.param.ente rest.searchsoggetto.filtro rest.searchoggetto.filtro rest.caricarelazioni rest.anagrafe.nucleo.familiare rest.redditi.dati.dichiarazione rest.tributi.indicatori.ici rest.tributi.indicatori.versamenti.ici rest.tributi.dichiarazioni.ici rest.tributi.versamenti.ici rest.isauthorized rest.logout rest.listattivita rest.listattivita.stato rest.listattivita.presaincarico rest.listattivita.trasmesso rest.listattivita.crea.segnalazione rest.listattivita.salvanota rest.listattivita.salvanota.upload rest.categoria.note.list rest.get.oggetto rest.get.soggetto rest.searchoggetto.fabbricato rest.searchoggetto.terreno rest.searchoggetto.ternacatstale rest.searchoggetto.ternacatstale.param.foglio rest.searchoggetto.ternacatstale.param.numero rest.searchoggetto.ternacatstale.param.sezione rest.searchoggetto.ternacatstale.param.isfabbricato rest.docfa.list rest.docfa.file rest.gestionedispositivo token ente filtro filtro /mobile/rels /mobile/anagrafe/getnucleofamiliare /mobile/dichiarazioni/getdatidichiarazione /mobile/tributi/getindicatoriici /mobile/tributi/getindicatoriversamentiici /mobile/tributi/getdichiarazioniici /mobile/tributi/getversamentiici /login/auth/token/ /login/auth/logout/ /mobile/attivita/lista /mobile/attivita/lista/stato /mobile/attivita/presaincaricorl /mobile/attivita/trasmessoalbackoffice /mobile/attivita/creasegnalazione /mobile/attivita/salvanota /mobile/attivita/upload /mobile/attivita/categorienote /mobile/oggetto /mobile/soggetto /mobile/oggetto/filtro/f /mobile/oggetto/filtro/t /mobile/service/getcentroidebyfoglioenumero foglio numero sezione isfabbricato /mobile/docfa/lista /mobile/docfa/file /mobile/dispositivo/refreshpos ToscaMobile_Manuale_Installazione_V1.0.2.docx 21 / 28

22 rest.gestionedispositivo.longitude rest.gestionedispositivo.latitude rest.gestionedispositivo.srid rest.docfa.listparam rest.docfa.fileparam rest.ar.aroundme rest.ar.aroundme.civici longitudine latitudine epsg docfa name /mobile/augmentedreality/aroundme /mobile/augmentedreality/aroundmecivici rest.ar.param.lat latitude rest.ar.param.long longitude rest.ar.param.buffer buffer rest.ar.param.srid srid rest.ar.param.sridvalue <CODICE_PROIEZIONE> bbox.llx <COORDINATA_X_LOWER_LEFT_BBOX> bbox.lly <COORDINATA_Y_LOWER_LEFT_BBOX> bbox.urx <COORDINATA_X_UPPER_RIGHT_BBOX> bbox.ury <COORDINATA_Y_UPPER_RIGHT_BBOX> bbox.searchresult 3 Una volta completata la personalizzazione del progetto bisogna ricompilare il progetto per avere un pacchetto del tipo ElisaMobile.apk che conterrà l applicazione installabile: per farlo posizionarsi sulla root del progetto ElisaMobile editare il file local.properties in modo che punti alla directory del sdk android corretta; di seguito il contenuto di local.properties: sdk.dir=<path_assoluto_android_sdk> Quindi lanciare il comando: ant release Durante il processo di compilazione verrà richiesto l inserimento della password del keystore (ElisaMobile.key contenuto nel progetto), digitare engineering25, come da esempio: -release-prompt-for-password: [input] Please enter keystore password (store:./elisamobilekey): engineering25 in seguito verrà richiesto la password per l alias elisamobile, ridigitiamo engineering25, come da esempio: -release-prompt-for-password: [input] Please enter keystore password (store:./elisamobilekey): engineering25 [input] Please enter password for alias 'elisamobile': engineering25 ToscaMobile_Manuale_Installazione_V1.0.2.docx 22 / 28

23 Terminata la compilazione sotto la directory bin del progetto troveremo il file.apk ElisaMobilerelease.apk, pronto per essere installato e rinominato (al momento della scrittura della guida il renaming corretto è ElisaMobile1.0.1.apk). 6.3 Configurazione geodb-ds.xml Di seguito viene riportata la struttura di esempio del Datasource del DB Geografico. <?xml version="1.0"?> <datasources> <local-tx-datasource> <jndi-name>jdbc/geodb</jndi-name> <driver-class>org.postgis.driverwrapper</driver-class> <connection-url> jdbc:postgresql://<ip_server_postgres>:<porta_server_postgres>/<schema_elisa_mobile_gis> </connection-url> <user-name><user_elisa_mobile_gis></user-name> <password><password_elisa_mobile_gis></password> <min-pool-size>10</min-pool-size> <max-pool-size>20</max-pool-size> </local-tx-datasource> </datasources> ToscaMobile_Manuale_Installazione_V1.0.2.docx 23 / 28

24 7 Installazione della web application per la distribuzione di ToscaMobile Nel pacchetto di installazione di TM, vi è il file QREncoder.war che va copiato in PATH_TO_SERVER/webapps/. Questi, non necessita di ulteriori configurazioni. Nota JBoss La directory in cui copiare i war o esplodere i.zip delle applicazioni è SERVER_JBOSS/server/default/deploy. ToscaMobile_Manuale_Installazione_V1.0.2.docx 24 / 28

25 8 Installazione backend di gestione ToscaMobile possiede una pannello di amministrazione che si integra all interno del Portale ACSOR. Per installarlo bisogna innanzitutto avere a disposizione un installazione correttamente funzionante di ACSOR; appurato quest aspetto è possibile sostituire i war ed i jar di ACSOR con quelli prodotti da ToscaMobile per ACSOR (N.B.: la compilazione di ToscaMobile produrrà un acsor.war ed un acsor-service-ejb.jar, che vanno sovrascritti a quelli già utilizzati nell installazione di ACSOR). 8.1 Creazione database per il backend di gestione L applicazione in oggetto ha bisogno di un ulteriore schema che precedentemente abbiamo chiamato <SCHEMA_ELISA_MOBILE>. Con lo script di creazione dello schema nel file elisamobile.sql verrà creato sia l utente elisamobile che lo schema elisamobile ; gli script devono essere lanciati all interno del database di ACSOR. I nomi e gli utenti degli script sono ovviamente indicativi. 8.2 Configurazione Sinapsi E necessario istruire sinapsi con dei nuovi permessi, per garantire l accesso alle nuove risorse installate. Insieme a questo manuale è presente lo script Configurazione sinapsi.sql, che deve essere lanciato sul database di sinapsi, già installato con ACSOR. 8.3 Configurazioni necessarie al backend di gestione Inoltre bisogna apportare le seguenti modifiche solo a questi file di configurazione: acsor.properties acsorejb.properties log4j.xml elisamobile-ds.xml Configurazioni acsor.properties Di seguito le modifiche da apportare al file acsor.properties: # #Gestione caricamento dei menu' # acsor.plugins.menu = \ webbean.plugins.bonifica.bonificamenu,webbean.plugins.spagobi.spagobimenu,\ webbean.plugins.sportello.catastale.sportellocatastalemenu,\ webbean.plugins.statistiche.statistichemenu,webbean.plugins.admin.infomenu,\ webbean.plugins.elisamobile.elisamobilemenu ToscaMobile_Manuale_Installazione_V1.0.2.docx 25 / 28

26 acsor.entities.beans = it.eng.elisamobile.entity.elisamobileentity #Se ci sono già voci presenti, devono essere separate da virgola Configurazione acsorejb.properties Verificare la presenza nel file acsorejb.properties delle seguenti proprietà: logger.disabled.flag=false logger.default.name=logging.applicazione_web Configurazione log4j.xml Modificare il file log4j.xml aggiungendo il seguente appender: <appender name="jdbc" class="org.apache.log4j.jdbcplus.jdbcappender"> <param name="url" value="jdbc:postgresql:// <IP_SERVER_POSTGRES>:<PORTA_SERVER_POSTGRES>/<SCHEMA_ELISA_MOBILE>" /> <param name="dbclass" value="org.postgresql.driver" /> <param name="username" value="<user_elisa_mobile>" /> <param name="password" value="<password_elisa_mobile>" /> <param name="sql" value="insert INTO elisamobile.main_log (id, prio, iprio, category, thread, message, time, application, authority, ipaddress, throwable, class, method, filename, line) VALUES (nextval('log_elisa_mobile.seq_main_log_id'), '@CAT@', '@THREAD@', '@MSG@', '@LAYOUT:1@', '@MDC:application@', '@MDC:authority@', '@MDC:ip address@', '@THROWABLE@', '@LAYOUT:2@', '@LAYOUT:3@', '@LAYOUT:4@', '@LAYOUT:5@')" /> <param name="throwablemaxchars" value="4000" /> <param name="layoutpartsdelimiter" value="#" /> <layout class="org.apache.log4j.patternlayout"> <param name="conversionpattern" value="%d{yyyy-mm-dd HH:mm:ss,SSS}#%C#%M#%F#%L#%m#%X{application}#%X{authority}#%X{ip address}" /> </layout> </appender> <logger name="logging.applicazione_web"> <level value="debug" /> <appender-ref ref="jdbc" /> </logger> ToscaMobile_Manuale_Installazione_V1.0.2.docx 26 / 28

27 8.3.4 Creazione e configurazione del file elisamobile-ds.xml Per il corretto funzionamento del backend di gestione è necessario creare un ulteriore data source. Di seguito viene riportato il contenuto del file elisamobile-ds.xml (se non presente nel pacchetto di installazione va creato). <?xml version="1.0"?> <datasources> <local-tx-datasource> <jndi-name>jdbc/elisamobile</jndi-name> <driver-class>org.postgresql.driver</driver-class> <connection-url>jdbc:postgresql:// <IP_SERVER_POSTGRES>:<PORTA_SERVER_POSTGRES>/<SCHEMA_ELISA_MOBILE></connectionurl> <user-name><user_elisa_mobile></user-name> <password><password_elisa_mobile></password> <min-pool-size>2</min-pool-size> <max-pool-size>5</max-pool-size> </local-tx-datasource> </datasources> ToscaMobile_Manuale_Installazione_V1.0.2.docx 27 / 28

28 9 Caricamento DOCFA e Planimetrie Dopo aver eseguito l installazione dei DOCFA secondo il manuale di riferimento EL_8A3_8A4_8A5_8A7_Manuale_Installazione_MI_Modulo_Bonifica_v2.6, bisogna lanciare l artefatto convertdocfatifftopng.jar sulla directory FileRepository (<zipfiledir>), il quale provvederà a convertire i DOCFA in un formato grafico supportato dal client mobile. Di seguito un esempio di utilizzo: java jar convertdocfatifftopng.jar <zipfiledir> <tempdir> <outputdir> [<numthreads>] La descrizione dei parametri è: 1) zipfiledir directory contenente i DOCFA formato zip originali; 2) tempdir directory temporanea utilizzata per la conversione; 3) outputdir directory che conterrà i DOCFA convertiti; 4) numthreads il numero di thread che si vuole utilizzare per la conversione. Es. di comando completo: java jar convertdocfatifftopng.jar /~/docfa /~/docfa/temp /~/docfa/output 10 <fine del documento> ToscaMobile_Manuale_Installazione_V1.0.2.docx 28 / 28