Bugzilla_Win32安裝指南英文版

1、bugzilla:win32install (tcivis) v1.0技術(shù)參考 , 2009-03-25author:yucheng hu, tcivis websystems, inc.tcivis-v1.0-technology.ott2009-03-25copyright ? tcivis 2006 - 2009. page 1 of 24備忘c(diǎn)opyright ? tcivis 2006 2009. 版權(quán)所有urls 參考 :/bugzilla:win32install#scheduled_taskshttp:/技術(shù)支持 :http:/知識

2、產(chǎn)權(quán) :tcivis 及作者持有本文檔的所有權(quán)相關(guān)工作 :技術(shù)文檔格式化版本摘要 :bugzilla狀態(tài) :正常odt 發(fā)行版本tcivis-v1.0-technology.ott2009-03-25copyright ? tcivis 2006 - 2009. page 2 of 24目 錄1 installing bugzilla on microsoft windows.41.1 bugzilla.41.1.1 installing bugzilla from cvs.41.1.2 upgrading from cvs.51.1.3 installing bugzilla from th

3、e tarball.51.1.4 upgrading from tarball.61.2 mysql.61.2.1 download mysql .61.2.2 install.61.2.3 create bugs database and user.61.3 activestate perl.71.3.1 download activestate perl 5.8.1 or higher.71.3.2 install.81.3.3 upgrading existing installs.81.3.4 create temp directory.91.3.5 install modules.9

4、1.4 apache.141.4.1 download apache 2.x.141.4.2 install.151.4.3 grant write access for apache account.151.4.4 configure port and documentroot.151.4.5 configure cgi.161.4.6 disable logging.191.4.7 restart apache.191.5 extras.191.6 configure bugzilla.201.6.1 edit localconfig.201.6.2 checksetup.pl.201.6

5、.3 parameters.221.7 scheduled tasks .221.7.1 collectstats.pl .221.7.2 whineatnews.pl.231.7.3 backing up bugzilla.23tcivis-v1.0-technology.ott2009-03-25copyright ? tcivis 2006 - 2009. page 3 of 241 installing bugzilla on microsoft windowsbugzilla version 2.18 was the first release that runs unmodifie

6、d on windows. this document guides you step by step through the installation process. note that there are a few things that dont work very well on windows, such as mod_perl. 1.1 bugzillatheres two main methods to getting the bugzilla source - from cvs or in a tarball. the best method for fetching bu

7、gzilla is to grab it directly from cvs, as this will allow for simple upgrades, even if you have customised bugzilla. read the release notes before you do anything. 1.1.1 installing bugzilla from cvsdownload the cvsnt client from 1 (2.15 meg). run the installation, youll only need to install the com

8、mand line client and the password server (:pserver:) protocol. once the install has completed, log out and log in again to pick up the changes to the path. note: this document assumes you want to install bugzilla into c:bugzilla. open the command line, and cd to the parent of the directory you want

9、to install bugzilla into. as well be installing bugzilla into c:bugzilla, the current directory must be c:. c:set cvsroot=:pserver::/cvsrootc:cvs logintcivis-v1.0-technology.ott2009-03-25copyright ? tcivis 2006 - 2009. page 4 of 241234logging in to :pserver:anonymouscv

10、:2401:/cvsrootcvs password: anonymousc:cvs checkout -d bugzilla -rbugzilla_stable bugzillacvs checkout: updating bugzillau bugzilla/.cvsignoreu bugzilla/bugzilla.pm.u bugzilla/template/en/default/whine/multipart-mime.txt.tmplu bugzilla/template/en/default/whine/schedule.html.tmpl

11、cvs checkout: updating bugzilla/template/en/extensionu bugzilla/template/en/extension/filterexceptions.plcvs checkout: updating bugzilla/template/en/extension/hookc:1.1.2 upgrading from cvsif youve already installed an earlier version of bugzilla from cvs or from a tarball, updating is easy. even if

12、 youve made customisations, cvs is smart enough to merge. if cvs needs help merging, it displays a c in the first column of its report. you need to resolve such conflicts manually. c:bugzillacvs update -r -d -rbugzilla_stablecvs update: updating .p editusers.cgicvs update: updating bugzillap bugzill

13、a/bug.pmp bugzilla/bugmail.pmp bugzilla/chart.pmp bugzilla/flag.pmp bugzilla/user.pmp bugzilla/util.pmcvs update: updating bugzilla/authu bugzilla/auth/cgi.pmcvs update: updating bugzilla/templatecvs update: updating bugzilla/template/plugin.cvs update: updating template/en/default/searchcvs update:

