Subversion、BugFree安裝指南

Subversion、BugFree安裝指南

 

    Apache、PHP、MySQL、Subversion、BugFree的服務配置可以稱得上覆雜，在幾經摸索獲得成功後，作文以記之。

 

1          伺服器安裝

如果你很熟悉Apache、PHP、MySQL的配置，那麼很幸運，伺服器的配置對你來說絕不是什麼難事。如果你不熟悉它們，那麼我推薦你用已有的第三方套件來組織服務程式。

現有的伺服器套件有很多種，在使用了幾組套件後，決定採用WAMP伺服器套件。

1.1       下載WAMP

官方網站: http://www.wampserver.com/

 

1.2       安裝

WAMP的安裝很簡單，按照提示下一步即可。

Apache的http預設埠為80，如果你的IIS服務所佔埠也為80的話，將引起衝突。你可以安裝WAMP之前把IIS關掉，或者將IIS的WEB服務另改一個埠。

在安裝過程中，安裝程式將提示使用者選擇www的根目錄。可以直接將此指向當前機器的BugFree的目錄，如：d:/BugFree

安裝完畢後，應該可以在系統托盤中看到WAMP的圖示，可以由此進入相關服務的管理程式。

 

2          Subversion

2.1       下載Subversion

官方網站: http://subversion.tigris.org/

 

2.2       安裝

 

2.3       建立程式碼庫

進行命令列視窗，輸入命令：svnadmin create d:/svn（請輸入你要建立的程式碼庫目錄）

 

配置使用者和許可權：

來到d:/svn/conf目錄，修改svnserve.conf：

# [general]

# password-db = passwd

改為：

[general]

password-db = passwd

 

然後修改同目錄的passwd檔案，去掉下面三行的註釋：

# [users]

# harry = harryssecret

# sally = sallyssecret

最後變成：

[users]

harry = harryssecret

sally = sallyssecret

此處為系統預設的兩個使用者，你大可改為你自己的帳戶。

很明顯，格式為：<使用者名稱> ＝ <密碼>

 

 

2.4       啟動Subversion服務

方式有兩種（windows上推薦第二種方法）：

2.4.1        使用Subversion命令列

1)      進入命令列，來到Subversion安裝目錄的bin目錄下（如：D:/Program Files/Subversion/bin/）

2)      輸入命令：svnserve -d -r d:/svn（請指向你的程式碼庫目錄）

 

2.4.2        安裝服務

Windows系統下也可直接安裝服務來啟動Subversion：

1)      官方網站: http://clanlib.org/~mbn/svnservice/

2)      將SVNService.exe拷貝到Subversion安裝目錄的bin目錄下（如：D:/Program Files/Subversion/bin/）

3)      來到相應目錄，輸入命令：svnservice -install -d -r d:/svn（請指向你的程式碼庫目錄）。

4)      如果安裝成功，應該會在系統服務列表中看到SVNService：

5)      改變服務的啟動型別為“自動”，並啟動服務：

6)      至此服務安裝完成

 

 

2.5       配置Subversion的網路服務

Subversion使用Apache2.0來作為http前端。

安裝步驟如下：

1)      來到Apache的安裝目錄下的bin目錄，在Subversion安裝目錄下的/bin （c:/Program Files/Subversion/bin)，找到檔案: mod_dav_svn.so，mod_authz_svn.so和libdb43.dll，把他們複製到Apache 功能模組目錄下(c:/wamp/Apache2/modules).

2)      編輯Apache的配置檔案(Apache2/conf/httpd.conf)

去掉下面兩行的"#"

#LoadModule dav_fs_module modules/mod_dav_fs.so

#LoadModule dav_module modules/mod_dav.so

在LoadModule section增加下面兩行

LoadModule dav_svn_module modules/mod_dav_svn.so

LoadModule authz_svn_module modules/mod_authz_svn.so

    新增svn版本庫管理：

<Location /svn>

DAV svn

SVNParentPath d:/svn （請指向你的程式碼庫目錄）

</Location>

3)      重起Apache

 

2.6       客戶端的使用

