Mantis安装配置及使用教程

Mantis安装配置及使用教程
缺陷管理工具mantis 搭建安装及使用手册
SPT
2010 年7 月7 日
Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
目录
一、软件准备 (3)
二、安装：xampp (3)
三、安装：MySQL (4)
四、安装：mantis (6)
五、设置：mantis 为中文 (7)
六、Mantis 中邮件配置： (9)
七、Mantis 中上传附件设置 (10)
八、安装及配置JpGraph (12)
九、Mantis 时间设置 (13)
十、Mantis 使用手册 (14)
Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
一、软件准备
1、系统：Windows XP SP3；
2、软件：
xampp-win32-1.5.4a-installer
mysqlcc-0.9.3-win32；
mantis-1.0.7.tar；
jpgraph-2.0.tar；
二、安装：xampp
1、下载完xampp 后，进行安装，安装目录自定，如安装在C:\mantis\；
2、安装一路next；
3、注意一点，默认apache 端口为80，mysql 为3306，如果端口被占用了，需要设置端口，一般IIS 会占用apache 的80 端口，最好把IIS 服务停掉；
4、安装完成后，出现如下图：apache 和mysql 启动就可以了；
5、点击上图Apache 那行的Admin 按钮，弹出一页面，选中中文；
6、点击左边“安全”。

出现下图页面；
Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
7、点击图中http://localhost/security/xamppsecurity.php 链接，设置mysql 中
root 的密码。

三、安装：MySQL
1、一路next 后，安装完成，在桌面打开，如下图；
2、在name 中填root，在hostname 中填localhost，在Password 中输入刚刚设置的root 密码。

填完后，点ADD 按钮；
3、在左边选中DATABASE 点右键，选择新建数据库，新建一个mantis 数据库；
Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
4、新建完mantis 数据库后，在下面的User Adminstration 右键新增加一个
用户，用户名和密码最好都为mantis，”host”为”localhost”并且为该用户
指定数据库Mantis 与权限All Privileges,点击Add,如下图；
Generated by Foxit PDF Creator . Foxit Software
http://ww
For evaluation only.
四、安装：mantis
1、解压Mantis-1.0.7.tar.gz 到某盘根目录下，如C:\mantis\mantis-1.0.7;
2、设置mantis 目录权限，打开C:\mantis\xampp\apache\conf\httpd.conf 文件，在文件最后添加如下内容：
Alias /mantis "c:/mantis/"
<Directory "c:/mantis/">
Options Indexes
AllowOverride None
Order allow,deny
Allow from all
</Directory>
注意："c:/mantis/"目录中的/是反斜杠。

3、打开IE 输入http://localhost/mantis，会自动跳到mantis 安装页面;
4、Database 输入为Mantis，注意：installing Database 没有插入成功。

把SQL 拷贝出来。

此步骤出现相关bugtracker 的错误，原因为没有bugstracker 文件夹，在xampp\mysql\data\下加入之前项目的bugtracker 文件夹就可以了; Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
5、打开http://localhost/xampp/页面，点击工具下的phpMyAdmin，进
入页面输入mysql 的用户名和密码;
6、选中mantis 数据库，然后点击右边的SQL，出现下面页面;
7、把刚刚拷贝的SQL 复制上去，注意去掉第一行;
8、执行成功后打开http://localhost/mantis，就进入到登陆页面了。

默认用户名为administrator，密码为root。

