INSTALLING IGSUITE 3.2. (DOCUMENTO SCADUTO) ------------------------------------------------------------------------------ Indice Argomenti 1. Introduction 2. Installation Requirements 3. Configuration 4. Quick Start 5. On-Line Update 6. Upgrade from previous versions 7. Manifest 8. Copyright 9. Trademarks 1. Introduction IGSuite is a powerful business applications "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 customer relationship, document management, resource and planning management. To access these powerful business applications, the user simply needs use a new generation browser (with Javascript CSS2 and Cookies support). As an organisation actively involved in the open source community we support the use of the open source browsers such as Mozilla, Firefox and Opera and will also work on Microsoft's Internet Explorer 6. IGSuite has not been tested on any beta version of any browser currently released. 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. 2. 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: 2.1. Perl http://www.perl.org 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]. 2.2. PostgreSQL http://www.postgresql.org or MySQL http://www.mysql.com 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. 2.3. SQLite http://search.cpan.org/~msergeant/DBD-SQLite-1.12/lib/DBD/SQLite.pm 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. 2.4. 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 (E.g. for Suse it is Yast) for other distributions will be necessary to leverage the packages offered 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!! 2.5. Linux (Any Distribution) - Windows (98 98SE XP NT 2000) We choose to write IGSuite applications so that they are portable and can be run on almost every platform. This allows the customer the freedon to run the platform of their choice. Make you sure that requirements list is compatible with the platform you want to use for the installation of IGSuite and all should work without any problems. Currently we have tested IGSuite on following systems: Suse, RedHat, Mandriva, Gentoo, Debian, Slackware, Win98, Win2000 Server, Win XP. For futher information, you can consult these documents: [Installing IGSuite under Windows] 2.6. Apache http://www.apache.org This webserver is distributed for all currently tested platforms and only requires a small amount of customisation inside of the configuration file (httpd.conf). Be sure that all folders and of particular note: “DocumentRoot” and “cgi-bin” (or practically the system directory that contains the data files and cgi scripts of IGSuite) they have the read, write and execute permissions (for cgi-bin directory) for the system user who executes Apache. We recommend that you configure Apache a in VirtualHost configuration for IGSuite so as not to interfere with other “Web Sites” managed by the Apache web server. 2.7. HylaFax http://www.hylafax.org (optional) Without a doubt the better Opensource Fax server that exists. It does not need of no particular attention. Once installed (IGSuite can also be installed without it) will have to be configured an user who has privileges (by FTP protocol) to access to received fax (please read official documentation of Hylafax). In order to use all the Hylafax features in IGSuite (on Linux), it will be necessary to install also the LIBTIFF package on the server where IGSuite is installed, but such feature are completely optional. N.B. At moment does not exist a version of Hylafax for Windows, such feature therefore is not usable by Windows platform 2.8. Samba http://www.samba.org (opzionale) On samba we will simply share the Apache "DocumentRoot" directory where every user of IGSuite from client side has privileges of reading and writing by associating the sharing to a local unit as an example “L: ”. Such share it will have to allow to the reading and writing also to the user who executes Apache. This in order to allow IGSuite to create documents and standard templates. You can consult HowTo section on the official site project. 3. Configuration If before installing IGSuite it has not been provided to resolve requirement over lists to you, numerous anomalies will compromise the execution of all the functionalities of the suite. However as user root/Administrator of the system, type “perl install.pl”, and answer to all the questions that will come made to you. 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. 4. 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. 5. 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. 6. 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 alla versione 3.2.0 occorre leggere la seguente documentazione [Passare a IGSuite 3.2] * 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. 7. Manifest In order to see the latest release of the Manifest, follow this address http://www.igsuite.org/cgi-bin/igwiki?action=findexec&keytofind=manifest&fiel dtofind=name 8. 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 9. Trademarks Microsft and Internet Explorer are trademarks of Microsoft Corporation. All trademarks are recognised as belonging to their rightful owner/s.