缺陷跟踪系统Mantis介绍及安装

梦幻小丑灯

现在所在的创业公司之前没有QA体系，我入职以后一切都要从头梳理和搭建，调研了很多测试工具，现在
介绍一下Mantis这个缺陷跟踪管理系统。
Mantis是一个操作简洁但功能强大的免费开源缺陷管理系统，使用PHP语言开发，服务能够部署在Windows
、Linux、Mac OS X等任何PHP支持的环境上，支持所有主流数据库如MySQL、MSSQL等。服务搭建完成后，
以Web页面的形式提供操作接口，这样使用者在任何地点、任何平台上都能够使用它。在功能上，Mantis能
够针对不同项目制定不同的缺陷处理流程、能够区分项目参与人员的角色实现访问权限控制、能够定制哪
些事件发生时发送邮件以提醒相关的责任人、提供了非常好的中文支持和定制。对于我司，采用了很多免费
开源的工具，如果这些工具都采用自己的鉴权系统，使用工具的同事需要记住很多不同工具的用户名和密码，
使用上十分不便，Mantis可以支持LDAP，这样就支持统一的认证了。
下面说一下Mantis的安装方法。在写这篇博客的时候，Mantis的最新版本是1.2.19，下载到本地后拷贝到Web
服务器的主目录，如/var/www/html/，然后使用相应的解压缩命令解压，如：

mars@mars-Ideapad-V460:/var/www/html$ unzip mantisbt-1.2.19.zip
然后修改目录名字为mantisbt，权限更改为777：

mars@mars-Ideapad-V460:/var/www/html$ mv mantisbt-1.2.19 mantisbt
mars@mars-Ideapad-V460:/var/www/html$ sudo chmod 777 mantisbt
为了后续能够正常使用Mantis的所有功能，正式安装之前需要检查下服务器上的PHP模块是否满足要求，
如curl、mbstring、gd，然后在浏览器中输入http://localhost/mantisbt即可跳转到安装页面。


在这个界面需要填写相关的数据库信息，如数据库普通/管理员用户名和密码，不要勾选“Print SQL Queries
instead of Writing to the Database”，然后点击“Install/Upgrade Database”，安装完成后会有安装是否成功
的检查页面,确保所有的结果都是绿色：

简单的安装完成后,数据库的相关配置会写入/var/www/html/mantisbt/config_inc.php文件中，我们先不要
按照Web页面提示以Admin用户登陆，先访问http://localhost/mantisbt/admin/check.php检查一下服务器
PHP是否有其他不匹配的配置，我遇到的问题是时区和PHP的POST上传文件大小限制问题，到PHP配置文
件中修改timezone为Asia/Shanghai、post_max_size后重启Apache，检查通过：


接下来我们访问http://localhost/mantisbt/login_page.php以administrator:root登陆系统，然后访问
http://localhost/mantisbt/admin/test_icons.php检查所有图标，确保所有检查结果OK，访问
http://localhost/mantisbt/admin/test_langs.php检查语言，确保没有报错，然后访问http://localhost/mantisbt
/admin/test_email.php，点击”Send Mail”测试邮件系统是否工作正常：


如果返回错误或者页面长时间无响应，需要配置Mantis的邮件服务器，方法是在config_inc.php中添加如下
配置（我使用了126邮箱服务器，也可以使用自建邮箱服务器）：

# --- Email Configuration ---
$g_phpMailer_method = PHPMAILER_METHOD_SMTP;
$g_smtp_host = 'smtp.126.com';
$g_smtp_port = 25;
$g_smtp_username = '你的邮箱全名';
$g_smtp_password = '你的邮箱密码';
$g_administrator_email = '你的邮箱全名';
$g_webmaster_email = '你的邮箱全名';
$g_from_email = '你的邮箱全名';
$g_return_path_email = '你的邮箱全名';
$g_from_name = 'MarsLoo Mantis系统';

改动Mantis的配置后无需重启Apache服务器，直接刷新页面然后点击”Send Mail”即可看到邮件成功发
送的消息：

接下来到服务器主目录的mantisbt目录下删除admin目录或者重命名，然后在config_inc.php文件中添加
如下配置即可让Mantis支持中文：

# --- Language Configuration ---
$g_default_language     = 'chinese_simplified';
$g_language_choices_arr = array(
    'chinese_simplified',
    'english',
);
$g_language_auto_map = array(
    'zh-cn, zh-sg, zh' => 'chinese_simplified',
    'en-us, en-gb, en-au, en' => 'english',
);
$g_fallback_language    = 'chinese_simplified';

点击“Logout”退出系统后，Mantis界面变成中文，提示我们应该删除Administrator账号或修改其密码：


以Adminstrator:root用户登入系统后新建一个管理员权限的用户（“管理”->“用户管理”），然后登陆注
册邮箱点击注册邮件配置密码后才能使用账号，

使用新的管理员账号登陆系统后删除默认的Administrator账号即可。细心的朋友会发现，目前Mantis系
统发送邮件通知的网址前缀是http://localhost/mantisbt，对于Mantis系统管理员来说是可以访问的，对
于其他用户谁知道这里的localhost对应的IP地址是什么呢，所以需要修改Apache的ports.conf文件，将
Listen 80改为IP加端口的形式：

Listen 192.168.1.5:80
再修改PHP的配置文件，将SMTP = localhost改为：

SMTP = 192.168.1.5
然后$ sudo service apache2 restart重启Web服务器，尝试注册一个用户，检查下这一次的邮件中地址
正确与否：

最后，以新建立的管理员用户账号登陆Mantis系统，安装“Mantis图表 1.0”和“导入/导出问题 1.0”两个插
件（“管理”->“插件管理”）。
至此，Mantis系统的安装全部完成。