Mantis安装配置手册

作者：龚云卿 2006-4-28

1　所需软件

1.1　MySQL

MySQL-server-4.1.10-0.i386.rpm

MySQL-client-4.1.10-0.i386.rpm

MySQL-devel-4.1.10-0.i386.rpm

MySQL-shared-4.1.10-0.i386.rpm

MySQL-shared-compat-4.1.10-0.i386.rpm

1.2　Apache

httpd-2.0.54.tar.gz

1.3　PHP

php-5.0.4.tar.gz

1.4　mantis

mantis-1.1.1-bin

1.5　Jpgraph

jpgraph-1.19.tar.gz

jpegsrc.v6b.tar.gz

zlib-1.1.3.tar.gz

libpng-1.2.8.tar.gz

freetype-2.1.10.tar.gz

t1lib-5.1.0.tar.gz

1.6　Graphviz

graphviz-2.4-1.rh73.i386.rpm

graphviz-devel-2.4-1.rh73.i386.rpm

graphviz-doc-2.4-1.rh73.i386.rpm

graphviz-graphs-2.4-1.rh73.i386.rpm

graphviz-tcl-2.4-1.rh73.i386.rpm

 

1.7　浏览支持

ZendOptimizer-linuxi386.tar.gz

 

1.8　CVSWeb

CVSWeb3.0.0.tar.gz

