ToscaMobile Manuale Installazione V1.0oscat.rete.toscana.it/docman/view.php/262/914/Tosca...Progetto...

Progetto ToscaMobile

Manuale Installazione ToscaMobile Versione 1.0.2

ToscaMobile_Manuale_Installazione_V1.0.2.docx 1 / 28

Manuale Installazione

ToscaMobile

Presentato da:




ToscaMobile

Cliente Regione Toscana Colline Metallifere


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 1.0.2

Pagine 28

Nome File ToscaMobile_Manuale_Installazione_V1.0.2.docx




Storia del documento

Versione Data Autore Cambiamenti apportati

1.0.0 12/01/2012 Pasquale Paola Stesura iniziale documento

1.0.1 04/04/2012 Pasquale Paola Inserimento gestione civici, dovuto ad un’esplicita richiesta evolutiva del cliente

1.0.2 02/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_Bonifica_v2.6

Allegato al pacchetto di installazione

Tabella 2: Documentazione di riferimento




INDICE GENERALE

1 INTRODUZIONE ...................................................................................................................................................... 6

1.1 OBIETTIVI DEL DOCUMENTO ................................................................................................................................... 6 1.2 STRUTTURA DEL DOCUMENTO ................................................................................................................................ 6 1.3 TERMINI E DEFINIZIONI ........................................................................................................................................... 6

2 PREREQUISITI ......................................................................................................................................................... 8

2.1 REQUISITI DI SISTEMA PER L’INSTALLAZIONE DI TM .............................................................................................. 8 2.2 REQUISITI APPLICATIVI PER L’INSTALLAZIONE DI TM ........................................................................................... 9

2.2.1 Pacchetti Software Applicativi ........................................................................................................................ 9 2.2.2 Parametri, Credenziali AAA, url e path di installazione SW di base ............................................................. 9

2.3 MATRICE DI COMPATIBILITÀ DI TM ........................................................................................................................ 9 2.4 SKILL MINIMI RICHIESTI PER PROCEDERE CON L’INSTALLAZIONE E CONFIGURAZIONE ......................................... 10

3 COMPONENTI OGGETTO DI INSTALLAZIONE E CONFIGURAZIONE ................................................. 11

4 DATABASE TOSCAMOBILE: CREAZIONE E CARICAMENTO ................................................................. 12

4.1 CREAZIONE DATABASE POSTGRES ........................................................................................................................ 12 4.2 POPOLAMENTO <SCHEMA_ELISA_MOBILE_GIS> ........................................................................................ 12

4.2.1 Prerequisiti struttura tabelle ........................................................................................................................ 12 4.2.2 Popolamento DB ........................................................................................................................................... 14

5 GESTIONE GEOSERVER ..................................................................................................................................... 18

6 INSTALLAZIONE E CONFIGURAZIONE WEB DI TOSCAMOBILE REST SERVICE ........................... 19

6.1 CONFIGURAZIONE BUSINESS.PROPERTIES ............................................................................................................. 19 6.2 CONFIGURAZIONE CONF.PROPERTIES ................................................................................................................... 20 6.3 CONFIGURAZIONE GEODB-DS.XML ....................................................................................................................... 23

7 INSTALLAZIONE DELLA WEB APPLICATION PER LA DISTRIBUZIONE DI TOSCAMOBILE ....... 24

8 INSTALLAZIONE BACKEND DI GESTIONE ................................................................................................... 25

8.1 CREAZIONE DATABASE PER IL BACKEND DI GESTIONE .......................................................................................... 25 8.2 CONFIGURAZIONE SINAPSI ................................................................................................................................... 25 8.3 CONFIGURAZIONI NECESSARIE AL BACKEND DI GESTIONE ................................................................................... 25

8.3.1 Configurazioni acsor.properties ................................................................................................................... 25 8.3.2 Configurazione acsorEjb.properties ............................................................................................................. 26 8.3.3 Configurazione log4j.xml .............................................................................................................................. 26 8.3.4 Creazione e configurazione del file elisamobile-ds.xml ............................................................................... 27

9 CARICAMENTO DOCFA E PLANIMETRIE ..................................................................................................... 28




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 .............................................................. 11




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 box1.

1.2 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 Definizione

AAA Autenticazione (Authentication), controllo degli accessi (Authorization) e tracciamento del consumo delle risorse da parte degli utenti (Accounting)

ACI Anagrafe Comunale Immobili

ACSOR Anagrafe Comunale Soggetti Oggetti Relazioni

AS Application Server

BBOX Bounding Box - rappresenta i limiti di un'immagine georefernziata ossia i 4 estremi della zona geografica in cui ricade uno specifico Ente.

DB Database

1 Sarà utilizzato il seguente simbolo:




DBTL Database Territoriale Locale

EPSG 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.

GUI Graphic User Interface

