MantisBT的安装配置及使用

Mantistb安装配置及使用文档

背景

MantisBT是一个基于php技术的轻量级的开源缺陷跟踪系统，以web操作的形式提供项目管理和缺陷跟踪服务。在功能和实用性上足以满足中小型项目的管理及跟踪。

特点

1. email通知功能可以自己定制
2. 支持多项目、多语言
3. 权限设置灵活(每个项目或缺陷可设为公开或私有状态，缺陷可以在不同项目间移动)
4. 缺陷关联功能(缺陷可以关联到其他相关缺陷)
5. 流程定制方便

和其他开源工具比较

1. Bugzilla
   http://www.bugzilla.org
   
   1. 需要安装mysql + apache
   2. 需要安装一些perl模块(所需模块在http://landfill.bugzilla.org/ppm/)
      

      响应速度快
      安装麻烦，
      流程是固定的，不能定制
      基于web方式
      需要perl支持

2. BugFree

   1. 不再更新

3. weblssues

   1. 客户机/服务器模式
   2. 服务器可安装在任何支持php和mysql的主机上，客户端(windows,linux,os x),web client
   3. 容易部署和定制
   4. 允许自定义很多功能

安装配置

服务器：xx.xxx.xxx.xx

一、拉mantisbt的源代码到本地
https://github.com/mantisbt/mantisbt.git

二、拉phpmailer、adodb、disposable、securimage源代码（在mantisbt/library）
phpmailer：https://github.com/mantisbt/PHPMailer.git
adodb：https://github.com/mantisbt/ADOdb.git
disposable：https://github.com/mantisbt/disposable_email_checker.git
securimage：https://github.com/mantisbt/securimage.git

三、新建远程仓库，把mantisbt工程 push到仓库
仓库地址：http://git.intra.weibo.com/lijie17/MantisBT.git

四、把mantisbt/library/中的四个空文件夹删掉（phpmailer、adodb、disposable、securimage），然后 add、commit、push

五、再新建四个文件夹（ phpmailer、adodb、disposable、securimage）
分别把第二步拉下来的四个工程里面的代码拷到相应文件夹（除了readme.md），然后 add、commit、push

六、xx.xxx.xxx.xx 拉代码(服务器拉代码)
git clone http://git.xx.xx.xx/lijie17/MantisBT.git

七、访问 http://ip:port/MantisBT
返回界面信息如下：


1. GOOD 说明这一步完成
2. Hostname(for Database Server):数据库服务的地址: ip:port
3. Username(for Database)、Password(for Database)分别是你建的数据库的登陆帐号和密码
4. Database name (for Database) ：要建的数据库的名字，用默认bugtracker
5. Admin Username (to create Database if required) 、Admin Password (to create Database if required) 设置管理员的用户名和密码
6. Print SQL Queries instead of Writing to the Database 选择这项表示不创建数据库，默认不选这项，即按照上述信息创建数据库

八、点击install/Update Database 进入下一步
错误情况类似：

针对报错解决相应问题就可以了，这里的问题是mysql版本低导致的

正常情况:

九、完善Write Configuration File(s)
1. 按照提示去路径/lampp/htdocs/MantisBT/config下修改config_inc.php文件

一般该路径下只有config_inc.php.sample 、Web.config这两个文件
如果有config_inc.php文件，可能会报如下错误信息

解决方法：先将config_inc.php文件移走，修改提示信息出来之后再移进来或按下面方法新建就可以

1. 创建config_inc.php文件
   执行命令：cp config_inc.php.sample config_inc.php
2. 按提示修改config_inc.php
   

黄框中的字符串是每次install的时候随机生成的
4. 上面操作都完成后点击最下面的continue

进入mantis的登陆页面

MantisBT使用

一、注册账号
如果没有mantisbt账号，可以通过username：administrator password: root 登陆
点击登陆页面下面的注册一个新账号，注册完成后会往邮箱里发送修改密码的邮件，修改完后才可以登陆，所以第二步就是要配置邮箱（发件箱）
二、配置邮箱
完成下面两步就可以收到邮件了
1. 修改MantisBT/config_defaults_inc.php

------------------------------
# MantisBT Email Settings #
------------------------------
#mantis网页上显示的邮箱
$g_webmaster_email = 'lijie_weibo@sina.com';
＃收件人邮箱中显示的发送邮箱
$g_from_email = 'lijie_weibo@sina.com';
#收件人邮箱中显示的发送方的名称
$g_from_name＝ 'Mantis Bug Tracker';
#你回复邮件时的接收方，和发件箱保持一致
$g_return_path_email = 'lijie_weibo@sina.com';
#可以为空
g_administrator_email = 'lijie_weibo@sina.com';
#邮箱提醒功能
g_enable_email_notification = ON;

1. 修改MantisBT/config/config_inc.php

# --- Email Configuration ---
#发送方式选择，一般用smtp
$g_phpMailer_method = PHPMAILER_METHOD_SMTP;
#发件箱的服务器，根据自己想用的邮箱进行配置，我这里用的sina邮箱
#当所有都修改完仍然不能接收到邮件时，可以查看发件箱服务器是否配置正确
$g_smtp_host = 'smtp.sina.com.cn'; 
#发件箱用户名（到时候其他人收到的就是这个邮箱发送的邮件）
$g_smtp_username = 'lijie_weibo';
#发件箱的密码
$g_smtp_password = 'xxxx'; 
#可以为空
$g_administrator_email  = 'lijie_weibo@sina.com';
$g_webmaster_email      = 'lijie_weibo@sina.com';
$g_from_email           = 'lijie_weibo@sina.com'; 
#是否启用phpmailer
$g_use_phpMailer = ON;
#phpmailer的位置
$g_phpMailer_path = '/xx/xx/lampp/htdocs/MantisBT/library/phpmailer';

三、MantisBT介绍
1. mantisbt主要分三部分：管理、缺陷报告、统计
一些子功能可能因为版本不同会有细微差别(下图取自http://www.th7.cn/Program/php/201603/790985.shtml)

2. 首页

3. 我的视图各项说明
1. 分派给我的(未解决)：
指bug已经报告，指定由“我”来进行跟进的bug列表
2. 未分派的：
指bug已经报告，但是还没有指定由哪个项目组成员进行跟进的bug列表
3. 我报告的：
在这里会显示由“我”报告的bug列表
4. 已解决：
指bug已经得到解决，bug的状态为［已解决］
5. 最近修改的：
这一栏显示那些bug报告最近被项目组成员修改了
6. 我监视的：
指“我”正在监视的那些bug，在bug报告中，“我”被选为监视人
4. 查看问题

上半部分是一个过滤器，可以把想要查看的问题的一些特征值在里面进行设置
下半部分是筛选出来的所有问题，并且可以打印报告，导出为多种格式
5. 统计报表

可以根据需要对所有的问题进行统计分析，并会产生相应的图表
6. 管理

只有管理员有管理项，包括：用户管理、项目管理、标签管理 等等

四、MantisBT使用
1. 创建项目
管理－》项目管理－》创建项目[ 如（三、6.管理）图中所示 ]
还可以添加分类（不同的bug可能属于不同的类别）

1. 提交问题
   提交问题－》选择项目－》选择分类
   只有在有项目存在的时候才有 提交问题 这一项
   如下图所示，根据要提交的bug填相应的各项，然后提交问题，提交后就可以在我的视图中查看到