bugzallia安装手册

Bugzilla安装手册

for windows

will

2010-1-9

目录

1. 概述 (4)

1.1 安装环境 (4)

2. 安装........................................... (4)

2.1 安装前准备 (4)

2.2 安装 Perl (5)

2.3 安装XAMPP................................... . 5

2.4 Bugzilla (5)

2.5 安装Perl 模块 (6)

2.5.1 自动安装（ *推荐 *） (6)

2.5.2 网络安装 (6)

2.5.3 手动安装 (6)

3. 配置 (7)

3.1 localconfig (7)

3.2 MySQL (8)

3.3 checksetup.pl (8)

3.4 Appache (8)

3.5 修改注册表 (8)

3.6 汉化 (8)

3.7 解决报告和图表的中文乱码问题 (8)

4. 附录 (9)

4.1 Perl模块列表 (9)

1 概述

Bugzilla 在项目中已经使用了一段时间，相对其他商业缺陷跟踪系统，Bugzilla 还是有很多优势的。

或许因为我是开源爱好者，特别钟爱这些开源的测试工具，想在其他项目中推广。但是Bugzilla 的安装和配置，经常令很多人郁闷，尤其是在Windows 下的安装。

为此在Windows 上进行了多次试验，并简化了安装过程，这篇文章就是为了让更多的人轻松安装和使用Bugzilla ，hope this helps ！

1.1 安装环境

2 安装

2.1 安装前准备

1. 下载ActivePerl-5.10.0

本文中使用5.10.0 版本测试通过，因此推荐使用5.10.0 版本，已上传到CSDN ，地址如下：

https://www.360docs.net/doc/b41891537.html,/source/1978649

如果想使用其他版本，可在此处下载：

https://https://www.360docs.net/doc/b41891537.html,/activeperl/downloads/

2. 下载XAMPP-1.7.1

本文中使用1.7.1 版本测试通过，因此推荐使用1.7.1 版本。

https://www.360docs.net/doc/b41891537.html,/projects/xampp/files/XAMPP%20Windows/1.7.1/xam pp-win32-1.7.1-installer.exe/download

如果想使用其他版本，可在此处下载：

https://www.360docs.net/doc/b41891537.html,/projects/xampp/files/XAMPP%20Windows/

3. 下载Perl 模块（* 推荐* ）

若选择网络安装Perl 模块，可跳过此步。

这些模块是根据bugzilla-3.4.4和perl-5.10.0，整理成的压缩包，并且包含自动安装脚本install_ppms.pl。推荐下载这些模块，然后使用

“install_ppms.pl”自动安装，下载地址如下：

https://www.360docs.net/doc/b41891537.html,/source/1981169

4. 下载Bugzilla

本文中使用bugzilla-3.4.4 ，下载地址如下：

https://www.360docs.net/doc/b41891537.html,/pub/https://www.360docs.net/doc/b41891537.html,/webtools/bugzilla-3.4.4.tar.gz

5. 下载汉化包

https://www.360docs.net/doc/b41891537.html,/source/1981400

2.2 安装perl

1. 执行activeperl.exe

2. 选择安装目录

3. 完成

安装完成后，可使用perl –v 查看版本。

2.3 安装XAMPP

1. 执行xampp-win32-1.7.1-installer.exe

2. 选择安装目录

3. 安装完成时，保持默认选项即可

安装完成后，打开“XAMPP Control Panel ”，启动Apache 和MySQL ，访问：http://127.0.0.1/，检查是否正常。

2.4 Bugzilla

1. 解压bugzilla-3.4.4.tar.gz

2. 拷贝bugzilla-

3.

4.4 至xampp\htdocs\ 目录下（可跳过）

2.5 安装perl模块

在bugzilla 目录下，执行checksetup.pl –check-modules ，检查有哪些模块还未安装。安装前准备的perl 模块中以经包含了几乎所有所需要的模块。

2.5.1 自动安装（*推荐* ）

