漁人碼頭

Subversion(SVN)安裝使用指南

※簡述※

Subversion是近期在開源社區中非常流行的一款版本控制軟件，它是CVS的替代產物。

它的主要特征有：

• CVS大部分的功能。
• 支持“目錄”級別的版本管理，并且解決了CVS中遲遲未能解決的文件重命名和移動等問題。甚至對文件或文件夾的屬性都提供了版本管理。
• “提交（commit）”實現了真正意義上的原子操作。也就是類似數據庫中的事務的功能。
• 版本號依據每次提交而改變，不再針對每個文件。日志信息也是針對每次提交而設置。所以看到版本號是幾百或者幾千也不用太驚訝，表示方式不一樣罷了。
• 通過WebDAV/DeltaV協議，可以與Apache的網絡服務無縫銜接（通過Apache來運行）。這樣就能提供一些額外的功能，例如：認證，壓縮傳輸，以及數據倉庫（Repository，見下）的瀏覽等。
• 也可以作為獨立服務器運行，但這樣的話提供的功能較為簡單薄弱。
• 兩種運行模式都支持SSH（當然需要各自的支持和配置）
• 降低了分支（Branch）和標簽（tag）上的時間消耗。底層設計理念和實現上的不同，不細說了。
• 時間消耗依據的是文件改變部分的大小，而不是數據總量。
• 創建數據倉庫時，用戶可以指定是使用內嵌的 BerkeleyDB 數據庫，還是特定格式的文件系統。

其他還有些零星的小功能，具體可以參閱： http://subversion.tigris.org/roadmap.html

這里解釋一下 數據倉庫 的概念：
一個數據倉庫對應的可以是一個項目，也可以是多個項目。SVN是基于數據倉庫進行管理的。
按照用戶習慣，可以只在每個數據倉庫內僅放置一個項目的內容。

※下載※

Subversion 1.2.3:
http://subversion.tigris.org/project_packages.html
（SVN的Server端，分不同操作系統的版本，這里我下載的是for windows及for linux的）

TortoiseSVN:
http://tortoisesvn.tigris.org/download.html
（windows下的SVN客戶端，以shell方式集成在系統右鍵菜單中）

Apache 2.0.55:
http://httpd.apache.org/download.cgi
（視操作系統而下）

※安裝使用※

下面說一下安裝，分兩種平臺（windows，linux）及兩種模式（與Apache綁定 vs. Stand-alone）
具體在Apache上的配置倒是大同小異。

另外，SVN是支持SSL的，但是這個配置牽涉到其他太多東西，本文就不過多涉及了。真的有需要可以參考SVN的手冊（英文）。

方便起見，用幾個變量代表具體的值，請自行加以調整：

%SystemRoot% — windows的系統所在目錄，一般類似這樣：C:\WINNT
%SVN_HOME% — SVN的安裝目錄
%SVN_REPO_PARENT% — SVN所有數據倉庫的根目錄（就是存放全部版本文件的總目錄）
%PROJECT_NAME% — 項目名，嚴格的來說它對應的是一個數據倉庫，但是這里遵從用戶習慣，以項目名稱方式來命名。
%SERVER_NAME_OR_IP% — 服務器名或IP地址
%APACHE_HOME% — Apache2的安裝路徑

另外，安裝過程默認使用文件系統做后臺數據庫，文中不再加以說明。如需使用BerkeleyDB，請自行參考SVN文檔。

Windows上的服務器端安裝
____________________________________________

1.雙擊下載得來的”svn-1.2.3-setup.exe”并安裝到”%SVN_HOME%”

2.安裝完畢后，”%SVN_HOME%\bin”應該已經自動加入到系統路徑（%PATH%）中。如果沒有，請手工添加。

3.用命令行來測試安裝結果是否正確：

如果返回這樣的錯誤信息：”svnadmin.exe - Unable To Locate DLL”，那就需要嘗試一下步驟的中的一種或幾種：
安裝VC++ 6.0（主要是安裝VC的運行庫）
或者直接從別的機器上拷貝一個”msvcp60.dll”文件到本機的”%SystemRoot%\system32″下

4.使用以下命令創建一個數據倉庫，用來存放項目的源代碼和其他文件：

5.其中%SVN_REPO_PARENT%是包含所有數據倉庫的目錄，%PROJECT_NAME%是所創建的數據倉庫對應的項目名。

*************************
* 以 Stand-alone 模式運行 *
*************************

6.從命令行啟動SVN Server：

注意里面的參數 r 限定了瀏覽全部數據倉庫的根目錄

當然如果覺得每次這樣啟動太麻煩的話，也有SVN Serveice的包裝程序（http://dark.clansoft.dk/~mbn/svnservice/）。通過它能夠以windows service的方式運行SVN Server（其本質還是Stand-alone），運行起來相對比較方便。

7.創建用戶數據庫（其實就是一個txt文本，就叫它”users.conf”吧，你也可以改名），保存到
%SVN_REPO_PARENT%\%PROJECT_NAME%\conf
目錄（那個conf子文件夾在創建數據倉庫時已被自動創建好），然后在這個文件內添加需要的用戶名和密碼。基本的樣例如下：

注意這里密碼是明文存放的，所以也是這種方式的不足之處。

8.在”%SVN_REPO_PARENT%\%PROJECT_NAME%\conf”目錄下找到這個”svnserve.conf”文件，用任何文本編輯器打開，為剛才創建的那些用戶添加讀寫權限：

里面的”users.conf”就是剛才在第7步創建的用戶文件。

9.最后，重啟SVN Server（什么？你不知道怎么重啟？關掉窗口再重新用命令行啟動啦；包裝成Service的話么就更加簡單了）

