分享

Mantis在iis5下的安装指南

 Jcp189 2010-08-14
Mantis在iis5下的安装指南
点击:1064       更新时间:2007-3-8 14:26:05
Mantis,是一个开源的 Bug 跟踪管理系统,基于 PHP+MySQL,支持 Windows;相对于BugZilla,属于轻量级的,对于一个小的开发团队来说是完全够用的。
    下面是我写的一个安装指南。(注:我的操作系统是win2000 server 5.0.2195 sp4)
准备工作
1.    下载php5.0.5 installer:   
http://cn2./get/php-5.0.5-installer.exe/from/cn2./mirror
Php5win32.zip     http://cn2./get/php-5.0.5-Win32.zip/from/cn2./mirror
php-pecl-5.0.5-Win32.zip     http://cn2./get/pecl-5.0.5-Win32.zip/from/cn2./mirror
2.    phpmailer-1.7.2     http://nchc.dl./sourceforge/phpmailer/phpmailer-1.72.zip
3.jpgraph-2.0beta      http://members./jpgraph/jpgdownloads/jpgraph-2.0beta.tar.gz
4. mysql5.0.13     http://dev./get/Downloads/MySQL-5.0/mysql-5.0.13-rc-win32.zip/from/http://mysql.cs.pu.edu.tw/
5.mantsi-1.0.0a2    http://www./index.php

安装 PHP5:
  假设你的系统安装于 C 盘,否则下列目录均须改成相应的盘的目录。
  首先,运行php5install.exe。然后将下载来的 PHP5 RC3(php-5.0.0RC3-Win32.zip) 解压缩到 C:\PHP\ 目录下。将 PECL 扩展模块集合包里的所有文件解压缩到 C:\PHP\ext\ 目录下。
  复制 C:\PHP\ 目录下的 php5ts.dll 文件到 C:\windows\(如果是 windows 2000 操作系统,则为 C:\WINNT\ 目录,下同,不再重复说明) 目录下。
  复制 C:\PHP\ 目录下的下列 dll 文件于 C:\windows\system32\ 目录下:
CODE
1.    
2.      fdftk.dll
3.      fribidi.dll
4.      gds32.dll
5.      libeay32.dll
7.      libmhash.dll
8.      libmysql.dll
10.      ntwdblib.dll
11.      yaz.dll

  其中 libmysql.dll 为 MySQL 的扩展支持。
  复制 C:\PHP\ 目录下的 php.ini-dist 文件到 C:\windows\ 目录下,并改名为 php.ini ,并用记事本打开编辑:
  定位到下面两行:
CODE
1.    
2.    ; Directory in which the loadable extensions (modules) reside.
3.    extension_dir = "./" 4.    
修改下面一行使它指向 C:\PHP\ext\ 目录,修改后如下:
CODE
1.    
2.    ; Directory in which the loadable extensions (modules) reside.
3.    extension_dir = "C:\PHP\ext\" 4.    

定位到下面两行:
CODE
1.    
2.    ;Windows Extensions
3.    ;Note that ODBC support is built in, so no dll is needed for it. 4.    

  可以看到下面列出了所有可支持扩展,我们可以去掉前面的分号来使 PHP 支持相应的扩展。我测试了下,支持下列扩展,也可以根据选择是否配置。这里我们只须要将下面的两行作修改,去掉行首的';'
CODE
1.
11.    extension=php_gd2.dll
26.    extension=php_mysql.dll
保存文件退出并退出。

安装phpmailer
将下载下来的phpmailer-1.71.zip解压缩到C:\PHP\includes \PHPMailer目录下;


安装jpgraph2.0beta
将下载下来的jpgraph2.0beta.tar.gz解压缩到C:\PHP\includes目录下;(注:这里必须是2.x版本的,因为2.x版本是for php5的,1.x版本是forphp5以下版本的)

安装mysql

安装到c:/mysql目录下。直接安装就可以了,在安装过程中修改一下安装目录,跳过注册,设置root密码。其他全部next就可以。

安装mantis
将下载下来的压缩包解压就可以了。
我mantis目录是:d:/mantis。
这样所有的组件都安装好了,但是还存在很多问题。我们需要做一些修改和设置才能让mantis正常的工作。
说明: 文中所说的软件的最高版本号均为截止到2005-10-1的最高版本号;


相应的修改和设置工作
1.建立mantis数据库;
这里假设MySQL安装在C:\MySQL下;
安装后运行任务管理器,在进程中可以看到一个名字为mysqld-nt.exe的进程,这说明mysql服务已经启动了。
1)修改MySQL默认的root用户密码: (如果安装时已经设置密码了,这一步可以不作)
在命令行下进入c:\mysql\bin,运行如下命令:
C:\>cd mysql
  C:\mysql>cd bin
  C:\mysql\bin>mysql -u root mysql
    mysql>UPDATE user SET Password=PASSWORD( ’<new_root_password’> ) WHERE user=’root’;
    mysql>FLUSH PRIVILEGES;
说明:请将< new_ root_password>改为你设定的root用户的新密码。更改密码后,要用root用户访问mysql,必须使用mysql -u root -p,按提示输入入正确的root新密码。
2)创建mantis数据库:
注意:进行这一步以前,需要先把你的Mantis安装包解压缩,因为创建数据库需要用到其中的建表SQL文件。
mysql>create database mantis;
    mysql>connect mantis;
    mysql>source <mantis_path>\sql\db_generate.sql