五、设置：mantis 为中文
修改Mantis 中的默认配置文件config_defaults_inc.php,找到如下内容,对照修改.
如果把以下内容拷到config_inc.php 中也可以.
配置文件加载顺序:先加载config_defaults_inc.php,后加载config_inc.php。

Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
config_inc.php 中的值会覆盖config_defaults_inc.php.
################################
# Mantis Language Settings
################################
# --- language settings -----------
# If the language is set to 'auto', the actual
# language is determined by the user agent (web browser)
# language preference.
$g_default_language = 'chinese_simplified_gb2312';
# list the choices that the users are allowed to choose
$g_language_choices_arr = array(
'auto',
'bulgarian',
'catalan',
'chinese_simplified_gb2312',
'chinese_traditional',
'croatian',
'czech',
'danish',
'dutch',
'english',
'estonian',
'finnish',
'french',
'german',
'hebrew',
'hungarian',
'icelandic',
'italian',
'japanese',
'korean',
'latvian',
'lithuanian',
'norwegian',
'polish',
'portuguese_brazil',
'portuguese_standard',
'romanian',
'russian',
'serbian',
'slovak',
'slovene',
'spanish',
'swedish',
Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
'turkish',
'ukrainian'
);
# Browser language mapping for 'auto' language selection $g_language_auto_map = array(
'bg' => 'bulgarian',
'ca' => 'catalan',
'zh-cn, zh-sg, zh' => 'chinese_simplified_g
b2312',
'zh-hk, zh-tw' => 'chinese_traditional',
'cs' => 'czech',
'da' => 'danish',
'nl-be, nl' => 'dutch',
'en-us, en-gb, en-au, en' => 'english',
'et' => 'estonian',
'fi' => 'finnish',
'fr-ca, fr-be, fr-ch, fr' => 'french',
'de-de, de-at, de-ch, de' => 'german',
'he' => 'hebrew',
'hu' => 'hungarian',
'hr' => 'croatian',
'is' => 'icelandic',
'it-ch, it' => 'italian',
'ja' => 'japanese',
'ko' => 'korean',
'lt' => 'lithuanian',
'lv' => 'latvian',
'no' => 'norwegian',
'pl' => 'polish',
'pt-br' => 'portugese_brazil',
'pt' => 'portugese_standard',
'ro-mo, ro' => 'romanian',
'ru-mo, ru-ru, ru-ua, ru' => 'russian',
'sr' => 'serbian',
'sk' => 'slovak',
'sl' => 'slovene',
'es-mx, es-co, es-ar, es-cl, es-pr, es' => 'spanish',
'sv-fi, sv' => 'swedish',
'tr' => 'turkish',
'uk' => 'ukrainian'
);
# Fallback for automatic language selection
$g_fallback_language = 'english';
六、Mantis 中邮件配置：
Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
以下内容可以在config_defaults_inc.php 中找到。

建议把该内容拷到config_inc.php 中.
#############################
# Mantis Email Settings
#############################
# --- email variables -------------
$g_administrator_email = 'xxxx@';
$g_webmaster_email = 'xxxx@';
# the 'From: ' field in emails
$g_from_email = 'xxxx@';
# the return address for bounced mail
$g_return_path_email = 'xxxx@';
# allow email notification
# note that if this is disabled, sign-up and password reset messages will
# not be sent.
$g_enable_email_notification = ON;
# select the method to mail by:
# 0 - mail()
# 1 - sendmail
# 2 - SMTP
$g_phpMailer_method = 2; #以smtp 发送邮件
# This option allows you to use a remote SMTP host. Must use the phpMailer scrīpt
# Name of smtp host, needed for phpMailer, taken from php.ini
$g_smtp_host = ':25'; #加上端口号25
# These options allow you to use SMTP Authentication when you use a remote
# SMTP host with phpMailer. If smtp_username is not '' then the username
# and password will be used when logging in to the SMTP server.
$g_smtp_username = 'xxxxx';
$g_smtp_password = 'xxxxx';
邮件系统的配置建议用smtp 方式。

一般公司都有自己的邮件服务器，让管
理员给你开一个mantis 的专用信箱。

注意：还需要配置一个地方，在C:\xampp\apache\conf 目录下在找到
httpd.conf，打开后搜索到listen，把Listen 80 修改为listen IP:80，IP 就是你
服务器的地址。

还有修改php.ini，把SMTP = localhost 修改为SMTP = IP，IP
为你服务器IP
这样修改的好处是邮件发送的时候是直接以IP 地址发送链接的，而不是以localhost 发送的。

七、Mantis 中上传附件设置
1、在mantis 目录下新建一个upload 文件夹
2、在mantis 页面新建项目时，
配置好附件上传的路径。

如下图：
Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
3、打开config_inc.php 文件，搜索到Mantis File Upload Settings。

设置如下：$g_allow_file_upload = ON;
$g_file_upload_method = DISK; #设置为上传到硬盘上。

$g_max_file_size = 5000000; # 5 MB，设置附件的大小限制
$g_allowed_files = 'txt,jpg,jepg,gif,bmp,doc';#设置允许上传的附件类型$g_disallowed_files = ' '; #设置不允许上传的附件类型
$g_absolute_path_default_upload_folder = 'c:\mantis\upload'; #设置默认的
上传路径
$g_preview_attachments_inline_max_size=99999;#99999 数值是与字节计
算的，如果上传的任何小于这个字节大小的bmp, png, gif, jpg 格式的图片
文件直接显示。