为了方便安装，已经将bugzilla-3.4.4 所需的模块整理成压缩包，下载地址见安装前准备部分。

压缩包内包含了近50 个模块，详细列表见附录。

安装步骤如下：

1. 解压PPM_bugzilla3.4.4_required.zip 至某个目录（路径中不要包含中文字符、空格）。

2. 执行“install_ppms.pl ”

3. 检查是否有错误信息

2.5.2 网络安装

如果你的服务器可以直接连接上网络，也可以使用ppm install 通过网络安装。

使用默认的库，有时会找不到指定的模块，执行如下命令添加ppm 库后，再尝试安装：

ppm repo

add https://www.360docs.net/doc/b41891537.html,/MSWin32-x86/5.10/1000/package.xml

或者使用这种方式安装（package 替换成模块名）：

ppm install http://cpan.uwinnipeg.ca/PPMPackages/10xx/package .ppd

但是在通过代理上网的环境中，有时会不能正常安装。此类问题，可以搜索ppm install proxy 等关键字来解决。若不能解决代理问题，可先将源文件或已编译好的文件下载至本地后，再通过手动安装，见3.4.3 。

2.5.3 手动安装

已编译的二进制包

1. 下载

https://www.360docs.net/doc/b41891537.html,/MSWin32-x86/5.10/1000/package.xml

2. 打开该package.xml ，搜索模块名称。

如：Template-Toolkit

3. 根据标签

如： ，从而确定下载地址：

https://www.360docs.net/doc/b41891537.html,/MSWin32-x86/5.10/1000/A/AB/ABW/Template-T oolkit-2.22.tar.gz

4. 下载该文件后，使用7-zip 解压。解压后会有2 个文件：blib 和module-versioon .ppd 。

如：Template-Toolkit-2.22.tar.gz 解压后会有blib 和

Template-Toolkit-2.22.ppd 。

5. 将blib 文件夹压缩成module-version .tar.gz 格式。

如：Template-Toolkit-2.22.tar.gz

6. 执行ppm install module-version. ppd 安装该模块。

如：ppm install Template-Toolkit-2.22.ppd

http://cpan.uwinnipeg.ca/PPMPackages/10xx/zips/

源码安装

1. 安装7-zip ，以解压.tar.gz 文件。

2. 下载编译器https://www.360docs.net/doc/b41891537.html,/source/1981273

3. 在https://www.360docs.net/doc/b41891537.html,上搜索并下载模块

4. 解压module .tar.gz

5. perl Makefile.pl

6. nmake

7. nmake test

8. nmake install

3 配置

3.1 localconfig

再次执行checksetup.pl ，不需要加参数。

checksetup.pl 会列出你已经正确安装的Perl 模块及版本信息。还会生成一个localconfig 文件。这里面包含bugzilla 一些参数的默认设置。

用文本编辑器打开localconfig ，需要修改$db_driver 和$db_pass 两个值。更改$db_driver 为正确的数据库，如：mysql 、Pg 或oracle （本例中使用mysql ）。修改$db_pass ，为访问数据库创建一个密码。

3.2 MySQL

1. 添加用户

需要为bugzilla 创建一个新的MySQL 用户（让bugzilla 使用root 用户是很不安全的）。

下面的例子基于localconfig 的默认设置。如果你更改过，需要在下面的SQL 中做同样的修改。“$db_pass ”要替换为localconfig 中的值（本例中

$db_pass=bugs ）。

mysql>create database bugs;

mysql> GRANT SELECT, INSERT, UPDATE, DELETE, INDEX, ALTER, CREATE, LOCK TABLES, CREATE TEMPORARY TABLES, DROP, REFERENCES ON bugs.* TO

bugs@”localhost” IDENTIFIED by “bugs”;

mysql> FLUSH PRIVILEGES;

3.3 checksetup.pl

接下来，重新运行checksetup.pl 。它会编译UI 模板，连接到数据库并创建数据库及表。