14、 updating template/en/default/whinecvs update: updating template/en/extensionc:bugzilla1.1.3 installing bugzilla from the tarballdownload bugzilla from 2 (2.4 meg). bugzilla ships as a tarball, which has the extension .tar.gz. any decent windows archive tool should be able to extract tarballs. tcivi

15、s-v1.0-technology.ott2009-03-25copyright ? tcivis 2006 - 2009. page 5 of 245678910111213141516171819202122232425262728293031323334353637383940extract the archive to the directory of your choice. for the remainder of this document i will assume that you have extracted bugzilla into c:bugzilla. have a

16、 check after you extracted it, as you probably extracted it to location such as c:bugzillabugzilla-3.3.2 which is not what you want. 1.1.4 upgrading from tarballif you installed bugzilla from the tarball, the simplest way to upgrade is to follow the cvs upgrading instructions. 1.2 mysql1.2.1 downloa

17、d mysql download the mysql windows essentials installer from http:/ (14.1 meg). mysql 5.x is now stable enough and can be used. 1.2.2 installmysql has a standard windows installer. its ok to select a typical mysql install (the default). for the remainder of this document i will assume you have insta

18、lled mysql into default location c:program filesmysqlmysql server 5.0, with default port number 3306, and password sockmonkey which is my favorite. 1.2.3 create bugs database and useruse the mysql command line utility to create the bugzilla database and a mysql account for bugzilla. c:program filesm

19、ysqlmysql server 5.0binmysql -user=root -p mysqlenter password: sockmonkeytcivis-v1.0-technology.ott2009-03-25copyright ? tcivis 2006 - 2009. page 6 of 24414243welcome to the mysql monitor. commands end with ; or g.your mysql connection id is 2server version: 5.0.67-community-nt mysql community edit

20、ion (gpl)type help; or h for help. type c to clear the buffer.mysql create database bugs;query ok, 1 row affected (0.11 sec)mysql grant all privileges on bugs.* to bugslocalhost identified by sockmonkey;query ok, 0 rows affected (0.03 sec)mysql flush privileges;query ok, 0 rows affected (0.00 sec)my

21、sql quitbyec:program filesmysqlmysql server 5.0binif you are running mysql 4.1, you may encounter the client does not support authentication protocol requested by server error message. to fix this, once the user has been created you will have to reset the password using old_password: c:mysqlbinmysql

22、 -user=root -p mysqlenter password: sockmonkeywelcome 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 affect

23、ed (0.00 sec)mysql quitbyec:mysqlbin1.3 activestate perl1.3.1 download activestate perl 5.8.1 or higherdownload the activestate perl 5.8.1 or higher msi from: http:/ (12.5 meg). tcivis-v1.0-technology.ott2009-03-25copyright ? tcivis 2006 - 2009. page 7 of 24444546474849505152535455565758596061626364

24、6566676869707172737475767778798081note that bugzilla requires activestate perl 5.8.1 as it needs cgi.pm version 2.93 or higher. 5.8.0 ships with cgi.pm version 2.81, 5.8.1 ships with cgi.pm version 3.00. there is a bug in time:local 1.10 , which is shipped with activestate perl 5.8.6, that will caus

25、e warnings to be generated at the top of every buglist. its a good idea to avoid version 5.8.6 (version 5.8.4 works without issue). 1.3.2 installactivestate perl uses a standard windows installer. install, sticking with the defaults, which will install perl into c:perl. note: installing perl into a

26、directory that contains a space (eg c:program files) will break the template-toolkit installer. once the install has completed, log out and log in again to pick up the changes to the path. 1.3.3 upgrading existing installsif you already have activestate perl installed, nows a good time to ensure you

27、re running the latest version of activestate perl, along with the latest versions of the modules. to upgrade activestate perl, follow the directions at: http:/ upgrade your modules, simply run ppm upgrade tcivis-v1.0-technology.ott2009-03-25copyright ? tcivis 2006 - 2009. page 8 of 241.3.4 create te