DATABASE
路
径
上传文件存放路
径
config_defaults_inc 保存
位置
备份
D:\Program
Files\xampp\mysql\data\bugtracker\upload
1
D:\Program Files\xampp\mysql\data\upload
无备份bugtracker 可备
份上传的文件
D:\Program
Files\xampp\mysql\data\bugtracker\upload
2
空
无备份bugtracker 可备
份上传的文件
空3
D:\Program Files\xampp\mysql\data\upload
无备份bugtracker 可备
份上传的文件
空4
空
无备份bugtracker 可备
份上传的文件
Generated by Foxit PDF Creator . Foxit Software For evaluation only. DISK
路
径
上传文件存
放路径
config_defaults_inc 保存位置备份
D:\Program
Files\xampp\mysql\data\bugtracker\upload
Ok 1
D:\Program
Files\xampp\mysql\data\upload
备份
bugtracker
并修改该
项目的“上
传文件路
径”，备份
upload 没
成功
D:\Program
Files\xampp\mysql\data\bugtracker\upload
Ok 2
空
估计不行，
没试
空3
D:\Program
Files\xampp\mysql\data\upload
D:\Program
Files\xampp\mysql\data
下。

我很费解
估计不行，
没试
空4
空
无效的上传路径；目录不
存在或Web 服务器不
能写入该目录
这肯定不
行，虽然没
试
八、安装及配置JpGraph
下载JpGraph 后，解压到c:\mantis\core\目录下，名称为jpgraph.
打开core\graph_api.php 文件，找到function graph_get_font()，在里面加一句'simsun' => FF_SIMSUN,
在config_inc.php 或config_defaults_inc.php 中应该有以下配置内容:
############################
# Mantis JPGRAPH Addon
############################
# --- jpgraph settings --- #
# Initial Version from Duncan Lisset
#
# To use the Jpgraph addon you need the JPGRAPH package from
# http://www.aditus.nu/jpgraph/index.php
# You can place the package whereever you want, but you have
# to set the var in jpgraph.php eg.
# (DEFINE('DIR_BASE','/www/mantisbt/jpgraph/');)
$g_use_jpgraph = ON;
$g_jpgraph_path = 'C:/mantis/core/jpgraph/src/' ;#注意src 后面加/，该目
录就是你放jpgraph 的目
录。

Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
#注意:这里需要指定src\jpgraph.php 的路径.页面出错时会有提示的.
# what truetype font will the graphs use. Allowed values are 'arial', 'verdana',
'courier', 'book', 'comic', 'times',
# 'georgia', 'trebuche', 'vera', 'veramono', or 'veraserif'. Refer to the jpgraph
manual for details.
# NOTE: these fonts need to be installed in the TTF_DIR as specified to
jpgraph
$g_graph_font = 'simsun';
# what width is used to scale the graphs.
$g_graph_window_width = 800;
# bar graph aspect ration (height / width)
$g_graph_bar_aspect = 0.9;
# how many graphs to put in each row in the advanced summary page
$g_graph_summary_graphs_per_row = 2;
$g_system_font_folder = 'c:/winnt/fonts/';
$g_font_per_captcha = 'simsun.ttf';
配置完成后，如果配置成功则出现下面页面，点击“统计报表”；
九、Mantis 时间设置
在config_inc.php 或config_defaults_inc.php 中添加以下内容:
#时区设置
putenv("TZ=Asia/Shanghai");
Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
Mantis 使用教程
获取用户名
在网页浏览器地址栏里输入/login_page.php 进入Mantis 的登录界面,如下图:
Mantis 的默认管理员的用户名为administrator 密码为root。

但在这里我们不使用
默认用户名，并且一般用户不具备管理员权限的。

注册用户名
点击Mantis 的登录页面“注册一个新帐号”，转到以下界面：
Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
在此页面输入自定义的帐号和有效的E-MAIL，点击注册。

如果成功注册将会出现
以下页面：
Mantis 将会随机生成一个用户密码以E-MAIL 的形式发到你刚才填写的E-MAIL 地
址，所以填写的E-MAIL 地址一定要真实有效，否则你将不能收到你的登录密码。

修改注册的密码
注册成功后，查看你所填写的E-MAIL 邮箱是否已经收到由Mantis 发出的用户注册
确认信，如下图：
点击信入面的超级链接进入Mantis 新注册用户的密码修改页面，如下图：Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
在此页面输你所希望的密码，然后点击页面下方的“更新帐号信息”按钮，完成密
码修改。

如果想修改其它个人信息，只需点击[更改个人设置]就可以了。

注意：默认的新注册用户只有[报告人员]的存取权限，其它一些权限的设定需要管
理员另行配置。

使用Mantis
2.1 登录Mantis
在登录的页面，输入刚刚注册的用户名:：james 密码：123，进入Mantis 的主界面。

