Installare Bugzilla su Microsoft Windows

Autore originale: Byron Jones        Traduzione a cura di G.C. Cipriani

La versione 2.18 di Bugzilla è stata la prima ad essere completamente compatibile con Windows. La versione stabile corrente è la 2.22 . Questo documento vi guiderà passo passo nell'installazione.

E' importante sapere che alcune cose non funzionerann con Windows (fortunatamente poche). La più importante è l'interfaccia di gestione della posta in ingresso (leggere il file (contrib/README.Mailif).

Bugzilla

I sorgenti di Bugzilla sono disponibili in due formati: CVS o tarball. Il metodo migliore per installare ed upgradare Bugzilla è indubbiamente quello di utilizzare il CVS (soprattutto se lo avete in precedenza customizzato).

Leggete il Release Notes prima di fare qualsiasi cosa..

Installare Bugzilla mediante CVS

Scaricare il client CVSNT da http://www.cvsnt.org/ (2.15 Mega).

Installare il programma. Avrete bisogno di installare il Command line client ed il Password Server (:pserver:) Protocol. Dopo aver completato l'installazione eseguite un log out ed un log in per rendere effettive la modifiche al PATH

Nota: questo documento assume che abbiate installato Bugzilla nella directory C:\Bugzilla.

Aprite la dosshell (command line) e andate nella directory "parente" di Bugzilla. Se avete installato Bugzilla nella directory c:\buzgzilla dovete andare in c:\ 

Upgrade di Bugzilla mediante CVS

Se avete installato una versione precedente di Bugzilla l'update alla 2.22 è semplice. Mediante CVS verranno applicate direttamente le modifiche ai sorgenti. Se CVS non è in grado di farlo indicherà una "C" nella prima colonna del suo reporto (in questo caso dovrete risolvere il conflitto manualmente). Posizionatevi nella cartella c:\bugzilla ed eseguite questi comandi:

Installare Bugzilla dal TarBall (file .tar)

Scaricare Bugzilla 2.22 from: 
http://bugzilla.org/download.html (1.9 Mega).

Utilizzate un programma di gestione archivi compressi "decente" per scomprimere il file (rar o zip vanno benissimo)..

Decompattata il file dove preferite. La soluzione migliore è comunque creare una cartella C:\Bugzilla.

Upgrade dal TarBall

Se installi Bugzilla dal tarball per l'upgrade segui le istruzioni indicate nella sezione.CVS.

MySQL

Scaricare MySQL 4.1.x e MySQLcc

Scarica il file MySQL "Windows Essentials" da
http://dev.mysql.com/downloads/mysql/4.1.html (14.1 Mega).

MySQL 5.x è in fase di sviluppo e non è raccomandato. Non utilizzare nemmeno la versione 3.x.

Installazione

Utilizzare il programma di installazione di MySQL . Utilizzare l'installazione "Typical MySQL install" (quella di default). La directory di default di installazione (quella che considereremo noi) sarà C:\mysql.

Creare il database dei Bugs e l'utente per Bugzilla

Useremo la command line di  mysql per creare il database di Bugzilla ed un account MySql per Bugzilla.

La password di esempio 'sockmonkey' sarà quella per l'account di Bugzilla. Potete utilizzare quella che preferite.:

C:\mysql\bin>mysql --user=root -p mysql
Enter password: ********
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 15 to server version: 4.0.20a-debug

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql> create database bugs;

Query OK, 1 row affected (0.11 sec)

mysql> grant all privileges on bugs.* to 'bugs'@'localhost' identified by 'sockmonkey';
Query OK, 0 rows affected (0.03 sec)

mysql> flush privileges;
Query OK, 0 rows affected (0.00 sec)

mysql> quit

Bye

C:\mysql\bin> 

Se state utilizzando MySQL 4.1, potrebbe comparirvi la segnalazione di errore Client does not support authentication protocol requested by server. Per risolvere questo errore dovete resettare la password dell'utente che avete appena creato.

ActiveState Perl

Scaricare ActiveState Perl 5.8.1 o superiori

Scaricare ActiveState Perl 5.8.1 o superiori (versione MSI) da:
http://activestate.com/Products/Download/Download.plex?id=ActivePerl (12.5 Mega).

Notare che Bugzilla richiede ActiveState Perl 5.8.1 e necessita di CGI.pm versione 2.93 o superiori. La versione 5.8.0 di Perl contiene CGI.pm versione 2.81 mentre la versione 5.8.1 contiene CGI.pm versione 3.00.

C'è un file: a bug in Time::Local 1.10, contenuto in ActiveState Perl 5.8.6, che causa dei warning all'inizio di ogni buglist. Meglio quindi evitare la versione 5.8.6 (limitarsi alla versione 5.8.4).

Installazione

ActiveState Perl usa il Windows Installer. La cartella di default sarà C:\Perl.

Nota: non utilizzare spazi nel nome delle cartelle (es "C:\Program Files") altrimenti l'installer si bloccherà.

Dopo l'installazione uscire e rientrare dall'account per eseguire i cambiamenti sul PATH..

Upgrade di installazioni precedenti

Se hai già installato il PERL controlla semplicemente di avere i moduli aggiornati. Al limite aggiorna anche PERL (ma non è strettamente necessario, se la versione è compatibile con Bugzilla).

Per upgradare ActiveState Perl, seguire le indicazioni di questo file:
http://aspn.activestate.com/ASPN/docs/ActivePerl/install.html

Per upgradare i moduli semplicemente lancia la procedura ppm upgrade

Creare una directory Temp 

In Windows, Perl ha bisogno di una directory di lavoro per i files temporanei (CGI.pm, File::Spec). E' sufficiente che tale directory sia nel path di windows..

Per evitare problemi, controllate (o create) una C:\Temp directory ed assicuratevi che sia possibile accedere in r/w.

Installare i moduli

Bugzilla richiede l'installazione di diversi moduli PERL, la maggior parte dei quali sono disponibili alla locazione http://landfill.bugzilla.org/ppm/.

Se usi un firewall potresti avere problemi nell'uso di PPM. Leggi le faq contenute nell'ActivePerl FAQ.

Il modulo Net::LDAP + l'unico richiesto se vuoi utilizzare Active Directory for authentication.

PatchReader 0.9.4

Assicuratevi che la versione di PatchReader installata sia la 0.9.4 o superiori. Se è più vecchia disinstallala e reinstalla quella nuova dall'indirizzo http://landfill.bugzilla.org/ppm/PatchReader.ppd.

Apache

E' preferibile lanciare Bugzilla a mezzo di un web server Apache. Se vuoi usare IIS segui le configuration instructions nella documentazione di Bugzilla..

Scarica Apache 2.x

Preleva Apache HTTP Server versione 2.x o superiori da:
http://httpd.apache.org/download.cgi (5.8 Mega).

Installazione

L'installazione a mezzo windows installer è estremamente semplice. Segui il prompt, ed esegui l'installazione multiutente (All Users). Apache si autoinstalla in una Apache2 directory all'interno del path specificato in fase di installazione. Il path di default sarà quindi C:\Programmi\Apache Group e quindi Apache sarà installato in  C:\Programmi\Apache Group\Apache2..

Nel nostro documento assumeremo che di default Apache sia installato in C:\Programmi\Apache Group\Apache2.

Se già sta girando IIS dovrai configurare Apache affinché giri su un port differente dall' 80, altrimenti ci saranno seri problemi. Scegli comunque l'installazione All Users e cambieremo il port più avanti.

Di default Apache sarà installato con l'account System. Per ragioni di sicurezza è meglio riconfigurare il servizio affinché giri come Apache utente. Creare un utente che non sia membro di gruppi e riconfigurare Apache affinché giri con quell'account..

Garantire l'accesso in scrittura per l'account di Apache

Di default Apache gira con l'account System. Questo account richiede la possibilità di scrivere/modificare dati nelle directoy seguenti e nelle relative sottodirectories. 

• C:\Bugzilla\data
• C:\Programmi\Apache Group\Apache2\logs
• C:\Temp

Notare chet C:\Bugzilla\data viene creato la prima volta che lanci checksetup.pl.

Configurare il Port e la DocumentRoot

Edita il file C:\Programmi\Apache Group\Apache2\conf\httpd.conf con il tuo text editor preferito.

Per cambiare i ports di Apache (listens on, o binds to), edita le opzioni Listen.

Cambia il  DocumentRoot per settarlo in C:\Bugzilla. Nota che ci sono due  locazioni in httpd.conf che vanno updatate. Dovrai usare / invece di \ come separatore del path.

Configura CGI

Per abilitare il supporto CGI in Apache devi abilitare il riconoscimento dei CGI togliendo il commento alla linea AddHandler cgi-script .cgi .

E consentire gli script CGI nella directory di Bugzilla inserendo l'opzione ExecCGI. Avremo anche modificare i privilegi di accesso ai documenti sensibili modificando l'opzione AllowOverride None in AllowOverride All.

Apache ha bisogno di sapere come interpretare gli script CGI a mezzo della direttiva ScriptInterpreterSource.

#
# This should be changed to whatever you set DocumentRoot to.
#
<Directory "C:/Bugzilla">

#
# Possible values for the Options directive are "None", "All",
# or any combination of:
#   Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
#
# Note that "MultiViews" must be named *explicitly* --- "Options All"
# doesn't give it to you.
#
# The Options directive is both complicated and important.  Please see
# http://httpd.apache.org/docs-2.0/mod/core.html#options
# for more information.
#
    Options Indexes FollowSymLinks ExecCGI

#
# AllowOverride controls what directives may be placed in .htaccess files.
# It can be "All", "None", or any combination of the keywords:
#   Options FileInfo AuthConfig Limit
#
    AllowOverride All

#
# Controls who can get stuff from this server.
#
    Order allow,deny
    Allow from all

#
# Tell Apache to use Perl to execute .cgi
#
    ScriptInterpreterSource Registry-Strict

</Directory>

#
# DirectoryIndex: sets the file that Apache will serve if a directory
# is requested.
#
# The index.html.var file (a type-map) is used to deliver content-
# negotiated documents.  The MultiViews Option can be used for the 
# same purpose, but it is much slower.
#
DirectoryIndex index.html index.html.var index.cgi

Affinché lo ScriptInterpreterSource Registry-Strict funzioni, dovrai inserire una modifica nel registro affinché Apache utilizzi PERL per eseguire gli script CGI..

Creare una key HKEY_CLASSES_ROOT\.cgi\Shell\ExecCGI\Command con il path completo di perl.exe con il parametro -T . Per esempio C:\Perl\bin\perl.exe -T

Disabilitare i logs

Per evitare una gestione dei log inutile può essere utile commentare la direttiva customLog.

Riavviare Apache

Siamo giunti alla fine. Riavviare Apache per acquisire i cambiamenti.

Extra

Bugzilla (v2.20) ha un supporto interno per i servers SMTP, ma non supporta l'autenticazione dei servers SMTP o la gestione degli errori..

Se ti occorre l'autenticazione SMTP ), puoi usare Glob's sendmail wrapper. Scaricalo ed installalo come indicato nel suo sito.

Se abiliti i logs in Sendmail, dovrai assicurarti che Apache abbia il permesso in scrittura nella C:\usr\lib.

Configurare Bugzilla

checksetup.pl

Lancia checksetup.pl. Controllerà i moduli PERL e creerà un localconfig.

Edita il localconfig

Apri il C:\Bugzilla\localconfig con il tuo text editor preferito.

Dovrai dire a Bugzilla come accedere al tuo database. Se usi bugs/bugs, dovrai settare solo la db_pass.

checksetup.pl

Lancia ancora checksetup.pl . Stavolta inizializzerà le tabelle del database e configurerà Bugzilla.

Parametri

Ora puoi collegarti a Bugzilla utilizzando l'account appena creato. Punta il tuo browser su http://localhost/, scegli Log in to an existing account, ed esegui il login.

In fondo alla pagina scegli Parameters.

Metti la tua password di email nell'opzione maintainer.

Metti l'URL di Bugzilla nel campo urlbase . Questo URL sarà utilizzato nelle email..

Scarica ed installa WebDot da http://www.graphviz.org/Download_windows.php. Metti il path completo di dot.exe in webdotbase.

Schedulazione Tasks

collectstats.pl

Configurata un task schedulato per fare girare collectstats.pl di notte.

Passo-passo per Windows XP:

1. Pannello di controllo --> Operazioni pianificate--> Aggiungi operazione pianificata
2. Avanti
3. Sfoglia
4. Cerca perl.exe (se non hai cambiato path è in C:\Perl\bin\perl.exe)
5. Dagli un nome, per esempio "Bugzilla CollectStats"
6. Configurara il processo affinchè venga eseguito ogni giorno all'ora da te preferita
7. Se Apache gira come user e non come SYSTEM, inserisci qui l'utente. Altrimenti dovrai creare un account che abbia i privilegi di accesso/scrittura nella directory di Bugzilla.
8. Seleziona "proprietà".
9. Inserisci "-T" ed il nome dello script nel path di perl. Ad esempio C:\Perl\bin\perl.exe -T C:\Bugzilla\collectstats.pl
10. Cambia la directory di partenza ("da") indicando la directory di Bugzulla.

whineatnews.pl

Aggiungi una operazione pianificata per whineatnews.pl così come hai fatto per collectstats.pl

Backup di Bugzilla

Vuoi backuppare l'intera directory di Bugzilla ? E' piccola e dovrai semplicemente realizzare una operazione custom per il backup di windows.

La cosa più importante da backuppare è il database. MySQl ha già delle opzioni che consentono di estrarre i dati e salvarli..

Schedula mysqldump per creare il dump e inserisci il file risultante nel file di backup. Troverai la documentazione su mysqldump all'indirizzo http://dev.mysql.com/doc/mysql/en/mysqldump.html.

Congratulations, the Bugzilla installation process is complete!