说明:请将<mantis_path>改为你解压缩Mantis安装包的路径;
3)创建mantis用户,并赋给对Mantis数据库的相应权限:
    mysql>GRANT SELECT, INSERT, UPDATE, DELETE, INDEX, ALTER, CREATE, DROP, REFERENCES, LOCK TABLES,
            CREATE TEMPORARY TABLES ON mantis.* TO mantis@localhost IDENTIFIED BY ’<mantis_password>’;
    mysql>FLUSH PRIVILEGES;  
说明:请将<mantis_password>改为你设定的mantis用户的密码;这个密码在下面的操作中要写到Mantis的配置文件中;
4)完成MySQL初始化工作,退出
    mysql>exit

2.设置Mantis
1)打开IIS管理器,在默认网站中增加一个虚拟目录Mantis,指向你的Mantis解压缩目录(这里使用D:\WebSite\Mantis),在“属性”窗口的“文档”页面增加默认文档“index.php”;
2)将D:\WebSite\Mantis中的config_inc.php.sample复制一份,改名为config_inc.php,修改其中的设置;
Mantis的设置是这样保存的:在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,这里对每个参数都有详细的解释,虽然是E文,不过应该都能看懂;Sample中给出的一些设置是一定需要修改的,比如MySQL数据库的连接参数,管理员的邮箱的;其他的要根据你的实际情况进行修改。
下面是我的一些自定义参数,其中一些参数($g_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 = DEVELOPER;   # 默认用户级别
$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.mail.net’;   # SMTP 服务器
$g_smtp_username = ’mailuser’;   # 邮箱登录用户名
$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.yourftp.com’;   # 上传文件 FTP
$g_file_upload_ftp_user = ’ftpuser’;   # FTP 登录用户名
$g_file_upload_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登录进去,进行管理设置。

3.Mantis的初步安全设置
1)在Mantis目录下有一个admin目录,如果你在IE中打开这个目录下的index.php查看,你就会知道这个目录是进行Mantis Administration的,使用这个模块可以检查你的Mantis是否安装完全,对旧版本的Mantis进行升级,对Mantis的页面CSS文件进行修改;使用这个管理模块是不需要用户名和密码的,因此任何人都可以通过这个管理模块查看你的Mantis系统信息,而且由于有升级模块,在这里还可以直接对数据库进行修改;因此如果被未授权的人打开,结果会是什么样不用我多说;最好因此按照系统的建议,在配置完成后将这个admin目录删除;注意一定是删除而不是改名!改名后仍然是可以访问的!
2)在添加一个管理员用户后,删除系统默认的administrator用户。

4.PHPMail的设置
默认情况下,Mantis使用内置的Mailto()函数进行邮件的发送,包括新用户注册发送密码、Bug改变提醒、重设密码等邮件的发送都使用MailTo()来完成,不过实际使用中发现,MailTo函数好像不支持需要校验的邮件服务器,比如我的263邮箱每次都提示需要校验,所以我给PHP安装了PHPMail模块,设置Mantis使用PHPMailer发送邮件。
1)下载PHPMailer:从
http://phpmailer.下载,版本是1.72;
2)安装PHPMailer:将下载下来的phpmailer-1.72.zip解压缩到C:\PHP\includes \PHPMailer目录下;
3)修改Windows目录下的PHP.ini,找到include_path,增加C:\PHP\includes \PHPMailer目录;
4)如上表所示,设置$g_use_phpMailer、$g_phpMailer_path和$g_phpMailer_method三个参数;
5)现在应该就可以使用PHPMailer进行邮件发送了;

6.图形报表的设置
默认情况下,Mantis的图形报表是关闭的,需要安装JPGraph模块并设置$g_use_jpgraph为ON才能打开图形报表;
1)下载JPGraph:从
http://www./jpgraph/index.php下载JPGraph的安装文件,目前最高版本是2.0beta;
2)将下载下来的jpgraph-2.0beta.tar.gz解压缩到C:\PHP\includes目录下;
3)打开config_inc.php文件,修改$g_jpgraph_path为JPGraph的src目录,$g_use_jpgraph为ON;
4)修改Windows目录下的PHP.ini文件,将“;extension=php_gd2.dll”中的‘;’去掉;另外如果extension_dir项不正确,请把extension_dir改为正确的值(应该是extension_dir = "./ext/"。(这些前面已经提到过这里再重复一下);
5)修改JPGraph的src目录下的jpgraph.php;将CACHE_DIR和TTF_DIR分别定义为Windows下的Temp目录和Fonts目录,如下所示
DEFINE("CACHE_DIR","E:/WinTemp/Temp/jpgraph_cache");
DEFINE("TTF_DIR","C:/WinNT/Fonts/");
6)现在再打开Mantis的统计页面,可以看到多了分别按状态等进行统计的图形报表,包括柱图、饼图和线图;
7)不过如果你的界面语言是用简体中文或者繁体中文,那么你会看到图形中的汉字都是乱码,这是因为Mantis对于JPGraph的编码设置不正确造成的。由于 PHP5 变化太大,jpGraph开发组直接开发了 jpGraph 2.X 类库,(注: 开发组在他们的网站上已经申明)所以PHP5下只能用 jpGraph 2.X ,同理,而jpGraph 1.x 只适用于 PHP4。
因此,以下解决方法针对的是 PHP5 + jpGraph 2.X
1. config_inc.php中增加$g_graph_font = 'simsun';
2. core/graph_api.php中函数function graph_get_font()中定义中文:
在$t_font_map数组中加上两行:
'simsun' => FF_SIMSUN,
'simhei' => FF_SIMHEI
这样,缺省系统就会找simsun字体。
8)现在你的图形报表应该就可以显示中文了。

    本站是提供个人知识管理的网络存储空间,所有内容均由用户发布,不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息,谨防诈骗。如发现有害或侵权内容,请点击一键举报。
    转藏 分享 献花(0

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多