Installazione su Linux
La seguente documentazione riguarda l'installazione di WebGUI su un sistema operativo Linux. Queste istruzioni assumono che si abbia familiarità con Linux e con l'installazione di software open source. Se hai bisogno di assistenza, contattaci per stipulare un contratto di assistenza.
Perl
Scarica e installa l'ultima versione di
Perl. WebGUI è stato scritto per la 5.6.0 e dovrebbe funzionare bene con ogni versione successiva.
Moduli Perl
Scarica e installa i seguenti moduli perl da
CPAN. Il modo migliore è di usare il metodo automatico:
perl -MCPAN -e shell
cpan> install LWP
cpan> install DBI
cpan> install DBD::mysql
cpan> install Digest::MD5
cpan> install Date::Calc
cpan> install Image::Magick
Nota: Dovresti sempre controllare questa lista prima di un upgrade perchè ogni tanto vengono aggiunti dei nuovi moduli richiesti.
Web Server
Scarica ed installa
Apache con
mod_perl. Al giorno d'oggi molti sistemi operativi hanno apache già installato. Controlla la tua distribuzione per i dettagli. WebGUI è stato testato con apache 1.3.19.
Nota: non è necessario eseguire WebGUI sotto mod_perl, ma la performance è nettamente migliore. Inoltre, WebGUI può funzionare con qualsiasi web server, ma raccomandiamo apache perchè è il migliore.
Modifica il file di configurazione del web server in modo da farlo puntare alla cartella che contiene il file index.pl di WebGUI. Un virtual host di apache può essere come questo:
<VirtualHost *>
<Files ~ "\.(pl)$">
SetHandler perl-script
PerlHandler Apache::Registry
Options +ExecCGI
</Files>
DocumentRoot /opt/apache/www
ServerName www.mycompany.com
ServerAlias mycompany.com
ErrorLog /opt/apache/logs/error-log
CustomLog /opt/apache/logs/access-log SomeLogType
</VirtualHost>
Database
Scarica ed installa l'ultima versione di
MySQL. WebGUI è stato testato con MySQL 3.23.x.
Nota:
- WebGUI è stato scritto per funzionare con qualsiasi motore database.
- Abbiamo bisogno di esperti database. Se sei esperto di un db diverso dal MySQL e vuoi dare una mano, ti invitiamo a contattare il team di sviluppo.
WebGUI
Scarica la versione più recente di WebGUI. Estraila:
gunzip webgui-latest.tar.gz
tar xvf webgui-latest.tar
Sposta la cartella di WebGUI dove vuoi che sia la root del tuo web server:
mv WebGUI /opt/apache/
Crea un database per l'installazione di WebGUI e aggiungi i privilegi necessari:
mysql -e "create database WebGUI"
mysql -e "grant all privileges on WebGUI.* to webgui@localhost identified by 'password'"
mysql -e "flush privileges"
Riempi il database con lo script di creazione:
mysql -uwebgui -ppassword WebGUI < docs/create.sql
Modifica il file di configurazione e rimpiazza le informazioni standard con le tue. (Attenzione a non inserire spazi vuoti alla fine della riga, questo confonde il config.)
vi etc/WebGUI.conf
Cron Jobs
Se vuoi puoi aggiungere un cron job o due per automatizzare alcune cose nel sistema.
Se ad esempio vuoi che le sessioni scadano automaticamente, o scaricare automaticamente i contenuti da altri siti, dovresti aggiungere questo cron:
10 * * * * cd /opt/www/lib/; perl runHourly.pl > /dev/null
PSST
Queste sono le informazioni relative all'account amministrativo installato di default:
username: Admin
password: 123qwe
Testing
Se hai problemi col tuo sistema o vuoi semplicemente verificare che tutto sia installato correttamente, abbiamo un paio di utility per questo.