Win2000下Bugzilla安装实录

 

 

(作者：Jackey，网址：www.kuihua.net)

1       前言：

Bugzilla是软件测试的利器，是一款优秀的开源的Bug Tracking System；由于是专门为Unix定制开发的，因此要想在Windows平台下安装，需要费不少的劲；不晓得是什么原因，网上有关Bugzilla的安装讲解大多都是支离破碎的，再加上它本身就是一种可以任意修改的Perl脚本程序，而且Bugzilla开发小组在代码维护和发布上也可能有点小问题；这些因素造成要想在Windows平台下搭建一个相对完整的Bugzilla系统，更是难上加难；不过，如果有一定的Perl语言知识的话，改动起来还是比较快的。

本文是针对在Windows的LAN环境下，安装和修改Bugzilla脚本的的经验介绍，一步一步的向您介绍如何配置和搭建Bugzilla的安装环境。下面是本文的另一些连接映射，欢迎各位看官讨论使用，共同进步。

葵花论坛：http://www.kuihua.net/bbs/dispbbs.asp?boardID=1&RootID=1035&ID=1035

微软培训：http://www.devmanclub.com/ShowPost.aspx?PostID=4130

CSDN专栏：http://www.csdn.net/Develop/read_article.asp?id=24088

    另外，本文参考了微软培训论坛里的如下文章，本文应该是此文的改进版：），如有不妥，请留言或E-Mail联系我。同时，为了确保各位看官能够真正将Bugzilla用起来，将广大的人民群众从修改Perl脚本的苦海中解救出来，我还提供了一个已经排除了大量Bug的汉化版，但还是要做简单修改，主要是填写E-Mail地址和Mysql的安装路径；文章最后还探讨了如何利用CVSNT系统，与Bugzilla开发小组同步升级，避免重复修改Bugzilla的升级版本；有关CVSNT系统请参考本人的相关文章。

      

参考文章：http://www.devmanclub.com/ShowPost.aspx?PostID=2584

CVS文章：http://www.csdn.net/Develop/read_article.asp?id=19756

下载连接：http://www.kuihua.net/soft/Bugzilla-2.17.6(Jackey).rar

 

最后，祝愿各位看官用得开心，每天利用Bugzilla消灭无数的Bug，哈哈！！

2       安装Mysql与Mysqlcc：

1.   本文使用的是最新Mysql For Windows的4.0.17版本，没有出现问题，这是官方下载连接：http://www.mysql.com/get/Downloads/MySQL-4.0/mysql-4.0.17-win.zip

2.   安装时需要注意最好不要改动Mysql的默认安装位置，否则，无法引导，需要改动一些设置。这里假设你的安装位置为：D:\mysql

3.   安装完毕后进入D:\mysql\bin，执行winmysqladmin.exe，如果出现绿灯，则说明你的Mysql系统正常启动了。

4.   下载Mysql Center Control版本，这是一个Mysql的管理器，可以直接修改数据库内容，非常方便。下载连接：http://ftp.tku.edu.tw/mysql/Downloads/MySQLCC/mysqlcc-0.9.3-win32.zip

5.   修改mysql的root用户密码：

D:\>cd mysql

D:\mysql>cd bin

D:\mysql\bin>mysql -u root mysql

mysql>UPDATE user SET Password=PASSWORD('<new_password'>) WHERE user='root';

mysql>FLUSH PRIVILEGES;

说明：其中<new_password>为root用户的新密码。更改密码后，要用root用户访问mysql，必须使用mysql -u root -p，按提示敲入正确的root新密码。

6.   创建bugs用户，并赋给相应的权限：

   mysql>GRANT SELECT, INSERT, UPDATE, DELETE, INDEX, ALTER, CREATE, DROP, REFERENCES, LOCK TABLES, CREATE TEMPORARY TABLES ON bugs.* TO bugs@localhost IDENTIFIED BY '<bugs_password>';

mysql> FLUSH PRIVILEGES;

说明：要记住bugs用户的密码，在下面的bugzilla配置文件要用。

7.   创建bugs数据库：

mysql>create database bugs;

mysql>exit

8.   这时可以打开mysqlcc.exe，用root用户登陆到本机的mysql数据库中，看看变化；注意：上面的数据库操作可以直接在mysqlcc中操作。

3       安装ActivePerl和相关Module：

1.   下载ActivePerl-5.6.1.633-MSWin32-x86.msi或以上版本。这里假设你的安装路径是：D:\Perl

