==== Introduzione ==== IGSuite è una "suite" di programmi per ufficio molto potente e completa. Sfruttando le caratteristiche di un ambiente Web-based, si rende facile nell'utilizzo e comprende un pacchetto di applicazioni gestite da un ambiente multiutente del tutto personalizzabile. Per il suo utilizzo lato client occorre semplicemente avere un browser di nuova generazione (che supporti JavaScript CSS2 e i Cookie). Puntando all'indirizzo del server, grazie ad un sistema di autenticazione si aprirà una sessione personalizzata, un ambiente in cui sarà possibile gestire il proprio posto di lavoro "virtuale". Il tutto con l'aspetto grafico (skin) preferito, il linguaggio scelto, numerosi parametri di personalizzazione e la possibilità di conferire permessi di accesso alle procedure, per utente. '''NEW!''' Dalla versione 3.2.3 è disponibile per IGSuite un package manager denominato IGPacMan che attraverso un interfaccia web guida l'utente passo passo verso l'installazione automatica del sistema. Tale sistema può essere utilizzato sia su piattaforma Windows che Linux ed in alcuni casi semplifica notevolmente il processo di installazione o aggiornamento. [igpacman|Per saperne di più...] ==== Requisiti di installazione ==== IGSuite è un insieme di CGI scritti in Perl che si avvale esclusivamente del supporto di un modulo "esterno" (cioè da installare se già non è presente nel vostro sistema) per interfacciarsi ad un RDBMS (attualmente PostgreSQL, MySQL o SQLite). E' in programma la possibiltà di utilizzare altri database. I requisiti sono: ===== Perl http://www.perl.org ===== C'è poco da dire su Perl (versione minima 5.003); IGSuite utilizza alcuni moduli standard di Perl cosiddetti Core, ed altri non standard. I moduli non standard sono solo quelli che utilizza per interfacciarsi al Database e cioè Pg per PostgreSQL, DBI e DBD::mysql per MySQL o DBD::sqlite per SQLite per i quali vi rimandiamo alle relative documentazioni ufficiali inerenti la loro installazione. '''Documentazione tecnica: Per ulteriori informazioni sulla policy utilizzata dal framework di IGSuite sull'uso dei moduli Perl: [IG Perl modules policy]'''. ===== PostgreSQL http://www.postgresql.org o MySQL http://www.mysql.com ===== Due dei più maneggevoli Database attualmente disponibili. Durante il nostro lavoro abbiamo avuto modo di testare le prestazioni di entrambe e sicuramente MySQL offre prestazioni maggiori rispetto alla velocità di risposta, ma di contro IGSuite è nativo per PostgreSQL e proprio su questo database è stato maggiormente testato. ===== SQLite http://search.cpan.org/~msergeant/DBD-SQLite-1.12/lib/DBD/SQLite.pm ===== Questo incredibile database è estremamente versatile e utilissimo ma '''solo ed esclusivamente''' nel caso si voglia testare la Suite o la si voglia utilizzare per ininfluenti quantità di dati. L'implementazione di SQLite è molto recente non sconsigliamo quindi il suo utilizzo in server di produzione. Per quanto riguarda la configurazione del server RDBMS che si vuole utilizzare, occorrerà individuare o creare un utente che abbia i '''permessi di creazione di tabelle e database'''. In caso di problemi si può far riferimento agli HowTo e alle Faq presenti nella documentazione sul sito ufficiale e non ultimo utilizzare la mailing-list o il forum o optare per qualche tipologia di supporto commerciale. N.B. LA MAGGIOR PARTE DEI PROBLEMI DI INSTALLAZIONE DI IGSUITE RISCONTRATI, E' DOVUTA ALLA NON ESATTA DEFINIZIONE NELL'RDBMS DI UTENTI CON I DIRITTI PER LA CREAZIONE DI DATABASE E TABELLE. ===== PG.pm o DBI con DBD::mysql o DBD::SQLite http://www.cpan.org ===== Sono i moduli che permettono a Perl di interagire con il database, l'unico accorgimento da avere è che quello installato sul proprio sistema sia compatibile con la versione del Database che si sta utilizzando. Per chi utilizza '''Linux''' Vi rimandiamo alla documentazione relativa alla distribuzione in uso. Infatti per alcune distribuzioni l'installazione dei moduli avviene grazie ad un gestore di pacchetti interno (Es. per Suse c'è Yast) per altre distribuzioni occorrerà partire dai pacchetti offerti da http://www.cpan.org Per chi utilizza '''Windows''' invece si può scaricare Perl da ActivePerl http://www.activeperl.com una distribuzione di Active State. All'interno della distribuzione ActivePerl si potrà trovare documentazione relativa a PPM (Perl Package Manager) per installare i moduli su citati. E' anche presente sul sito di IGSuite nella sezione Howto un mini-howto che spiega come installare moduli Perl sotto Windows. ''N.B. Il modulo Pg.pm per interfacciare perl a PostgreSQL necessario ad IGSuite non è lo stesso di DBI/DBD::Pg!!!'' ===== Linux (Qualsiasi distribuzione) - Windows (98 98SE XP NT 2000) ===== Per scelta i mezzi con i quali è stato creato IGSuite hanno la particolarità di essere "portabili" su ogni piattaforma. Questo libera l'utente dall'obbligo di scegliere un sistema operativo piuttosto che un altro. Assicurarsi che i requisiti sopra elencati siano compatibili con la piattaforma che volete utilizzare per l'installazione di IGSuite e il tutto funzionerà senza problemi. Fin'ora è stato testato il funzionamento di IGSuite sui seguenti sistemi: Suse, RedHat, Mandriva, Gentoo, Debian, Slackware, FreeBSD, Win98, Win2000 Server, Win XP. E' possibile anche consultare questo documenti: [Installare IG su Windows] ===== Apache http://www.apache.org ===== Distribuito ormai per tutte le piattaforme necessita soltanto di qualche accorgimento all'interno del file di configurazione (httpd.conf). Accertarsi che tutte le cartelle e in special modo "DocumentRoot" e "cgi-bin" (o in pratica le directory del proprio sistema che contengono i file di dati e gli script cgi di IGSuite) abbiano i permessi di lettura scrittura ed esecuzione (per quest'ultima), per l'utente che esegue Apache. Per praticità si consiglia di configurare su Apache un VirtualHost creato ad hoc per IGSuite in modo da non interferire con altri "Siti" gestiti dal server. ===== HylaFax http://www.hylafax.org (opzionale) ===== E' senza dubbio il miglior server di Fax "Open" che esista. Non necessita di nessuna particolare attenzione. Una volta installato (può anche non essere installato IGSuite funziona ugualmente) dovrà essere configurato un utente che abbia accesso (tramite il protocollo FTP) ai fax ricevuti (consultare la documentazione sul sito ufficiale). Per utilizzare tutte le feature di IGSuite relative a Hylafax (su Linux), occorrerà installare anche le LIBTIFF sul server dove è installato IGSuite, ma tali feature sono del tutto opzionali. ''N.B. Allo stato attuale non esiste una versione di Hylafax per Windows, tale feature quindi non è utilizzabile su server installati si piattaforma Windows'' ===== Samba http://www.samba.org (opzionale) ===== Su samba, nel caso si voglia utilizzare la gestione documentale di IGSuite, occorrerà semplicemente condividere la directory DocumentRoot di Apache attraverso una share, dove ogni utente di IGSuite dal proprio client abbia permessi di lettura e scrittura, associando la condivisione ad un'unità locale ad esempio "L:". Tale share dovrà permettere la lettura e scrittura anche all'utente che esegue Apache. Questo per permettere ad IGSuite di creare documenti standard o modelli di documenti. Per maggiori informazioni consultare la sezione HowTo sul sito ufficiale del progetto. ==== Configurazione ed installazione ==== Se prima di installare IGSuite non si è provveduto a risolvere i requisiti sopra elencati, si avranno numerose anomalie che impediranno sicuramente l'esecuzione di tutte le funzionalità della suite. Comunque come utente root/Amministratore di sistema, digitare "perl install.pl", e rispondere alle domande che vi verranno fatte. Per configurare IGWebMail occorre allo stato attuale agire manualmente sul file di configurazione dir_dei_cgi/conf/igsuite.conf e seguire le spiegazioni in esso contenute, è possibile inoltre leggere questo documento su "[Configurare IG|come configurare IGSuite]". IGWebMail può ricevere la posta sfruttando più metodi: dall'uso del protocollo POP3 alla lettura diretta dello spool delle caselle locali. Su sistemi Windows si dovrà necessariamente optare per l'utilizzo dei protocolli SMTP e POP3 rispettivamente per l'invio e la ricezione delle e-mail. ==== Quick Start ==== Una volta installato se tutto è andato bene si tratterà semplicemente di spostarsi su un Client e da un Browser (che supporti HTML 4; CCS; JavaScript; e l'uso dei '''cookies''') puntare al server tramite un indirizzo tipo: Esempio: http://mioserver/cgi-bin/igsuite Verrà chiesta una Login e una Password; inserire quella impostata come amministratore di IGSuite durante l'installazione, e una volta loggati cliccare su "Personale" e aggiungere gli altri utenti del sistema o seguire le indicazioni riportate. ==== Aggiornamento On-Line ==== Per aggiornare IGSuite, si hanno a disposizione due possibilità una manuale e una automatica: Aggiornamento manuale: Lanciare dalla riga di comando il seguente script: root@server# /directory/dei/cgi/igsuited --update-igsuite Aggiornamento automatico: "igsuited" è un demone che si occupa di effettuare numerose operazioni tra cui quella di tenere il sistema sempre aggiornato, tramite l'aggiornamento degli script ma anche l'aggiornamento delle tabelle e dei database necessari a IGSuite. Per fare in modo che sia avviato ad ogni riavvio del sistema consultare la documentazione del proprio sistema. === Upgrade da versioni precedenti === * Per l'aggiornamento '''da versioni precedenti alla versione 3.2.0''' occorre leggere la seguente documentazione [Upgrade to IG 3.2|Passare a IGSuite 3.2] * Per l'aggiornamento '''dalla 3.2.0 alla 3.2.3''' è sufficente lanciare la procedura di installazione della nuova release che provvederà ad aggiornare tutte le tabelle in uso. In alternativa ci si può avvalere di [igpacman|IGPacMan].
%blue%BUG%blue%: per via di un bug non ancora individuato esiste la possibilità che in seguito all'aggiornamento da una precedente release si ritrovino tutti gli account degli utenti disabilitati come fossero scaduti. Basterà rientrare in ogni scheda utente e riattivare semplicemente gli account. '''N.b. In ogni caso in seguito ad ogni aggiornamento è buona norma controllare il contenuto del file di configurazione di IGSuite (igsuite.conf).''' === Manifest === Per visualizzare il Manifest inerente le ultime release seguire questo indirizzo http://www.igsuite.org/cgi-bin/igwiki?action=findexec&keytofind=manifest&fieldtofind=name === Copyright === Copyright (c) 1998-2007. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. SEE ALSO perl(1), DBI(3), Mysql(3), Postgres, SQLite, and sure http://www.igsuite.org