bugzallia安装手册.docx

Bugzilla安装手册 for windows will2010-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 安装环境 版本 Windows 2003 Server ActivePerl-002-MSWin32-x86-283697.msi 5.10.0 .1002 XAMPP 1.7.1 2 安装 2.1 安装前准备 1. 下载ActivePerl-5.10.0 本文中使用5.10.0 版本测试通过，因此推荐使用5.10.0 版本，已上传到CSDN ，地址如下：/source/1978649 如果想使用其他版本，可在此处下载：/activeperl/downloads/ 2. 下载XAMPP-1.7.1 本文中使用1.7.1 版本测试通过，因此推荐使用1.7.1 版本。/projects/xampp/files/XAMPP%20Windows/1.7.1/xampp-win32-1.7.1-installer.exe/download 如果想使用其他版本，可在此处下载：/projects/xampp/files/XAMPP%20Windows/ 3. 下载Perl 模块（* 推荐* ）若选择网络安装Perl 模块，可跳过此步。这些模块是根据bugzilla-3.4.4和perl-5.10.0，整理成的压缩包，并且包含自动安装脚本install_ppms.pl。推荐下载这些模块，然后使用“install_ppms.pl”自动 安装，下载地址如下：/source/1981169 4. 下载Bugzilla 本文中使用bugzilla-3.4.4 ，下载地址如下：/pub//webtools/bugzilla-3.4.4.tar.gz 5. 下载汉化包/source/1981400 2.2 安装perl1. 执行activeperl.exe2. 选择安装目录3. 完成安装完成后，可使用perl v 查看版本。2.3 安装XAMPP 1. 执行xampp-win32-1.7.1-installer.exe 2. 选择安装目录3. 安装完成时，保持默认选项即可安装完成后，打开“XAMPP Control Panel ”，启动Apache 和MySQL ，访问：/ ，检查是否正常。2.4 Bugzilla 1. 解压bugzilla-3.4.4.tar.gz 2. 拷贝bugzilla-3.4.4 至xampphtdocs 目录下（可跳过）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 /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. 下载/MSWin32-x86/5.10/1000/package.xml 2. 打开该package.xml ，搜索模块名称。如：Template-Toolkit 3. 根据标签 确定下载地址：/MSWin32-x86/5.10/1000/。path/of_module/module-version.tar.gz 如： ，从而确定下载地址：/MSWin32-x86/5.10/1000/A/AB/ABW/Template-Toolkit-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 之所以按照上述方法下载和安装，是因为 Activestate 上的模块比较全，基本上所需要的都可以找到。 当然也可以在其他地址下载 zip 包，解压后直接就可以安装。 http:/cpan.uwinnipeg.ca/PPMPackages/10xx/zips/ 源码安装 1. 安装7-zip ，以解压.tar.gz 文件。2. 下载编译器/source/1981273 3. 在 上搜索并下载模块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 ）。mysqlcreate 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 打开xamppapacheconfhttpd.conf，在末尾添加如下内容： Alias /bugzilla x:pathofbugzilla Options ExecCGI All AllowOverride All ScriptInterpreterSource Registry-Strict Order allow,deny Allow from all 3.5 修改注册表 输入regedit打开注册表编辑器，在HKEY_CLASSES_ROOT下新建.cgi项，在.cgi下新建Shell项，在Shell下新建ExecCGI项，在ExecCGI下新建Command项。修改Command的默认值为：X:Perlbinperl.exe -T如图：F5刷新后，重启Apache。3.6 汉化 1. 解压bugzilla_chinese_template.zip 2. 复制default 和extension 到xampphtdocsbugzillatemplateen 目录下，替换原文件夹3. 重新访问，测试是否为中文页面3.7 解决报告和图表中文乱码问题 打开perlsitelibGDGraphaxestype.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:WINDOWSFontsSURSONG.TTF); $self-set_y_label_font(C:WINDOWSFontsSURSONG.TTF); $self-set_x_axis_font(C:WINDOWSFontsSURSONG.TTF); $self-set_y_axis_font(C:WINDOWSFontsSURSONG.TTF); $self-set_legend_font(C:WINDOWSFontsSURSONG.TTF); $self-set_values_font(C:WINDOWSFontsSURSONG.TTF); 4 附录 4.1 模块列表PPM_bugzilla3.4.4_required.zip 中包含了近50 个模块，列表如下：1: 1_CGI.pm 2: 2_TimeDate3: 3_Params-Validate4: 4_Class-Singleton5: 5_DateTime-TimeZone6: 6_DateTime-Locale7: 7_DateTime8: 8_AppConfig9: 9_Template-Toolkit10: 10_Email-Address11: 11_Email-Simple12: 12_Return-Value13: 13_Email-Send14: 14_Email-MIME-Encodings15: 15_MIME-Types16: 16_Email-MIME-Conten