Differences

This shows you the differences between two versions of the page.

--- tecnica:gps_cartografia_gis:mapserver_fgs [2009/06/22 11:17] – niccolo
+++ tecnica:gps_cartografia_gis:mapserver_fgs [2009/10/20 11:28] (current) – niccolo
@@ Line 22: / Line 22: @@
 ===== Installazione =====
-Si scarica il pacchetto **fgs-mapserver_extended**, lo si rende eseguibile e lo si esegue. Per evitare conflitti con il software già installato è necessario utilizzare **porte non standard** per alcuni servizi (Apache, PostgreSQL).
+Si scarica il pacchetto **fgs-mapserver_extended**, lo si rende eseguibile e lo si esegue.
+L'installazione conviene farla come **utente non privilegiato**, altrimenti la configurazione di PostgreSQL fallisce (non può eseguire ''initdb'' come ''root''). Inoltre l'utente che esegue l'installazione sarà l'amministratore di PostgreSQL e il proprietario dei processi in esecuzione.
+Supponiamo di creare un utente ad-hoc di nome **fgs**, se vogliamo installare tutto il software nella directory **''/opt/fgs/''**, bisogna che la directory ''/opt'' sia scrivibile dall'utente durante l'installazione.
+Per evitare conflitti con il software già installato è necessario utilizzare **porte non standard** per alcuni servizi (Apache, PostgreSQL).
 <code>
@@ Line 30: / Line 36: @@
 + Port selected : '8080'
 * You can start apache with : fgs start apache
+</code>
-*      *** PostgreSQL installation ***
+Per utilizzare il software installato sotto **''/opt/fgs/''** e per avviare i servizi si deve eseguire:
-+ Correct files in share/ directory
-* Selecting TCP port... Example: 5433, 5433, etc...
+<code>
-? What TCP port do you want to use [5432] : 5433
+. /opt/fgs/setenv.sh
-+ Creating PostgreSQL's database directory in '/opt/fgs/apps/pgsql/data' :
+fgs start apache
-initdb: cannot be run as root
+fgs start pgsql
-Please log in (using, e.g., "su") as the (unprivileged) user that will
-own the server process.
-* To start PostgreSQL, use : fgs start pgsql
 </code>
-Come si vede c'è qualche problema da risolvere per inizializzare PostgreSQL.
+Dopo aver eseguito ''setenv.sh'' è possibile utilizzare anche i tool da riga di comando come **''ogrinfo''** ecc. Si consiglia di aggiungere il ''setenv.sh'' al profilo utente:
+<code>
+echo ". /opt/fgs/setenv.sh" >> ~/.bashrc
+</code>
+Per avviare tutti i servizi al boot di sistema si modifica ''rc.local'' aggiungendo:
+<file>
+su fgs -c "( . /opt/fgs/setenv.sh ; fgs start )"
+</file>
+FIXME Sarebbe opportuno esegure ''fgs stop'' allo shutdown.
+==== Disabilitare un servizio installato ====
+Per disabilitare un servizio senza disinstallarlo - ad esempio per disabilitare l'avvio automatico di PostgreSQL - si può intervenire direttamente sullo script di avvio **''/opt/fgs/etc/init.d/pgsql''**, aggiungendo un comando **''exit''** al suo inizio.
+===== Installazione moduli aggiuntivi =====
+Il pacchetto FGS comprende numerosi moduli aggiuntivi non installati dal pacchetto principale. L'elenco è visibile direttamente nella [[http://dl.maptools.org/dl/fgs/releases/9.5/modules/|directory di download]] (specifica per la versoine del pacchetto principale).
+Come esempio vogliamo installare il plugin **Client Oracle (OCI)** della libreria GDAL. Dobbiamo specificare il numero di versione, altrimenti rischiamo di installare il plugin per Oracle 11 invece che per la versione 10:
+<code>
+fgs install gdal-base-1.6.1-oci:10.2.0.4-1 http://dl.maptools.org/dl/fgs/releases/9.5/modules
+</code>
+===== Modulo Apache =====
+La configurazione FGS si trova in **''/opt/fgs/etc/fgs/pkgs/apache-base/apache.conf''**:
+<file>
+PORT=8080
+USER='apache'
+GROUP='apache'
+</file>
+I parametri **''USER''** e **''GROUP''** vengono impostati solo se ''fgs start'' viene eseguito da root, in tal caso apache gira con il suo utente. Altrimenti gira a nome dell'utente fgs.
+Il file di configurazione usato è **''/opt/fgs/www/conf/live.httpd.conf''** (viene sovrascritto ad ogni avvio di Apache), questi i parametri importanti:
+<file>
+ServerRoot "/work/fgs/www"
+Listen 8080
+User apache
+Group apache
+DocumentRoot "/work/fgs/www/htdocs"
+ErrorLog "logs/error_log"
+CustomLog "logs/access_log" common
+</file>
+La configurazione del PHP è in **''/opt/fgs/www/conf/php5.ini''** ma viene sovrascritta ad ogni avvio di Apache con il contenuto di **''/opt/fgs/www/conf/php5.ini.template''**.
+Le estensioni PHP **non vengono caricate automaticamente** (come in Debian), ma vanno aggiunte a mano:
+<file>
+extension=curl.so
+extension=php_mapscript.so
+</file>
+Ad esempio l'estensione **curl** è necessaria per chiamare ''**fopen($url)**'', altrimenti si ottiene l'errore:
+<code>
+Notice: fopen() [function.fopen]: Unable to find the wrapper "http"
+    - did you forget to enable it when you configured PHP? in /var/www/fopen_test.php on line 54
+Warning: fopen(http://host/) [function.fopen]: failed to open stream:
+    No such file or directory in /var/www/fopen_test.php on line 54
+</code>