Manuale Installazione Equogest/GestiGAS
Progetto e3g, Software gestionali per l'economia solidale
Aggiornato alla data del (vedere in calce al documento)
La versione più recente di questo manuale si trova on-line all'indirizzo
http://wiki.progettoe3g.org/index.php?title=Manuale_Installazione_Equogest/GestiGAS
Copyright © 2003-2012
Andrea Piazza http://www.andreapiazza.it
Marco Munari http://www.marcomunari.it
- Questo manuale, per volontà degli autori, è rilasciato sotto la disciplina della licenza Creative Commons Public License (Attribuzione - Non Commerciale - Condividi allo stesso modo 2.5). Tu sei libero: di riprodurre, distribuire, comunicare al pubblico, esporre in pubblico, rappresentare, eseguire o recitare l'opera; di creare opere derivate. Alle seguenti condizioni: devi riconoscere il contributo dell'autore originario; non puoi usare quest’opera per scopi commerciali; se alteri, trasformi o sviluppi quest’opera, puoi distribuire l’opera risultante solo per mezzo di una licenza identica a questa. In occasione di ogni atto di riutilizzazione o distribuzione, devi chiarire agli altri i termini della licenza di quest’opera. Se ottieni il permesso dal titolare del diritto d'autore, è possibile rinunciare ad ognuna di queste condizioni. Le tue utilizzazioni libere e gli altri diritti non sono in nessun modo limitati da quanto sopra. Questo è un riassunto in linguaggio accessibile a tutti del Codice Legale (http://creativecommons.org/licenses/by-nc-sa/2.5/legalcode).
Abstract
Contents |
Prerequisiti
Per funzionare correttamente il software del Progetto e3g necessita di un computer dotato di:
- Sistema operativo Linux oppure Windows, Mac OS X, Free BSD
- Apache 1.3.x/2.x (http://www.apache.org/)
- PHP 4.3.x/4.4.x/5.0.x/5.1.x/5.2.x (http://www.php.net/)
- MySQL 3.23/4.x/5.x (http://www.mysql.com/) oppure altro database engine PEAR compatibile
ovvero di un server web, connesso o meno alla rete internet. Controllare - per esempio tramite phpinfo() - che il memory_limit di PHP sia impostato almeno a 64 MB, rispetto ai predefiniti 16 MB dell'installazione standard.
Download sorgenti
I sorgenti del programma si trovano sul sito web del Progetto e3g, nell'apposita sezione Download: raggiungere l'indirizzo
fare clic su "Download" a sinistra e poi su "Software e3g". In alternativa è possibile scaricare l'ultima versione anche da SourceForge.net, il più grande "contenitore" mondiale di progetti Open Source, l'indirizzo diretto è
Per il funzionamento del software del "Progetto e3g" (Equogest e GestiGAS) sono indispensabili le librerie P4A (PHP For Applications) che possono essere liberamente scaricate da:
P4A è un framework per la costruzione di applicazioni event-driven e web-based sviluppato da CreaLabs (http://www.crealabs.it/) e rilasciato con licenza GNU/GPL (come quella del Progetto e3g).
Setup installazione
Fase 1: librerie P4A (PHP For Applications)
Scompattare le librerie p4a e caricarle in una sottodirectory del proprio spazio web (locale o remoto), ad esempio in
Prima di proseguire si consiglia di provare il loro regolare funzionamento, dopo aver eventualmente avviato il server web, semplicemente collegandosi a http://www.mio_sito.org/p4a/index.php: vengono elencate alcune applicazioni di esempio, provare in particolare "products_catalogue" che richiede la connessione al database (leggere il relativo file README su come creare le tabelle necessarie).
In caso di necessità riferirsi al servizio di supporto di P4A (http://sourceforge.net/forum/forum.php?forum_id=473897).
Fase 2: sorgenti "Progetto e3g"
Scompattare a questo punto i sorgenti del "Progetto e3g" e caricarli nella directory
Creare (e su sistemi *nix rendere scrivibili, 777) le due sottodirectory
Fase 3: creazione database e tabelle
All'interno della directory http://www.mio_sito.org/e3g/db sono presenti i due script SQL per la creazione delle tabelle del database e l'inserimento dei dati iniziali:
Nel caso di Equogest considerare:
- equogest_db_init_cond.sql (contiene le tabelle comuni)
- equogest_db_init_multi.sql (contiene le tabelle specifiche)
Nel caso di GestiGAS considerare:
- gestigas_db_init_cond.sql (contiene le tabelle comuni)
- gestigas_db_init_multi.sql (contiene le tabelle specifiche)
Procedere in questo modo: creare un database vuoto ed eseguire nell'ordine i due script DOPO aver sostituito "[PREFIX]" con un prefisso minuscolo valido, ad esempio "miogas_" o "miabottega_" (nel caso di multigestione, e in solo in questo caso, tale prefisso sarà poi da specificare nel file di configurazione locale).
Fase 4: configurazione
Creare una copia del file http://www.mio_sito.org/e3g/config_inst.php e denominarla http://www.mio_sito.org/e3g/config.php; aprire quest'ultimo file con un semplice editor di testo e personalizzare i vari dati, in particolare:
- parametri per la connessione al database: hostname, nome del DB, username e password di accesso
- parametri per i messaggi automatici di posta elettronica inviati da Equogest/GestiGAS: indirizzi e nomi del mittente e del destinatario delle risposte, eventuale tipo di invio tramite SMTP coi relativi campi (prefisso, host, porta, autenticazione, nome utente e password)
- il tipo di gestione: specificare "G" per "GestiGAS", oppure "E" per "Equogest"
- parametro "locale" per la definizione della propria nazione e lingua: per l'Italia va bene "it_IT"
- se il server ha attivata la direttiva open_basedir, decommentare la relativa riga
Invio posta tramite SMTP di GMail
A titolo di esempio, riportiamo la configurazione per utilizzare l'SMTP di GMail durante l'invio di messaggi:
define('MAIL_SMTP', true); // Invio tramite SMTP
define('MAIL_SMTP_SECURE', 'ssl'); // Prefisso per il server
define('MAIL_HOST', "smtp.gmail.com"); // Server SMTP
define('MAIL_PORT', 465); // Porta del server SMTP
define('MAIL_SMTP_AUTH', true); // Autenticazione SMTP
define('MAIL_USERNAME', 'vostro-email@gmail.com'); // GMail username
define('MAIL_PASSWORD', 'vostra-password'); // GMail password
Attivazione funzioni periodiche
Alcune funzionalità del programma (notifiche automatiche di apertura e chiusura ordini, mailing-list ecc.), hanno bisogno di essere "sollecitate" periodicamente, ovvero occorre che vengano eseguite almeno una volta al giorno od ogni ora. Il sistema naturale per ottenere questo su server Linux è tramite il comando crontab che consente lo scheduling di qualsiasi script.
Per attivare il relativo crontab si deve quindi aprire in modifica sul server il file che descrive le operazioni periodiche da svolgere:
sudo crontab -e
aggiungere in coda la riga:
0 0-23 * * * wget http://www.mio_sito.org/e3g/cron.php
che determina un "sollecito" ad ogni ora, oppure, nel caso di uso delle sole notifiche automatiche ma non della mailing-list, è sufficiente un "sollecito" quotidiano tramite:
0 6 * * * wget http://www.mio_sito.org/e3g/cron.php
uscire e infine salvare premendo CTRL+X.
Su sistemi Mac OS X il comando equivalente a crontab è launchd.
Chi non può accedere direttamente al server da linea di comando, può optare per una delle seguenti alternative:
- se l'hosting è dotato di pannello Plesk, allora utilizzare l'apposita "schedulazione di eventi";
- utilizzare un servizio online gratuito come http://www.onlinecronjobs.com/
- sfruttare i login degli utenti: mettendo a true la costante presente nel config.php
- define('E3G_LOGIN_CRON', true);
ogni volta che un qualsiasi utente effettua (o tenta) un login al programma, vengono richiamate quelle funzioni da eseguire periodicamente; l'unico problema che si può verificare con tale semplice metodo è che se i login non sono molto frequenti, si rischia che le varie operazioni periodiche non vengano eseguite in tempo. In particolare le notifiche di apertura e chiusura ordini richiedono almeno un richiamo al giorno, mentre la funzione mailing-list richiede almeno un richiamo ogni ora.
Avvio del software
Puntare semplicemente il browser all'indirizzo
e procedere con le cose da fare inizialmente così come descritto nel manuale utente, nella sezione ad uso dell'amministratore (4.1).
Aggiornamento da precedente versione
Fase 1: copie di sicurezza
Prima di procedere, creare anzitutto una copia di sicurezza sia del vostro database, sia dei vostri sorgenti attuali; entrambe vi saranno utili per ripristinare l'attuale situazione nel caso si verifichi qualche imprevisto. Ad esempio si può rinominare http://www.mio_sito.org/e3g in http://www.mio_sito.org/e3g_OLD.
Fase 2: sorgenti "Progetto e3g"
Scompattare la nuova versione dei sorgenti del "Progetto e3g" nella directory (vuota) http://www.mio_sito.org/e3g ed aggiungere il file di configurazione http://www.mio_sito.org/e3g/config.php ricopiandolo dalla precedente installazione.
Fase 3: aggiornamento database
Entrare nel software come amministratore per confermare un eventuale aggiornamento del database. Se questo è previsto dai sorgenti, allora nella prima schermata dopo il login, appaiono uno o due tasti denominati "Aggiorna database..." e "Aggiorna database (tab. condivise)...": non si deve fare altro che premerli nello stesso ordine ed attendere il messaggio che avvisa sull'esito dell'operazione.
Quest'ultima fase va naturalmente eseguita PRIMA che nel sistema entrino gli altri normali utenti.
Casi particolari
Equogest/GestiGAS: aggiornamenti da versioni precedenti di 0.18.0
Chi aggiorna da versioni precedenti di 0.18.0 deve modificare il file di configurazione http://www.mio_sito.org/e3g/config.php aggiungendo la seguente riga:
- // Eventuale attivazione delle funzioni periodiche tramite login
- define('E3G_LOGIN_CRON', false);
Equogest/GestiGAS: aggiornamenti da versioni precedenti di 0.15.0
Chi aggiorna da versioni precedenti di 0.15.0 deve modificare il file di configurazione http://www.mio_sito.org/e3g/config.php aggiungendo il blocco di righe relative all'invio email con SMTP: confrontare nella parte iniziale la propria versione con quella predefinita conf_inst.php. Se non si fa uso di SMTP mantenere tutti i valori così come proposti.
Equogest: aggiornamento da versione 0.12.0
Chi aggiorna Equogest dalla versione 0.12.0 deve eseguire la seguente query di inserimento nel database:
- INSERT INTO [PREFIX]catmerceologica VALUES("000","Non indicato","00");
dopo aver ovviamente sostituito "[PREFIX]" con il prefisso utilizzato per le tabelle del database.
Equogest/GestiGAS: aggiornamenti da versioni precedenti di 0.12.0
Chi aggiorna da versioni precedenti di 0.12.0 deve modificare il file di configurazione http://www.mio_sito.org/e3g/config.php aggiungendo le seguenti due righe:
- // Definizione di nazione e lingua (locale di P4A)
- define('P4A_LOCALE', 'it_IT');
immediatamente prima di
- require_once( dirname(__FILE__) . '/config_const.php' );
Documentazione
Tutta la documentazione, in continua evoluzione così come il software, si trova nella sottodirectory http://www.mio_sito.org/e3g/docs, ma le versioni più aggiornate dei vari documenti sono accessibili on-line ai seguenti indirizzi:
- Manuale Installazione: http://wiki.progettoe3g.org/index.php/Manuale_Installazione_Equogest/GestiGAS
- Manuale Equogest: http://wiki.progettoe3g.org/index.php/Manuale_Equogest
- Manuale GestiGAS: http://wiki.progettoe3g.org/index.php/Manuale_GestiGAS
Supporto
Il supporto tecnico è attualmente costituito da una serie di domande e risposte frequenti sugli aspetti operativi dei software, e da alcuni forum on-line, ad accesso libero o riservato agli iscritti al servizio di supporto professionale. I forum possono anche essere utilizzati per lasciare commenti e/o suggerimenti sul Progetto e3g in generale.
Fare riferimento alla sezione "Supporto" del sito http://www.progettoe3g.org.
Supporto professionale
E' possibile avvalersi di un'installazione personalizzata completa di supporto professionale (forum online, e-mail o telefono) da parte del team che ha ideato e sin qui curato lo sviluppo del presente software.
Per maggiori informazioni mettersi in contatto con gli autori indicati all'inizio del documento.
Appendici
Licenza software "Progetto e3g"
Questo programma è software libero; è lecito redistribuirlo o modificarlo secondo i termini della Licenza Pubblica Generica GNU come pubblicata dalla Free Software Foundation; o la versione 2 della licenza o (a propria scelta) una versione successiva.
Questo programma è distribuito nella speranza che sia utile, ma SENZA ALCUNA GARANZIA; senza neppure la garanzia implicita di NEGOZIABILITA' o di APPLICABILITA' PER UN PARTICOLARE SCOPO. Si veda la Licenza Pubblica Generica GNU per avere maggiori dettagli.
Questo programma deve essere distribuito assieme ad una copia della Licenza Pubblica Generica GNU, che on-line si trova all'indirizzo http://www.gnu.org/licenses/gpl.txt; per una traduzione italiana si veda http://www.softwarelibero.it/gnudoc/gpl.it.txt.
Donazioni
Equogest e GestiGAS sono software libero distribuito gratuitamente, ma sono accettate donazioni in denaro per:
- esprimere apprezzamento per il tempo e le risorse che il gruppo di lavoro sta impiegando per lo sviluppo ed il mantenimento del software
- aiutare a sostenere i costi di esercizio dell'infrastruttura informatica (web server, banda, domini, ecc.)
- accelerare lo sviluppo del software o di una specifica funzionalità
Mettiti in contatto con gli autori indicati all'inizio del documento per avere informazioni su come donare nel modo più conveniente.
