开源缺陷跟踪系统mantis安装指南

1. 简介
mantis(螳螂)是一个基于php/MySQL/web的缺陷跟踪系统，最新版本是0.19.2。
要了解更多信息请到http://www.mantisbt.org/。
2. 下载
mantis0.19.2 http://www.mantisbt.org/download.php
mysql5.0.2 http://dev.mysql.com/downloads/mysql/5.0.html
PHP5.0.3 http://www.php.net/downloads.php
apache2.0.52 http://httpd.apache.org/download.cgi
3. 安装步骤
1）安装刚才下载的软件
下面假设各软件的安装目录为
c:\mantis-0.19.2
c:\mysql-5.0.2
c:\php-5.0.3
c:\apache-2.0.52
我习惯下载zip版的程序，直接解压到一个目录就可以了。没有的话，只好下载windows_installer版本：）。
a.安装apache2.0.52
我下载的是http://apache.freelamp.com/httpd/binaries/win32/apache_2.0.52-win32-x86-no_ssl.msi
运行安装程序，安装时选择安装给当前用户，采用8080端口，不要安装成服务，对我来说没必要。安装后同样可以再安装成service
详细请参考：
apahce在windows下的安装指南 http://httpd.apache.org/docs-2.0/platform/windows.html
运行c:\apache-2.0.52\bin\apache.exe，在IE地址栏输入http://localhost:8080/，可以看到安装成功。如果前面是安装成80端口的服务，则输入http://localhost/
b.其它的软件直接解压到自己想要的目录。当然如果你下载的是installer也是一样的，直接运行安装程序，无非是安装
后多了几个启动的快捷菜单外加一些默认设置罢了。
2）为apache配置php
打开c:\apache-2.0.52 \conf\httpd.conf文件，添加如下内容到文件尾
#PHP 5
LoadFile "c:/php-5.0.3/php5ts.dll"
LoadModule php5_module "c:/php-5.0.3/php5apache2.dll"
AddType application/x-httpd-php .php
＃PHP.ini path
PHPIniDir "c:/php-5.0.3"
3）php配置
将c:\php-5.0.3下的php.ini-dist复制一份，并改名为php.ini
查找include_path,改为include_path=".;c:\php-5.0.3\pear"
查找extension_dir,改为extension_dir="c:\php-5.0.3\ext"
查找php_mysql.dll,将这一行前面的“;”号去掉
保存文件
4）为apache安装mantis系统
打开c:\apache-2.0.52 \conf\httpd.conf文件，添加如下内容到文件尾
Alias /mantis "c:/mantis-0.19.2/"
<Directory "c:/mantis-0.19.2/">
Options Indexes
AllowOverride None
Order allow,deny
Allow from all
</Directory>
查找DirectoryIndex，添加index.php到后面。像这样DirectoryIndex index.html index.html.var index.php
5)创建数据库
运行c:\mysql-5.0.2\bin\mysqld-nt，启动数据库
mysql -uroot -p
create database bugtracker;
use bugtracker;
source c:\mantis-0.19.2\sql\db_generate.sql;
当然你也可以用其它GUI工具创建数据库。
6)mantis配置
将c:\mantis-0.19.2下的config_inc.php.sample复制一份，并改名为config_inc.php
如果你改了root的密码，打开这个文件，设置$g_db_password='yourpassword'
7)windows环境
将c:\php-5.0.3添加到path中
8)启动bug tracking system
首先启动apache和mysql,
在址栏输入http://localhost:8080/mantis/index.php或者http://localhost/mantis/index.php
应该可以看到初始页面了。用amdinistrator/root登录，mantis 开始为你工作。
9)邮件服务器配置
在c:\php-5.0.3\php.ini文件中查找smtp,将localhost改为你的发件服务器,如SMTP = smtp.163.com
在php.ini文件中查找sendmail_from,将前面的分号去掉,并在后面填上邮件地址
在c:\mantis-0.19.2\config_inc.php文件中添加
$g_smtp_host='smtp.163.com';
$g_smtp_username='yourusername';
$g_smtp_password='yourpassword';
$g_phpMailer_method =2;

查找$g_return_path_email,将后面的邮件地址改为有效的地址,这一点非常重要,不然将无法正常发送激活注册的邮件.
config_inc.php其它邮件地址最好也改为有效的地址.
$g_smtp_username,$g_smtp_password在服务器需要验证时用,不需验证时不用加,或设为
$g_smtp_username=''
$g_smtp_password=''
现在你可以注册新用户,并使用发送邮件功能了。
4.后记
昨天想装一个bug tracking system，上网转了一下，最后选定了mantis，理由只有一个：感觉这是一个功能能满足我的需要，更重要的是我能掌控的系统，以前除了在mysql 上create过一个db外，没有用过上面的任何一种软件。安装这个东西完全是为了我自己用，我是一个很懒的人，觉得把一些问题记在txt里会有一些麻烦，其他人如果愿意用，我当然不反对：）。
从下载安装到写完这个所谓的指南，用了几乎一天，有一些小问题浪费了很多时间，网上的一些安装手册，并没有想象的好用，
按照我这个指南，一个小时应该可以搞定。

集成apache+php+mysql+...的安装工具，http://www.apachefriends.org/en/xampp.html用它来安装very easy，即使你什么都不懂，也只要几分钟。
下载windows下的安装包,setup,找到apache\conf\httpd.conf，在文件最后添加
Alias /mantis "c:/mantis-0.19.2/"
<Directory "c:/mantis-0.19.2/">
Options Indexes
AllowOverride None
Order allow,deny
Allow from all
</Directory>
启动apache和mysql就行了。发邮件的功能设置见上面的3.9)
唯一不好的是，他安装了一整套软件，如果你的机器上已经安装了mysql等，就会浪费一些硬盘空间。