Instalación de Bugzilla en windows
Instalación de bugzilla en windows[editar]
Bugzilla es un conjunto de cgi que nos pemiten llevar una base de datos de incidencias de un proyecto desde un navegador web. Supuestamente, cuando alguien da de alta una incidencia, envía correos a las personas implicadas y los devuelve cuando las incidencias se van corrigiendo.
Necesita un servidor web con base de datos. En la instalación yo tengo apache y mysql sobre windows. También necesita perl, así que hay que instalarlo.
- Bugzilla se puede bajar de http://www.bugzilla.org/download/#v222 y me bajo la 2.22 que es la última estable en este momento.
- Una vez bajado el fichero, lo desempaqueto en el directorio de mi sitio web donde quiero que corra bugzilla. Me crea un subdirectorio bugzilla-2.22 y dentro un montón de ficheros.
- Instalo perl que es necesario. Una vez hecho, abro una ventana de ms-dos, voy al directorio bugzilla-2.22 y ejecuto
c:\> perl checksetup.pl
esto me indica si tengo o no todo lo necesario para correr bugzilla. De momento me da errores de que necesito ciertos módulos de perl adicionales
Bugzilla requires some Perl modules which are either missing from your system, or the version on your system is too old. They can be installed by running (as Administrator) the following: ppm install MailTools Minimum version required: 1.67 ppm install MIME-Tools Minimum version required: 5.406 ppm install AppConfig Minimum version required: 1.52 ppm install Template-Toolkit Minimum version required: 2.08 ppm install TimeDate Minimum version required: 2.21 ppm install DBI Minimum version required: 1.38
Instalo el primer paquete con perl, y obtengo lo siguiente
c:\> ppm install MailTools ==================== Install 'MailTools' version 1.74 in ActivePerl 5.8.8.817. ==================== Installing C:\Perl\html\site\lib\Mail\Address.html Installing C:\Perl\html\site\lib\Mail\Cap.html Installing C:\Perl\html\site\lib\Mail\Field.html Installing C:\Perl\html\site\lib\Mail\Filter.html Installing C:\Perl\html\site\lib\Mail\Header.html Installing C:\Perl\html\site\lib\Mail\Internet.html Installing C:\Perl\html\site\lib\Mail\Mailer.html Installing C:\Perl\html\site\lib\Mail\Send.html Installing C:\Perl\html\site\lib\Mail\Util.html Installing C:\Perl\html\site\lib\Mail\Field\AddrList.html Installing C:\Perl\site\lib\auto\Mail\Internet\add_signature.al Installing C:\Perl\site\lib\auto\Mail\Internet\autosplit.ix Installing C:\Perl\site\lib\auto\Mail\Internet\escape_from.al Installing C:\Perl\site\lib\auto\Mail\Internet\nntppost.al Installing C:\Perl\site\lib\auto\Mail\Internet\reply.al Installing C:\Perl\site\lib\auto\Mail\Internet\send.al Installing C:\Perl\site\lib\auto\Mail\Internet\sign.al Installing C:\Perl\site\lib\auto\Mail\Internet\smtpsend.al Installing C:\Perl\site\lib\auto\Mail\Internet\unescape_from.al Installing C:\Perl\site\lib\auto\Mail\Internet\_prephdr.al Installing C:\Perl\site\lib\auto\Mail\Util\autosplit.ix Installing C:\Perl\site\lib\auto\Mail\Util\mailaddress.al Installing C:\Perl\site\lib\auto\Mail\Util\maildomain.al Installing C:\Perl\site\lib\auto\Mail\Util\read_mbox.al Installing C:\Perl\site\lib\Mail\Address.pm Installing C:\Perl\site\lib\Mail\Cap.pm Installing C:\Perl\site\lib\Mail\Field.pm Installing C:\Perl\site\lib\Mail\Filter.pm Installing C:\Perl\site\lib\Mail\Header.pm Installing C:\Perl\site\lib\Mail\Internet.pm Installing C:\Perl\site\lib\Mail\Mailer.pm Installing C:\Perl\site\lib\Mail\Send.pm Installing C:\Perl\site\lib\Mail\Util.pm Installing C:\Perl\site\lib\Mail\Field\AddrList.pm Installing C:\Perl\site\lib\Mail\Field\Date.pm Installing C:\Perl\site\lib\Mail\Mailer\qmail.pm Installing C:\Perl\site\lib\Mail\Mailer\rfc822.pm Installing C:\Perl\site\lib\Mail\Mailer\sendmail.pm Installing C:\Perl\site\lib\Mail\Mailer\smtp.pm Installing C:\Perl\site\lib\Mail\Mailer\testfile.pm Successfully installed MailTools version 1.74 in ActivePerl 5.8.8.817.
repito con los demás paquetes. Hay uno que me da un error de que no puede instalar determinadas caracteríasticas adicionales. Lo ignoro y continuo con los demás paquetes.
Una vez instalados, vuelvo a ejecutar
c:/> perl checksetup.pl
Checking perl modules ...
Checking for AppConfig (v1.52) ok: found v1.55
Checking for CGI (v2.93) ok: found v3.15
Checking for Data::Dumper (any) ok: found v2.121_08
Checking for Date::Format (v2.21) ok: found v2.22
Checking for DBI (v1.38) ok: found v1.50
Checking for File::Spec (v0.84) ok: found v3.12
Checking for File::Temp (any) ok: found v0.16
Checking for Template (v2.08) ok: found v2.13
Checking for Text::Wrap (v2001.0131) ok: found v2005.082401
Checking for Mail::Mailer (v1.67) ok: found v1.74
Checking for MIME::Base64 (v3.01) ok: found v3.07
Checking for MIME::Tools (v5.406) ok: found v5.411
Checking for Storable (any) ok: found v2.15
The following Perl modules are optional:
Checking for GD (v1.20) not found
Checking for Chart::Base (v1.0) not found
Checking for XML::Twig (any) not found
Checking for GD::Graph (any) not found
Checking for GD::Text::Align (any) not found
Checking for PatchReader (v0.9.4) not found
Checking for Image::Magick (any) not found
All the required modules are available at:
http://landfill.bugzilla.org/ppm/
You can add the repository with the following command:
ppm rep add bugzilla http://landfill.bugzilla.org/ppm/
If you you want to see graphical bug charts (plotting historical data over
time), you should install libgd and the following Perl modules:
GD: ppm install GD
Chart: ppm install Chart
If you want to use the bug import/export feature to move bugs to
or from other bugzilla installations, you will need to install
the XML::Twig module by running (as Administrator):
ppm install XML::Twig
If you want to convert BMP image attachments to PNG to conserve
disk space, you will need to install the ImageMagick application
Available from http://www.imagemagick.org, and the Image::Magick
Perl module by running (as Administrator):
ppm install Image::Magick
If you you want to see graphical bug reports (bar, pie and line charts of
current data), you should install libgd and the following Perl modules:
GD: ppm install GD
GD::Graph: ppm install GDGraph
GD::Text::Align: ppm install GDTextUtil
If you want to see pretty HTML views of patches, you should install the
PatchReader module:
PatchReader: ppm install PatchReader
Checking user setup ...
This version of Bugzilla contains some variables that you may
want to change and adapt to your local settings. Please edit the
file './localconfig' and rerun checksetup.pl
The following variables are new to localconfig since you last ran
checksetup.pl: index_html cvsbin interdiffbin diffpath create_htaccess webserv
ergroup db_driver db_host db_pass db_sock db_check
Veo que hay una serie de módulos opcionales que se pueden instalar si se quieren determinadas caracteríasticas, pero de momento los ignoro. Me fijo en las últimas líneas que indican que editemos el fichero ./localconfig para cambiar el valor de las variables que nos resulten interesantes. Edito el fichero y toco más o menos a ojo (básicamente poner el nombre de la base de datos a usar, usuario y password).
Vuelvo a ejecutar el checksetup
c:\> perl checksetup.pl
Checking perl modules ...
Checking for AppConfig (v1.52) ok: found v1.55
Checking for CGI (v2.93) ok: found v3.15
Checking for Data::Dumper (any) ok: found v2.121_08
Checking for Date::Format (v2.21) ok: found v2.22
Checking for DBI (v1.38) ok: found v1.50
Checking for File::Spec (v0.84) ok: found v3.12
Checking for File::Temp (any) ok: found v0.16
Checking for Template (v2.08) ok: found v2.13
Checking for Text::Wrap (v2001.0131) ok: found v2005.082401
Checking for Mail::Mailer (v1.67) ok: found v1.74
Checking for MIME::Base64 (v3.01) ok: found v3.07
Checking for MIME::Tools (v5.406) ok: found v5.411
Checking for Storable (any) ok: found v2.15
The following Perl modules are optional:
Checking for GD (v1.20) not found
Checking for Chart::Base (v1.0) not found
Checking for XML::Twig (any) not found
Checking for GD::Graph (any) not found
Checking for GD::Text::Align (any) not found
Checking for PatchReader (v0.9.4) not found
Checking for Image::Magick (any) not found
All the required modules are available at:
http://landfill.bugzilla.org/ppm/
You can add the repository with the following command:
ppm rep add bugzilla http://landfill.bugzilla.org/ppm/
If you you want to see graphical bug charts (plotting historical data over
time), you should install libgd and the following Perl modules:
GD: ppm install GD
Chart: ppm install Chart
If you want to use the bug import/export feature to move bugs to
or from other bugzilla installations, you will need to install
the XML::Twig module by running (as Administrator):
ppm install XML::Twig
If you want to convert BMP image attachments to PNG to conserve
disk space, you will need to install the ImageMagick application
Available from http://www.imagemagick.org, and the Image::Magick
Perl module by running (as Administrator):
ppm install Image::Magick
If you you want to see graphical bug reports (bar, pie and line charts of
current data), you should install libgd and the following Perl modules:
GD: ppm install GD
GD::Graph: ppm install GDGraph
GD::Text::Align: ppm install GDTextUtil
If you want to see pretty HTML views of patches, you should install the
PatchReader module:
PatchReader: ppm install PatchReader
Checking user setup ...
Creating data directory (./data) ...
Creating local attachments directory ...
Creating graphs directory...
Creating .htaccess...
Creating ./data/attachments/.htaccess...
Creating Bugzilla/.htaccess...
Creating ./data/.htaccess...
Creating ./template/.htaccess...
Creating ./data/webdot/.htaccess...
Bugzilla requires an SMTP server to function on Windows.
Please enter your SMTP server's hostname: "AQUI PONGO MI SERVIDOR SMTP"
Precompiling templates ...
Bugzilla requires that perl's DBD::mysql be installed.
To install this module, you can do:
ppm install DBD-mysql
En un momento se para y me pide mi servidor de smtp (supongo que para enviar los correos, ver en las últimas líneas de la salida). Le pongo el nombre/ip de dicho servidor. Luego me dice que necesito instalar el módulo de perl para mysql, así que ejecuto
c:\> ppm install DBD-mysql ==================== Install 'DBD-mysql' version 3.0002 in ActivePerl 5.8.8.817. ==================== Installing C:\Perl\site\lib\auto\DBD\mysql\mysql.bs Installing C:\Perl\site\lib\auto\DBD\mysql\mysql.dll Installing C:\Perl\site\lib\auto\DBD\mysql\mysql.exp Installing C:\Perl\site\lib\auto\DBD\mysql\mysql.lib Installing C:\Perl\html\site\lib\Mysql.html Installing C:\Perl\html\site\lib\Bundle\DBD\mysql.html Installing C:\Perl\html\site\lib\DBD\mysql.html Installing C:\Perl\html\site\lib\DBD\mysql\INSTALL.html Files found in blib\arch: installing files in blib\lib into architecture depende nt library tree Installing C:\Perl\site\lib\Mysql.pm Installing C:\Perl\site\lib\Bundle\DBD\mysql.pm Installing C:\Perl\site\lib\DBD\mysql.pm Installing C:\Perl\site\lib\DBD\mysql\GetInfo.pm Installing C:\Perl\site\lib\DBD\mysql\INSTALL.pod Installing C:\Perl\site\lib\Mysql\Statement.pm Successfully installed DBD-mysql version 3.0002 in ActivePerl 5.8.8.817.
Vuelvo a ejecutar el checksetup.pl (quito de la salida todo lo que es repetido...). Crea también un montón de tablas en la base de datos, también me salto esa salida. Al final me pide un correo para el administrador de la base de datos de bugzilla.
c:\> perl checksetup.pl ... Looks like we don't have an administrator set up yet. Either this is your first time using Bugzilla, or your administrator's privileges might have accidentally been deleted. Enter the e-mail address of the administrator: "AQUI PONGO MI CORREO DE ADMINISTRADOR" You entered "AQUI SALE MI CORREO DE ADMINISTRADOR". Is this correct? [Y/n] Y Enter the real name of the administrator: "AQUI PONGO MI NOMBRE" Enter a password for the administrator account: "AQUI PONGO UNA PASSWORD" Please retype the password to verify: "AQUI PONGO LA MISMA PASSWORD" "AQUI SALE MI CORREO DE ADMINISTRADOR" is now set up as an administrator account. Now that you have installed Bugzilla, you should visit the 'Parameters' page (linked in the footer of the Administrator account) to ensure it is set up as you wish - this includes setting the 'urlbase' option to the correct url.
Configurar apache para Bugzilla[editar]
Ahora me toca configurar apache para que todo esto vaya bien.
Edito el fichero de configuracion de apache: "inicio", "programas", "apache http server", "configure apache server", "edit de httpd.conf apache configuration file".
Voy a la linea que pone
#AddHandler cgi-script .cgi
y la descomento quitándole la # de delante.
Justo después de un sitio que pone
#
# "C:/Archivos de programa/Apache Software Foundation/Apache2.2/cgi-bin" should be changed to whatever your ScriptAliased
# CGI directory exists, if you have that configured.
#
<Directory "C:/Archivos de programa/Apache Software Foundation/Apache2.2/cgi-bin">
AllowOverride None
Options None
Order allow,deny
Allow from all
</Directory>
le añado mi directorio de bugzilla con lo siguiente
#
# "C:/Archivos de programa/Apache Software Foundation/Apache2.2/cgi-bin" should be changed to whatever your ScriptAliased
# CGI directory exists, if you have that configured.
#
<Directory "C:/Archivos de programa/Apache Software Foundation/Apache2.2/cgi-bin">
AllowOverride None
Options None
Order allow,deny
Allow from all
</Directory>
<Directory "C:/PATH_DE_MI_SITIO_WEB/bugzilla-2.22">
Options +ExecCGI
AllowOverride Limit
DirectoryIndex index.cgi
</Directory>
Reinicio el servidor apache: "inicio", "programas", "apache http server", "control apache server", "restart".
Un problemilla con Bugzilla y la ubicación de Perl[editar]
Abro el navegador, me voy a donde tengo bugzilla http://localhost/bugzilla-2.22
y me sale un "internal server error". Al final, investigando, veo que el index.cgi de bugzilla busca perl en /usr/bin/perl, que supongo es la ubicación en unix/linux. En mi pc, perl se instaló en c:\perl\bin\perl.exe, así que cambio c:\perl por c:\usr
Nuevamente al nevegador y ya funciona.
Cuando necesitas instalar algún plugin de Bugzilla por ejemplo el testopia debes cambiar nuevamente el nombre de la carpeta a Perl para ejecutar nuevamente el checksetup.pl y para visualizarlo en el navegador debes renombrar nuevamente la carpeta Perl como usr. Para evitar este cambio puedes descargarte una herramienta como MB-SearchReplace Pro 1.1 para reemplazar en todos los archivos .pl .cgi y .pm el string #!/usr/bin/perl por #!C:/Perl/bin/perl
Hacer que Bugzilla pueda enviar correos[editar]
Para que bugzilla envíe correos pueden pasar varias cosas.
En bugzilla, entrando como administrador y seleccionando "parameters", "email", podemos configurar qué queremos usar para que bugzilla envíe emails.
Una opción es poner "smtp" y el nombre del servidor smtp. Esto puede que le funcione a gente normal, pero no a mí, que estoy dentro de una empresa con proxy que requiere usuario/password y con un servidor de smtp de la empresa que requiere usuario/password. Como no encontré ningún sitio para poner ese usuario/password o el proxy, me decidí por otra opción.
Otra opción, la que usé, es "sendmail". Para usar "sendmail" desde windows, debemos instalarlo. Me bajé un gratuito y que tiene instalador de sendmail para bugzilla. Para que todo funcione como debe, este sendmail debería instalarse en C:\usr\lib\sendmail.exe. Este es el sitio en el que bugzilla lo busca. sendmail tiene un fichero sendmail.ini en el que podemos tocar cosas como servidor smtp que vamos a usar, usuario y password de ese servidor, etc, etc.
Si queremos instalar sendmail en otro sitio, lo hacemos, pero debemos tocar el fichero ./Bugzilla/Constants.pm de donde hayamos instalado bugzilla. Ahí hay una línea al final que pone algo así como
use constant SENDMAIL_EXE => '/usr/lib/sendmail.exe';
debemos tocarla para que apunte al sitio donde tenemos sendmail.exe
Luego, en mi caso, tuve un problema secundario que pongo por si a alguien le pasa, pero que no tiene por qué. El servidor de smtp de mi empresa no me permite enviar un correo con el campo "from" cambiado (que no sea mi usuario). Como bugzilla se conecta con mi cuenta (a través de sendmail) y pone en el campo "from" algo como "bugzilla-admin-daemon" o "bugzilla-admin", tuve que buscar por todos los ficheros de bugzilla y en la configuración de correo para cambiar ese "from" por mi usuario. Con esto todo listo.
Los ficheros que toqué de bugzilla son estos
./data/template/template/en/default/account/cancel-token.txt.tmpl: $output .= "\n\nFrom: bugzilla-admin-daemon\nTo: "; ./data/template/template/en/default/account/email/change-new.txt.tmpl: $output .= "\nFrom: bugzilla-admin-daemon\nTo: "; ./data/template/template/en/default/account/email/change-old.txt.tmpl: $output .= "\nFrom: bugzilla-admin-daemon\nTo: "; ./data/template/template/en/default/account/password/forgotten-password.txt.tmpl: $output .= "\nFrom: bugzilla-admin-daemon\nTo: "; ./template/en/default/account/cancel-token.txt.tmpl~:From: bugzilla-admin-daemon ./template/en/default/account/email/change-old.txt.tmpl~:From: bugzilla-admin-daemon ./template/en/default/account/password/forgotten-password.txt.tmpl~:From: bugzilla-admin-daemon
En cuanto a la configuración, en "parameters", "email" hay varias cajas con los textos que se van a enviar por los correos en los que está el "from".
Enlaces sobre Bugzilla[editar]
- https://wiki.mozilla.org/Bugzilla:Win32Install
- Traducción al español del anterior: http://www.chuidiang.com/bugzilla/instalacion-bugzilla-windows.php
- http://www.bugzilla.org/docs/2.22/html