28、mp directoryon windows, perl has a hard time of locating the correct directory to write its temporary files (cgi.pm, file:spec). basically it has a list of paths hard coded to use, instead of querying windows for the correct path. to avoid problems, create the c:temp directory (it has to be on drive

29、 c) and ensure system has write and modify access. 1.3.5 install modulesbugzilla requires a number of perl modules to be installed. they are either available in the activestate repository, or at http:/theoryx5.uwinnipeg.ca/ppms/ (perl 5.8.x) or http:/cpan.uwinnipeg.ca/ppmpackages/10 xx/ (perl 5.10.x

30、). you should use ppm program install them from internet into your local computer. later you will see an example (example 1) with details. if you use a proxy server or a firewall you may have trouble running ppm. this is covered in the activeperl faq. if it still doesnt work, or you just dont like t

31、his way, you have another choice here. instead of run ppm directly, you may download installation packages manually into your local computer firstly, and then run ppm to install them. these kind of installation packages are available in http:/cpan.uwinnipeg.ca/ppmpackages/10 xx/zips/ (perl 5.10.x).

32、later you will see an example (example 2) with details for this kind of ppm local installation. while, up to now, you still do not know which perl modules should be installed. to know this, use command below: c:bugzillaperl checksetup.pl -check-modulesthen the script will tell you which modules are

33、needed, under this line: tcivis-v1.0-technology.ott2009-03-25copyright ? tcivis 2006 - 2009. page 9 of 2482checking perl modules.and which module is needed according to the database you use (mysql), under this line: checking available perl dbd modules.as well as which modules are optional, under thi

34、s line: the following perl modules are optional:the script will also tell you which modules are ok: checking for pathtools (v0.84) ok: found v3.2501and which modules are too old: checking for cgi.pm (v3.33) found v3.29as well as which modules were not installed yet: checking for timedate (v2.21) not

35、 foundyou should install all the missing ones, and re-install all the out-of-date ones. but thats not enough. as perl modules have dependencies among each other, when you install a perl module, the ppm program may tell you that some dependent modules are missing. then you have to install these depen

36、dent modules firstly. example 1: standard ppm installationhere we provide an exmaple of standard installation method. the ppm program will get modules from internet and install them into your local computer. note 1: this example is a bit out-of-date. in recent activestate perl version (v5.10

37、.x), when you type c:ppmtcivis-v1.0-technology.ott2009-03-25copyright ? tcivis 2006 - 2009. page 10 of 2483848586878889the gui will pop up instead of command line environment showed in this example. while, its still possible to run under command line. try c:ppm install timedate instead of c:ppmppm i

38、nstall timedatenote 2: the module list below may not correct for you. pls use script checksetup.pl to have a check. see below. note 3: the net:ldap module is only required if you want to use active directory for authentication. ok. here is the example: c:ppmppm - programmers package manager version

39、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 http:/theoryx5.uwinnipeg.ca/ppms/repositories:1 activestate ppm2 repository2 actives

40、tate package repository3 bugzillappm install appconfig=install appconfig version 1.52 in activeperl 13.=downloaded 50508 bytes.successfully installed appconfig version 1.52 in activeperl 13.ppm install timedate=install timedate version 1.16 in activeperl 13.=downloaded 19235 byt

41、es.successfully installed timedate version 1.16 in activeperl 13.ppm install dbi=install dbi version 1.43 in activeperl 13.=downloaded 508164 bytes.tcivis-v1.0-technology.ott2009-03-25copyright ? tcivis 2006 - 2009. page 11 of 24909192939495969798991001011021031041051061071081091101111

42、12113114115116117118119120121122123124125126127128successfully installed dbi version 1.43 in activeperl 13.ppm install dbd-mysql=install dbd-mysql version 2.9002 in activeperl 13.=downloaded 178803 bytes.successfully installed dbd-mysql version 2.9002 in activeperl 13.ppm instal

43、l template-toolkit=install template-toolkit version 2.13 in activeperl 13.=downloaded 530770 bytes.successfully installed template-toolkit version 2.13 in activeperl 13.ppm install mailtools=install mailtools version 1.67 in activeperl 13.=downloaded 46881 bytes.successfully ins

44、talled mailtools version 1.67 in activeperl 13.ppm install gd=install gd version 2.07 in activeperl 13.=downloaded 363039 bytes.successfully installed gd version 2.07 in activeperl 13.ppm install chart=install chart version 2.3 in activeperl 13.=downloaded 58641 bytes.suc

45、cessfully installed chart version 2.3 in activeperl 13.ppm install gdgraph=install gdtextutil version 0.86 in activeperl 13.=downloaded 19178 bytes.successfully installed gdtextutil version 0.86 in activeperl 13.=install gdgraph version 1.43 in activeperl 13.=downloaded 7