你即可以完全使用命令列方式來使用Subversion，也可使用第三方工具來作為Subversion的客戶端工具，TortoiserSVN官方網站: http://tortoisesvn.tigris.org/

詳細的使用方法在Subversion、TortoiserSVN的幫助文件裡已有描述。

 

2.7       如何配置Subversion自動傳送郵件

Subversion是通過Hooks 來控制每次Transaction的行為, 有Pre-Commit, Post-Commit 等.

一般情況下我們希望在提交程式碼後，Subversion可以自動傳送郵件給組裡的每個成員,  這種情況下我們可以通過post-commit這個指令碼來完成.

這些指令碼存放在你的Repository的Hooks目錄下, 一般情況下, 是以.template字尾結尾, 如果是Unix平臺, 需要改成.sh, Windows 平臺改成.bat就可以.

 

當一個Transaction成功完成後， 就會呼叫post-commit.bat 這個指令碼.

下面的例子給出了， 如何在Subversion提交程式碼後自動傳送郵件的例子.

set REPOS=%1

set REV=%2

commit-email-win.pl %REPOS% %REV% -l C:Tempsvnlookcommit-email.log --from your-email@server.com -s "[project-dev] Commit"

commit-email-win.pl 是用來傳送郵件的Perl 指令碼， 所以你的系統需要安裝Perl.

%REPOS% 引數是你的Repository的目錄

%REV% 引數是Commit的Revision號

--from 表面郵件傳送人的地址

-l 引數是日誌的目錄， 用來記錄每次郵件傳送的細節

-s 引數是郵件的標題

 

下面給出commit-email-win.pl， 您可以將他放在svn/bin 目錄下， 並保證svn/bin在系統的PATH環境變數裡面.

請根據你的系統配置， 正確改寫下面幾處變數:

$sendmail

$svnlook

$emailsFile # 每行一個郵件地址

$tmp_dir

$mailserver # SMTP的域名或者IP

找到$mailer->auth ， 正確填寫你的郵件地址的帳號， 和密碼 (SMTP 驗證用)， 並保證你的Perl 已經安裝Authen::SASL

commit-email-win.pl

 

至此 就算大功告成， 你可以直接執行commit-email-win.pl 指令碼， 來檢查指令碼是否正常執行， 此時mailerDebugLevel可以設定為1.

> commit-email-win.pl d:/svn_repository 2

如果執行成功， 你就可以通過Commit再次檢查執行是否正常

 

 

3          BugFree

3.1       下載BugFree

官方網站: http://bugfree.1zsoft.com/

 

3.2       安裝

1)      解壓縮BugFree到任意目錄。如：D:/BugFree/

2)      在安裝WAMP時，將http根目錄指向此目錄即可。

3)      修改D:/BugFree/Include/SetupBug.inc.php檔案：

找到這行：

//$BugConfig["ScriptDir"] = "Your path to BugFree";

去掉“//”，並改為自己的BugFree目錄。如：

$BugConfig["ScriptDir"] = "d:/BugFree";

4)      訪問BugFree的安裝頁面：http://localhost/install.php

5)      填定各項引數。

注意如果mysql中尚無bugfree資料庫，請在此頁面中選中，如此則會自動建立BugFree資料庫及相關表。

6)      填寫完畢後，點選按鈕：

將生成的ConfigBug.inc.php覆蓋D:/BugFree/Include/SetupBug.inc.php

7)      將d:/BugFree下的兩個檔案改名：install.php和upgrade.php。任意名稱都可。

8)      至此BugFree安裝完畢。可以使用admin:123456訪問http://localhost/Login.php以驗證。

 

3.3       BugFree的郵件服務配置

1)      開啟Apache的php配置檔案。如：c:/wamp/Apache2/bin/php.ini

2)      找到[mail function]一節，修改以下兩項配置：

SMTP = 你的郵件伺服器地址（如：mailsvr， smtp.163.com）

Sendmail_from = bugfree的自動郵件地址（如：sun@geostar.com.cn）

3)      儲存配置，郵件配置成功。