J2EE Java 2 Enterprise Edition

PATH_TO_SERVER Path assoluto alla directory del server del portale ACSOR

SHAPE ESRI Shape file

SRID Spatial Reference System Identifier (SRID)

TM ToscaMobile

TBD To Be Defined

UIU Unità Immobiliare Urbana

WMS Web Map Service

<value> Definisce un’informazione parametrica

Tabella 3: Termini e definizioni




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 http://oscat.rete.toscana.it/ 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

GeoServer2 2.1 http://www.geoserver.org PostgreSQL 8.4 e 9.1 http://www.postgresql.org PostGIS3 1.5 http://www.postgis.org ANT 1.8.x http://ant.apache.org JDK 1.6.x http://www.oracle.com/technetwork/java/javase/downloads Android SDK r18 http://developer.android.com/sdk/index.html GDAL 1.x http://www.gdal.org

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;




2.2 Requisiti Applicativi per l’installazione di TM

2.2.1 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 Descrizione ACSOR (con componenti Visoraci) Versione Free o “a licenza” secondo la matrice di compatibilità di

TM Profilazione Sinapsi e CAS Script sql per la creazione e configurazione dell’accesso a TM WAR QREncoder war QR creator WAR MobileRest 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.

2.2.2 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 Versione ACSOR Free Unica versione

Tabella 6: Matrice di Compatibilità




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.




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 Obiettivo DB PostGIS ToscaMobile Creazione e Configurazione del DB Caricamento Dati Popolamento del Database

Installazione Componente Web ToscaMobile REST Service

Modalità di Deploy del WAR

Installazione della web application per la distribuzione di ToscaMobile

Modalità di Deploy del WAR

Installazione BACKEND di Gestione Modalità di Deploy dei WAR e JAR Caricamento DOCFA e Planimetrie Modalità di conversione di specifici dati

Tabella 7: Componenti oggetto di installazione e configurazione




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>

4.2.1 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).




4.2.1.1 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 WGS84.

4.2.1.2 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 S3_CT28G_CAMPITURE CT28_COD_COM CT28_SEZ CT28_FOGLIO CT28_NUMERO CT28_ALLEGATO CT28_SVILUPPO CT28_GEOMETRIA CT28_PROT_ULTIMO_AGG CT28_OBJECT_ID Particelle Nome tabella S3_CT24G_PARTICELLE CT24_COD_COM CT24_SEZ CT24_FOGLIO CT24_NUMERO CT24_ALLEGATO CT24_SVILUPPO CT24_AREA CT24_GEOMETRIA CT24_PROT_ULTIMO_AGG CT24_OBJECT_ID

4.2.1.3 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




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.

4.2.2 Popolamento DB

4.2.2.1 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 4326 -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:




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.

4.2.2.2 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.

4.2.2.2.1 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"




"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"

4.2.2.2.2 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




#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_MOBILE_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




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




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 Valore server.name <INDIRIZZO>:<PORTA> apk.name <Nome_file.apk> pathDocfa <PATH_ASSOLUTO_ALLA_CARTELLA_DEI_DOCFA>4 fileExtension zip driver org.postgresql.Driver url jdbc:postgresql://<IP_SERVER_POSTGRES>:

<PORTA_SERVER_POSTGRES>/<SCHEMA_ELISA_MOBILE>5 user pman password pman max.query.result 100 ente <CODICE_ENTE> postgis.datasource java:jdbc/geodb postgis.fabbricatitable <NOME_TABELLA_FABBRICATI> postgis.fabbricatitable.foglio <NOME_COLONNA_FOGLIO_FABBRICATI> postgis.terrenitable.numero <NOME_COLONNA_NUMERO_FABBRICATI> postgis.fabbricatitable.sezione

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




postgis.fabbricatitable.geometria <NOME_COLONNA_GEOMETRIA_FABBRICATI> postgis.terrenitable <NOME_TABELLA_PARTICELLE> postgis.terrenitable.foglio <NOME_COLONNA_FOGLIO_PARTICELLE> postgis.terrenitable.numero <NOME_COLONNA_NUMERO_PARTICELLE> postgis.terrenitable.sezione postgis.terrenitable.geometria <NOME_COLONNA_GEOMETRIA_PARTICELLE> postgis.satellitecivici_table “SATELLITI_CIVICI” postgis.satellitecivici_table.geometria “GEOMETRIA” postgis.satellitecivici_table.nomevia “NOMEVIADL” postgis.satellitecivici_table.numciv “NUMCIV” postgis.satellitecivici_table.licenzecomm “LICENZE_COMMERCIALI” postgis.satellitecivici_table.numres “NUMERO_RESIDENTI” postgis.satellitecivici_table.numuiu “NUMERO_UIU” postgis.satellitecivici_table.contrattiloc “CONTRATTI_LOCAZIONE” postgis.satellitecivici_table.codicevia “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 Valore geoserver.url http://<INDIRIZZO>:<PORTA>/geoserver rest.url http://<INDIRIZZO>:<PORTA>/elisa-mobile-

