Mantis 安装配置手册：报错

作者：龚云卿 2006-4-28

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

httpd-2.0.54.tar.gz

php-5.0.4.tar.gz

mantis-1.1.1-bin

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

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

ZendOptimizer-linuxi386.tar.gz

CVSWeb3.0.0.tar.gz

安装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安装完毕。

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

# tar -xf jpegsrc.v6b.tar

# cd jpeg-6b

# ./configure

# make

# make install

# tar –zxvf zlib-1.1.3.tar.gz

# cd zlib-1.1.3

# ./configure

# make

# make install

# tar –zxvf libpng-1.2.8.tar.gz

# cd libpng-1.2.8

# ./configure

# make

# make install

# tar –zxvf freetype-2.1.10.tar.gz

# cd freetype-2.1.10

# ./configure

# make

# make install

# tar –zxvf t1lib-5.1.0.tar.gz

# cd t1lib-5.1.0

# ./configure

# make

# make install

# 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

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

安装完毕后用<? 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

# mv mantis-1.1.1 /var/www/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

#tar -zxvf ZendOptimizer-linuxi386.tar.gz

#cd ZendOptimizer-2.6.0-linux-glibc21-i386

#./install.sh

//重启Apache

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

# 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’;     # 页面标 题栏

#cd /var/www/mantis

#mysql -u mantis -p bugtracker<sql/db_generate.sql

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

编辑 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

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

通过浏览器访问： 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

 

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

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

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

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>

设置mantis配置文件config_inc.php

//添加下面一行

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

$g_source_control_account ＝ ’cvsuser’; # 必须是 mantis 的有效帐户；

在cvs仓库的配置文件loginfo中添加一行：

DEFAULT /usr/local/bin/php /var/www/mantis/core/checkin.php %{,sVv} $USER

这样，在提交cvs文件时，在log message中输入包含有“issue #nnnn”的内容，就会将提交的版本信息，添加在该issue的note中。

添加下面内容：

       # --- 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';

 

# 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