2.   修改PPM（Perl Package Manager）的下载地址，提高Perl安装其它模块时的下载速度。

打开D:\Perl\Lib\CPAN.pm，查找并更改$CPAN: defaultsite ||= "ftp://ftp.perl.org/pub/CPAN";为$CPAN: defaultsite ||= "http://cpan.shellhung.org";

3.   由于有几个Perl Module无法直接安装，需要下载到本地通过nmake.exe和cl.exe编译并安装，因此，最好装一个Visual C++ 6.0，这样才能完成特殊模块的安装。

4.   Bugzilla需要多个Perl Module的支持，在它的帮助文档中有介绍，为了方便和简化各位看官的安装过程，本人写了一个简单的批处理文件，如果你下载了本人提供的修改包，解压后有一个PerlModule目录，里面有一个PerlModule.bat文件，直接运行就可以了，但需要注意的是：有几个模块无法直接安装，仔细看提示，告诉了你如何安装这些特殊模块。这里新增加了Authen::SASL模块，用于发送邮件认证信息。此外，在本文的附录中列出了这个批处理的源代码，供各位看官改进和参考。

4       下载Bugzilla：

1.   首先说明：如果你已经下载了我提供的修改包，这部分可以直接跳过，修改包里已经改好了。

2.   www.bugzilla.org上目前只有bugzilla-2.17.6.tar.gz下载，但是它的用户认证部分有问题，就是Bugzilla\Bugzilla\Auth\DB.pm这个文件，可以从Mozilla提供的CVS服务器上下载最新的替换掉，Mozilla的CVS服务器如下：anonymous@cvs-mirror.mozilla.org:/cvsroot

3.   这里假设你的解压位置为：D:\Bugzilla

4.   下载中文汉化版，可以到sourceforge.net下载，本人的修改包中使用的是最新的bugailla-2.17.4-cn-0.92.tar.gz，由候光敏汉化，不过，好多地方都还是英文的，如果各位看官有兴趣的话可以自己跟自己的需要自己汉化，因为它都是一些有源代码的脚本。

5.   把下载的文件解压，将cn目录拷贝到D:\Bugzilla\template目录下。

5       配置IIS：

1.   打开【控制面板】->【管理工具】->【Internet 服务管理器】，在【默认 Web 站点】点按右键选择【属性】->【主目录】->【配置…】，在【应用程序映射】中点击【添加】，增加如下资料：

2.   Perl脚本解析器：(*.pl)

可执行文件: D:\Perl\bin\perl.exe "%s" %s

扩展名: .pl

仅限于: GET,HEAD,POST

3.   CGI脚本解析器：(*.cgi)

可执行文件: D:\Perl\bin\perl.exe "%s" %s

扩展名: .cgi

仅限于: GET,HEAD,POST

4.   默认 Web 站点】->【新建】->【虚拟目录】：

别名：Bugzilla，访问目录：D:\Bugzilla，访问权限中增加【写入】权限。

5.   选择刚建立的虚拟目录Bugzilla，右键选择【属性】-> 【文档】。【默认文档】中增加index.cgi。

 

6       修改Perl脚本文件：

6.1    已经下载了本人提供的修改包的看官请看：

1.   打开D:\Bugzilla\defparams.pl文件，定位到文件尾部，做如下的信息修改：

2.   替换Bugzilla访问页面：

替换http://<Your Bugzilla Root URL>为你对外提供Bugzilla访问的地址，主要用于E-Mail通知。

例如：http://192.168.0.1/Bugzilla/ （最后一个反斜杠一定要加，否则会出问题。）

3.   替换E-Mail的服务器地址：

找到<Your E-Mail Server Address>，替换成你的邮箱的服务器地址，主要用于E-Mail通知。

例如：pop3.263.net

4.   替换E-Mail的发送者地址：

找到<Your E-Mail Address>，替换成你的邮箱的地址，Bugzilla系统邮件通知的源地址。

例如：yoyo@263.net

5.   替换E-Mail发送者的邮箱密码：

找到<Your E-Mail Password>，替换成你的邮箱密码，主要用于需要认证的邮件服务器。

例如：I am ladengJ

6.   打开D:\Bugzilla\localconfig文件，做如下的信息修改：

7.   修改Mysql的安装路径：

找到 $mysqlpath= 替换成你的mysql安装路径，注意要用双斜杠。

例如：$mysqlpath = “D:\\mysql\\bin\\mysql”;

8.   修改登陆Mysql系统的bugs用户的登陆密码：

