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 安裝環境
 
 版本
 
Windows 2003 Server
  
 
ActivePerl-5.10.0.1002-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 ，地址如下：

http://download.csdn.net/source/1978649

如果想使用其他版本，可在此處下載：

https://www.activestate.com/activeperl/downloads/

 

2.  下載XAMPP-1.7.1

本文中使用1.7.1 版本測試通過，因此推薦使用1.7.1 版本。

http://sourceforge.net/projects/xampp/files/XAMPP%20Windows/1.7.1/xampp-win32-1.7.1-installer.exe/download

如果想使用其他版本，可在此處下載：

http://sourceforge.net/projects/xampp/files/XAMPP%20Windows/

 

3.  下載Perl 模組（* 推薦* ）

若選擇網路安裝Perl 模組，可跳過此步。

這些模組是根據bugzilla-3.4.4和perl-5.10.0，整理成的壓縮包，並且包含自動安裝指令碼"install_ppms.pl”。推薦下載這些模組，然後使用“install_ppms.pl”自動 安裝，如下：

http://download.csdn.net/source/1981169

 

4.  下載bugzilla

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

http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-3.4.4.tar.gz

 

5.  下載漢化包

http://download.csdn.net/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<module_name> 通過網路安裝。

 

使用預設的庫，有時會找不到指定的模組，執行如下命令添加ppm 庫後，再嘗試安裝：

ppm repo add  http://ppm4.activestate.com/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.  下載http://ppm4.activestate.com/MSWin32-x86/5.10/1000/ package.xml

2.  開啟該package.xml ，搜尋模組名稱。

如：Template-Toolkit

 

3.  根據標籤<CODEBASE HREF=”path/of/module/module-version.tar.gz ”/> 確定：

http://ppm4.activestate.com/MSWin32-x86/5.10/1000/ path/of_module/module-version.tar.gz。

如：<CODEBASE HREF="A/AB/ABW/Template-Toolkit-2.22.tar.gz "/> ，從而確定：http://ppm4.activestate.com/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.  下載編譯器http://download.csdn.net/source/1981273

3. 在http://search.cpan.org 上搜尋並下載模組

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 "
<Directory "x:/path/of/bugzilla ">
    Options ExecCGI All
    AllowOverride All
    ScriptInterpreterSource Registry-Strict
    Order allow,deny
    Allow from all
</Directory>

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

 

本文來自CSDN部落格，轉載請標明出處：http://blog.csdn.net/will2ni/archive/2010/01/10/5169366.aspx