Mantis1.2.19 在Windows 平臺上的安裝配置詳解

安裝環境：

　　WindowsXP 32

　　Apache2.2.22+PHP5.4.39+MySQL5.5.28

 

1、簡介

　　MantisBT是由PHP開發的、基於WEB的缺陷跟蹤系統，並採用開源數據庫MySQL，構成一個完整的開源解決方案，以下圖1所示。MantisBT的主要功能能夠分爲3個部分：管理、缺陷報告和統計分析。每一個部分又有一些子功能，子功能下面還有一些具體的功能，其功能結構，能夠用圖2來描述。

圖1

 

圖2

MantisBT的功能特色：

（1）支持多項目、多語言。

（1）權限設置靈活，不一樣角色有不一樣權限，還支持自定義角色。

（1） 能夠創建缺陷之間的關聯或依賴關係，從而更有效地管理項目。

（1）缺陷統計分析功能比較強，有多種直方圖和圓餅圖，並能導出CSV文件供Excel做進一步分析。

（1） 有自定義字段功能，能夠知足企業的一些特殊要求。

（1） 缺陷能夠在不一樣項目間移動。

（1）  主頁可發佈公告、項目相關新聞，方便信息傳播。

（1） 我的可定製Email通知功能，每一個用戶可根據自身的工做特色訂閱相關的缺陷狀態郵件。

（1） 能夠定製軟件公司特定的缺陷處理流程。

 

與Bugzilla相比，Mantis有以下優勢：

　　第1、Mantis相對Bugzilla有更好的操做界面。

　　第2、安裝和使用都相對簡單一點。對於通常的項目， Mantis做缺陷跟蹤，已經綽綽有餘。

 

2、下載安裝

       因爲Mantis是創建在PHP、MySQL環境之上的，因此Mantis安裝分爲兩部分，既要安裝PHP、MySQL等支撐平臺，還要完成自身的安裝。支撐平臺的安裝能夠參照Windows搭建Apache+MySQL+PHP環境。如下詳細介紹mantis自身的安裝。

首先，Mantis官方下載地址爲 http://www.mantisbt.org/download.php，下載版本：mantisbt-1.2.19.zip

其次，PHPMyAdmin官方下載地址爲http://sourceforge.net/projects/phpmyadmin/ ，下載版本：phpMyAdmin-4.4.4-all-languages.zip

一、安裝

(1)將下載的mantisbt-1.2.19.zip壓縮包進行解壓，放在D:\php目錄中，並將文件夾改名爲：mantisbt

(2)將下載的phpMyAdmin-4.4.4-all-languages.zip壓縮包進行解壓，放在D:\php目錄中，並將文件夾改名爲：phpMyAdmin

二、配置

(1) 確認apahce和mysql服務已經啓動

(2) 打開瀏覽器，輸入http://localhost/phpMyAdmin，輸入MySQL的登陸用戶名與密碼(root/123456)，在「SQL」中執行建立數據庫腳本:create database mantisdb;

或者在「數據庫」中：填寫「mantisdb」、「utf8_general_ci」，點擊「建立」，建立成功.

(3) 打開瀏覽器，輸入http://localhost/mantisbt/admin/install.php進入相關配置

依次輸入:
　　mysql （數據庫類型）
　　localhost （服務器名）
　　root （mantis數據庫擁有者的用戶名）
　　123456 （mantis數據庫擁有者的密碼）
　　mantisdb   （mantis數據庫名）
　　root （mysql數據庫管理員用戶）
　　123456 （mysql數據庫管理員密碼）

最後點擊「Install/Upgrade Database」這個按鈕，安裝開始，其實就是在MySQL中建立相關的表和初始化一些數據的過程，在個人電腦上花了大約七八秒鐘，而後就顯示完成信息了。若是各個條目的右邊都顯示綠色的「GOOD」字樣的話，那就恭喜你，你已經成功安裝了MantisBT，若是有些條目顯示的不是「GOOD」，那就要回頭檢查一下，多半是數據庫權限不夠的問題，比較省事的辦法就是我上面的作法，直接給MantisBT使用root帳號，就不會有權限的問題了。

(4) 查看是否可打開 mantis 登陸頁面（http://localhost/mantisbt/login_page.php）

(5) 配置完成的 Mantis 只有一個默認的系統管理員用戶：administrator，密碼： root。

(6)你會看到登陸界面，登陸界面下面有兩行紅字：

Warning: You should disable the default 'administrator' account or change its password.
Warning: Admin directory should be removed.

都是安全方面的warning，前一個說administrator這個管理員帳號的密碼得改，這個簡單，administrator的默認密碼是「root」，登陸進去，在My Account這個標籤下面修改就能夠了，修改密碼的時候還須要你提供真實可用的Email地址。

另一個warning也不難解決，如它所說，刪除「Admin」目錄，個人是「D:\php\mantisbt\admin」這個目錄。

 

3、漢化

默認狀況下，顯示的語言是英文，如今須要將它漢化爲中文，設置以下：

修改配置文件： 在 Mantis 目錄下 config_defaults_inc.php

修改前： $g_default_language  = 'english';

修改後： $g_default_language  = 'chinese_simplified';

 

4、郵件配置

一、修改配置文件： 在 Mantis 目錄下 config_defaults_inc.php中設置「Mantis Email Settings」的相關信息，包括下列內容：

（1） 將$g_administrator_email、$g_webmaster_email、$g_from_email、$g_return_path_email等設爲有效的郵件地址；

