Windows与Linux下MantisBT的安装与配置相关手册.doc

大名鼎鼎的Mantis是一个Bug跟踪系统，使用PHP编写，简单，易用，功能丰富，一直享有盛誉，还有很重要的一点，它是免费的，中小型企业使用它来跟踪缺陷和问题是再合适不过了。今天安装并配置了一下，在这里记录下来：1.安装：安装Mantis（现在叫MantisBT）之前，应先准备好Apache，MySQL和PHP的安装，这些在我以前的日志里已经有说明，在这里就不重复了，参见WAMP（Windows Apache MySQL PHP）+phpMyAdmin安装配置。到Mantis官网上下载最新的稳定版本：/download.php选择Stable release版本，如mantisbt-1.1.6.zip。解压到Apache的资源目录下，在浏览器中输入mantis访问地址，如http:/localhost/mantis，将进入数据库安装界面，设置相关数据库信息，填写要创建的数据库名字（默认为bugtracer，可修改为其他）、数据库使用用户和密码（我使用了root用户，当然也可以先创建其他用户然后在这里使用），点击安装数据库。安装完成后，再次打开http:/localhost/mantis，用administrator root进行登录，验证安装。2.配置：2.1图形报表模块支持2.1.1编辑php的配置文件php.ini，找到;extension=php_gd2.dll，将前面的“;”去掉，市php能够提供图形支持。2.1.2到http:/www.aditus.nu/jpgraph/jpdownload.php下载最新的JPGRAPH包，根据自己安装的PHP版本来选择，如jpgraph-2.3.4.tar.gz，解压到mantis根目录下，重命名为jpgraph。打开mantis安装目录下新生成的config_inc.php文件，添加：$g_use_jpgraph = ON;$g_jpgraph_path = . . DIRECTORY_SEPARATOR . jpgraph . DIRECTORY_SEPARATOR.src.DIRECTORY_SEPARATOR; 2.1.3如果此时打开图标查看，可能会发现图表标题是乱码，这是字体设置问题。打开mantis根目录下core文件夹下graph_api.php，找到function graph_get_font()在$t_font_map = array(后添加一行：chinese_gbk = FF_SIMSUN,其中chinese_gbk 是个别名，你也可以叫其他的；然后再打开mantis安装目录下的config_inc.php文件，添加一行：$g_graph_font = chinese_gbk;如果你的mantis采用的是gb2312编码，那么到此为止已经配置好了，如果是utf8编码的话，还需要找到jpgraph目录下src/jpgraph_ttf.inc.php，在文件中找到elseif( $aFF = FF_SIMSUN ) / Do Chinese conversion if( $this-g2312 = null ) include_once jpgraph_gb2312.php ; $this-g2312 = new GB2312toUTF8(); return $this-g2312-gb2utf8($aTxt);修改为：elseif( $aFF = FF_SIMSUN ) / Do Chinese conversion /* if( $this-g2312 = null ) include_once jpgraph_gb2312.php ; $this-g2312 = new GB2312toUTF8(); return $this-g2312-gb2utf8($aTxt); */ return $aTxt;或者直接将整段注释掉，也可以直接删掉。再打开查看图表，应该没问题了。2.2其他配置打开mantis安装目录下的config_inc.php，添加：#登录界面默认语言$g_default_language = chinese_simplified;#邮件服务器配置$g_smtp_host=;$g_smtp_username=username;$g_smtp_password=password;$g_phpMailer_method =2;#关闭在左下角显示mantis版本号$g_show_version=OFF;#关闭在左下角显示查询结果数$g_show_queries_count = OFF;#网络管理员邮箱设置$g_webmaster_email = AAA;#设置时区（北京）date_default_timezone_set(PRC);#设置文件上传类型（硬盘存储）和路径$g_file_upload_method = DISK;$g_absolute_path_default_upload_folder = D:/Root/mantis/upload/;#关闭注册$g_allow_signup = OFF;#设置附件最大体积$g_preview_attachments_inline_max_size = 5000000;#设置图片查看方式（直接打开）$g_view_summary_threshold = VIEWER;这些可以根据自己实际需要来选择是否配置和修改，其他配置可以参见mantis安装目录下config_defaults_inc.php，将其中的项拷贝出来放到config_inc.php，然后修改即可。基于Windows和Linux安装mantis基于Windows下开源缺陷跟踪系统Mantis安装1. 简介mantis(螳螂)是一个基于php/MySQL/web的缺陷跟踪系统，最新版本是1.0.1。要了解更多信息请到/。2. 下载mantis-1.0.1/download.phpmysql-5.0.20-win32.zip/downloads/mysql/5.0.htmlphp-5.1.2-Win32.zip/downloads.phpapache_2.0.55-win32-x86-no_ssl.msi/download.cgi3. 安装步骤下面是我安装时设置的目录 c:qa c:qamantis c:qamysql c:qaphp c:qaapache 首先安装的是 apache_2.0.55 Apache是著名的服务器，开始安装的时候总是遇到系统找不到指定的文件，没有安装名为apache2的服务器。在网上查找找到 如果系统安有IIS服务，再安装Apache，就会出现上面错误。 解决的方法是 把IIS服务停掉，并在“添加删除windows组件”中去除IIS组件。 根据这样的提示操作之后，我再次安装了Apache，前面几项只需点“NEXT”就行了，到了要求填写network domain、server domain、和email的时候 如果没有域名，就随便写点，也没有什么影响。 接下来 配置Apache 在 c:qaapacheconf目录下，打开httpd.conf进行配置apache.查找DirectoryIndex,这是设定主页的首页的文件名，为了支持PHP,我是这样更改： 更改前为：DirectoryIndex index.html index.html.var， 更改后为：DirectoryIndex index.html index.html.var index.php,也就是在其后面添加index.php。 查找DocumentRoot,这是指定主页放置的目录，默认为C:/qa/apache/apache2/htdocs,可以使用默认的，也可以自己指定，比如D:/test 安装 php 将php-5.1.2-Win32.zip解压缩到c:qaphp下，把 fdftk.dll fribidi.dll gds32.dll libeay32.dll libmhash.dll libmysql.dll ntwdblib.dll php5isapi.dll php5nsapi.dll php5ts.dll ssleay32.dll yaz.dll 这些文件copy到C:windowssystem32下，同时复制 c:qaphp 目录下的 php.ini-dist 文件到 C:windows 目录下，并改名为 php.ini。 配置php.ini 找到下面两行; Directory in which the loadable extensions (modules) reside. extension_dir = ./ 将extension_dir 的路径修改为你自己安装的路径， 我的是; Directory in which the loadable extensions (modules) reside. extension_dir = C:qaphpext, 寻找;default_charset,为了让其支持中文,可以修改默认的字符集,可使用UTF-8或者GB2312或者GBK,都行,它默认的是;default_charset=iso-8859-1,修改就行了. 修改httpd.conf 添加下面代码。LoadModule php5_module C:/qa/php/php5apache2.dll AddType application/x-httpd-php . 到文件的尾部。 php LoadModule是加载PHP模块，路径一定要准确。 AddType 是让apache支持PHP类型。 保存httpd.conf。 测试apache安装结果 修改好配置文件后，重启apache 随便编写一个PHP文件放到D:/test下，比如:写上下面几行 并保存为1.php,打开浏览器，输入:http:/localhost/1.php,就会出现hello world，现在Apache+PHP配置已经完全成功了， 值得注意的一点就是每次修改httpd.conf后，都得重启一次apache才能生效。 安装Mysql Mysql 的安装比较简单，就不一一说明了，因为我想让数据库支持中文 就在安装的时候 把编码该成GBK。 启动 Mysql的服务。 部署mantis 将mantis-1.0.1解压缩到php的发布目录中 c:qamantis，由于1.0.1中取消了原来sqldb_generate.sql 的数据库脚本而采用了通过系统来建立环境。 通过浏览器访问http:/localhost/mantis/admin/install.php可看到部署mantis数据库环境的界面。 默认的数据库是bugtracker，注意要使用有管理员权限的用户来建立数据库（建立好bugtracker数据库），我用了root 。 设定好了install/upgrade database之后正常情况下在输出反馈页面下一片绿色的good,那就是ok了， 要是有红色的bad，那要调整好了再初始化到ok才行，这时候mysql新增的bugtracker库里建立起很多以mantis_开头的表，到此数据库初始化结束。 设置Mantis将c:qamantis中的config_inc.php.sample复制一份，改名为config_inc.php，修改其中的设置；在config_defaults_inc.php中保存这Mantis的默认设置：用户自己的设置信息保存在config_inc.php中，如果某个选项在config_inc.php中有设置，则系统使用config_inc.php中的设置，否则使用config_defaults_inc.php的系统默认设置；config_inc.php.sample则是Mantis给出的一个用户设置文件例子。根据情况修改config_inc.php文件中的设置，设置很简单，各个参数的在config_defaults_inc.php都有很详细的说明。下面是我的一些自定义参数，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 = DEVELOPER; # 默认用户级别$g_window_title = Mantis Bug 跟踪管理系统; # 浏览器标题$g_page_title = Rink的BUGs跟踪管理系统; # 页面标题栏$g_enable_email_notification = ON; # 开通邮件通知$g_smtp_host = smtp.*.com; # SMTP 服务器$g_smtp_username = *; # 邮箱登录用户名$g_smtp_password = *; # 邮箱登录密码$g_use_phpMailer = ON; # 使用 PHPMailer 发送邮件$g_phpMailer_path = c:/qa/mantis/core/phpmailer/; # PHPMailer 的存放路径$g_phpMailer_method = 2; # PHPMailer 以 SMTP 方式发送 Email$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了，打开浏览器，输入http:/localhost/mantis应该就可以看到Mantis的登录页面了，你可以用默认用户名administrator和密码root登录进去，进行管理设置。Mantis的初步安全设置删除admin目录在Mantis目录下有一个admin目录，这是Mantis管理员进行管理Mantis的，比如之前我们构建数据库环境的install.php等。使用这个模块可以检查你的Mantis是否安装完全，对旧版本的Mantis进行升级，对Mantis的页面CSS文件进行修改；使用这个管理模块是不需要用户名和密码的，因此任何人都可以通过这个管理模块查看你的Mantis系统信息，而且由于有升级模块，在这里还可以直接对数据库进行修改。因此Mantis会建议在配置完成后将这个admin目录删除；注意一定是删除而不是改名！改名后仍然是可以访问的！删除administrator在添加一个具备管理员权限的用户后，删除系统默认的administrator用户。PHPMail的设置默认情况下，Mantis使用内置的Mailto()函数进行邮件的发送，包括新用户注册发送密码、Bug改变提醒、重设密码等邮件的发送都使用MailTo()来完成，不过实际使用中发现，MailTo函数好像不支持需要校验的邮件服务器。其自身携带的PHPMailer配置起来也有问题,所以我直接将下载的PHPMailer覆盖Mantis里附带的Mailer(cqamantiscorephpmailer)。来发送邮件。关于更多PHPMailer请到。修改PHP.ini，找到include_path，增加c:qamantiscorephpmailer目录；如上表所示，设置$g_use_phpMailer、$g_phpMailer_path和$g_phpMailer_method三个参数；现在应该就可以使用PHPMailer进行邮件发送了；图形报表(jpgraph)的设置默认情况下，Mantis的图形报表是关闭的，因此在Mantis的报表中看不到“图形报表”的入口，需要安装JPGraph模块并设置$g_use_jpgraph为ON才能打开图形报表；下载JPGraph：从http:/www.aditus.nu/jpgraph/index.php下载JPGraph的安装文件，当前最新版本是jpgraph-2.1.1;将下载下来的jpgraph-2.1.1.tar.gz解压缩到c:qamantiscorejpgraph目录下；打开config_inc.php文件，修改$g_jpgraph_path为JPGraph的src目录，$g_use_jpgraph为ON；也就是 $g_use_jpgraph = ON; # 使用图形报表(jpgraph) $g_jpgraph_path = c:/qa/mantis/core/jpgraph/src/; # JPGraph路径 ,注意最后的/要加修改PHP.ini文件，激活“extension=php_gd2.dll”和“extension=php_iconv.dll”；另外如果extension_dir项不正确，请把extension_dir改为正确的值。将PHPdlls下面的iconv.dll复制到WindowsSystem32目录下，以上两个步骤使PHP自动载入php_gd2和php_iconv.dll模块，这两个模块是JPGraph在显示图表和进行汉字编码转换是所必须的；现在再打开Mantis的统计页面，可以看到多了图形报表，分别按状态等进行统计的图形报表，包括柱图、饼图和线图，但是图形中有很多乱码，那是因为Mantis中默认是通过UTF-8设置JPGraph，而我们界面语言是用简体中文，因此汉字显示出来都是乱码。解决方法很简单：在Mantisconfig_inc.php中将$g_graph_font = 改为$g_graph_font = simsum;由于Mantis中图形报表默认字体里不含有中文，因此我们要在Mantiscoregraph_api.php中相应增加对图形标题等设置字体代码；在function graph_get_font() .中font_map增加simsum = FF_SIMSUN ，以供Mantis调用。这样以来，在图形报表中就能看到简体中文了。补充一下linux下的安装过程1所需软件1.1MySQLMySQL-server-4.1.10-0.i386.rpmMySQL-client-4.1.10-0.i386.rpmMySQL-devel-4.1.10-0.i386.rpmMySQL-shared-4.1.10-0.i386.rpmMySQL-shared-compat-4.1.10-0.i386.rpm1.2Apachehttpd-2.0.54.tar.gz1.3PHPphp-5.0.4.tar.gz1.4mantismantis-1.1.1-bin1.5Jpgraphjpgraph-1.19.tar.gzjpegsrc.v6b.tar.gzzlib-1.1.3.tar.gzlibpng-1.2.8.tar.gzfreetype-2.1.10.tar.gzt1lib-5.1.0.tar.gz1.6Graphvizgraphviz-2.4-1.rh73.i386.rpmgraphviz-devel-2.4-1.rh73.i386.rpmgraphviz-doc-2.4-1.rh73.i386.rpmgraphviz-graphs-2.4-1.rh73.i386.rpmgraphviz-tcl-2.4-1.rh73.i386.rpm1.7浏览支持ZendOptimizer-linuxi386.tar.gz1.8CVSWebCVSWeb3.0.0.tar.gz2安装步骤2.1安装Mysql安装mysql server# rpm -ivh MySQL-server-4.0.20-0.i386.rpm安装mysql# rpm -ivh MySQL-client-4.0.20-0.i386.rpm安装mysql其他包# rpm ivh MySQL-devel-4.1.10-0.i386.rpm# rpm ivh MySQL-shared-4.1.10-0.i386.rpm# rpm ivh MySQL-shared-compat-4.1.10-0.i386.rpm运行mysql 客户端,并开放root用户的远程访问权限。以便调试# mysql use mysql update user set host = % where user = root and host localhost; exitMysql安装完毕。2.2安装apache# tar -zxvf httpd-2.0.54.tar.gz# cd httpd-2.0.54# ./configure -prefix=/web/apache -enable-module=so# make# make installApache安装完毕。说明：apache在linux下的默认最大进程数为256，无论如何修改httpd.conf都不能超过这个限制。如果想加大这个限制，在编译apache前编辑/home/tmp/apache/src/include/httpd.h，将其中#define HARD_SERVER_LIMIT 256 一行改为#define HARD_SERVER_LIMIT 2048后再编译apache。2.3安装GD库2.3.1jpeg-6b 的安装# tar -xf jpegsrc.v6b.tar# cd jpeg-6b# ./configure# make# make install2.3.2zlib 的安装# tar zxvf zlib-1.1.3.tar.gz# cd zlib-1.1.3# ./configure# make# make install2.3.3libpng 的安装# tar zxvf libpng-1.2.8.tar.gz# cd libpng-1.2.8# ./configure# make# make install2.3.4freetype 的安装# tar zxvf freetype-2.1.10.tar.gz# cd freetype-2.1.10# ./configure# make# make install2.3.5T1lib 的安装# tar zxvf t1lib-5.1.0.tar.gz# cd t1lib-5.1.0# ./configure# make# make install2.3.6gd 的安装# tar zxvf gd-2.0.33.tar.gz# cd gd-2.0.33# ./configure# vi Makefile（编辑 Makefile文件改 CFLAGS=-O 为 CFLAGS=-O -DHAVE_XPM -DHAVE_JPEG -DHAVE_LIBTTF改 LIBS=-lm -lgd -lpng -lz 为 LIBS=-lm -lgd -lpng -lz -ljpeg -lttf -lXpm -lX11改 INCLUDEDIRS=-I. -I/usr/local/include -I/usr/include/X11 -I/usr/X11R6/include/X11为 INCLUDEDIRS=-I. -I/usr/local/include -I/usr/include/X11 -I/usr/X11R6/include/X11 -I/usr/local/include/freetype）# make# make install2.4安装php# tar zxvf php-5.0.4.tar.gz# cd php-5.0.4#./configure -prefix=/web/php -with-apxs2=/web/apache/bin/apxs -with-config-file-path=/usr/local/lib -enable-track-vars -with-xml -with-mysql -with-libxml-dir=/usr/local/lib -with-gd=/usr/local -with-t1lib=/usr/local -with-tiff-dir=/usr/local -with-jpeg-dir=/usr/include -with-ttf=/usr/include/freetype -with-zlib-dir=/usr/include -with-png-dir=/usr/include -with-mbstring -enable-mbstring=all# make# make install# cp php.ini-dist /usr/local/lib/php.ini修改php.ini中的下列行extension_dir = ./为extension_dir = /web/php/include/php/ext2.5GD库的安装检查安装完毕后用查看结果如下：gdGD Support enabledGD Version 1.6.2 or higherFreeType Support enabledFreeType Linkage with TTF libraryT1Lib Support enabledGIF Support enabledJPG Support enabledPNG Support enabledWBMP Support enabled2.6安装Mantis# mv mantis-1.1.1 /var/www/mantis2.7建立数据库bugtracker及用户mantis$mysqladmin -u root -p create bugtracker/输入MySQL的root密码即可完成创建数据库bugtracker的操作$mysql -u root -pmysqlgrant all privileges on bugtracker.* to mantislocalhost identified by 你指定的mantis用户密码;mysqlFLUSH PRIVILEGES;mysqlq2.8安装Zend Optimizer#tar -zxvf ZendOptimizer-linuxi386.tar.gz#cd ZendOptimizer-2.6.0-linux-glibc21-i386#./install.sh/重启Apache#/web/apache/bin/apachectl k restart2.9配置mantis# cd /var/www/mantis# vi config_inc.php/修改以下几行$g_db_username = mantis;$g_db_password = 你在建立用户时指定的密码;$g_database_name = bugtracker;/增加以下几行$g_path = /mantis/;$g_icon_path = $g_path.images/;$g_absolute_path = /var/www/mantis/;$g_use_iis = OFF;$g_show_version = ON;/以下是配置邮件的，Mantis使用邮件来进行注册和通知，所以必须配置好$g_enable_email_notification = ON; # 开通邮件通知$g_smtp_host = ; # SMTP 服务器$g_smtp_username = ; # 邮箱登录用户名$g_smtp_password = 对应用户邮箱的密码; # 邮箱登录密码$g_use_phpMailer = ON; # 使用 PHPMailer 发送邮件$g_phpMailer_path = /usr/local/php/includes/PHPMailer/; # PHPMailer 的存放路径$g_phpMailer_method = 2; # PHPMailer 以 SMTP$g_show_version = OFF; # 不在页面下部显示 Mantis的版本号$g_default_language = english; # 默认语言为英语$g_default_new_account_access_level = DEVELOPER; # 默认用户级别$g_use_jpgraph= ON; # 使用图形报表$g_jpgraph_path = /web/php/include/jpgraph/src/; # JPGraph路径$g_window_title = Software Quality Manager; # 浏览器标题$g_page_title = Software Quality Manager; # 页面标题栏2.10创建数据库的表结构#cd /var/www/mantis#mysql -u mantis -p bugtrackersql/db_generate.sql/输入数据库密码即可创建2.11配置httpd.conf编辑apache的httpd.conf#vi /web/apache/conf/httpd.conf/增加以下几行LoadModule php5_module modules/libphp5.soAddType application/x-httpd-php .php .phtml .php3 .incAlias /mantis/ /var/www/mantis/Options Indexes MultiViews Includes FollowSymLinks +ExecCGIAllowOverride NoneOrder allow, denyAllow from all找到DirectoryIndex index.html index.html.var，将其改为DirectoryIndex index.html index.html.var index.php2.12重启apache服务# /web/apache/bin/apachectl k restart2.13访问Mantis通过浏览器访问：/mantis/如果出现登录页面，则一切Ok！升级数据库登录/mantis/admin点击“Upgrade your installation”，升级其中的“Basic upgrade set (required)”和“String escaping fixes (recommended)”。然后，#mysql u mantis p bugtrackersql/db_update.sql并初始化数据库#mysql u mantis p bugtracker /path/to/cvsroot/dev, # /path/to/cvsroot/test, #=修改指向本地的CVSROOT);如果有多个cvsroot,这定缺省的cvsroot$cvstreedefault = test;其它个性化设置cvsweb.conf还有许多其它个性化设置，常见的有这些变量：$logo 图标设置$defaulttitle 标题设施$address 管理员email地址设置$long_intro 介绍文字$short_instruction 说明文字把文件cvsweb.cgi复制到apache的cgi目录cp cvsweb.cgi /path/to/apache/cgi-bin转到/path/to/apache/cgi-bin修改cvsweb.cgi修改cvsweb.cgi让CGI找到配置文件：$config = $ENVCVSWEB_CONFIG | /path/to/apache/conf/cvsweb.conf;中文支持让cvsweb正确显示中文，找到sub html_header($)函数，然后在和之间插入一行，修改如下$title复制所有的gif,png文件到apache的icons目录增加访问控制CVSWEB可不能随便开放给所有用户，因此需要使用WEB用户认证：先生成 passwd:/path/to/apache/bin/htpasswd -c cvsweb.passwd user修改httpd.conf，增加AuthName CVS AuthorizationAuthType BasicAuthUserFile /path/to/cvsweb.passwdrequire valid-user3.2配置config_inc.php设置mantis配置文件config_inc.php/添加下面一行$g_cvs_web = 7/cgi-bin/cvsweb.cgi/; #CVSWeb链接地址$g_source_control_accountcvsuser; #必须是mantis的有效帐户；3.3配置CVS配置文件loginfo在cvs仓库的配置文件loginfo中添加一行：DEFAULT /usr/local/bin/php /var/www/mantis/core/checkin.php %,sVv $USER这样，在提交cvs文件时，在log message中输入包含有“issue #nnnn”的内容，就会将提交的版本信息，添加在该issue的note中。4Relationship Graph功能配置4.1修改config_inc.php配置添加下面内容： # - Relationship Graphs - # Show issue relationships using graphs. # # In order to use this feature, you must first install either GraphViz # (all OSs except Windows) or WinGraphviz (only Windows). # # Graphviz homepage: /sw/tools/graphviz/ # WinGraphviz homepage: .tw/oodtsen/wingraphviz/ # # Refer to the notes near the top of core/graphviz_api.php and # core/relationship_graph_api.php for more information. # Enable relationship graphs support. $g_relationship_graph_enable = ON; # Font name and size, as required by Graphviz. If Graphviz fai