Bug Tracker 使用手冊

第二章 安裝

內容列表

2.1 系統需求

2.2 安裝 Bug Tracker

2.3 設定客戶回報系統

2.4 設定郵件伺服器

2.4 升級

2.1 系統需求

伺服器需求

• 一台網頁伺服器
• 支援 PHP 4.1.0 以後的版本
• PostgreSQL 資料庫 7.0 以後或 MySQL 4.0 以後的版本

如果您使用 PostgreSQL，建議您使用 7.4 以後，或是 8.0 版。

如果您使用 MySQL，建議使用 4.1 以後的版本。而且，最好支援 UTF8 Character Set，這樣在使用排序時會有比較正確的結果。 另外，如果您需要上傳超過 1MB 的檔案，除了 PHP 本身的限制外 (預設是 2MB)，如果您使用的是 MySQL，您必須要注意是否支援超過 1MB 的封包。在啟動 MySQL 時，您可以在 mysqld 加上 --max_allowed_packet=16M 這個參數，以調高 MySQL 的限制。

客戶端需求

• 支援 JAVA script 的網頁瀏覽器 (如果不支援 JAVA script，某些功能可能無法使用)

2.2 安裝 Bug Tracker

安裝 Bug Tracker 十分容易，步驟如下：

• 下載 Bug Tracker
• 解壓縮到您的網頁根目錄
• 修改 bug/include/config.php
• 使用瀏覽器連到快速設定精靈 http://your.ip.com/bug/setup/index.php，並依畫面指示完成安裝

在解壓縮 Bug Tracker 到您的網頁根目錄後，在連到快速設定精靈前，您必須修改二個檔案，以下為 include/config.php：

<?
$GLOBALS['BR_dbserver'] = "127.0.0.1"; // 資料庫伺服器的 IP
$GLOBALS['BR_dbuser'] = "pgsql"; // 資料庫的使用者
$GLOBALS['BR_dbpwd'] = "password"; // 資料庫密碼
$GLOBALS['BR_dbname'] = "bugdb"; // Bug Tracker 所要使用的資料庫名稱

/* 這是您 Bug Tracker 在系統中的真正路徑 */
$GLOBALS["SYS_PROJECT_PATH"] = "/usr/local/apache/htdocs/bug";

/* 這是你使用瀏覽器連到 Bug Tracker 的網頁絕對路徑。例如，如果您是以
 * http://192.168.0.1/bug/index.php 連到 Bug Tracker，則您這
 * 裡的路徑必須填為 "/bug"。
 */
$GLOBALS["SYS_URL_ROOT"] = "/bug";
?>

編輯完上述檔案後，您就可以使用 http://your.ip.com/bug/setup/index.php 來連到快速設定精靈 setup/index.php。請注意，"/bug/setup/index.php" 的路徑會依您 Bug Tracker 的所在目錄而有所不同。

接下來你只要按照畫面指示一直按下一步即可完成安裝。在安裝完成後，您可以使用瀏覽器連到 http://your.ip.com/bug/index.php。預設的系統管理者帳號及密碼都是 "admin"，請記得在第一次登入後修改密碼。

就這樣，安裝完成，很簡單吧！

請注意：在您完成安裝後，如果您沒有要自行安裝額外的語言支援，請立即將 "setup" 這個目錄移除，以免其它使用者誤連。如果您要自行安裝其它語言，請參考第五章的說明。

2.3 設定客戶回報系統

如果您不需要客戶回報系統，您可以跳過這一小節。如果您要設定一個客戶回報系統或是匿名回報系統，您只要編輯 feedback_site/include/config.php 中關於資料庫的資訊。修改完後，您就可以使用瀏覽器連到 http://your.ip.com/bug/feedback_site/index.php。您可以新增客戶使用者或是乾脆開發為匿名回報系統，設客戶自己註冊。請參考 4.3 節的說明。

客戶回報系統可以完全和 Bug Tracker 分開，您可以將 "feedback_site" 這個目錄搬到其它目錄中，或是搬到其它的網頁伺服器上。例如，您可以將 "feedback_site" 目錄搬到和 Bug Tracker 同一層，並改名為 "feedback"，如此一來，您就可以使用 http://your.ip.com/feedback/index.php 來連到客戶回報系統。

2.4 設定郵件伺服器

Bug Tracker 在寄送電子郵件有二種方式：使用系統的 mail 指令或是使用 SMTP 協定連接其它郵件伺服器。

如果您的 Bug Tracker 是安裝在一台可以寄發電子郵件的 FreeBSD、Linux 伺服器上，您可以使用系統 mail 指令 (預設值)。但是如果將 Bug Tracker 安裝在 Windows 的機器上，則必須使用 SMTP 協定去連接其它的郵件伺服器。

在 Bug Tracker 的設定檔 include/config.php 中，有下列項目：

<?
/* Choose the method to send system email. It could be "mail" or "smtp".
* mail: Use the php mail() function. It requries the UNIX command "mail".
* smtp: Use PHP socket() function to connect to SMTP server. If you are
* running Bug Tracker on Win32, you should use smtp.
*/ 
$GLOBALS["email_method"] = "mail";

/* SMTP server. If the $GLOBALS["email_method"] is set to smtp, you have to
* specify the SMTP server to use.
*/
$GLOBALS["smtp_server"] = "127.0.0.1";
$GLOBALS["smtp_port"] = "25";

/* If your SMTP server requres authentication, you should specify an user
* and password to do the authentication. If the $GLOBALS["smtp_user"] is
* empty, it means no authentication is required.
*/
$GLOBALS["smtp_user"] = "";
$GLOBALS["smtp_password"] = ""
?>

如果您要使用系統的 mail 指令來寄信，請將 $GLOBALS["email_method"] 設為 "mail"。如果您要使用 Bug Tracker 中實作的 SMTP 協定來連接其它伺服器送信，請設為 "smtp"。在設為 smtp 時，您必須另外設定所要使用的伺服器位址 (smtp_server) 及埠號 (smtp_port)。如果您的 SMTP 伺服器要求通過認證才能送信，則您必須再設定 SMTP 的使用者及密碼。

如果您要使用客戶回報系統，您也必須要設定 feedback_site/include/config.php 中的上述項目。

如果您在使用 SMTP 送信時發生問題，信件一直都無法收到，您可以修改 include/config.php，將 $GLOBALS["smtp_debug"] 設為 TRUE，以進入除錯模式。在除錯模式下，您可以看到信件寄發失敗的原因，並可依此解決問題。

2.5 升級

如果您是要從舊的版本升級，請執行下列步驟：

• 下載 Bug Tracker。
• 解壓縮到您的網頁根目錄。
• 修改 bug/include/config.php。
• 使用瀏覽器連到升級精靈 http://your.ip.com/bug/setup/upgrade.php，並依畫面指示完成升級。