1、Mantis 在Windows 平台上的安装方法目 录1 简要介绍.42 安装前的准备工作.42.1 安装IIS.42.2 安装MySQL.42.3 安装PHP .42.4 下载phpMyAdmin .52.5 下载Mantis.53 Mantis 的安装方法.53.1 配置phpMyAdmin .53.2 利用phpMyAdmin 创建Mantis 数据库.73.3 配置Mantis.83.4 修改Mantis 的配置文件.104 Mantis 使用方法简单介绍.101 简要介绍Mantis 使用的是MySQL 数据库，该软件是用php 编写的。因此，需要下载MySQL数据库和php 解释器
2、。作为开源软件，Mantis 的配置不是非常的方便，因此，需要下载开源软件phpMySQLAdmin 完成安装过程中，对数据库的操作。本安装手册使用的软件版本如下：Windows IIS 5.1MySql 4.0.18Php 4.3.8phpMyAdmin 2.6.0Mantis 0.18.32 安装前的准备工作2.1 安装IISMantis 是B/S 架构的软件缺陷管理系统，因此，在安装Mantis 之前，需要在服务器上预先安装IIS 系统。在“控制面板”的“添加/删除程序”中，选择“添加/删除Windows 组件”，安装IIS。2.2 安装MySQLMantis 使用的数据库是MySQL，
3、因此，在安装Mantis 之前，需要下载MySQL的安装程序。在浏览器中输入下面的网址就可以下载4.0.18 版本的MySQL。http:/ 之后，安装过程与一般的Windows 程序一样，只要采用默认的安装方式即可。2.3 安装PHPMantis 是用php 开发的， 因此， 需要从下面的地址下载php 软件。http:/ 软件，安装过程中均采用默认选项即可。2.4 下载phpMyAdmin从下面地址下载phpMyAdmin 软件，该软件使用来操作MySQL 数据库。http:/ 下载Mantis从下面的地址中下在Mantis，当前的稳定版本是0.18.3，下载之后，用winzip或者Win
4、RAR 解压该软件。http:/ Mantis 的安装方法3.1 配置phpMyAdmin第一步：创建phpMyAdmin 的虚拟目录，如下图所示。图1 创建虚拟目录第二步：命名web 虚拟目录访问的别名，该虚拟目录建设完毕后，需要通过该别名访问phpMyAdmin。图2 创建phpmyadmin 的虚拟目录第三步：选择phpMyAdmin 在硬盘上的实际路径，在本次安装过程中，路径为E:softtoolmantisphpMyAdmin-2.6.0-rc1phpMyAdmin-2.6.0-rc1图3 选在phpMyAdmin 所在的硬盘上的路径第四步：设置phpMyAdmin 执行权限，如下图
5、所示，把执行权限设置为“脚本和可执行文件”图4 修改执行权限3.2 利用phpMyAdmin 创建Mantis 数据库第一步：运行C:mysqlbin winmysqladmin.exe。启动MySql 数据库。第二步：在浏览其中输入http:/localhost/phpmyadmin/index.php，然后弹出下面的界面，再下图所示的红色矩形框中输入需要创建的数据库名“bugtrack”，然后，鼠标左键单击“创建”按钮，然后“bugtrack”数据库创建完毕。图5 创建bugtrack 数据库第三步：通过phpMyAdmin 执行Mantis 的数据库建库脚本，创建Mantis 的数据库表
6、。如下图所示，选中红色矩形1 所示的“SQL”页面。然后，在红色矩形2中选择浏览按钮选中Mantis 自带的数据库建表脚本。本次安装过程中，建库脚本的位置是E:softtoolmantismantisbt-0.18.3mantisbt-0.18.3sqldb_generate.sql。选择建库脚本后，点击“执行”按钮，自动生成所有的数据表。图6 执行Mantis 创建数据库的sql 脚本3.3 配置Mantis第一步：参照图1，建立Mantis 的虚拟目录，web 虚拟目录的访问别名如下图所示。图7 创建Mantis 的虚拟目录第二步：选择Mantis 在硬盘上的实际路径，在本次安装过程中，路
7、径如下图所示。图8 选择Manits 在服务器硬盘的的路径第三步：设置Mantis 执行权限，如下图所示，把执行权限设置为“脚本和可执行文件图9 修改执行权限3.4 修改Mantis 的配置文件在Mantis 的目录中， 找到文件config_inc.php.sample ， 把该文件名改为config_inc.php。然后，修改该文件中的内容，主要修改下面三条红色的记录，分别是MySql 的用户名、密码、数据库名。保证用户名和密码与MySql 的root 用户一致。数据库名与您使用phpMyAdmin 创建的数据名相同。# set these values to match your set
8、up$g_hostname = localhost;$g_port = 3306; # 3306 is default$g_db_username = root;$g_db_password = ;$g_database_name = bugtrack;更详细的配置见下面1)将Mantis中的config_inc.php.sample复制一份，改名为config_inc.php，修改其中的设置； Mantis的设置是这样保存的：在config_defaults_inc.php中保存这Mantis的默认设置，用户自己的设置信息保存在config_inc.php中，如果某个选项在config_in
9、c.php中有设置，则系统使用config_inc.php中的设置，否则使用config_defaults_inc.php的系统默认设置；config_inc.php.sample则是Mantis给出的一个用户设置文件例子。 所以我们需要修改config_inc.php文件中的设置，设置很简单，各个参数的意义可以参见config_defaults_inc.php，这里对每个参数都有详细的解释，虽然是E文，不过应该都能看懂；Sample中给出的一些设置是一定需要修改的，比如MySQL数据库的连接参数，管理员的邮箱的；其他的要根据你的实际情况进行修改。 下面是我的一些自定义参数，其中一些参数（$g
10、_use_jpgraph 和$g_use_phpMailer的设置请参照下面的内容）： $g_use_iis = ON; # 使用IIS $g_show_version = OFF; # 不在页面下部显示 Mantis的版本号 $g_default_language = chinese_simplified; # 默认语言为简体中文 $g_show_project_menu_bar = ON; # 显示项目选择栏 $g_show_queries_count = OFF; # 在页脚不显示执行的查询次数 $g_default_new_account_access_level = DEVELOPE
11、R; # 默认用户级别 $g_use_jpgraph = ON; # 使用图形报表 $g_jpgraph_path = C:/PHP/includes/JPGraph/src/; # JPGraph路径 $g_window_title = Mantis Bug 跟踪管理系统; # 浏览器标题 $g_page_title = Mantis Bug 跟踪管理系统; # 页面标题栏 $g_enable_email_notification = ON; # 开通邮件通知 $g_smtp_host = ; # SMTP 服务器 $g_smtp_username = mailuser; # 邮箱登录用户名
12、 $g_smtp_password = mailpwd; # 邮箱登录密码 $g_use_phpMailer = ON; # 使用 PHPMailer 发送邮件 $g_phpMailer_path = C:/PHP/includes/PHPMailer/; # PHPMailer 的存放路径 $g_phpMailer_method = 2; # PHPMailer 以 SMTP 方式发送 Email $g_file_upload_ftp_server = ; # 上传文件 FTP $g_file_upload_ftp_user = ftpuser; # FTP 登录用户名 $g_file_up
13、load_ftp_pass = ftppwd; # FTP 登录密码 $g_short_date_format = Y-m-d; # 短日期格式，Y 大写表示 4 位年 $g_normal_date_format = Y-m-d H:i; # 普通日期格式 $g_complete_date_format = Y-m-d H:i:s; # 完整日期格式 完成以上设置以后，你就可以使用Mantis了，打开IE，输入http:/localhost/mantis，应该就可以看到Mantis的登录页面了，你可以用默认用户名administrator和密码root登录进去，进行管理设置。 2.Mantis
14、的初步安全设置 1)在Mantis目录下有一个admin目录，如果你在IE中打开这个目录下的index.php查看，你就会知道这个目录是进行Mantis Administration的，使用这个模块可以检查你的Mantis是否安装完全，对旧版本的Mantis进行升级，对Mantis的页面CSS文件进行修改；使用这个管理模块是不需要用户名和密码的，因此任何人都可以通过这个管理模块查看你的Mantis系统信息，而且由于有升级模块，在这里还可以直接对数据库进行修改；因此如果被未授权的人打开，结果会是什么样不用我多说；最好因此按照系统的建议，在配置完成后将这个admin目录删除；注意一定是删除而不是改
15、名！改名后仍然是可以访问的！ 2)在添加一个管理员用户后，删除系统默认的administrator用户。 3.PHPMail的设置 默认情况下，Mantis使用内置的Mailto()函数进行邮件的发送，包括新用户注册发送密码、Bug改变提醒、重设密码等邮件的发送都使用MailTo()来完成，不过实际使用中发现，MailTo函数好像不支持需要校验的邮件服务器，比如我的263邮箱每次都提示需要校验，所以我给PHP安装了PHPMail模块，设置Mantis使用PHPMailer发送邮件。 1)下载PHPMailer：从http:/下载，最新版本是1.71; 2)安装PHPMailer：将下载下来的p
16、hpmailer-1.71.zip解压缩到C:PHPincludes PHPMailer目录下； 3)修改Windows目录下的PHP.ini，找到include_path，增加C:PHPincludes PHPMailer目录； 4)如上表所示，设置$g_use_phpMailer、$g_phpMailer_path和$g_phpMailer_method三个参数； 5)现在应该就可以使用PHPMailer进行邮件发送了； 4.图形报表的设置 默认情况下，Mantis的图形报表是关闭的，需要安装JPGraph模块并设置$g_use_jpgraph为ON才能打开图形报表； 1)下载JPGrap
17、h：从http:/www.aditus.nu/jpgraph/index.php下载JPGraph的安装文件，目前最高版本是1.14； 2)将下载下来的jpgraph-1.14.tar.gz解压缩到C:PHPincludes目录下； 3)打开config_inc.php文件，修改$g_jpgraph_path为JPGraph的src目录，$g_use_jpgraph为ON； 4)修改Windows目录下的PHP.ini文件，将“;extension=php_gd2.dll”和“;extension=php_iconv.dll”两行前面的分号删除；另外如果extension_dir项不正确，请把
18、extension_dir改为正确的值（应该是extension_dir = ./extensions/，我这里不知道为什么是extension_dir = ./，大概就是因为使用懒人安装方法的缘故吧）； 5)将C:PHPdlls下面的iconv.dll复制到WindowsSystem32目录下，以上两个步骤使PHP自动载入php_gd2和php_iconv.dll模块，这两个模块是JPGraph在显示图表和进行汉字编码转换是所必须的； 6)修改JPGraph的src目录下的jpgraph.php；将CACHE_DIR和TTF_DIR分别定义为Windows下的Temp目录和Fonts目录，如
19、下所示 DEFINE(CACHE_DIR,E:/WinTemp/Temp/jpgraph_cache); DEFINE(TTF_DIR,C:/WinNT/Fonts/); 7)现在再打开Mantis的统计页面，可以看到多了分别按状态等进行统计的图形报表，包括柱图、饼图和线图； 8)不过如果你的界面语言是用简体中文或者繁体中文，那么你会看到图形中的汉字都是乱码，这是因为Mantis对于JPGraph的编码设置不正确造成的，JPGraph会自动将汉字转换为UTF-8编码，但是需要在调用JPGraph的时候对标题等SetFont，Mantis没有做这个操作，因此汉字显示出来都是乱码，解决方法是在Ma
20、ntiscoregraph_api.php中增加对图形标题等设置字体的代码； 对于柱图和线图，要设置图形标题和x、y轴标题、节点标题： /Set the title and axis font if the default_language is set to chinese if (config_get(default_language)=chinese_simplified) $graph-title-SetFont(FF_SIMSUN,FS_NORMAL); $graph-xaxis-title-SetFont(FF_SIMSUN,FS_NORMAL); $graph-yaxis-tit
21、le-SetFont(FF_SIMSUN,FS_NORMAL); $graph-xaxis-SetFont(FF_SIMSUN,FS_NORMAL); $graph-yaxis-SetFont(FF_SIMSUN,FS_NORMAL); else if (config_get(default_language)=chinese_traditional) $graph-title-SetFont(FF_CHINESE,FS_NORMAL); $graph-yaxis-title-SetFont(FF_CHINESE,FS_NORMAL); $graph-xaxis-title-SetFont(F
22、F_CHINESE,FS_NORMAL); $graph-xaxis-SetFont(FF_CHINESE,FS_NORMAL); $graph-yaxis-SetFont(FF_CHINESE,FS_NORMAL); ; 对于饼图，要设置图形标题和图例名称： /Set the title and legend font if the default_language is set to chinese if (config_get(default_language) = chinese_simplified) $graph-title-SetFont(FF_SIMSUN,FS_NORMAL)
23、; $graph-legend-SetFont(FF_SIMSUN,FS_NORMAL); else if (config_get(default_language) = chinese_traditional) $graph-title-SetFont(FF_CHINESE,FS_NORMAL); $graph-legend-SetFont(FF_CHINESE,FS_NORMAL); ; 大家可以找到位置自己修改，简单的说就是在graph_api.php中每个“$graph-title-Set(”后面根据当前的图表是柱图、线图还是饼图分别加上上面两段； 9)现在你的图形报表应该就可以显示中
24、文了。 4 Mantis 使用方法简单介绍第一步：管理员登录。在浏览器的地址栏中输入http:/localhost/mantis/index.php弹出下图所示的登录界面。首次登录的用户名是：administrator，密码是：root图10 Mantis 登录界面第二步：管理员创建用户。选择菜单“Manage”，弹出下面界面，然后，点击“Create New Accounter”创建新的用户。图11 创建新用户步骤一第三步： 如下图所示，填写必要的信息创建新的用户wangwei图12 创建新用户步骤二第四步： 定制用户界面的语言。使用新用户wangwei 的用户名登录Mantis，如下图所示，选择菜单“My Account”，然后，选择“Preference”，然后，在“Language”下拉列表中选择“Chinese_simplified”。然后，以后用户wangwei 的界面转为中文版。图12 定制用户界面的语言第五步：由于本文是Mantis 的安装说明书，因此，关于Mantis 的使用说明，不在本文描述之列。从总体上看，Mantis 软件简单易用，相信各位朋友通过短时间的摸索可以掌握使用方法。这里不做赘述。_
