Introduction
IGSuite is a powerful and complete applications office "suite" with a web-based interface making it easy to use and deploy. It includes a package of applications which provide a customizable multiuser e-workplace covering such business requriements such as (luca, insert app names here)
To access these powerful business applications, the user simply needs use a new generation browser (with Javascript CSS2 and Cookies support). We recommend using (luca, insert your preferences here. needs to be more than just firefox).
Thanks to the user management and authentication system, when you connect to your server a personalized session will be opened and an environment where it is possible to manage and personalize your "virtual" workplace is presented. All with the preferred look and feel (preferred skin), the chosen language, numerous personal preferences and the possibility to set user privileges per procedure.
Currently, we recommend the use of IGSuite in organisations comprising of between 3 to a maximum of 50 users. Enhancements, such as division by user groups which will assist in user list managment are being explored but are yet to be implemented in IGSuite.
Installation Requirements
IGSuite is a group of cgi written in Perl that take advantage exclusively from an external module support (N.B you have to install if it is not present in your system yet) in order to connect to a RDBMS (PostgreSQl, MySQL or SQLite). There are plans to support other databases.
Requirements are:
There is nothing to special about Perl (minimal version 5.003); IGSuite uses some Perl standard modules, the so-called "Core", and others not are not standard. Non standard modules are only used to connect to the Database like Pg (for PostgreSQL) ; DBI with DBD::mysql for MySQL or DBD::sqlite for SQLite for which we ask you to read the relative documentation.
Technical documentation: For further information about Perl Modules policy used by IGSuite Framework: IG Perl modules policy.
These are two of the most manageable Database currently available. During our job we have tested the performances of both and sure MySQL offers greater speed performances, but the entire project of IGSuite is native for PostgreSQL and it is on this database that IGSuite has been mainly tested.
This incredible database is extremely powerful and useful but only and exclusively when you want to test the Suite or you want to use it for unimportant amounts of data. The implementation of SQLite is very recent and not recommedned for use in production server environment.
As far as the RDBMS configuration it will need to have or to create a user who has the permissions to create tables and database. If you have problems please read HowTo or Faq section in the official documentation. You can also sign to the mailing list or choose some commercial support available.
N.B. THE GREATER NUMBER oF THE PROBLEMS DURING IGSUITE INSTALLATION ARE DUE TO THE INCORRECT SETTING OF USERS RIGHTS FOR THE DATABASE AND TABLE CREATION WITHIN THE RDBMS.
PG.pm or DBI with DBD::mysql or DBD::SQLite http://www.cpan.org 
These are modules that allow Perl to interact with the database. It is important to ensure that the one installed is compatible with the version of the Database that is being used.
If you use Linux we refer you back to the documentation of the respective distribution in use. In fact for some distributions the modules installation happens thanks to an inner packages manager (Es. for Suse is Yast) for other distributions will be necessary to leave from the packages offers by http://www.cpan.org
If you use Windows, you can download Perl from ActivePerl http://www.activeperl.com a distribution of Active State. Inside of ActivePerl distribution you can find documentation relative to PPM (Perl Package Manager) in order to install the cited modules on. On the IGSuite site in the Howto section there is available a mini-howto that explains how to install modules under Windows.
N.B. The Pg.pm Perl interface module necessary to connect PostgreSQL to IGSuite is not the same one as DBI/DBD::Pg!!
Linux (Any Distribution) - Windows (98 98SE XP NT 2000)
We choosed to write IGSuite applications that have the particularitity of being portable on every platform. This set customer free to choose one platform rather than an other.
Make you sure that requirement over list are compatible with the platform you want to use for the installation of IGSuite and all will work without problems.
Until now we have tested IGSuite on following systems: Suse, RedHat, Mandriva, Gentoo, Debian, Slackware, Win98, Win2000 Serveur, Win XP.
It's possible also to consult these documents: Installare IG su Windows
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 questa 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.
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
Su samba occorrerà semplicemente condividere la directory DocumentRoot di Apache creando 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.
Consultare la sezione HowTo sul sito ufficiale del progetto.
Configuration
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 "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 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 all'indirizzo del server.
Si potrà aprire il file index.html generato automaticamente dall'installazione o in alternativa richiamare lo script "igsuite".
Example: 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.
On-Line Update
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 from previous versions
- Per l'aggiornamento dalla 3.1.5 alla 3.1.6 è sufficente lanciare la procedura di installazione della release 3.1.6 che provvederà ad aggiornare tutte le tabelle in uso.
- Per l'aggiornamento dalla 3.1.6 alla 3.1.7 una volta lanciato lo script di installazione occorre spostare la directory /dir_dei_cgi/conf/users in /dir_dei_cgi/data/users creata appositamente all'installazione.
- Per l'aggiornamento dalla 3.1.7 alla 3.1.8 una volta lanciato lo script di installazione occorre spostare il contenuto della tabella 'pagine' (ex tabella per le pagine wiki) nella nuova tabella 'pages' che IG creerà. Ricontrollare i privilegi degli utenti di IG Personale->Utenti->Gestione Permessi.
- Per l'aggiornamento dalla 3.1.8 alla 3.1.9 è sufficente lanciare la procedura di installazione della nuova release e seguire eventuali indicazioni che compariranno a video.
- Per l'aggiornamento dalla 3.2.0 alla 3.2.1 è sufficente lanciare la procedura di installazione della nuova release che provvederà ad aggiornare tutte le tabelle in uso.
Manifest
In order to see the latest release of the Manifest, follow this address http://www.igsuite.org/cgi-bin/igwiki?action=finde...
Copyright
Copyright (c) 1998-2006. 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
| 
