Installazione su Windows 2000
La seguente documentazione riguarda l'installazione di WebGUI sul sistema operativo Windows 2000 con Internet Information Server (IIS). Queste istruzioni danno per assunto che tu abbia familiarità con Windows 2000 e con l'installazione di software per questa piattaforma.
Web Server
IIS dovrebbe essere stato installato insieme a Windows 2000 durante l'installazione del sistema operativo. Se non è così, bisogna installarlo tramite il Pannello di controllo di Windows
Note:
- Assicurati di scaricare gli ultimi service pack per IIS da Microsoft. Sono noti molti buchi di sicurezza nelle release di IIS e molti di essi sono stati risolti dai service pack.
- Puoi eseguire WevGUI sotto IIS o Apache. Diamo le istruzioni per IIS perchè tipicamente è preinstallato in Windows 2000 Server. Se invece vuoi usare Apache puoi scaricarlo da qui.
- WebGUI non supporta e non supporterà in futuro PerlEx di ActiveState. PerlEx ha un modo completamente ridicolo di implementare le più comuni variabili d'ambiente, e non si adegua a nessuno standard se non al loro stesso. Se necessiti di maggior performance, suggeriamo di usare apache con mod_perl.
Perl
Scarica ed installa l'ultima versione di
Active Perl. WebGUI è stato scritto su perl 5.6.x e funziona con ogni versione successiva.
Nota:
- Assicurati che tutte le opzioni di installazione siano spuntate. Questo assicura che Active Perl si configuri per lavorare con IIS.
Moduli Perl
Scarica ed installa i seguenti moduli perl dall'
Archivio CPAN di Active State. Il modo migliore è di usare il metodo automatico:
ppm
PPM> install DBI
PPM> install DBD::mysqlPP
PPM> install Date::Calc
Image Magick
Se vuoi usare le funzioni di thumbnail e di ridimensionamento delle immagini di WebGUI, è necessario installare Image Magick. Puoi ottenerlo da
http://public.planetmirror.com/pub/imagemagick/binaries/
Database
Scarica ed installa l'ultima versione di
MySQL. WebGUI è stato testato con MySQL 3.23.x.
WebGUI
Scarica la più recente versione di WebGUI. Estrai i files usando
WinZip o
WinRAR. (
Nota: Il file è compresso con gzip e tar, ma entrambi i programmi citati riescono a decomprimere questo tipo di archivio)
Usando il Gestione Risorse di Windows sposta o copia la cartella di WebGUI nella root del web server (tipicamente c:\inetpub)
Sempre con il Gestione Risorse di Windows copia il file index.pl dalla cartella "www" nella cartella "wwwroot".
Crea un database per l'installazione di WebGUI ed aggiungi i privilegi necessari (assicurati di essere in C:\inetpub prima) inserendo i seguenti comandi:
mysql -e "create database WebGUI"
mysql -e "grant all privileges on WebGUI.* to webgui@localhost identified by 'password'"
mysql -e "flush privileges"
mysql -uwebgui -ppassword WebGUI < docs/create.sql
Modifica il file di configurazione (in etc/WebGUI.conf ad esempio usando WordPad) e rimpiazza le informazioni uin esso contenute con quelle relative al tuo database. (Fai attenzione a non lasciare spazi sulla fine delle righe, questo confonde il config)
Configurazione di IIS
E' necessario fare una modifica alla configurazione di IIS.
Seleziona dallo Start Menu:
Start > Programs > Administrative Tools > Internet Services Manager
clicca col destro su "Default Web Site" o sul sito che stai configurando per eseguire WebGUI. Quindi scegli "Properties".
Vai sul tab "Home Directory" . Cambia il settaggio chiamato "Execute Permissions" a "Scripts and Executables".
Dovresti anche cliccare sul bottone "Configuration" e verificare che le App Mappings sono state aggiunte .
PATH_INFO
Su IIS la variabile d'ambiente PATH_INFO è disabilitata di default. Questo è un problema perchè questa variabile è necessaria a WebGUI per funzionare. Installando Perl 5.6.x dopo che è stato installato IIS, abbiamo fatto metà di ciò che è necessario. L'altra metà è deselezionare l'opzione con la dicitura "Check that file exists." Puoi trovare questa opzione facendo doppio clic sull'estensione .pl.
Nota: In alcuni rari casi hai anche bisogno di eseguire il seguente comando: adsutil.vbs set w3svc/AllowPathInfoForScriptMappings TRUE Il file "adsutil.vbs" si trova o in "c:\winnt\system32\inetsrv\adminsamples\" o "c:\winnt\system32\inetsrv\adminscripts\" o "c:\inetpub\adminscripts" a seconda della tua installazione.
NOTA IMPORTANTE: Le ultime versioni di IIS hanno rimosso le funzionalità riguardanti PATH_INFO. Questo significa che per installare WebGUI devi aggiungere un "/" dopo index.pl (esempio: http://www.mysite.com/index.pl/).
Per ovviare a questo problema devi creare un file default.plx nella tua cartella che contenga le seguenti linee:
use CGI;
my $c = CGI->new;
print $c->redirect(-uri=>'/index.pl/',-nph=>1);
E devi settare come tua home page default.plx nelle proprietà del sito.
PSST
Le informazioni di default dell'account amministrativo: :
username: Admin
password: 123qwe
Lavori programmati
Potresti voler programmare alcuni job per automatizzare certe parti del sistema.
Se vuoi che le sessioni scadano automaticamente, e che il contenuto degli altri siti venga scaricato periodicamente, devi creare il seguente hourly.bat e programmare che venga eseguito ogni ora.
@echo off
cd \opt\www\lib\
c:\perl\bin\perl runHourly.pl