bugzilla安装指南.doc

作者:王文熹日期2005.07.06版本:1.0Bugzilla.8.1安装指南:WINOWS 版本Bugzilla是一款基于Unix based system的Bug侦测管理软件,将这套软件移植到Windows 环境下需要对系统环境进行相应的调整. 以下是Bugzilla.8.1在Windows下安装所需要的工具以及安装步骤:1.0 Win32 Perl首先我们需要安装Perl, Perl可以从ActiveState找到, Windows版下载地址: /Products/ActivePerl/ . 请用Version 5.8.1以上版本进行安装.1.1Perl的安装Active Perl采用标准Windows安装程序, 请按照默认路径安装到C:Perl .安装后请从新启动系统使安装生效.1.2 确认Windows根目录下有目录C:Temp, 如果没有请从新创建此目录.1.3 Perl Modules on Win32在Windows环境下需要安装一些Perl模块, 它们可以在/ppm/ 找到.有两种安装方法: 1. 下载安装: 请将所需要的模块下载到本地电脑, 在MS-DOS模式下打入命令:C:perl ppm install 2.网络安装: 请打开MS-DOS模式, 然后按照提示步骤进行安装. 建议用此方法安装.C:ppmPPM - Programmers Package Manager version 3.1.Copyright (c) 2001 ActiveState Corp. All Rights Reserved.ActiveState is a devision of Sophos.Entering interactive shell. Using Term:ReadLine:Stub as readline library.Type help to get started.ppm rep add Bugzilla /ppmRepositories:1 ActiveState PPM2 Repository2 ActiveState Package Repository3 Bugzillappm install AppConfig=Install AppConfig version 1.52 in ActivePerl 10.=Downloaded 50508 bytes.Successfully installed AppConfig version 1.52 in ActivePerl 10.ppm install TimeDate=Install TimeDate version 1.16 in ActivePerl 10.=Downloaded 19235 bytes.Successfully installed TimeDate version 1.16 in ActivePerl 10.ppm install DBI=Install DBI version 1.43 in ActivePerl 10.=Downloaded 508164 bytes.Successfully installed DBI version 1.43 in ActivePerl 10.ppm install DBD-mysql=Install DBD-mysql version 2.9002 in ActivePerl 10.=Downloaded 178803 bytes.Successfully installed DBD-mysql version 2.9002 in ActivePerl 10.ppm install Template-Toolkit=Install Template-Toolkit version 2.13 in ActivePerl 10.=Downloaded 530770 bytes.Successfully installed Template-Toolkit version 2.13 in ActivePerl 10.ppm install GD=Install GD version 2.07 in ActivePerl 10.=Downloaded 363039 bytes.Successfully installed GD version 2.07 in ActivePerl 10.ppm install Chart=Install Chart version 2.3 in ActivePerl 10.=Downloaded 58641 bytes.Successfully installed Chart version 2.3 in ActivePerl 10.ppm install GDGraph=Install GDTextUtil version 0.86 in ActivePerl 10.=Downloaded 19178 bytes.Successfully installed GDTextUtil version 0.86 in ActivePerl 10.=Install GDGraph version 1.43 in ActivePerl 10.=Downloaded 71764 bytes.Successfully installed GDGraph version 1.43 in ActivePerl 10.ppm install PatchReader=Install PatchReader version 0.9.4 in ActivePerl 10.=Downloaded 9558 bytes.Successfully installed PatchReader version 0.9.4 in ActivePerl 10.ppm install Net:LDAP=Install Convert-ASN1 version 0.19 in ActivePerl 08.=Downloaded 26326 bytes.Successfully installed Convert-ASN1 version 0.19 in ActivePerl 08.=Install perl-ldap version 0.33 in ActivePerl 08.=Downloaded 188548 bytes.Successfully installed perl-ldap version 0.33 in ActivePerl 08.=Install Net-LDAP-Express version 0.11 in ActivePerl 08.=Downloaded 7693 bytes.Successfully installed Net-LDAP-Express version 0.11 in ActivePerl 08.ppm 1.4 安装PatchReader 0.9.4 请确定安装0.9.4以上版本, 如果现有0.9.4以下版本请删除后再安装. 安装步骤:ppm uninstall PatchReader=Remove PatchReader version 0.9.2 from ActivePerl 10.=.Successfully removed PatchReader version 0.9.2 from ActivePerl 10.ppm install /ppm/PatchReader.ppd=Install PatchReader version 0.9.4 in ActivePerl 10.=Downloaded 9558 bytes.Successfully installed PatchReader version 0.9.4 in ActivePerl 10.ppm1.5 安装Bugzilla请从/download.html 下载Bugzilla 2.18 版本. 然后将其解压到目录C:bugzilla1.6安装MySQL1.6.1请从/downloads/mysql/4.1.html 下载4.1版本,请不要用5.X版本.1.6.2请从/downloads/mysqlcc.html下载 MySQL Control Center.1.6.3请将MySQL解压到C:MYSQL1.6.4建立BUGS 数据库用Mysqlcc建立Bugzilla数据库和用户, 假设数据库名称和用户名称为bugs. 注意:在后面的介绍将沿用此名称.所有数据库名称都为小写拼写.运行MySQLcc, 设立HostName 为 localhost. 默认MySQL用户名root,请自己设定密码. 这个默认帐号只可以从Localhost访问.连接到服务器(Action-Connect), 从左面的面版中选择 “Database”, 然后创建新的Database(Action- New Database),默认名称为bugs.建立新的用户, 选择User Administration (Action- New User). Username: bugs, host: localhost, 设置一个自己的密码. 然后在Allow access to 部分中给With GRANT option打钩.如果在执行MySQL 4.1中出现Client does not support authentication protocol requested by server error message.请按照以下步骤进行修改:C:mysqlbinmysql -user=root -p mysqlEnter password: *Welcome to the MySQL monitor. Commands end with ; or g.Your MySQL connection id is 15 to server version: 4.1.11-ntType help; or h for help. Type c to clear the buffer.mysql set password for bugslocalhost = OLD_PASSWORD(sockmonkey);Query OK, 0 rows affected (0.00 sec)mysql quitByeC:mysqlbin1.7 安装Apache Server1.7.1请从/download.cgi 下载Apache 2.0 Win32 Binary.安装前请确定安装权限是所有用户.安装时请用安装默认路径, C:Program FilesApache Group.1.7.2 服务器设置编辑C:Program FilesApache GroupApache2confhttpd.conf 更改端口# Listen: Allows you to bind Apache to specific IP addresses and/or# ports, instead of the default. See also the # directive.# Change this to Listen on specific IP addresses as shown below to # prevent Apache from glomming onto all bound IP addresses ()#Listen 8:80Listen localhost: 80 更改DocumentRoot 到C:bugzilla,注意有两个地方需要改动,同时将 改为 /.# DocumentRoot: The directory out of which you will serve your# documents. By default, all requests are taken from this directory, but# symbolic links and aliases may be used to point to other locations.#DocumentRoot C:/bugzilla# Each directory to which Apache has access can be configured with respect# to which services and features are allowed and/or disabled in that# directory (and its subdirectories). # First, we configure the default to be a very restrictive set of # features. # Options FollowSymLinks AllowOverride None# Note that from this point forward you must specifically allow# particular features to be enabled - so if somethings not working as# you might expect, make sure that you have specifically enabled it# below.# This should be changed to whatever you set DocumentRoot to.# 配置CGI添加AddHandler cgi-script .cgi# AddHandler allows you to map certain file extensions to handlers:# actions unrelated to filetype. These can be either built into the server# or added with the Action directive (see below)# To use CGI scripts outside of ScriptAliased directories:# (You will also need to add ExecCGI to the Options directive.)#AddHandler cgi-script .cgi 配置AllowOverride# Possible values for the Options directive are None, All,# or any combination of:# Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews# Note that MultiViews must be named *explicitly* - Options All# doesnt give it to you.# The Options directive is both complicated and important. Please see# /docs-2.0/mod/core.html#options# for more information.# Options Indexes FollowSymLinks ExecCGI# AllowOverride controls what directives may be placed in .htaccess files.# It can be All, None, or any combination of the keywords:# Options FileInfo AuthConfig Limit# AllowOverride All# Controls who can get stuff from this server.# Order allow,deny Allow from All# Tell Apache to use Perl to execute .cgi#ScriptInterpreterSource Registry-Strict 添加index.cgi# DirectoryIndex: sets the file that Apache will serve if a directory# is requested.# The index.html.var file (a type-map) is used to deliver content-# negotiated documents. The MultiViews Option can be used for the # same purpose, but it is much slower.#DirectoryIndex index.html index.html.var index.cgi# AccessFileName: The name of the file to look for in each directory# for additional configuration directives. See also the AllowOverride 1.8 添加注册表加入新密匙HKEY_CLASSES_ROOT.cgiShellExecCGICommand设置default value为 C:Perlbinperl.exe T从新启动Apache Server1.9 配置Bugzilla1.9.1 运行MS-DOS, 进入bugzilla 目录, 运行checksetup.plC:cd bugzillaC:bugzillaperl checksetup.plChecking perl modules .Checking for AppConfig (v1.52) ok: found v1.52Checking for CGI (v2.93) ok: found v3.04Checking for Data:Dumper (any) ok: found v2.121Checking for Date:Format (v2.21) ok: found v2.22Checking for DBI (v1.32) ok: found v1.43Checking for DBD:mysql (v2.1010) ok: found v2.9002Checking for File:Spec (v0.82) ok: found v0.87Checking for File:Temp (any) ok: found v0.14Checking for Template (v2.08) ok: found v2.13Checking for Text:Wrap (v2001.0131) ok: found v2001.09291The following Perl modules are optional:Checking for GD (v1.20) ok: found v2.07Checking for Chart:Base (v0.99) ok: found v2.3Checking for XML:Parser (any) ok: found v2.34Checking for GD:Graph (any) ok: found v1.43Checking for GD:Text:Align (any) ok: found v1.18Checking for PatchReader (any) ok: found v0.9.4Most ActivePerl modules are available at Apaches ppm repository.A list of mirrors is available at /dyn/closer.cgi/perl/win32-bin/ppms/You can add the repository with the following command: ppm rep add apache /dist/perl/win32-bin/ppms/Checking user setup .This version of Bugzilla contains some variables that you may wantto change and adapt to your local settings. Please edit the file./localconfig and rerun checksetup.plThe following variables are new to localconfig since you last ranchecksetup.pl: index_html cvsbin interdiffbin diffpath create_htaccess webservergroup db_host db_pass db_sock db_check severities priorities opsys platformsC:bugzilla1.9.2 用编译软件打开文件C:Bugzillalocalconfig设置db_pass# How to access the SQL database:#$db_host = localhost; # where is the database?$db_port = 3306; # which port to use$db_name = bugs; # name of the MySQL database$db_user = bugs; # user to attach to the MySQL database# Enter your database password here. Its normally advisable to specify# a password for your bugzilla database user.# If you use apostrophe () or a backslash () in your password, youll# need to escape it by preceding it with a character. () or ()#$db_pass = sockmonkey;1.9.3从新运行checksetup.plC:bugzillaperl checksetup.plChecking perl modules .Checking for AppConfig (v1.52) ok: found v1.52Checking for CGI (v2.93) ok: found v3.04Checking for Data:Dumper (any) ok: found v2.121Checking for Date:Format (v2.21) ok: found v2.22Checking for DBI (v1.32) ok: found v1.43Checking for DBD:mysql (v2.1010) ok: found v2.9002Checking for File:Spec (v0.82) ok: found v0.87Checking for File:Temp (any) ok: found v0.14Checking for Template (v2.08) ok: found v2.13Checking for Text:Wrap (v2001.0131) ok: found v2001.09291The following Perl modules are optional:Checking for GD (v1.20) ok: found v2.07Checking for Chart:Base (v0.99) ok: found v2.3Checking for XML:Parser (any) ok: found v2.34Checking for GD:Graph (any) ok: found v1.43Checking for GD:Text:Align (any) ok: found v1.18Checking for PatchReader (any) ok: found v0.9.4Most ActivePerl modules are available at Apaches ppm repository.A list of mirrors is available at /dyn/closer.cgi/perl/win32-bin/ppms/You can add the repository with the following command: ppm rep add apache /dist/perl/win32-bin/ppms/Checking user setup .Creating data directory (./data) .Creating graphs directory.Creating .htaccess.Creating Bugzilla/.htaccess.Creating ./data/.htaccess.Creating ./template/.htaccess.Creating ./data/webdot/.htaccess.Precompiling templates .Checking for MySQL Server (v3.23.41) ok: found v4.0.20a-debugCreating table user_group_map .Creating table series_data .Creating table longdescs .Creating table dependencies .Creating table components .Creating table keywords .Creating table cc .Creating table duplicates .Creating table groups .Creating table flagtypes .Creating table profiles .Creating table products .Creating table bugs_activity .Creating table series_categories .Creating table keyworddefs .Creating table fielddefs .Creating table group_control_map .Creating table profiles_activity .Creating table group_group_map .Creating table user_series_map .Creating table bugs .Creating table series .Creating table versions .Creating table flagexclusions .Creating table logincookies .Creating table watch .Creating table bug_group_map .Creating table votes .Creating table attachments .Creating table flags .Creating table milestones .Creating table tokens .Creating table flaginclusions .Creating table quips .Creating table namedqueries .Creating initial dummy product TestProduct .Populating duplicates table.Creating duplicates directory.Migrating old chart data into database .Adding group tweakparams .Adding group editusers .Adding group creategroups .Adding group editcomponents .Adding group editkeywords .Adding group admin .Adding group editbugs .Adding group canco