Generated by Foxit PDF Creator . Foxit Software
For evalua
tion only.
在主界面我们可以看到一条工具栏，这就是我们能够使用的所有功能了。

在工具栏的下
方我们看到有5 大栏，分别是：
1. 未指定的：是指问题已经报告，但还没有指定由那个项目组成员进行跟进的问题列
表。

2. 已解决的：指问题已经得到解决，问题的状态为[已经解决]。

3. 我正在监视的：指你正在监视那些问题，在问题报告中，你被选为监视人。

4. 由我报告的：在这里将会显示由你报告的问题列表。

5. 最近修改：这一栏显示那些问题报告最近被项目组成员修改了。

2.2 问题报告
点击[问题报告]进入以下页面，选择你报告的问题所属的项目，如下图：
从下拉框选择完成后，点击[选择项目]，进行问题报告主界面，如下图：Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
在上图中有些栏位是打了红星的，表示这些是必填内容。

填好问题报告后，点击[提交
报告]，就会将此问题提交到系统，系统将会通过E-MAIL 通知项目组的相关人员。

在问题报告的右上角有一个[高级报告]的选项，点击后，将会出现以下页面。

点击[高级报告]后，会发现比原来多出来的好几个选项，这些都是有利于模拟问题重
现的。

2.3 问题查询
查找问题，只需点击工具栏上[查看问题]，出现以下的界面：
Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
在工具栏的下方，有一个蓝灰相隔的表格，这些表格的内容正是查找的条件选项，点击其中一选项，就会出现一个下拉框代替任意两个字，让你输入你查找的内容。

输入完成
后，点击筛选按钮就会结果返回到下方的表格，即是：
上图就是是返回的查找结果，点击相应的记录就可以进行修改。

2.4 问题修改
在查找结果的列表上点击编号内容,则会进入问题修改的页面,如下图:
图2.4.1
Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
图2.4.2
图2.4.3
在图2.4.1 里一共有6 个按钮，具体功能如下：
. 修改问题：进入问题明细页面进行修改。

. 分派给：是指将这个问题分派给那个人员处理，一般只能选择开发员权限的人员。

. 将状态改为：更改问题的状态，将需要输入更改状态的理由。

. 监视问题：点击后，所有和这个问题相关的改动都会通过E-MAIL 发到监视用户的
邮箱。

. 创建子项问题：建立一个问题的子项，而这个子项报告的问题是依懒于这个问题
而存在的。

. 移动问题：将这个问题转移到其它项目中。

图2.4.2 与图2.4.3 功能界面比较直观，不在这描述了。

Generated by Foxit PDF Creator .
Foxit Software
For evaluation only.
报表统计
点击工具栏上的[报表统计]，以表格的形式对问题进行统计，有“按问题状态”、“按
严重性”、“按项目”等，如下图
图3.1
Mantis 的管理
最重要的一章，在这一章将会介绍Mantis 如何管理用户、如何管理项目、如何添
加自定义字段等一系列功能。

4.1 用户管理
点击工具栏的管理，进入默认的界面就是[用户管理]。

在这个界面下，我们能看到
一些帐户的信息，如：一周内注册的用户、从未登录的用户等等。

界面如下：Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
图4.1.1
我们在这个界面下可以做的事分别是：
1. 删除帐号：对于一些从未使用的帐号进行删除，可以点击图4.1.1[清理帐号]按钮进行删
除，可以在点击帐号列表的帐号，进入帐号明细进行删除。

如下图：
图4.1.1 a
2. 权限设置：为帐号选择一个合适的存取权限的角色。

如：报告人员、开发人员、管理员
等。

3. 重设密码：点击重设密码，密码将会以E-MAIL 的形式发到用户的登记的电子邮箱。

4. 添加用户到项目：只有进行这一操作用户才有权限对特定项目进行操作的。

界面如下图
图4.1.1b
5. 缺省帐号设置：在这里设定E-MAIL 缺省的提醒情况还有报告时缺省类型（高级报告还是
简单报告），最重要的一点是，“界面语言”一定要设为：“Chinese_simplified”否则
用户登录时将会显示一个英文界面。

Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
4.2 项目管理
在这一栏，我们可以添加一个新项目到Mantis，方便我们用Mantis 管理多个项目的问
题。

1. 创建项目，点击[创建新项目]，如下图：
图4.2 .1 a
2. 按要求输入项目内容，完成后点击[添加项目]。

如下图：
图4.2.2 a
3. 项目配置是在创建项目完成后进行的。