找到 $db_pass= 替换成在安装Mysql时创建的bugs用户的登陆密码。

例如：$db_pass = "I am ladeng";

6.2    没有下载本人提供的修改包的看官请看：

1.   打开D:\Bugzilla下所有的.cgi文件，将最后一行的T字符去掉，如下：

例如：#!/usr/bin/perl –wT  =>  #!/usr/bin/perl -w

2.   打开D:\Bugzilla下所有的.cgi文件，找到require "CGI.pl"; 在它后面增加一行：

require "Globals.pl"; 注意G一定要打写，否则Perl会报告无法定位一些文件；但有几个文件很特殊，必须写成require “globals.pl”，真是奇怪，这些文件是：Token.cgi、UserPrefs.cgi、Token.pm，这个问题不晓得是什么原因，哪位看官晓得原因的话，请给我讲讲：）

3.   打开D:\Bugzilla\globals.pl文件，在Use Bugzilla前面加入如下的邮件发送代码：

sub SendMail

{

    my ($msg,$person) = @_;

      

    use Net::SMTP;

   

    my $smtp_server = Param("mailserver");

    my $smtp_user = Param("mailuser");

    my $smtp_pass = Param("mailpass");

  

          #$person .= Param('emailsuffix');

       my $smtp = Net::SMTP->new($smtp_server) ||

              die 'Cannot connect to server \'$smtp_server\'';

      

       $smtp->auth($smtp_user,$smtp_pass);

      

       $smtp->mail($smtp_user);

       $smtp->to($person);

       $smtp->data();

       $smtp->datasend($msg);

       $smtp->dataend();

       $smtp->quit;

}

4.   打开D:\Bugzilla\defparams.pl文件，修改默认语言设置：

找到 name => ‘language’

修改 default => ‘en’ 为 default => ‘cn’

找到 name => ‘defaultlanguage’

修改 default => ‘en’ 为 default => ‘cn’

5.   打开D:\Bugzilla\defparams.pl文件，修改默认Bugzilla登陆页面：

找到 name => 'urlbase'

修改 default => ‘http://….’ 根据你的具体Bugzilla登陆页面进行修改。

6.   打开D:\Bugzilla\ defparams.pl文件，增加3个邮件通知需要的全局参数配置项：

①   MailServer（邮件发送服务器地址）

{

  name => 'mailserver',

  desc => 'Mail-Server assigned by Jackey in 2004.02.02!',

  type => 't',

  default => 'pop3.263.net'

},

②   MailUser（邮件发送者邮箱）

{

 name => 'mailuser',

 desc => 'Mail-User assigned by Jackey in 2004.02.02!',

 type => 't',

 default => 'yoyo@263.net'

}, 

③   MailPass（邮件发送者密码）

{

 name => 'mailpass',

 desc => 'Mail-Pass assigned by Jackey in 2004.02.02!',

 type => 't',

 default => 'I am ladengJ'

}, 

7.   打开与邮件发送相关的.cgi、.pl、.pm文件进行邮件配置修改：具体方法是屏蔽掉原来的邮件发送代码open SendMail，替换成自定义的SendMail(…)函数。

①  打开D:\Bugzilla\CGI.pl，将open SendMail改成：

SendMail($msg,$login);

②  打开D:\Bugzilla\Token.pm，将open SendMail改成：

SendMail($message,$vars->{'emailaddress'});

③  打开D:\Bugzilla\whineatnews.pl，将open SendMail改成：

SendMail($msg,$substs{'email'});

④  打开D:\Bugzilla\move.pl，将open SendMail改成：

SendMail($msg,$to);

⑤  打开D:\Bugzilla\importxml.pl，将open SendMail改成：

SendMail($header . $message . "\n",$to);

⑥  打开D:\Bugzilla\BugMail.pm，将open SendMail改成：

SendMail($msg,$person)

⑦  打开D:\Bugzilla\Flag.pm，将open SendMail改成：

SendMail($message,$flag->{'type'}->{'cc_list'});

⑧  打开D:\Bugzilla\globals.pl，将open SendMail改成：

SendMail($msg,$name);

8.   打开D:\Bugzilla\checksetup.pl文件，注释掉与平台相关的代码：[3967-3972，4004-4008]

#$SIG{HUP}  = \&bailout;

#$SIG{INT}  = \&bailout;

#$SIG{QUIT} = \&bailout;

#$SIG{TERM} = \&bailout;

#system("stty","-echo");  # disable input echoing

