BugTracker.NET 3.4.4 安裝指南

BugTracker.NET 是一套開放原始碼的 issue tracking 系統,使用了一陣子之後,覺得還挺不錯的(原本的 BugNET 就不再使用了)。它的設計風格可說是簡約樸素--此風格不僅表現在操作介面上,程式碼也是如此。作者並未使用「程式碼後置」(code-behind)撰寫模型,而是以單一 aspx 頁面搭配一些資料存取和其它工具類別的方式來撰寫。

這篇是我的安裝筆記。

環境需求
  • BugTracker.NET v3.4.4
  • IIS 6/7
  • Microsoft SQL Server 2005/2008(標準版或 Express 版皆可)
BugTracker.NET 有附一個批次檔可以大幅簡化安裝程序,檔案名稱是 install_btnet.cmd。它會直接幫你在 IIS 中建立應用程式、在 SQL Server 中建立所需之資料庫,並且修改 web.config 檔案的內容。當然,你也可以手動完成這些工作,只是利用批次檔會方便很多。

你得先了解你的 SQL Server 是什麼版本,及其所在的主機位置。如果是 SQL Server Express 版,而且打算跟 BugTracker.NET 安裝在同一台主機上,就不需要調整批次檔的內容,因為此批次檔是針對 SQL Server Express 所編寫的。如果是 SQL Server 標準版或更高階的版本,或者安裝於不同主機,就必須稍微修改一下批次檔和 web.config。

安裝步驟
  1. 至 BugTracker.NET 網站下載最新版本的壓縮檔(本文使用的版本是 3.4.4),然後將檔案解壓縮至硬碟的某個目錄,例如:D:\WebApps\BugTrackerNET。
  2. 修改 www 目錄下的 web.config,把所有的「(local)\SQLEXPRESS」替換成你的 SQL Server 的執行個體所在的位置。假設是 SQL Server 標準版,而且跟 BugTracker.NET 安裝在同一台主機上,就只要替換成「localhost」或「127.0.0.1」。
  3. 修改根目錄下的 install_btnet.bat,把所有的「localhost\SQLEXPRESS」替換成你的 SQL Server 的執行個體所在的位置,這裡也是改成「localhost」。
  4. 開啟「命令提示字元」視窗,將現行目錄切換至 BugTracker.NET 解壓縮的目錄下,然後執行 install_btnet.bat(注意:必須以系統管理員的身分執行)。此批次檔執行時,會依序問你三個問題:

    - Enter name of btnet instance. Hit enter for default "btnet":
    - Enter SQL Server username. Hit enter for default "sa":
    - Enter SQL Server password:

    第一個問題是讓你指定此網站應用程式的名稱(同時也是資料庫名稱)。預設值是 btnet,因此如果你直接按 Enter 鍵,它就會幫你在 IIS 中建立一個名為 btnet 的應用程式(網址為 http://localhost/btnet),並且在 SQL Server 中建立一個名為 btnet 的資料庫。

    第二和第三個問題是連接 SQL Server 的帳號和密碼,如果密碼沒有設定,直接按 Enter 鍵即可。
從批次檔開始執行到結束的過程中,如果沒有發生任何錯誤,你應該會看到如下圖的畫面。


最後一個指令是開啟網址 http://localhost/btnet,因此你應該還會看到一個新的瀏覽器視窗,如下圖:

預設的登入帳號和密碼都是 “admin”。若之前的安裝程序都已正確執行,應該就可以順利登入。一開始並沒有任何資料,所以畫面空蕩蕩的:


由於預設的 admin 帳號是管理者,因此登入之後,頁面上方會有一個「admin」連結。你可以從這個連結進入管理頁面,開始建立組織(部門、小組名稱之類的)、使用者帳號、專案等,並修改一些基本設定,例如:問題分類(category)、重要性(priority)、自訂欄位(custom fields)等等。

不過,在建立專案、使用者帳號之前,最好先看一下 web.config 檔案的內容,裡面還有一些基本的參數需要調整。以下是一些你可能比較關心的參數:
  • ErrorEmailTo:當系統發生錯誤時,要發送訊息給誰。通常是設定成你的電子郵件位址。
  • ErrorEmailFrom:當系統發生錯誤時,用來發送訊息的電子郵件信箱。
  • NotificationEmailEnabled:是否啟用 bug 異動的郵件通知,預設值為 “1”,代表啟用。
  • NotificationEmailFrom:用來發送 bug 異動通知郵件的電子郵件信箱。
  • NotificationSubjectFormat:Bug 異動通知的郵件主旨格式。
  • <mailsettings> 元素底下的 相關參數。這些是發送郵件時,與發信伺服器連接的基本參數。
  • AbsoluteUrlPrefix:這是用來產生完整網址時的前綴字串。在執行 install_btnet.cmd 時,此參數值會被修改為「http://主機名稱/btnet/」。如果你有啟用電子郵件通知功能(即前面提過的 NotificationEmailEnabled),通常就得修改這個參數,把主機名稱的部分改成某個網域或 IP 位址,例如:http://www.mycompany.com/btnet/。注意最後的斜線字元是必要的。
這樣就差不多了,如果要客製化操作介面,還可以參考之前寫的這篇:客製化 BugTracker.NET

Post Comments

技術提供:Blogger.