VFront - Guida all'installazione

Licenza di questa documentazione

Copyright (c) 2007 Marcello Verona <marcelloverona@gmail.com>
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
Texts. A copy of the license is included in the section entitled "GNU
Free Documentation License".

Requisiti di base

• Server web Apache 2.x (l'applicazione è stata sviluppata e testata per il server Apache 2.x, potrebbe funzionare con altri server web)
• MySQL 5.x oppure PostgreSQL 8.x (Attenzione! il supporto a PostgreSQL è in fase alpha)
• PHP versione 5.x

• php_mysqli (MySQL Improved) - qualora si utilizzasse un database mysql (o ci si volesse autenticare tramite server mysql esterno)
• php_pgsql (libreria Postgres) - qualora si utilizzasse invece un database postgresql (o ci si volesse autenticare tramite server postgresql esterno)

• php_gd2 - GD library versione >=2.x
• php_gettext per la localizzazione (traduzione dell'interfaccia). In caso non sia presente la libreria sarà utilizzata una implementazione di gettext in versione interpretata
• php_xsl per l'utilizzo delle trasformazioni XSL lato server. Qualora non si avesse la possibilità di usare questa estensione si potranno comunque utilizzare le trasformazioni lato client.
• php_ldap - qualora si volesse impostare l'autenticazione esterna via LDAP
• php_odbc - qualora si volesse impostare l'autenticazione esterna via ODBC
• php_soap - qualora si volesse impostare l'autenticazione esterna via SOAP (sperimentale)

• Image/Graph (http://pear.php.net/package/Image_Graph )
• Image/Canvas (http://pear.php.net/package/Image_Canvas ) come dipendenza di image/Graph

2.1 Nota importante per gli utilizzatori di PostgreSQL

Per chi ha fretta...

1. Estrai i file di VFront sulla cartella htdocs di Apache
2. Apri il file conf/conf.vfront.php e impostare correttamente i parametri seguendo i commenti del file
3. Apri il file inc/conn.php e per includere il path reale del file di configurazione conf.vfront.php
4. Esegui l'installazione da http://nome_del_server/path_vfront/_install/
5. Accedi all'amministrazione di Vfront, inizializzalo e configura da interfaccia grafica diritti e tabelle.
6. Appena hai più tempo leggiti il resto del documento...

Copia dei file ed impostazione dei diritti a file e cartelle

VFRONT_ROOT
- _install
- admin
- conf
- files
	-- docs
	-- tmp
	-- xls_custom
- html
- img
- inc
- locale
- js
- plugins
	-- FCKeditor
	-- phpmailer
	-- phpgettext
	-- ods
- stats
- sty
- tmp
- usr
- xml

• files e le sue sottocartelle 
• html
• tmp

Il file di configurazione

Connessione al database

$db1['dbtype']="mysql"; 
// indica la tipologia di databas: può essere "mysql" oppure "postgres". DEVE essere specificato

$db1['host']="localhost";
// host del server: 

$db1['port']="3306";
// porta del server: di default 3306 per MySQL e 5432 per PosgreSQL

$db1['user']="nomeutente";
// utente per la connessione al database

$db1['passw']="segreta";
// password per la connessione al database

$db1['dbname']="banca";
// nome del database: nel caso di postgres utilizzare "public", cioè il nome dello schema

$db1['frontend']="vfront_test";
// nome del database di VFront. In postgres corrisponde al nome dello schema (si suggerisce "frontend")

$db1['postgres_dbname']="nome_database";
// nome reale del database (solo nel caso si utilizzi Postgres)

Impostazioni di autenticazione

$conf_auth['tipo_external_auth']= ''; 

• 'db' : indica un'autenticazione tramite altro database presente sullo stesso server (solo MySQL)
• 'db_ext' : indica un database MySQL, PostgreSQL o genericamente collegato via ODBC, presente su altro server
• 'ldap' : indica un'autenticazione mediante server LDAP come OpenLDAP o Active DIrectory
• 'soap' : indica un'autenticazione mediante collegamento a WSDL SOAP. Questo tipo di autenticazione è sperimentale.

$conf_auth['campo_email']='email';
// indica il nome del campo database o LDAP per recuperare l'email dell'utente,
// utilizzata per l'autenticazione

$conf_auth['campo_password']='passwd';
// indica il nome del campo database o LDAP per recuperare la password dell'utente,
// utilizzata per l'autenticazione

$conf_auth['campo_nome']='nome'; // opzionale
// Indica il nome del campo database o LDAP da cui recuperare il nome dell'utente

$conf_auth['campo_cognome']='cognome'; // opzionale
// Indica il nome del campo database o LDAP da cui recuperare il nome dell'utente

$conf_auth['password_crypt']='md5'; // md5 | sha1 | null 
// Qualora le password fossero archiviate come hash md5 o sha1 impostare questo parametro

Autenticazione mediante database presente sullo stesso server (solo MySQL)

$conf_auth['db']['database']='nome_database'; 
// deve risiedere sullo stesso server (Solo Mysql) -- per altri server utilizzare DB_EXT, SOAP o altri metodi

$conf_auth['db']['tabella']='nome_tabella';
// nome della tabella da interrogare per l'autenticazione

Autenticazione mediante database esterno e/o residente su altro server (MySQL, PostgreSQL, ODBC)

$conf_auth['db_ext']['dbtype']="mysql"; 
// Può essere "mysql" oppure "postgres" oppure genericamente "odbc"

$conf_auth['db_ext']['host']="localhost"; 
// host del server DB esterno utilizzato per l'autenticazione 

$conf_auth['db_ext']['port']="3306"; 
// porta del server DB esterno utilizzato per l'autenticazione: 
// di default 3306 per MySQL e 5432 per PostgreSQL

$conf_auth['db_ext']['user']="utente"; 
// utente per l'autenticazione 

$conf_auth['db_ext']['passw']="barchetta"; 
// password

$conf_auth['db_ext']['dbname']="vfront_test"; 
// nome del database

$conf_auth['db_ext']['tabella']="utente"; 
// nome della tabella

$conf_auth['db_ext']['odbc_dsn']=""; 
// solo per connessioni ODBC: scrivere il DSN

Autenticazione mediante LDAP o Active Directory

$conf_auth['ldap']['base_dn']='o=Nome del server,c=IT';
// DN completo del server LDAP

$conf_auth['ldap']['host']='localhost';
// host del server LDAP

Autenticazione mediante SOAP (sperimentale)

$conf_auth['soap']['wsdl']='';
// indirizzo http(s) del file WSDL

$conf_auth['soap']['function_get_user']='';
//nome di funzione per interrogare l'elenco degli utenti

$conf_auth['soap']['function_get_user_results']='';
// nome di funzione per recuperare i dati degli utenti

Sezione SMTP e e-mail

$conf_mail['SMTP_AUTH']=false;
// indica se utilizzare un SMTP personalizzato. In caso contrario verrà utilizzato l'SMTP del server.

// Le seguenti tre variabili sono da impostare qualora l'autenticazione SMTP sia impostata su TRUE:

	$conf_mail['SMTP']="";
	// Indirizzo SMTP da utilizzare qualora si voglia fare uso di STMP personalizzato

	$conf_mail['SMTP_AUTH_USER']="";
	// utente smtp

	$conf_mail['SMTP_AUTH_PASSW']="";
	// password smtp


$conf_mail['MAIL_SENDER']="";
// email del mittente per gli invii effettuati da VFront (principalmente per il debug)
// ad esempio "noreply@vfront.org"

$conf_mail['MAIL_SENDER_NAME']="";
// Nome in chiaro del mittente per gli invii effettuati da VFront
// ad esempio "Admin VFront"

// mail amministratore di sistema
define('_SYS_ADMIN_MAIL','admin@vfront.org');

// mail dello sviluppatore (per le email di debug)
define('_DEV_MAIL','dev@vfront.org');

Sezione Debug

// errori a video | errori in email
$DEBUG_SQL=true;

$RPC_DEBUG=true;
// scrivi le chiamate SQL in un file (di default ./rpc.debug.txt) - default: FALSE

Sezione Log

$RPC_LOG=true;
// scrive un log delle chiamate SQL di inserimento, modifica e cancellazione - default: TRUE

Sezione localizzazione: lingua e codifica

/**
* Language : Valori possibili: it_IT, en_US, fr_FR , etc.
*/ 
define('FRONT_LANG','en_US');

/**  
* Encoding  
*/
define('FRONT_ENCODING','UTF-8');

Sezione Path

// path reale
define('FRONT_ROOT','D:/htdocs/vfront_test');

// path reale
define('FRONT_REALPATH','D:/htdocs/vfront_test');

// Path della document root
define('FRONT_DOCROOT','http://localhost/vfront_test');



// Nella maggior parte dei casi i seguenti si possono lasciare così come sono:

// path mysqldump (per l'esportazione di MySQL) - Default: mysqldump
define('_PATH_MYSQLDUMP',"mysqldump");

// path pg_dump (per l'esportazione di Postgres) - Default: pg_dump
define('_PATH_PG_DUMP',"pg_dump");

// path per il filesystem allegati
define('_PATH_ATTACHMENT',FRONT_REALPATH."/files");

// path di tmp per il filesystem allegati
define('_PATH_ATTACHMENT_TMP',FRONT_REALPATH."/files/tmp");

// path per il filesystem documenti utili
define('_PATH_HELPDOCS',FRONT_REALPATH."/files/docs");

// path di tmp accessibile via web
define('_PATH_TMP',FRONT_REALPATH."/tmp");

// path per i fogli di stile XSL allegati
define('_PATH_XSL',FRONT_REALPATH."/files/xsl_custom");

// path web per i fogli di stile XSL allegati
define('_PATH_WEB_XSL',FRONT_DOCROOT."/files/xsl_custom");

Sezione FOP

// Imposta se VFront può utilizzare l'applicazione FOP (true o false)
define('_FOP_ENABLED',true);

// Path di FOP sul server:
//define('_PATH_FOP','C:/fop-0.20.5/foptest/fop.bat');
//define('_PATH_FOP','/usr/local/fop/fop.sh');

Sezione Allegati e Link

// definizione della tabella allegato
define('_TABELLA_ALLEGATO',"{$db1['frontend']}.allegato");

// definizione della tabella link
define('_TABELLA_LINK',"{$db1['frontend']}.link");

Sezione Misc

define('_MAX_TEMPO_EDIT',240);

define('_BASE64_PASSFRASE',"passfrase");

define('_IMG_LOGO',FRONT_DOCROOT.'/img/vfront090.jpg');

define('_NOME_PROJ','VFront');

Inclusione del file di configurazione

####################################################
#
# COLLEGAMENTO AL FILE CONF
#

// ad esempio
require_once("D:/htdocs/vfront_test/conf/conf.vfront.php");

// oppure
require_once("/var/www/vfront/conf/conf.vfront.php");

Procedura di installazione automatica

1. Il path del file di configurazione, che verrà letto per l'installazione
2. Un'autenticazione di alto livello sul database (root o simile) per creare le tabelle, l'utente specificato nel file CONF e i diritti a lui riservati 
3. email e password per il primo utente (l'amministratore)

Procedura di installazione manuale

1. assicurarsi che il file conf.vfront.php sia stato correttamente configurato
2. Modificare il file inc/conn.php per puntare correttamente al file di configurazione
3. Creare l'utente database specificato nel file conf e attribuire diritti d'uso (SELECT, DELETE,INSERT, UPDATE) nonché il diritto SHOW VIEW sul database che si vuole leggere con VFront
4. Attribuire i diritti d'uso sul database (o schema su Postgres) di VFront
5. Attribuire i diritti di lettura sull' information_schema se necessario
6. Eseguire sul server database i file _install/vfront.mysql.sql oppure _install/vfront.postgres.sql a seconda del DB che si vuole utilizzare
7. Creare un utente nella tabella "utente" del database (o schema) di VFront che abbia livello=3 e gruppo=0. Nota bene che la password deve essere espressa in hash md5. Per generare un hash md5 della tua password utilizzare md5 da shell (su Linux) oppure utilizzare uno dei tanti convertitori presenti su web, ad es. http://pajhome.org.uk/crypt/md5/

Dopo l'installazione

Inizializzazione del sistema

1. Fare login con il proprio account di amministratore
2. Accedere alla sezione amministrazione
3. Nel primo menu scegliere "Inizializza registri"

Test impostazioni VFront