完成后，会请求你输入管理员帐号的信息。Bugzilla 可以有多个管理员帐号（你可以在稍后进行创建），但是你需要有一个来开始。输入管理员的Email 地址，他或她的全称，以及密码。

Checksetup.pl 就执行完成了，你可以在任何时候重新执行它。

3.4 Appache

打开xampp\apache\conf\httpd.conf，在末尾添加如下内容：

Alias /bugzilla "x:\path\of\bugzilla "

Options ExecCGI All

AllowOverride All

ScriptInterpreterSource Registry-Strict

Order allow,deny

Allow from all

3.5 修改注册表

打开注册表编辑器，在HKEY_CLASSES_ROOT下新建.cgi项，在.cgi下新建Shell项，在Shell下新建ExecCGI项，在ExecCGI下新建Command项。修改Command的默认值为：X:\Perl\bin\perl.exe -T

如图：

F5刷新后，重启Apache。

3.6 汉化

1. 解压bugzilla_chinese_template.zip

2. 复制default 和extension 到xampp\htdocs\bugzilla\template\en 目录下，替换原文件夹

3. 重新访问，测试是否为中文页面

3.7 解决报告和图表中文乱码问题

打开perl\site\lib\GD\Graph\axestype.pm ，找到子函数sub initialize {} 。找到以下内容：

$self->set_x_label_font(GD::gdSmallFont);

$self->set_y_label_font(GD::gdSmallFont);

$self->set_x_axis_font(GD::gdTinyFont);

$self->set_y_axis_font(GD::gdTinyFont);

$self->set_legend_font(GD::gdTinyFont);

$self->set_values_font(GD::gdTinyFont);

修改为：

$self->set_x_label_font('C:\WINDOWS\Fonts\SURSONG.TTF');

$self->set_y_label_font('C:\WINDOWS\Fonts\SURSONG.TTF');

$self->set_x_axis_font('C:\WINDOWS\Fonts\SURSONG.TTF');

$self->set_y_axis_font('C:\WINDOWS\Fonts\SURSONG.TTF');

$self->set_legend_font('C:\WINDOWS\Fonts\SURSONG.TTF');

$self->set_values_font('C:\WINDOWS\Fonts\SURSONG.TTF');

4 附录

4.1 模块列表

PPM_bugzilla3.4.4_required.zip 中包含了近50 个模块，列表如下：1: 1_CGI.pm

2: 2_TimeDate

3: 3_Params-Validate

4: 4_Class-Singleton

5: 5_DateTime-TimeZone

6: 6_DateTime-Locale

7: 7_DateTime

8: 8_AppConfig

9: 9_Template-Toolkit

10: 10_Email-Address

11: 11_Email-Simple

12: 12_Return-Value

13: 13_Email-Send

14: 14_Email-MIME-Encodings

15: 15_MIME-Types

16: 16_Email-MIME-ContentType

17: 17_Email-MIME

18: 18_Email-MessageID

19: 19_Email-MIME-Modifier

20: 20_DBD-mysql

21: 21_GD

22: 22_Chart

23: 23_Template-GD

24: 24_GDTextUtil

25: 25_GDGraph

26: 26_XML-Twig

27: 27_IO-stringy

28: 28_MailTools

29: 29_MIME-tools

30: 30_Authen-SASL

31: 31_Email-Date-Format

32: 32_MIME-Lite

34: 34_Email-Abstract

35: 35_Email-Simple-Creator

36: 36_Email-MIME-Creator

37: 37_Email-Reply

38: 38_Email-MIME-Encodings

39: 39_Email-MIME-Attachment-Stripper 40: 40_PatchReader

41: 41_Convert-ASN1-0.22

42: 42_perl-ldap

43: 43_Data-HexDump

44: 44_RadiusPerl

45: 45_FCGI

46: 46_constant

47: 47_Crypt-SSLeay

48: 48_Task-Weaken

49: 49_SOAP-Lite

50: 50_HTML-Scrubber