INSTALLARE IGSUITE 3.2. (DOCUMENTO SCADUTO) ------------------------------------------------------------------------------ Indice Argomenti 1. Introduzione 2. Requisiti di installazione 3. Configurazione ed installazione 4. Quick Start 5. Aggiornamento On-Line 1. Upgrade da versioni precedenti 2. Manifest 3. Copyright 1. 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. Si consiglia l'uso di IGSuite in realtà aziendali composte almeno da 3 utenti, fino a un massimo di 50, questo perché per una gestione di liste di utenti superiore alle 50 unità, sarebbe opportuno la divisione degli utenti per gruppi, aspetto non ancora implementato in IGSuite. Per il suo utilizzo lato client, occorre semplicemente 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 la skin preferita, il linguaggio scelto, numerosi parametri di personalizzazione e la possibilità di conferire permessi di accesso alle procedure per utente. 2. 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 o MySQL). E' in programma la possibiltà di utilizzare altri database. I requisiti sono: 2.1. 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) e DBI+DBD::mysql (per MySQL) per i quali vi rimandiamo alle relative documentazioni inerenti l'installazione. Documentazione tecnica: Per ulteriori informazioni sulla policy utilizzata dal framework di IGSuite sull'uso dei moduli Perl: [IG Perl modules policy]. 2.2. 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 l'intero progetto è nativo per PostgreSQL e proprio su questo database è stato maggiormente testato. Per quanto riguarda la configurazione 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 iscriversi alla mailing list di supporto. 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. 2.3. PG.pm o DBI/DBD::mysql 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 usando. Per chi utilizza Linux Vi rimandiamo alla documentazione relativa alla distribuzione in uso. Per Windows invece si può scaricare Perl da ActivePerl (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 minihowto che spiega come installare moduli sotto Windows. N.B. Il modulo Pg.pm per interfacciare perl a PostgreSQL necessario ad IGSuite non è lo stesso di DBI/DBD::Pg!!! 2.4. 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 una piattaforma piuttosto che un'altra. 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, Win98, Win2000 Server, Win XP. E' possibile anche consultare questo documenti: [Installare IG su Windows] 2.5. 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" abbiano i permessi di lettura scrittura ed esecuzione per questa ultima, per l'utente che esegue Apache. Per maggior sicurezza si consiglia di configurare su Apache un VirtualHost creato ad hoc per IGSuite in modo da non interferire con altri "Siti" gestiti dal server. 2.6. 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 2.7. Samba http://www.samba.org (opzionale) 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. 3. 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, oppure leggere questo documento "[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". 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. 5. 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. 1. Upgrade da versioni precedenti * Per l'aggiornamento dalla 3.1.0 alla 3.1.4 è sufficiente installare la nuova release come sopra riportato lo script mkstruct lanciato automaticamente dalla procedura di installazione provvederà ad aggiornare tutte le tabelle dei database usati da IGSuite (infatti in queste release IGSuite utilizzava più di un database). * Per l'aggiornamento alle release 3.1.5 e superiori il problema si complica in quanto IGSuite usa un solo database, e non ha più una struttura paragonabile a quella delle precedenti release. Si consiglia in questi casi di leggere [Upgrade to IG 3.1.7]. * Per l'aggiornamento dalla 3.1.5 alla 3.1.6 è sufficente lanciare la procedura di installazione della nuova release 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] 2. Manifest Per visualizzare il Manifest inerente le ultime release seguire questo indirizzo http://www.igsuite.org/cgi-bin/igwiki?action=findexec&keytofind=manifest&fiel dtofind=name 3. 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, and sure http://www.igsuite.org