Manuale di installazione di StatPortal Open Data

 

La presente documentazione è riferita ad una installazione su sistema operativo CentOS 6.

Manuale di installazione di StatPortal Open Data

Installazione prerequisiti

Elenco dei prerequisiti per l’installazione.

Installazione e configurazione PostgreSQL

Installazione di PostGIS

Installazione e configurazione Apache HTTP Server e PHP 5

Installazione e configurazione Apache Tomcat

Installazione e configurazione Drupal

Installazione e configurazione Geoserver

Installazione e configurazione D2RQServer

Installazione moduli

Setup database

Installazione moduli StatPortal Open Data

Configurazione di base servizi Java

Installazione e configurazione servizi OData

Installazione e configurazione servizio StatPortalOpenData

Installazione e configurazione servizio OpenDataProxy

Installazione e configurazione estensione web gis

Installazioni e configurazione estensioni STRestExtension

Installazione e configurazione OpenDataGisViewer

Installazione WSEtl

Installazione e configurazione ProxyServlet

Installazione SpodCkanApi

Installazione prerequisiti

Elenco dei prerequisiti per l’installazione.

Installazione e configurazione PostgreSQL

Versione di riferimento: PostgreSQL 9.2.10

 

Tutte le informazioni necessarie all’installazione di PostgreSQL su CentOS possono essere trovate a questo link.

Terminata l’installazione, aggiungere le funzioni per la generazione degli UUID (uuid-ossp module)

con il comando:

CREATE EXTENSION "uuid-ossp";

Installazione di PostGIS

Versione di riferimento: PostGIS2_92 2.1.7

Installazione tramite repository:

Yum install postgis2_92

Per abilitare le estenzioni su un nuovo database:

CREATE EXTENSION "postgis";

CREATE EXTENSION "postgis_topology";

Installazione e configurazione Apache HTTP Server e PHP 5

Versione di riferimento: httpd 2.2.15 e php 5.3.3

Per l’installazione di entrambi i requisiti consigliamo di seguire i passi di installazione descritti nell’ howto: http://www.rackspace.com/knowledge_center/article/centos-apache-and-php-install

Una volta installato Apache HTTP Server è necessario abilitare alcuni moduli aggiuntivi:

Installazione e configurazione Apache Tomcat

Versione di riferimento: Tomcat6 v.6.0.24 (Java 1.6.0).

Per installare Tomcat6 seguire i passi di installazione descritti nella documentazione ufficiale del progetto.

Aggiungere tra i parametri di avvio di Tomcat la seguente proprietà: Dspod.config.dir=<config_base_directory> (directory dove sono presenti le configurazioni di tutti i servizi)

Installazione e configurazione Drupal

Versione di riferimento: Drupal 7.19

Installare e configurare Drupal come descritto nella documentazione ufficiale.

Terminata l’installazione del CMS, installare e configurare i seguenti moduli aggiuntivi (dipendenze del modulo StatPortal OpenData):

Moduli raccomandati:

Installazione e configurazione Geoserver

Versione di riferimento: Geoserver v. 2.3.3.

Installazione

Per l’installazione seguire i passi descritti nella documentazione ufficiale di Geoserver. 

 

Terminata la procedura di installazione di Geoserver è necessario installare le seguenti estensioni:

Configurazione

Per configurare Geoserver è necessario eseguire i seguenti passi:

Installazione e configurazione D2RQServer

Configurazioni

Avvio

Installazione moduli

Setup database

Creazione dei due database: dati e cms 

Esecuzione script per la creazione delle tabelle di sistema su Postgresql 

Eseguire i seguenti file di script SQL sul database dei dati (si trovano nella cartella script del pacchetto), nell’ordine definito:

Installazione moduli StatPortal Open Data

Prima di procedere con l’installazione del modulo, installare il tema Statportal come descritto di seguito:

  1. Accedere al pannello di amministrazione
  2. Accedere alla sezione Aspetto → Installa un nuovo Tema 
  3. Eseguire l’upload dell’archivio theme/statportal.zip e cliccare su installa
  4. Abilitare il tema appena installato come teme predefinito per il Front-end del sito.

NB:  Assicurarsi della presenza delle funzioni per la gestione (creazione/confronto) degli UUID (vedi paragrafo Installazione e Configurazione PostgreSql).

        

Successivamente Installare il tema “seven”:

  1. Ritornare alla sezione Aspetto → Installa un nuovo Tema 
  2. Eseguire l’upload dell’archivio theme/seven.zip e cliccare su installa
  3. Selezionarlo come tema di default per l’amministrazione e l’inserimento/editing dei contenuti.

A questo punto è possibile procedere con l’installazione del modulo StatPortal OpenData:

  1. Accedere al pannello di amministrazione moduli di Drupal
  2. Cliccare sulla voce ‘Installa nuovo modulo’ e utilizzare il secondo metodo di installazione (Carica un archivio contenente un modulo o tema per installarlo).
  3. Selezionare la cartella module/sp-odata.zip dall’apposito form ed infine cliccare su installa.
  4. Terminata l’installazione, ritornare alla pagina dei moduli e abilitarlo.

Configurazione dei permessi per la creazione di una ‘Scheda dato’

Di default soltanto l’amministratore è autorizzato a creare le schede; per abilitare altri utenti alla creazione/modifica della ‘Scheda dato’ è consigliata la creazione di un nuovo ruolo. Assegnare tale ruolo a tutti gli utenti che desiderano creare nuove schede.

Configurazione di base servizi Java

Tutti i file di configurazione dei servizi Java sono memorizzati in un’unica directory, da riferire attraverso la proprietà

-Dspod.config.dir=<config_base_directory>

Questo deve essere fatto sia per i runnable jar che per i war.

Nella directory di base sono presenti i file di configurazione comuni a più servizi, mentre nella directory <config_base_directory>/<project_name> sono presenti i file di configurazione specifici.

Nella directory di base sono presenti i seguenti file di configurazione:

Per le configurazioni dei singoli servizi si rimanda agli appositi paragrafi.

Installazione e configurazione servizi OData

Installazione e configurazione servizio StatPortalOpenData

Installazione e configurazione servizio OpenDataProxy

Installazione e configurazione estensione web gis

Installazioni e configurazione estensioni STRestExtension

Installazione e configurazione OpenDataGisViewer

Installazione WSEtl

Installazione e configurazione ProxyServlet

Installazione SpodCkanApi

Attività pianificate - Cron

Aggiungere a cron i seguenti task:

# m h  dom mon dow   command

0 * * * * wget -O - -q -t 1 http://www.datiopen.it/cron.php?cron_key=1o1w5dZXVNGtSsmeZEoovfTTxIt2SAjx1yg7vcw6bPs

0 23 * * * find /var/www/export -mtime +1 -exec rm -f {} \; > /dev/null 2>&1

La prima riga schedula l’esecuzione del cron di Drupal; il parametro cron_key si ottiene dall’interfaccia di amministrazione di Drupal;

La seconda riga schedula la pulizia delle cartelle di export