9.   打开D:\Bugzilla\checksetup.pl文件，修改mysql安装路径：

找到my $mysql_binaries = `which mysql`; => my $mysql_binaries = "D:\\mysql\\bin\\mysql"

10. 打开D:\Bugzilla\checksetup.pl文件，修改cvsnt安装路径：(安装了cvsnt才需要修改)

找到my $cvs_executable = `which cvs`; => my $cvs_executable = “D:\\cvsnt\\cvs.exe”;

11. 打开D:\Bugzilla\checksetup.pl文件，修改webservergid信息：

找到my $webservergid = getgrnam($my_webservergroup) => my my $webservergid = ‘8’

12. 打开D:\Bugzilla\checksetup.pl文件，更正回车换行问题，这是由于Unix与Windows平台差异造成的：Unix的回车换行是 \n，而Windows是 \r\n，因此需要去掉一个字符。

找到chomp $login; 增加一行chop $login;

找到chomp $realname; 增加一行chop $realname;

找到chomp $pass1; 增加一行chop $pass1;

找到chomp $pass2; 增加一行chop $pass2;

13. 打开CMD.exe，进入D:\Bugzilla目录，键入perl checksetup.pl，运行一下，这时会生成一些文件，打开生成的localconfig文件，修改如下信息：

$index_html = 1 (生成index.html)

$mysqlpath = "D:\\mysql\\bin" (你的mysql\bin路径)

$webservergroup = "8"

$db_user = "bugs" (mysql的登陆用户名)

$db_pass = '<bugs_password>'(mysql bugs用户的登陆密码)

14. OK！！脚本修改完毕，就差一步了，下面是正式安装Bugzilla。

7       正式安装Bugzilla：

1.   打开CMD.exe，进入到D:\Bugzilla目录，键入perl checksetup.pl，会显示一系列的信息，仔细阅读，它可以反映你所配置的环境是否适合安装Bugzilla，Good Luck!!!J

2.   如果一切顺利的话，系统提示创建Administrator的相关邮件（用户登陆名）、Realname、登陆密码等资料。最后，如果成功，会提示“Reminder: Bugzilla now requires version 8.7 or later of sendmail！”

3.   打开浏览器，键入http://localhost/bugzilla 即可进入Bugzilla登陆界面，输入刚刚建立的Administrator用户和密码，注意：登陆名是邮箱地址。

4.   如果你很幸运的话，应该看到了一张很奇怪，很单调，甚至有点粗糙的页面；那么，我可以恭喜你了，因为，你已经进入了Bugzilla的神奇世界了…J

5.   你可以测试一下邮件通知功能：在注册与密码丢失部分都可以进行测试，亲身体会一下Bugzilla带来的神奇世界吧…J

8       如何与Bugzilla开发小组的版本同步：

当各位看官费劲千辛万苦，终于把经过大量修改的脚本代码运行起来以后，没过多长时间，Bugzilla开发小组又发布了2.18版本，不仅更正了2.17中的大量Bug，而且功能增强不少，看得你心痒痒的，下载了一个最新版本，遇到了与以前同样的问题：修改大量的Perl脚本，真是一场恶梦!L!

鉴于这种情况，本人使用CVS系统来处理，供各位看官参考！！前提是，你已经搭建了一套CVSNT系统，如果你还没有，可以参考本人写的相关文档。

首先，从www.bugzilla.org下载最新的Bugzilla-2.17.6版本，解压后，使用WinCVS将Bugzilla代码Import到CVS系统中，并建立Mozilla开发分支和发行标记，注意：主分支是你自己使用的分支，根据你自己的需要进行修改；而Mozilla是开发旁分支，用于与Mozilla的Bugzilla开发小组进行版本同步更新，即当Bugzilla有大的改进时，你可以下载那个发行版本，加入到这个Mozilla开发分支当中，然后再与主分支合并，就可以得到我们需要的最新的，而且是修改过的Bugzilla版本了。这样，就能很好的避免每一个新版本的Bugzilla源代码都去进行费时费力的大量修改。哈哈，‘爽’就一个字！！当然，在合并的过程中，可能会遇到冲突问题，不过，至少比直接修改源代码来得容易三。

下面是本人使用的分支名称，仅供参考：

Branch           => Mozilla                (Vendor Tag)

Release         => Ver-2-17-6            (Release Tag)

 

9     附录：(PerlModule.bat)

@echo off

 

@echo *******Start install perl module for Bugzilla***********