services layer.fabbricati <GEOSERVER_WORKSPACE>:<LAYER_NAME> layer.terreni <GEOSERVER_WORKSPACE>:<LAYER_NAME> layer.terreni.geometryfeaturename <GEOMETRY_FEATURE_NAME> layer.fabbricati.geometryfeaturename <GEOMETRY_FEATURE_NAME> layer.terreni.foglio <GEOSERVER_WORKSPACE>:<FEATURE_NAME> layer.terreni.numero <GEOSERVER_WORKSPACE>:<FEATURE_NAME>

layer.fabbricati.foglio <GEOSERVER_WORKSPACE>:<FEATURE_NAME> layer.fabbricati.numero <GEOSERVER_WORKSPACE>:<FEATURE_NAME> layer.fabbricati.selectionstyle polygon layer.terreni.selectionstyle polygon




center.longitude <LONGITUDINE_DEL_CENTRO> center.latitude <LATITUDINE_DEL_CENTRO> epsg.code EPSG:<CODICE_PROIEZIONE> elisa.codente <CODICE_ENTE> rest.loginpath /login/auth/login rest.login.link http://<INDIRIZZO>:<PORTA>/elisa-mobile-

services/mobile rest.login.param.login user rest.login.param.password pass rest.login.param.link link rest.login.param.timeschedulegps 120000 rest.param.token token rest.param.ente ente rest.searchsoggetto.filtro filtro rest.searchoggetto.filtro filtro rest.caricaRelazioni /mobile/rels rest.anagrafe.nucleo.familiare /mobile/anagrafe/getNucleoFamiliare rest.redditi.dati.dichiarazione /mobile/dichiarazioni/getDatiDichiarazione rest.tributi.indicatori.ici /mobile/tributi/getIndicatoriIci rest.tributi.indicatori.versamenti.ici /mobile/tributi/getIndicatoriVersamentiIci rest.tributi.dichiarazioni.ici /mobile/tributi/getDichiarazioniIci rest.tributi.versamenti.ici /mobile/tributi/getVersamentiIci rest.isauthorized /login/auth/token/ rest.logout /login/auth/logout/ rest.listattivita /mobile/attivita/lista

rest.listattivita.stato /mobile/attivita/lista/stato rest.listattivita.presaincarico /mobile/attivita/presaInCaricoRL rest.listattivita.trasmesso /mobile/attivita/trasmessoAlBackOffice rest.listattivita.crea.segnalazione /mobile/attivita/creaSegnalazione rest.listattivita.salvanota /mobile/attivita/salvaNota rest.listattivita.salvanota.upload /mobile/attivita/upload rest.categoria.note.list /mobile/attivita/categorieNote rest.get.oggetto /mobile/oggetto rest.get.soggetto /mobile/soggetto rest.searchoggetto.fabbricato /mobile/oggetto/filtro/F rest.searchoggetto.terreno /mobile/oggetto/filtro/T rest.searchoggetto.ternacatstale /mobile/service/getcentroidebyfoglioenumero rest.searchoggetto.ternacatstale.param.foglio foglio rest.searchoggetto.ternacatstale.param.numero numero rest.searchoggetto.ternacatstale.param.sezione sezione rest.searchoggetto.ternacatstale.param.isFabbricato isFabbricato rest.docfa.list /mobile/docfa/lista rest.docfa.file /mobile/docfa/file rest.gestionedispositivo /mobile/dispositivo/refreshPos




rest.gestionedispositivo.longitude longitudine rest.gestionedispositivo.latitude latitudine rest.gestionedispositivo.srid epsg rest.docfa.listparam docfa rest.docfa.fileparam name rest.ar.aroundme /mobile/augmentedreality/aroundme rest.ar.aroundme.civici /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




Terminata la compilazione sotto la directory bin del progetto troveremo il file .apk ElisaMobile-release.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>




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”.




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

8.3.1 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




acsor.entities.beans = it.eng.elisamobile.entity.ElisaMobileEntity

#Se ci sono già voci presenti, devono essere separate da virgola.

8.3.2 Configurazione acsorEjb.properties Verificare la presenza nel file acsorEjb.properties delle seguenti proprietà:

logger.disabled.flag=false

logger.default.name=LOGGING.APPLICAZIONE_WEB

8.3.3 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'), '@PRIO@', @IPRIO@, '@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>




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></connection-url>

<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>




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.0oscat.rete.toscana.it/docman/view.php/262/914/Tosca...Progetto...

Documents

Transcript of ToscaMobile Manuale Installazione V1.0oscat.rete.toscana.it/docman/view.php/262/914/Tosca...Progetto...