（2） 將$g_phpMailer_method值設爲2，表示以smtp方式發送郵件；

（3）將$g_smtp_hosty設定爲有效的郵件服務器主機名，如’mail.iflashbuy.com’；

（4）爲$g_smtp_username 和$g_smtp_passwordy設定一個登陸郵件服務器的有效用戶帳號和口令。

//Mantis Email Settings
$g_administrator_email='test@iflashbuy.com';
$g_webmaster_email='test@iflashbuy.com';
$g_from_email='test@iflashbuy.com';
$g_return_path_email= 'test@iflashbuy.com';

$g_use_phpMailer = ON; # 使用 PHPMailer 發送郵件
$g_phpMailer_method=2; # PHPMailer 以 SMTP 方式發送 Email
$g_smtp_host='mail.iflashbuy.com'; # SMTP 服務器
$g_smtp_username = 'test@iflashbuy.com'; # 郵箱登陸用戶名
$g_smtp_password='密碼'; # 郵箱登陸密碼

Note: 這邊示例使用的是公司的郵箱做爲郵件服務器測試成功。

你們常常會遇到，沒法發送郵件，而又不知道如何解決的問題，能夠經過如下方法進行調試：
進入郵件測試界面，在瀏覽器中輸入測試地址，例如：http://localhost/mantisbt/admin/test_email.php ，點擊測試，就能夠對發送失敗緣由進行檢測。

 

二、附上較理想的郵件設置

 

5、用 Administrator 註冊新用戶時設置密碼

在 Mantis 目錄下 config_defaults_inc.php 文件中找到 $g_send_reset_password

修改前：$g_send_reset_password = ON;

修改後:  $g_send_reset_password = OFF;

 

特附上設置前與設置後的圖：

 

6、配置局域網訪問

關閉防火牆，在局域網的任一電腦中輸入：http://ip/mantisbt/login_page.php便可成功訪問。

若失敗，可嘗試如下操做：

在Listen 127.0.0.1:80下一行加入一段代碼Listen 192.168.1.101:80
注：192.168.1.101爲Mantis服務器的IP地址
若是之後郵件系統不但願出現bug的地址爲127.0.0.1的，請把Listen 127.0.0.1:80注掉。只留Listen 192.168.1.101:80

 

7、上傳附件配置

一、在 Mantis 目錄下 config_defaults_inc.php 文件中找到Mantis File Upload Settings

$g_allow_file_upload= ON;
$g_file_upload_method= DISK;    　　　　　　　　　　 #上傳到硬盤
$g_max_file_size=2097152;        　　　　　　　　　 #附件大小限制爲2MB
$g_allowed_files= 'txt,jpg,jepg,gif,bmp,doc';    #容許上傳的文件類型
$g_disallowed_files='exe,com';                    #不容許上傳的附件類型
$g_absolute_path_default_upload_folder='D:\php\mantisbt\upload';    #默認的文件上傳的絕對路徑
$g_preview_attachments_inline_max_size=99999;                        #直接顯示任何小於這個字節大小的bmp,png,gif,jpg格式的上傳文件。

二、在MantisBT目錄下新建一個目錄upload（注意最好不要用中文目錄名，目錄名中間也不要帶空格）

 

8、解決CSV導出的中文顯示是亂碼

 假如保存的文件爲administrator.csv，其中中文亂碼解決辦法：

一、重命名administrator.csv爲administrator.txt

二、另存時選擇編碼方式爲ASCII更名過來，就能夠了

 

9、JpGraph

      在進行缺陷分析時，需要繪製直方圖、圓餅圖、趨勢圖等，爲了解決這個問題，要安裝JpGraph。若是不安裝這個軟件，也能夠將數據拷貝到Excel等，再進行分析。如想了解JpGraph，能夠參考官方網站http://jpgraph.net/上的相關內容。例如，JpGraph2.3.3安裝到D:\php\mantisbt\library的目錄下，要修改3個地方來完成配置。

一、 Config_default_inc.php爲JpGraph進行設置，即在」Mantis JPGRAPH Addon」段中修改下列相關的參數。

$g_use_jpgraph=ON;    #將off改成on;
$g_jpgraph_path=’D:\php\mantisbt\library\jpgraph’;        #JpGraph所在路徑
$g_graph_font=’simsun’;        #定義所用的字體，這裏指定宋體

在文件中的」Signup and Lost Passwod」段中修改下列兩個參數：

$g_system_font_folder=’c:\WINDOWS\Fonts’;
$g_font_per_captcha=’simsun.ttc’;

二、在mantisbtmantisbt\plugins\MantisGraph\core\graph_api.php文件中增長中文字體simsun（宋體），其代碼以下：

Function  graph_get_font(){
    $t_font_map=array(
        'simsun'=>FF_SIMSUM, //增長宋體映射
        'arial'   =>FF_ARIAL,
…    
}

三、在mantisbt/library/jpgraph/jpgraph_ttf.inc.php文件中注shi字符集編碼轉換，由於咱們已全面採用了UTF-8字符集，其代碼以下：

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

未解決中文問題。。。

 

 

後記：

一、若是是在windows下裝，要特別注意，文件路徑的「/」，不能使用「\」，這在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數據庫的鏈接參數，管理員的郵箱的;其餘的要根據你的實際狀況進行修改。

配置文件加載順序：先加載config_defaults_inc.php，後加載config_inc.php。config_inc.php中的值會覆蓋config_defaults_inc.php
若是要修改，建議拷到config_inc.php中修改。