@echo   ******************Ready Go!!!***********************

 

@echo ********* Install Bundle::Bugzilla Module   ************

call ppm install Bundle::Bugzilla

@echo OK!!

 

@echo ********* Install Chart Module   ************

call ppm install Chart

@echo OK!!

 

@echo ********* Install CGI Module   ************

call ppm install CGI

@echo ********* Failed??:)

@echo ********* Download it from fllowing URL **********

@echo http://cpan.shellhung.org/authors/id/L/LD/LDS/CGI.pm-3.04.tar.gz

@echo ********* Use it with fllowing step **********

@echo ********* 1. Upzip this tar.gz

@echo ********* 2. Run the CMD.exe

@echo ********* 3. Into the upzipped tar.gz use dos command "cd"

@echo ********* 4. perl MakeFile.pl

@echo ********* 5. nmake

@echo ********* 6. nmake test

@echo ********* 7. nmake install

@echo ********* 8. OK!!

 

@echo ********* Install Date::Format Module   ************

call ppm install Date::Format

@echo ********* Failed??:)

@echo ********* Download it from fllowing URL **********

@echo http://cpan.shellhung.org/authors/id/G/GB/GBARR/TimeDate-1.16.tar.gz

@echo ********* Use it with fllowing step **********

@echo ********* 1. Upzip this tar.gz

@echo ********* 2. Run the CMD.exe

@echo ********* 3. Into the upzipped tar.gz use dos command "cd"

@echo ********* 4. perl MakeFile.pl

@echo ********* 5. nmake

@echo ********* 6. nmake test

@echo ********* 7. nmake install

@echo ********* 8. OK!!

 

@echo ********* Install AppConfig Module **********

call ppm install AppConfig

@echo ********* Failed??:)

@echo ********* Download it from fllowing URL **********

@echo http://cpan.shellhung.org/authors/id/A/AB/ABW/AppConfig-1.55.tar.gz

@echo ********* Use it with fllowing step **********

@echo ********* 1. Upzip this tar.gz

@echo ********* 2. Run the CMD.exe

@echo ********* 3. Into the upzipped tar.gz use dos command "cd"

@echo ********* 4. perl MakeFile.pl

@echo ********* 5. nmake

@echo ********* 6. nmake test

@echo ********* 7. nmake install

@echo ********* 8. OK!!

 

@echo ********* Install Template::Toolkit Module **********

call ppm install Template::Toolkit

@echo ********* Failed??:)

@echo ********* Download it from fllowing URL **********

@echo http://cpan.shellhung.org/authors/id/A/AB/ABW/Template-Toolkit-2.12.tar.gz

@echo ********* Use it with fllowing step **********

@echo ********* 1. Upzip this tar.gz

@echo ********* 2. Run the CMD.exe

@echo ********* 3. Into the upzipped tar.gz use dos command "cd"

@echo ********* 4. perl MakeFile.pl

@echo ********* 5. nmake

@echo ********* 6. nmake test

@echo ********* 7. nmake install

@echo ********* 8. OK!!

 

@echo ********* Install Data::Dumper Module **********

call ppm install Data::Dumper

@echo OK!!

 

@echo ********* Install Date::Format Module **********

call ppm install Date::Format

@echo OK!!

 

@echo ********* Install DBI Module **********

call ppm install DBI

@echo OK!!

 

@echo ********* Install DBD::mysql Module **********

call ppm install DBD::mysql

@echo OK!!

 

@echo ********* Install File::Spec Module **********

call ppm install File::Spec

@echo OK!!

 

@echo ********* Install File::Temp Module **********

call ppm install File::Temp

@echo OK!!

 

@echo ********* Install Text::Wrap Module **********

call ppm install Text::Wrap

@echo OK!!

 

@echo ********* Install GD Module **********

call ppm install GD

@echo OK!!

 

@echo ********* Install GD::Graph Module **********

call ppm install GD::Graph

@echo OK!!

 

@echo ********* Install GD::Text::Align Module **********

call ppm install GD::Text::Align

@echo OK!!

 

@echo ********* Install PatchReader Module **********

call ppm install PatchReader

@echo OK!!

 

@echo ********* Install MIME::Tools Module **********

call ppm install MIME::Tools

@echo OK!!

 

@echo ********* Install MIME::Base64 Module **********

call ppm install MIME::Base64

@echo OK!!

 

@echo ********* Install Authen::SASL Module **********

call ppm install Authen::SASL

@echo OK!!

 

pause