在项目管理列表，点击项目名称，进入项目配
置界面，如下图：
图4.2.3 a
Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
图4.2.3 b
图4.2.3 c
Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
在上图中共分了五大块功能：
A. 子项目：在这里新建一个子项目并设定关联。

B. 分类：设定该项目的模块分类。

C. 版本：设定该项目的版本号。

D. 自定义字段：管理另一栏[自定义字段管理]添加了自定义字段，必须在这里设定为该
项目的，否则页面将不会显示。

E. 添加用户至项目：设定那些用户有权访问该项目的内容。

4.3 自定义字段管理
通过该功能，我们不单止能使
用Mantis 预定好的字段，还可以添加自定义的字段，使项目、问题报告更详尽、更适宜。

1. 新建：输入自定义字段的名称，然后点击[新建自定义字段]。

如下图：
2. 名称添加完成后，系统会提示“操作成功”，点击继续，进入如下界面进行修改。

Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
图4.3.2 a
3. 在图
4.3.2a 可以设定字段的类型、默认值、预设值、长度、修改权限等。

不过需要
注意一点，如果你要添加的下拉框（即枚举类型）选项内容要以“|”隔开，否则所
有选项都会连在一起，并且只有一项选择。

4.4 管理全局配置
[管理全局配置]就是让我们能够在这里设定测试环境，方便我们在问题报告时，
以选
择择的方式调出，输入的内容很简单，根据提示输入就可以了。

如下图：Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
4.5 管理配置
[管理配置]分成四大块：权限报表、工作流开始、工作流、邮件提醒。

现在逐一说
明。

权限报表
[权限报表]列出Mantis 六大角色所具有的权限，只是一个查询功能。

如下图：工作流开始
这一功能实现上就是权限的设定。

如下图：
Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
工作流
[工作流]就是指定问题的状态存取权限以及状态的下一状态。

见下图：
E-MAIL 提醒
该功能就是指当问题发生何种变化，以E-MAIL 通知那些人。

见下图：Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
Mantis 的FAQ
Q：APACHE 如何使用PHP？
A：在APAPCHE 的httpd.conf 增加以下代码，就可以以APACHE 支持PHP 了。

LoadFile "d:/php4/php4ts.dll"
# AddModule mod_php5.c
LoadModule php4_module "d:/php4/sapi/php4apache2.dll" ScriptAlias /php4/ "d:/PHP4/"
AddType application/x-httpd-php .php3
AddType application/x-httpd-php .php
AddType application/x-httpd-php .phtml
action application/x-httpd-php.php "d:/php4/php.exe"
#PHP.ini path
PHPIniDir "d:/php4"
Q：为什么我成功配置好Mantis,然后构造数据库时报PHP 不支持MYSQL 操作？A：如果你的PHP 版本为5.0 一般都会报这个错。

建议安装PHP4
Q：Mantis 如何使用简体中文版？
A：在config_inc.ini 里加上这一行“$g_default_language= 'chinese_simplified';“就可
以了。

Q：Mantis 如何发送E-MAIL？
A：同样在config_inc.ini 加入以下代码：
$g_smtp_host = '172.16.24.39'; //邮件服务器名
$g_smtp_username = 'kk'; //用户名（不需验证时为空）
$g_smtp_password = '123'; //密码（不需验证时为空）
$g_enable_email_notification= ON;
$g_use_phpMailer = on;
$g_phpMailer_path = 'D:\p
hp4\includes'; //phpMailer 路径
$g_return_path_email= 'kk@';
$g_phpMailer_method = 2; //0 表示用MAIL 发送，1 表示用SENDMAIL，2 表示用SMTP
Generated by Foxit PDF Creator . Foxit Software
For evaluation only.
发送。

曾经看到过很多人都已经合法配置好但都不能发E-MAIL 到外网，我也试过这样的
问题，后来发现装防火墙局域网是拦截了MANTIS 利用SOCKET 访问外网的。

具体
表现在调用fstockopen()是报错。

SYSTEM ERROR：UNABLE CONNECT TO 。

后来我
自己在局域网组建了一个邮件服务器就可以了。

Q：如何查出Mantis 在MYSQL 上建了些什么表？
A：打开db_table_names_inc.php 就可以看到了。

Q：如何修改Mantis 预设的选项？
A：打开文件strings_Chinese_simplified.txt，就可以看到中文版里所有内容。

通过查
找就可以方便修改你想替换的预设值。

Q：在Mantis 自定义字段时选择的枚举型，如何添加选项内容？
A：在预设值输入你的选项并用“|”隔开，就会在下拉框出现多个选项了。

Generated by Foxit PDF Creator . Foxit Software
For evaluation only.。