Mantistb安装配置及使用文档
背景
MantisBT是一个基于php技术的轻量级
的开源
缺陷跟踪系统,以web操作的形式提供项目管理和缺陷跟踪服务。在功能和实用性上足以满足中小型项目的管理及跟踪。
特点
- email通知功能可以自己定制
- 支持多项目、多语言
- 权限设置灵活(每个项目或缺陷可设为公开或私有状态,缺陷可以在不同项目间移动)
- 缺陷关联功能(缺陷可以关联到其他相关缺陷)
- 流程定制方便
和其他开源工具比较
- Bugzilla
http://www.bugzilla.org
- 需要安装mysql + apache
- 需要安装一些perl模块(所需模块在http://landfill.bugzilla.org/ppm/)
响应速度快
安装麻烦,
流程是固定的,不能定制
基于web方式
需要perl支持
BugFree
- 不再更新
weblssues
- 客户机/服务器模式
- 服务器可安装在任何支持php和mysql的主机上,客户端(windows,linux,os x),web client
- 容易部署和定制
- 允许自定义很多功能
安装配置
服务器: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文件移走,修改提示信息出来之后再移进来或按下面方法新建就可以
- 创建config_inc.php文件
执行命令:cp config_inc.php.sample config_inc.php - 按提示修改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;
2、修改
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可能属于不同的类别)
- 提交问题
提交问题-》选择项目-》选择分类只有在有项目存在的时候才有 提交问题 这一项
如下图所示,根据要提交的bug填相应的各项,然后提交问题,提交后就可以在我的视图中查看到