現在已經可以使用客戶端來連接SVN Server，進行import等操作了。
連接Server的URL應該是類似這樣的：

具體步驟，請參閱第20步。

************************
* 以Apache的模塊方式運行 *
************************

10.首先要了解的是SVN設計的時候只考慮了兼容Apache2.x，所以在Apache1.x下是不能正常工作的。

11.安裝Apache2
如果事先啟動了IIS之類的其他webserver，請先停止那些服務（端口被占用會導致Apache安裝失敗）。
其他問題可以參考Apache的安裝手冊。
這里假設安裝目錄為：%APACHE_HOME%

12.檢查Apache2的安裝是否成功
打開瀏覽器，訪問： http://localhost/
如果出現的是默認的歡迎頁面，那就沒有問題了。否則請仔細檢查，重新安裝。

13.打開Apache的配置文件： “%APACHE_HOME%\conf\httpd.conf”
查找”LoadModule”這個關鍵字，找到導入模塊的區塊（section）
反注釋掉下面這樣，從而加載Subversion所需要的DAV模塊：

完成之后看起來應該是這樣：

另外在這行下面再添加兩行（請注意把路徑中的”\”替換成”/”）：

特別需要注意的是：由于模塊依賴關系，這三行的出現順序千萬不能顛倒。

14.再來配置一下”httpd.conf”的其他部分，告訴Apache2 SVN的數據倉庫所在。
（為避免不必要的麻煩，所有路徑中的”\”都請替換成”/”）
注意：

• 按照下述配置，所有數據倉庫將共享密碼文件及權限文件
• 如果需要為每個數據倉庫創建獨立的設置，請查閱SVN的文檔（”Authorization Option”章節）

添加下述內容：

這里涉及到兩個文件: “%SVN_REPO_PARENT%/AccessFile” 及 “%SVN_REPO_PARENT%/passwd”.
并不一定非要放到”%SVN_REPO_PARENT%”目錄下，我圖方便而已。覺得不安全可以移到另外地方。
這兩個文件里面具體內容的設置請參考第16和17步。

15.保存”httpd.conf”并退出，這里Apache2的配置告一段落。

16.”%SVN_REPO_PARENT%/AccessFile”文件的內容

其中：

• [/] 指代所有數據倉庫的根目錄，匿名用戶默認的權限為只讀。
• 對于”user1″和”admin”，他們對所有數據倉庫都有讀寫權限。
• 對于”user2″，它對所有數據倉庫僅有只讀權限。但是下方又額外指定了他對”%PROJECT_NAME%:/src/test”目錄具有讀寫權限。
• 綜上，他對’test’目錄及其子目錄（自動繼承，除非特別指定） 具有讀寫權限，其他則均為只讀權限。

你可以根據需要來設定不同的權限，更詳細的說明還需要參考SVN文檔中的權限設置章節。

17.”%SVN_REPO_PARENT%/passwd”文件的內容
這個文件是通過”%APACHE_HOME%\bin\htpasswd.exe”自動生成的：

此時用文本編輯器打開”%SVN_REPO_PARENT%/passwd”，可以看到里面內容是類似這樣的：

18.把SVN自帶的XSLT文件拷貝到網站根目錄，
然后設置合理權限（windows平臺則不必考慮）

19. 重啟Apache2服務：

20.打開瀏覽器，訪問：http://%SERVER_NAME_OR_IP%/svn/
如果返回的頁面是”403 Forbidden”，可能是由于Apache2默認沒有打開目錄的瀏覽權限（Option Indexes，參閱Apache2文檔），但這并不影響使用。
現在已經可以用客戶端導入項目并開始使用了。
具體步驟，請參閱第20步。

***********************************************
* 注意：以下步驟/命令需要在裝有SVN客戶端的機器上執行 *
* Windows下安裝服務器端的時候已經同時安裝了客戶端 *
* Linux下尚待查證。 *
***********************************************

21.和CVS一樣，SVN在最初的時候需要將已有項目導入到數據庫中。
從命令行執行以下命令（Stand-alone）：

或者（Apache2 module）：

其中：
A) c:\temp\myproject里面包含了你所要導入的項目文件的內容
B) %SERVER_NAME_OR_IP%是SVN Server的名字或者IP地址，上面存有第5步中創建的數據倉庫
C) %PROJECT_NAME%是要導入到的數據倉庫名稱，這里選擇跟項目名一致
D) 參數 m 表明此次導入操作的注釋，SVN的注釋是按每次提交來定義的，導入也是提交的一種。
E) your_username和your_password是第7和17步創建的用戶及密碼，注意該用戶必須對上面的%PROJECT_NAME%數據倉庫有寫權限才能成功。

22.然后，需要從Server端再次checkout到本地：
（這點感覺不是太方便，為啥不做成import的時候有個選項，本地目錄可以自動生成版本信息呢？）

注意：
“co”是”checkout”的一個別名
那個點[.]代表當前目錄，checkout出來的文件會自動放到這個目錄下。也可以改為某個絕對路徑。

23.對于向SVN Serer增加，移動，刪除，或者修改后提交某些文件，參考使用以下命令：

對于上面的客戶端操作，如果安裝了TortoiseSVN，一切就變得簡單多了。
不過這個就要抓圖來說明了。等有空的時候再放上來。

※總結※

使用Eclipse的朋友還可以參考這里： http://subclipse.tigris.org/
它以插件的形式向Eclipse提供了SVN的支持。

另外，具體的設置，參數說明等還是需要自己去查閱SVN的文檔（在安裝server端的時候已經附帶）

參考文獻及資料：
_________________________________________

http://subversion.tigris.org/
http://www-128.ibm.com/developerworks/cn/opensource/os-subversion/
http://www.javayou.com/showlog.jspe?log_id=972