bugzilla2_20安装说明.doc

Windows下bugzilla2-20的部署一、软件准备：1、 Http服务器（ Apache HTTP Server）2、 Perl解释器：ActivePerl3、 MySQL数据库4、 James邮件服务器(/可以下载)5、 JDK或JRE：要使用James就需要安装一个Java运行时环境6、 Bugzilla(/)二、安装：1、 安装JDK：配置环境变量： 打开：我的电脑属性高级环境变量 在系统变量中增加一个JAVA_HOME= D:sdksjdk1.5.0_05 在系统变量中增加一个CLASSPATH=%JAVA_HOME%lib 在系统变量的PATH变量中增加值%JAVA_HOME%bin（注意值间用分号隔开）。2、James安装： 将下载到的james包解压到一个目录。如 D:toolsjames-2.2.0测试： 打开安装目录下的bin目录，执行run.bat。 如果出现如下提示信息表名安装成功，可以发送邮件了。Using PHOENIX_HOME: D:toolsjames-2.2.0 Using PHOENIX_TMPDIR: D:toolsjames-2.2.0temp Using JAVA_HOME: C:jdk1.5.0_05 Phoenix 4.0.1 James 2.2.0 Remote Manager Service started plain:4555 POP3 Service started plain:110 SMTP Service started plain:25 NNTP Service started plain:119 Fetch POP Disabled FetchMail Disabled 三、 安装MySQL5.0.22：安装时，选择utf-8编码，其他可默认安装创建数据库：bugsmysqlcreate database bugs;给bugs用户授权和指定密码”bugs”mysql grant select,insert,update,delete,index,alter,create,locktables,drop,references on bugs.* to bugslocalhost identified by bugs ;mysqlflush privileges;mysqlexit退出数据库四、ActivePerl安装：运行ActivePerl安装程序，指定安装路径（注意有一个复选框需要勾选，要求把perl的bin目录自动加入环境变量PATH中）。测试：进入命令行模式，执行perl version如果出现版本信息则表示安装正确。五、bugzilla安装：将下载到的bugzilla压缩包解压到任意目录，我的是D:toolsbugzilla七、Apache HTTP Server安装：安装：运行下载的Apache HTTP Server安装文件，选择安装路径和端口。我安装在D:toolsApache GroupApache2，端口是默认的80。好像还有一个选择就是启动时自动监视Apache服务器，安装后在启动栏中会多一个“Monitor Apache Servers”。运行它后，在系统栏会出现一个图标，打开它可以看到Apache服务器的运行状态，并且可以启动和停止服务。后边我们讲到启动或重启服务器，表示使用这个监视工具来操作Apache服务器。测试： 启动Apache服务器后，在浏览器中输入“http:/服务器IP地址”，应该会出现Apache的欢迎界面。如果没有，请检查服务是否正常启动了，端口是否和其他程序冲突了等等。八、Perl Module安装：Perl Module是Perl需要做一个特定的事情时需要的相关组件。我们这里要让Perl支持bugzilla的运行，就需要安装必要的一些Module。安装Perl、配置bugzilla以及配置Apache服务器是交叉进行的，所以下边我将描述整个安装配置过程。 Bugzilla提供了一个checksetup.pl的文件，其实就是它的安装处理文件了，它可以检查必要的perl Module是否存在，然后还能创建数据库表，编译一些文件等。在执行checksetup.pl之前，我们需要修改一些bugzilla的文件。因为我们是在windows环境下使用，bugzilla默认是用于Unix环境的，所以不得不对源文件做一些改动。 这是bugzilla自带的官方文档里的帮助，我们以此进行修改：打开安装目录内的Bugzilla/Bugmail.pm，即D:toolsbugzillaBugzillaBugMail.pm。将其中的open(SENDMAIL, |/usr/lib/sendmail $sendmailparam -t -i) | die Cant open sendmail;print SENDMAIL trim($msg) . n;close SENDMAIL; to use Net:SMTP;my $smtp_server = ; # change this# Use die on error, so that the mail will be in the unsent mails and# can be sent from the sanity check page.my $smtp = Net:SMTP-new($smtp_server) | die Cannot connect to server $smtp_server;$smtp-mail(); # change this$smtp-to($person);$smtp-data();$smtp-datasend($msg);$smtp-dataend();$smtp-quit; 现在要做一些改变。首先要把“”改为邮件服务器的地址，我们在本机安装了James做为邮件服务器，所以这里改为“”。如果是使用外部邮件服务器，则修改为对应的地址。然后把修改为一个邮件发送者的邮箱，这个随便写一个即可，我们用James，所以这里我填了“bugzilla-daemon”。如果使用外部邮件服务器，很可能需要进行发送者身份验证，这里可以增加一行$smtp-auth(发送者账号,密码);James不需要身份验证，所以不用增加此项。这里有一个很严重的问题是$smtp-to($person); 这一行，不知道是bugzilla故意写错还是怎么样，后边使用checksetup.pl进行安装时，这一行编译不过去，报告的是$person没有进行声明。在查看我们修改的这个位置所处的方法sub MessageToMTA ($) 内，并没有将$person做为参数传进来，也没有单独的声明。 通常是修改这个sub MessageToMTA ($)方法，在参数中增加一个值，将person做为参数传进来。同时在将参数值赋给$person。即将 sub MessageToMTA ($) 修改为 sub MessageToMTA ($) 增加了一个$符号。接着把该方法开始位置的 my ($msg) = (_); 修改为 my ($msg,$person) = (_); 增加了对$person的参数赋值。 但是这样修改后，方法增加了一个参数。还需要对整个bugzilla的目录进行全面搜索，寻找使用到这个MessageToMTA的地方，然后修改为需要两个参数的形式。但是我发现很难确定应该如何设置需要传入的第二个参数。在我做了对应的修改后，并不能成功的发送邮件，而且都没有连接邮件服务器，所以决定不使用这种方式。 我的做法是在“$smtp-to($person);”这一行前加上#号将其注释掉，而且可以成功发送邮件。 现在修改BugMail.pm文件，将sub MessageToMTA ($)方法中的“$smtp-to($person);”用#号注释掉，完成以上修改后保存。 现在在命令行模式进入bugzilla的安装目录，执行一下命令开始安装：perl checksetup.pl如果一切正常，将出现如下的提示信息：D:toolsbugzillaperl checksetup.plChecking perl modules .Checking for AppConfig (v1.52) not foundChecking for CGI (v2.93) ok: found v3.10Checking for Data:Dumper (any) ok: found v2.121_04Checking for Date:Format (v2.21) not foundChecking for DBI (v1.38) not foundChecking for File:Spec (v0.84) ok: found v3.05Checking for File:Temp (any) ok: found v0.16Checking for Template (v2.08) not foundChecking for Text:Wrap (v2001.0131) ok: found v2001.09293Checking for Mail:Mailer (v1.65) not foundChecking for Storable (any) ok: found v2.13The following Perl modules are optional:Checking for GD (v1.20) not foundChecking for Chart:Base (v1.0) not foundChecking for XML:Parser (any) ok: found v2.34Checking for GD:Graph (any) not foundChecking for GD:Text:Align (any) not foundChecking for PatchReader (v0.9.4) not foundAll the required modules are available at: /ppm/You can add the repository with the following command: ppm rep add bugzilla /ppm/If you you want to see graphical bug charts (plotting historical data overtime), you should install libgd and the following Perl modules:GD: ppm install GDChart: ppm install ChartIf you you want to see graphical bug reports (bar, pie and line charts ofcurrent data), you should install libgd and the following Perl modules:GD: ppm install GDGD:Graph: ppm install GDGraphGD:Text:Align: ppm install GDTextUtilIf you want to see pretty HTML views of patches, you should install thePatchReader module:PatchReader: ppm install PatchReaderBugzilla requires some Perl modules which are either missing fromyour system, or the version on your system is too old.They can be installed by running (as Administrator) the following: ppm install MailTools Minimum version required: 1.65 ppm install AppConfig Minimum version required: 1.52 ppm install Template-Toolkit Minimum version required: 2.08 ppm install TimeDate Minimum version required: 2.21 ppm install DBI Minimum version required: 1.38 其中的checkfor用来检查bugzilla需要用到的perl module是否存在，如果存在的话会显示“ok found”以及版本号，不存在的会显示“not found”。 接着看后边的提示信息，说使用如下命令可以把一个资源库加入perl的下载路径，来下载这些不存在的perl module。ppm rep add bugzilla /ppm/现在执行这行命令，将出现下边的提示：D:toolsbugzillappm rep add bugzilla /ppm/Repositories:1 ActiveState PPM2 Repository2 ActiveState Package Repository3 bugzilla 再看一下前边执行cheksetup.pl文件时列出的提示，其中有很多“ppm install xxx”这样的语句，这些其实就是用来下载并安装缺少的perl module的命令。现在在命令行中依次执行这些“ppm install xxx”命令。主要有下边这几个：ppm install GDppm install Chartppm install GDGraphppm install GDTextUtilppm install PatchReaderppm install MailToolsppm install AppConfigppm install Template-Toolkitppm install TimeDateppm install DBI 因为我们使用了mysql数据库，需要再安装一个module：Ppm install DBD-mysql每次执行安装命令需要的时间是由你的网络速度决定的，可能会花些时间，你也可以写一个批处理文件来自动执行这些命令。执行过程中有些时候会询问是否安装，请选择yes，或者需要你指定一个安装目录等，随意指定一个目录即可，我的是d:toolsperlmodule。 如果正常执行了一个安装程序，将出现类似如下的提示信息：D:toolsbugzillappm install GDInstall GD version 2.16 in ActivePerl 13.Installing D:toolsPerlsitelibautoGDGD.bsInstalling D:toolsPerlsitelibautoGDGD.dllInstalling D:toolsPerlsitelibautoGDGD.expInstalling D:toolsPerlsitelibautoGDGD.libInstalling D:toolsPerlhtmlsitelibGD.htmlInstalling D:toolsPerlhtmlsitelibGDPolyline.htmlFiles found in blibarch: installing files in bliblib into architecture dependent library treeInstalling D:toolsPerlsitelibGD.pmInstalling D:toolsPerlsitelibqd.plInstalling D:toolsPerlsitelibautoGDautosplit.ixInstalling D:toolsPerlsitelibGDPolyline.pmSuccessfully installed GD version 2.16 in ActivePerl 13. 现在来再次执行perl checksetup.pl命令，提示应该显示必要的模块都可以找到了。D:toolsbugzillaperl checksetup.plChecking perl modules .Checking for AppConfig (v1.52) ok: found v1.55Checking for CGI (v2.93) ok: found v3.10Checking for Data:Dumper (any) ok: found v2.121_04Checking for Date:Format (v2.21) ok: found v2.22Checking for DBI (v1.38) ok: found v1.48Checking for File:Spec (v0.84) ok: found v3.05Checking for File:Temp (any) ok: found v0.16Checking for Template (v2.08) ok: found v2.13Checking for Text:Wrap (v2001.0131) ok: found v2001.09293Checking for Mail:Mailer (v1.65) ok: found v1.67Checking for Storable (any) ok: found v2.13The following Perl modules are optional:Checking for GD (v1.20) ok: found v2.16Checking for Chart:Base (v1.0) 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 (v0.9.4) ok: found v0.9.5All the required modules are available at: /ppm/You can add the repository with the following command: ppm rep add bugzilla /ppm/ Checking user setup .This version of Bugzilla contains some variables that you maywant to change and adapt to your local settings. Please edit thefile ./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_driver db_host db_pass db_sock db_check 同时要求我们对自动生成的localconfig文件进行配置，主要是数据库的。现在打开bugzilla安装目录中的localconfig文件，这个文件是在执行了checksetup.pl后生成的。 因为我们是在本机安装了MySQL数据库，并且存储空间和用户名都是“bugs”，所以localconfig文件中的$db_driver = “mysql”;$db_host = localhost;$db_name = bugs;$db_user = bugs; 都不用修改，默认即可。需要修改的是$db_pass = ;这是bugs存储空间的bugs用户的密码，前边配置数据库时，密码设置为“bugs”，所以这里修改为：$db_pass = bugs; 保存该文件，然后再来执行checksetup.pl文件。如果一切正常，将会出现一些正常的提示信息，然后会询问SMTP服务器的主机名是什么，因为我们在本机使用James，所以这里就填。 接着会出现一些建表的提示信息，最后要求输入系统的超级管理员的邮箱账号、管理员名字、两次密码。 这样就结束了bugzilla的安装配置了。 现在来看Apache的配置，主要是Apache的httpd.conf文件，位于安装目录Apache Group下的Apache2conf内。我的是“D:/tools/Apache Group/Apache2/conf/httpd.conf”。首先找到DocumentRoot D:/tools/Apache Group/Apache2/htdocs这一行，将地址修改为bugzilla的安装目录：DocumentRoot D:/tools/bugzilla然后找到 修改为修改为bugzilla的安装目录：将Options Indexes FollowSymLinks这一行修改为：Options Indexes FollowSymLinks ExecCGI 把AllowOverride None改为AllowOverride ALL接着在之前加一行：ScriptInterpreterSource Registry-Strict 这一行很重要，是让Apache从注册表中寻找我们安装好的Perl的路径，使用Perl来对bugzilla里的cgi进行解释。把DirectoryIndex index.html index.html.var将其修改为：DirectoryIndex index.html index.html.var index.cgi 指明让Apache能够以index.cgi做为访问的默认页面。把#AddHandler cgi-script .cgi前边的#号去掉。修改前和修改后的重要部分的对比，中间去掉了注释信息：修改前：DocumentRoot D:/tools/Apache Group/Apache2/htdocs Options Indexes FollowSymLinks AllowOverride None Order allow,deny Allow from allDirectoryIndex index.html index.html.var修改后：DocumentRoot D:/tools/bugzilla Options Indexes FollowSymLinks ExecCGI AllowOverride ALL Order allow,deny Allow from all ScriptInterpreterSource Registry-StrictDirectoryIndex index.html index.html.var index.cgi 修改完成后保存。修改注册表：我们已经在httpd.conf文件中配置了让Apache在注册表中寻找Perl的安装路径，但是我们还没有在注册表中添加这些内容。现在就来新建一个注册表导入文件来完成添加。新建一个名为cgi.reg的文件，添加如下内容：Windows Registry Editor Version 5.00HKEY_CLASSES_ROOT.cgiHKEY_CLASSES_ROOT.cgiShellHKEY_CLASSES_ROOT.cgiShellExecCGIHKEY_CLASSES_ROOT.cgiShellExecCGICommand=d:toolsperlbinperl.exe -T 注意，最后一行应该是正确的perl安装路径。保存后执行该文件完成注册表的修改。九、正式运行：现在应该首先启动好James服务器、MySQL数据库服务器，最后启动Apache服务器。打开浏览器访问http:/服务器IP地址，应该可以看到bugzilla的首页了。可以使用在执行checksetup.pl文件时要求输入的管理员邮件地址（账号）和密码登录系统，如果可以正常登录，说明基本功能已经安装成功。再来测试邮件发送是否正常。先退出登录，然后在右下角点“New Account”创建一个新账号。输入一个你的其他可用邮箱地址，然后提交。如果正常的话会出现一个“Account Created”页面，说账号创建成功，密码已经发到你的邮箱去了。到底有没有发送成功，我们可以去看看James的日志，James会把每次发送邮件的情况都记录下来的。打开James安装目录下的appsjameslogs目录，我的在D:toolsjames-2.2.0appsjameslogs。找到文件名以smtpserver开头，日期做为后缀的文件，如smtpserver-2005-10-19-18-34.log。日期应该是当前的日期。如果发送正常，里边会记录发送成功的信息，类似如下：19/10/05 18:34:59 INFO smtpserver: Connection from localhost ()19/10/05 18:35:01 INFO smtpserver: Connection from localhost ()19/10/05 18:35:01 INFO smtpserver: Successfully spooled mail Mail1129718101343-0 from postmastermyMachineName for From是系统构造的，不用管它，for是邮件发送到的地址，应该是你刚刚注册新账号时用的地址。这里是成功了，如果失败的话，会有一些错误提示，请进行修正。 需要严重注意的是，你的这台服务器的计算机名最好不要有特殊字符，比如下划线。我遇到过就是计算机名包含了下划线，结果James识别postmastermyMachineName地址时，认为地址格式有误。如果你深入研究James的配置，应该可以解决这个问题的。 另外还要注意你的机器是否安装了什么防火墙啊等等安全软件，如果不成功也可以去检查一下。 现在打开你刚才注册用的那个邮箱收取邮件吧。如果正常的话，应该可以收到bugzilla发送的一封包含登录密码的邮件。 另外，就算James可以正常的发出邮件，你的邮箱还不一定可以收得到。我测试过几个网站提供的邮箱，只有google提供的gmail可以正常接收邮件，还有我们公司自己的邮箱也可以。但是像126.com这些就收不到了，不知是怎么回事。 我也测试过查询自己的密码、提交一个bug、操作bug等等，都可以正常的发送邮件到相关的邮箱去。不过这些邮件中的“发送人”却一直是“bugzilla-daemon”，这个我也不清楚该在什么地方配置。10、此时英文版的Bugzilla可正常进行工作，进行汉化工作：解压汉化包bugzilla-2.20-cn-1.0汉化包.zip，解压其中的cn_UTF8.zip及custom.zip，将cn_UTF8放在bugzilla目录中的template目录下，并将文件夹名字改为cn；将custom文件夹放在skins目录；bugzilla安装目录内CGI.pm文件里第55行改为$self-charset(UTF-8);进入bugzilla页面，登录管理员帐号，进行系统设置，将语言修改为cn；刷新页面，此时已显示为中文版；如出现乱码，浏览器应选择utf-8编码显示。 关于 Bugzilla/installation-list/ Bugzilla 用户名单，很多知名企业，其中以开源系统为主 /linweiguo/archives/000044.html Win2000下Bugzilla安装实录 (作者：Jackey) /programming/4/2005/cgi-11343023012506.shtml 在 Win32 下安装 Bugzilla (Good!) /data/2006/0808/article_1334.htm 安装bugzilla (作者 dreamstone) /ymliu888/archive/2005/12/13/656701.aspx 解答：为什么在应用了Bugzilla汉化包后，原来存在的汉字变成了乱码？ /ymliu888/archive/2005/12/14/658121.aspx 关于Bugzilla2.20发邮件以及邮件乱码的问题 4) 下载 Bugzilla /download/ Download : Bugzilla /projects/bugzilla-cn/ /project/showfiles.php?group_id=75477 Bugzilla 的汉化包和模块 bugzilla-2.20-cn-1.0.zip BugzillaModules-2.20.zip /ppm/ bugzilla-bundle.zip /php/dl.php?sid=15654 Mail Direct Pro /index_1_o_1.html Mail Direct Pro v-SSG .au/sendmail/ Fake Sendmail 1.9 5) 关于 Perl /soft/947.htm ActivePerl 5.8.8 Build 819 /conf/slides/cnhacktnt_PerlUnicodeIn5Min.ppt 讨论 Perl 和 Unicode 的关系 /blog/showlog.asp?cat_id=27&log_id=690 /fmddlmyy/archive/2005/05/04/372148.aspx /develop/article/69/69883.shtm 谈谈Unicode编码，简要解释UCS、UTF、BMP、BOM等名词 /pc/program/tutors/perl/perl0003.htm -CGI编程-Perl标量的操作符- /yhf/perlstep/perlstep6.html Perl程序设计中的函数(子程序) /netcobra/archive/2004/04/16/6322.html 转移安装 BugZilla 时 Perl 模块的安装 Part B. 补充事项 1) JIRA 的管理比 Bugzilla 要强一些，使用也比较方便，本身已经 支持多国语言(包括中文)。可惜，这个是要花钱的。虽然网上有 注册机，如果没有真正购买，将来遭到版权局的调查还是会被罚。 如果公司有预算，建议购买 JIRA，否则推荐用免费的 Bugzilla。 2) 上面那篇JIRA安装批南漏了讲一点，为了方便支持中文，在 安装 MySQL 的时候要选 Custom，数据库的默认类型要选 UTF8。 这个问题，对于 Bugzilla 也是一样，建议用 UTF8 来存储中文。 如果不指定 UTF8，要么无法正确显示中文，要么不能创建 Bug。 3) Bugzilla 的 Perl 包安装，其实是有很多简便的方法的，没必要 自己编译，而且发送邮件并不用修改大量 Code，只要装两个东西 就可以了。一是 Mail Direct Pro 作为本地 SMTP 服务器，注意 不要用最新的 ，这个版本破解不完全，显示未注册。二是 Fake Sendmail 作为 sendmail 程序，必须装在跟 Bugzilla 同一 个盘。例如 Bugzilla 在 H:ServerWebzSitebugzilla2.20.2 那么，sendmail 就应该装在 H:UsrLib，并且配置 ini 文件。 需要注意的是，必须配置好 SMTP 转发服务器。Mail Direct Pro 是支持中文的，选工具-配置-SMTP转投-添加，如果你的 SMTP 服务器如 需要验证，则必须填写帐号和密码。 在如果发送失败则转投这个选项上打勾，保证邮件可以正确发送。 当某些邮件服务器有特殊限制时，转发到外网专业 SMTP 较有保障。 4) Bugzilla 2.20 有汉化版，可以用于 2.20.2，但最新版2.22还没 汉化。而且汉化后还有一些问题，主要是发 Mail 不正常。对于 网页和邮件的乱码，请大家使用 UTF-8 汉化包，并参考汉化作者 的 Blog 里的解答，里面已经提到怎样消除这些乱码。我这里只是 补充一个目前翻遍整个 Google 都找不到答案的问题。 在汉化版里 sendmail 是表面正常，实际上并没有发出。经过我用 WinHex 研究 debug 文件，发现汉字编码是 UTF-8，注意：如果用 UltraEdit 按 Ctrl-H 则会自动将文档转为 UCS-2 (Unicode)。由 于里面的 From 向下跑了好几行，所以 sendmail 报告没有发信人。 通过查找 Bugzilla 的资料，发现是在 Token.pm 里处理忘记密码， 例如 H:ServerWebzSitebugzilla2.20.2BugzillaToken.pm。 错误现象： Bugzilla 2.20.2 汉化版的 sendm