46、1764 bytes.successfully installed gdgraph version 1.43 in activeperl 13.ppm install patchreader=install patchreader version 0.9.4 in activeperl 13.=downloaded 9558 bytes.successfully installed patchreader version 0.9.4 in activeperl 13.ppm install net:ldap=install convert-asn1 v

47、ersion 0.19 in activeperl 13.=downloaded 26326 bytes.tcivis-v1.0-technology.ott2009-03-25copyright ? tcivis 2006 - 2009. page 12 of 24129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181

48、182183184185186187188189190191192193194successfully installed convert-asn1 version 0.19 in activeperl 13.=install perl-ldap version 0.33 in activeperl 13.=downloaded 188548 bytes.successfully installed perl-ldap version 0.33 in activeperl 13.=install net-ldap-express version 0.1

49、1 in activeperl 13.=downloaded 7693 bytes.successfully installed net-ldap-express version 0.11 in activeperl 13.ppmand then, have a check: c:bugzillaperl checksetup.pl -check-modules example 2: ppm local installationas mentioned above, instead of run ppm directly, you may downlo

50、ad installation packages into your local computer, and then run ppm to install them. note: again, the module list below may not correct for you. pls use script checksetup.pl to have a check. see belew. step 1: download installation packages from http:/cpan.uwinnipeg.ca/ppmpackages/10 xx/zips/ (for p

51、erl 5.10.x). below is the sorted list: appconfig.zipcgi.pm.zipdbd-mysql.zipemail-address.zipemail-messageid.zipemail-mime.zipemail-mime-contenttype.zipemail-mime-encodings.zipemail-mime-modifier.zipemail-send.zipemail-simple.zipmime-types.zipreturn-value.ziptemplate-toolkit.ziptimedate.ziplets say y

52、ou downloaded them into folder c:perl_modules. tcivis-v1.0-technology.ott2009-03-25copyright ? tcivis 2006 - 2009. page 13 of 24195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224step 2: unpack the zip packages. each zip file will be unpacked into 3 files: xxx.

53、tar.gz, xxx.ppd, and a readme file. the readme file is not so valuable that you could throw it away. lets say you extracted all tar.gz files and ppd files into folder c:perl_modules. step 3: run ppm commands listed below. keep in this order, or you will probably meet dependency problem: c:perl_modul

54、esppm install cgi.pm.ppdc:perl_modulesppm install timedate.ppdc:perl_modulesppm install appconfig.ppdc:perl_modulesppm install template-toolkit.ppdc:perl_modulesppm install return-value.ppdc:perl_modulesppm install email-address.ppdc:perl_modulesppm install email-simple.ppdc:perl_modulesppm install

55、email-send.ppdc:perl_modulesppm install email-mime-contenttype.ppdc:perl_modulesppm install email-mime-encodings.ppdc:perl_modulesppm install mime-types.ppdc:perl_modulesppm install email-mime.ppdc:perl_modulesppm install email-messageid.ppdc:perl_modulesppm install email-mime-modifier.ppdc:perl_mod

56、ulesppm install dbd-mysql.ppdstep 4: run checksetup.pl to have a check. c:bugzillaperl checksetup.pl -check-modules1.4 apacheit is recommended that you run bugzilla with the apache web server. if you want to use iis to run bugzilla, there are configuration instructions in the bugzilla documentation.

57、 1.4.1 download apache 2.xdownload the apache http server version 2.x or high from: /download.cgi (5.8 meg). lets say you downloaded version 2.2. tcivis-v1.0-technology.ott2009-03-25copyright ? tcivis 2006 - 2009. page 14 of 242252262272282292302312322332342352362372382392401.4

58、.2 installyet another standard windows installer. just follow the prompts, making sure you install for all users. for the remainder of this document i will assume you installed apache into the default location, c:program filesapache software foundationapache2.2. if you are already running iis, you m

59、ust configure apache to run on a port other than 80, however you arent asked the port to listen on at install time. choose all users (which says port 80), and well change the port later. by default apache installs itself to run as the system account. for security reasons its better the reconfigure t

60、he service to run as an apache user. create a user that is a member of no groups, and reconfigure the apache2 service to run as that account. 1.4.3 grant write access for apache accountby default apache will run as the system account. this account needs write and modify access to the following direc