INSTALLARE IGSUITE 3.1 (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 e' 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 realta' 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 aprira' una sessione personalizzata, un ambiente in cui sara' possibile gestire il proprio posto di lavoro "virtuale". Il tutto con lo skin preferito, il linguaggio scelto, numerosi parametri di personalizzazione e la possibilita' di conferire permessi di accesso alle procedure per utente. 2. Requisiti di installazione IGSuite e' un insieme di CGI scritti in Perl che si avvale esclusivamente del supporto di un modulo "esterno" (cioe' da installare se gia' non e' presente nel vostro sistema) per interfacciarsi ad un RDBMS (attualmente Postgres o Mysql). E' in programma la possibilta' di utilizzare altri database. I requisiti sono: 2.1. Perl ( http://www.perl.org ) C'e' poco da dire su Perl (versione minima 5.003) IGSuite utilizza alcuni moduli standard di Perl cosidetti Core, ed altri non standard. I moduli non standard sono solo quelli che utilizza per interfacciarsi al Database e cioe' Pg (per postgres) e DBI (per Mysql) per i quali vi rimandiamo alle relative documentazioni inerenti l'installazione. 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 piu' 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 occorrera' individuare o creare un utente che abbia i permessi di creazione di tabelle e database. In caso di problemi si puo' far riferimento agli Howto e alle Faq presenti nella documentazione sul sito ufficiale. N.B. LA MAGGIOR PARTE DEI PROBLEMI DI INSTALLAZIONE DI IGSUITE RISCONTRATI, E' DOVUTA ALLA NON ESATTA DEFINIZIONE 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 e' 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 puo' scaricare Perl da ActivePerl (www.activeperl.com) una distribuzione di Active State. All'interno della distribuzione ActivePerl si potra' 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 postgres necessario ad IGSuite non e' lo stesso di DBI/DBD::Pg!!! 2.4. HylaFax ( http://www.hylafax.org ) E' senza dubbio il miglior server di Fax "Open" che esista. Non necessita di nessuna particolare attenzione. Una volta installato (puo' anche non essere installato IGSuite funziona ugualmente) dovra' essere configurato un utente che abbia accesso (tramite il protocollo FTP) ai fax ricevuti (consultare la documentazione sul sito ufficiale). Per utilizzare tutte le features di IGSuite relative a Hylafax (su Linux), occorrera' installare anche le LIBTIFF sul server dove è installato IGSuite, ma tali features sono del tutto opzionali. N.B. Allo stato attuale non esiste una versione di Hylafax per Windows, tale features quindi non e' utilizzabile su piattaforme Windows 2.5. Samba http://www.samba.org ( Opzionale ) Su samba occorrera' 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'unita' locale ad esempio "L:". Tale share dovra' 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. 2.6. Linux (Qualsiasi distribuzione) - Windows (98 98SE XP NT 2000) Per scelta i mezzi con i quali e' stato creato IGSuite hanno la particolarita' 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 funzionera' senza problemi. Fin'ora e' stato testato il funzionamento di IGSuite sui seguenti sistemi: Suse, RedHat, Mandrake, Debian, Slackware, Win98, Win2000 Server, Win XP. E' possibile anche consultare questo documenti: [Installare IG su Windows] 2.7. 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. 3. Configurazione ed installazione Se prima di installare IGSuite non si e' provveduto a risolvere i requisiti sopra elencati, si avranno numerose anomalie che impediranno sicuramente l'esecuzione di tutte le funzionalita' 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/isogest.conf e seguire le spiegazioni in esso contenute, oppure leggere su questo documento [come configurare IGSuite]. IGWebMail puo' ricevere la posta sfruttando piu' metodi: dall'uso del protocollo POP3 alla lettura diretta dello spool delle caselle locali. Su sistemi Windows si dovra' 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 e' andato bene si trattera' 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 potra' aprire il file index.html generato automaticamente dall'installazione o in alternativa richiamare lo script "isogest". Esempio: http://mioserver/cgi-bin/isogest Verra' 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 possibilita' una manuale e una automatica: Aggiornamento manuale: Lanciare dalla riga di comando il seguente script: root@server# /directory/dei/cgi/isogestd --update-isogest Aggiornamento automatico: "isogestd" e' 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 e' sufficente installare la nuova release come sopra riportato lo script mkstruct lanciato automaticamente dalla procedura di installazione provvedera' ad aggiornare tutte le tabelle dei database usati da IGSuite (infatti in queste release IGSuite utilizzava piu' 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 piu' 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 e' sufficente lanciare la procedura di installazione della nuova release che provvedera' 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 e' sufficente lanciare la procedura di installazione della nuova release e seguire eventuali indicazioni che compariranno a video. 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-2004. 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