2　安装步骤

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`;

> exit

 

Mysql安装完毕。

 

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 install

Apache安装完毕。

 

说明： 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.1　jpeg-6b 的安装

# tar -xf jpegsrc.v6b.tar

# cd jpeg-6b

# ./configure

# make

# make install

 

2.3.2　zlib 的安装

# tar –zxvf zlib-1.1.3.tar.gz

# cd zlib-1.1.3

# ./configure

# make

# make install

 

2.3.3　libpng 的安装

# tar –zxvf libpng-1.2.8.tar.gz

# cd libpng-1.2.8

# ./configure

# make

# make install

 

2.3.4　freetype 的安装

# tar –zxvf freetype-2.1.10.tar.gz

# cd freetype-2.1.10

# ./configure

# make

# make install

 

2.3.5　T1lib 的安装

# tar –zxvf t1lib-5.1.0.tar.gz

# cd t1lib-5.1.0

# ./configure

# make

# make install

 

2.3.6　gd 的安装

# 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 install

 

2.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/ext"

 

2.5　GD库的安装检查

安装完毕后用<? phpinfo(); ?>查看结果如下：
gd
GD Support enabled
GD Version 1.6.2 or higher
FreeType Support enabled
FreeType Linkage with TTF library
T1Lib Support enabled
GIF Support enabled
JPG Support enabled
PNG Support enabled
WBMP Support enabled

2.6　安装Mantis

# mv mantis-1.1.1 /var/www/mantis

2.7　建立数据库bugtracker及用户mantis

$mysqladmin -u root -p create bugtracker

//输入MySQL的root密码即可完成创建数据库bugtracker的操作

$mysql -u root -p

mysql>grant all privileges on bugtracker.* to 'mantis'@'localhost' identified by '你指定的mantis用户密码';

mysql>FLUSH PRIVILEGES;

mysql>/q

2.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 restart

2.9　配置mantis

# cd /var/www/mantis

# vi config_inc.php

 

//修改以下几行

$g_db_username = "mantis";

$g_db_password = "你在建立用户时指定的密码";

$g_database_name = "bugtracker";

 

//增加以下几行

$g_path = "http://www.yourdomain.com/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 = 'mail.softbrain.com.cn';    # SMTP 服务器

$g_smtp_username = 'esm@softbrain.com.cn'; # 邮箱登录用户名                       

$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 bugtracker<sql/db_generate.sql

//输入数据库密码即可创建

2.11　配置httpd.conf

编辑 apache的httpd.conf

#vi /web/apache/conf/httpd.conf

//增加以下几行

LoadModule php5_module         modules/libphp5.so

AddType application/x-httpd-php .php .phtml .php3 .inc

 

Alias /mantis/ "/var/www/mantis/"

<Directory “/var/www/mantis/”>

Options Indexes MultiViews Includes FollowSymLinks +ExecCGI

AllowOverride None

Order allow, deny

Allow from all

</Directory>

 

找到 DirectoryIndex index.html index.html.var，将其改为

DirectoryIndex index.html index.html.var index.php

 

2.12　重启apache服务

# /web/apache/bin/apachectl –k restart

 

2.13　访问Mantis

通过浏览器访问： http://www.yourdomain.com/mantis/

如果出现登录页面，则一切 Ok！

升级数据库

登录 http://www.yourdomain.com/mantis/admin

点击“Upgrade your installation”，升级其中的“Basic upgrade set (required)”和“String escaping fixes (recommended)”。

然后，

#mysql –u mantis –p bugtracker<sql/db_update.sql

并初始化数据库

#mysql –u mantis –p bugtracker<sql/db_insert_data.sql

 

2.14　Mantis的初步安全设置

在 Mantis目录下有一个admin目录，如果你在IE中打开这个目录下的index.php查看，你就会知道这个目录是进行Mantis Administration的，使用这个模块可以检查你的Mantis是否安装完全，对旧版本的Mantis进行升级，对Mantis的页面CSS文件进行修改；使用这个管理模块是不需要用户名和密码的，因此任何人都可以通过这个管理模块查看你的Mantis系统信息，而且由于有升级模块，在这里还可以直接对数据库进行修改；因此，在配置完成后将这个admin目录删除。

在添加一个管理员用户后，删除系统默认的 administrator用户。

3　CVS 集成配置

如果需要建立Mantis 和 CVS集成，需要将Mantis与CVS服务安装在同一台服务器上。

3.1　安装CVSWeb

CVSWEB就是CVS的WEB界面，可以大大提高程序员定位修改的效率。

解包

tar -zxvf   CVSWeb3.0.0.tar.gz

 

把配置文件cvsweb.conf复制到apache的配置目录下

cp cvsweb.conf /path/to/apache/conf

转到/path/to/apache/conf下并修改cvsweb.conf：

修改CVSROOT路径设置：

%CVSROOT = (

'Development' => '/path/to/cvsroot/dev', #<==修改指向本地的CVSROOT

'test' => '/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 = $ENV{'CVSWEB_CONFIG'} || '/path/to/apache/conf/cvsweb.conf';

 

中文支持

让cvsweb正确显示中文，找到sub html_header($)函数，

然后在<html>和<title>之间插入一行，修改如下

<html>

<meta http-equiv="Content-Type" content="text/html; charset=gb2312">

<title>$title</title>

复制所有的gif,png文件到apache的icons目录

 

增加访问控制

CVSWEB可不能随便开放给所有用户，因此需要使用WEB用户认证：

先生成 passwd:

/path/to/apache/bin/htpasswd -c cvsweb.passwd user

 

修改httpd.conf，增加

<Directory "/path/to/apache/cgi-bin/cvsweb/">

AuthName "CVS Authorization"

AuthType Basic

AuthUserFile /path/to/cvsweb.passwd

require valid-user

</Directory>

3.2　配置config_inc.php

设置mantis配置文件config_inc.php

//添加下面一行

$g_cvs_web = 'http://192.168.100.17/cgi-bin/cvsweb.cgi/';      #CVSWeb链接地址

$g_source_control_account ＝ ’cvsuser’; # 必须是 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中。

4　Relationship 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:    http://www.research.att.com/sw/tools/graphviz/

       # WinGraphviz homepage: http://home.so-net.net.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 fails to run

       # for you, you are probably using a font name that gd can't find. On

       # Linux, try the name of the font file without the extension.

       $g_relationship_graph_fontname          = 'Arial';

       $g_relationship_graph_fontsize            = 10;

 

       # Local path where the above font is found on your system for Relationship Graphs

       # You shouldn't care about this on Windows since there is only one system

       # folder where fonts are installed and Graphviz already knows where it

       # is. On Linux and other unices, the default font search path is defined

       # during Graphviz compilation. If you are using a pre-compiled Graphviz

       # package provided by your distribution, probably the font search path was

       # already configured by the packager.

       #

       # If for any reason, the font file you want to use is not in any directory

       # listed on the default font search path list, you can either: (1) export

       # the DOTFONTPATH environment variable in your webserver startup script

       # or (2) use this config option conveniently available here. If you need

       # to list more than one directory, use colons to separate them.

 

       # Since 0.19.3 we use the $g_system_font_folder variable to define the font folder

 

       # Default dependency orientation. If you have issues with lots of childs

       # or parents, leave as 'horizontal', otherwise, if you have lots of

       # "chained" issue dependencies, change to 'vertical'.

       $g_relationship_graph_orientation = 'horizontal';

 

       # Max depth for relation graphs. This only affects relation graphs,

       # dependency graphs are drawn to the full depth. A value of 3 is already

       # enough to show issues really unrelated to the one you are currently

       # viewing.

       $g_relationship_graph_max_depth              = 10;

 

       # If set to ON, clicking on an issue on the relationship graph will open

       # the bug view page for that issue, otherwise, will navigate to the

       # relationship graph for that issue.

       $g_relationship_graph_view_on_click = OFF;

 

       # Complete path to dot and neato tools. Your webserver must have execute

       # permission to these programs in order to generate relationship graphs.

       # NOTE: These are meaningless under Windows! Just ignore them!

       $g_dot_tool                                              = '/usr/bin/dot';

       $g_neato_tool                                    = '/usr/bin/neato';

 

4.2　安装Graphviz

# rpm –ivh graphviz-2.4-1.rh73.i386.rpm

# rpm –ivh graphviz-devel-2.4-1.rh73.i386.rpm

# rpm –ivh graphviz-doc-2.4-1.rh73.i386.rpm

# rpm –ivh graphviz-graphs-2.4-1.rh73.i386.rpm

# rpm –ivh graphviz-tcl-2.4-1.rh73.i386.rpm