Subversion for Windows 安裝指南 （1）

作者:蔡煥麟
huanlin.tsai at msa.hinet.net
Revision: 1.3  (Aug-17-2004)
1 簡介

Subversion 是一個版本控制系統，它是根據 CVS（Concurrent Versions System）的功能為基礎來設計，但是改進了一些 CVS 的缺點，例如：在 CVS 中搬移檔案目錄很不方便，Subverion 則連目錄的異動都納入版本管理；此外，它也增加了其他的功能，例如：不可分割的送交（如同資料庫交易的概念，送交多個檔案時，若有任何一個檔案失敗，則這次送交的所有檔案都不會進入檔案庫中）、支援多種網路協定、一致的檔案差異比對（不管什麼檔案類型，均使用二進位差異比對方式）....等等。

由於目前手邊查到的 Subversion 文件，主要都是針對 Linux 用戶來撰寫，所以這份文件特地針對 Windows 環境下安裝 Subversion 的步驟來說明，希望透過這份文件，能夠幫助你很快的把 Subversion 安裝起來。

在安裝過程中，會需要輸入一些命令列的指令，我不會詳細解釋某些指令的用途和意義，因此你除了要熟悉 DOS 的基本指令，還應該隨時查閱 Subversion 的電子書（有中文版），以了解 Subverion 命令列工具的使用方法。圖形化介面雖然方便，但是熟悉命令列工具的使用，才能讓你得到完全的自由。
1.1 閱讀基本觀念

如果你缺乏版本控制系統的基本觀念，就算能夠順利安裝好 Subversion，可能安裝完成後就不知道下一步怎麼做了。這裡只簡單的提一點必要的基礎觀念，記住你最終還是得閱讀 Subversion 的官方文件。
1.2 作業環境與軟體版本

以下是筆者安裝 Subverion 的作業環境與軟體版本：

    * Windows 2000 Server with SP4
    * Apache HTTP Server v2.0.50
    * Subversion v1.0.5
    * TortoiseSVN 1.0.6 build 1200

2 安裝與建立 Subversion 伺服器

本節介紹安裝 Subversion 所需的步驟，請準備一台穩定的機器，作為 Subversion 的伺服器。
2.1 安裝 Apache HTTP Server

到 http://httpd.apache.org 下載 Apache HTTP Server 2.0 版 for Windows 的安裝程式，我下載的檔案是 apache_2.0.50-win32-x86-no_ssl.msi。

下載之後直接安裝，安裝過程很簡單，就不贅述了，但安裝之前請先檢查你的電腦是否有安裝 IIS，由於 Apache 預設使用 80 port，會跟 IIS 的網站衝突，你必須把 IIS 的 Web 站台關閉，再安裝 Apache HTTP Server。

安裝完成以後，開啟瀏覽器，瀏覽網址 http://127.0.0.1 看看有沒有出現安裝成功的網頁。
2.2 安裝 Subversion

   1. 到 http://subversion.tigris.org/ 下載最新版的 Subversion，你可以下載 .zip 或者打包好的自動安裝程式，我下載的是檔案 svn-1.0.5-setup.exe。
   2. 下載後直接安裝，安裝過程都是下一步，沒什麼特別的。安裝完成後，連必要的環境變數都幫你設定好了（如果你下載的是 .zip 檔，就要自行設定）。
   3. 把 /httpd/ 目錄下的 mod_dav_svn.so 和 mod_authz_svn.so 複製到 /modules/ 目錄下。
   4. 把 /bin/ 目錄下的 libdb42.dll、libeay32.dll、以及 ssleay32.dll 複製到  底下的 bin 或 modules 資料夾。
   5. 接著用文書編輯器開啟 Apache HTTP Server 的 httpd.conf（在 /conf/ 目錄下），尋找一堆 LoadModule 指令，先找到以下兩行：

      #LoadModule dav_module modules/mod_dav.so
      #LoadModule dav_fs_module modules/mod_dav_fs.so

      把前面的 '#' 字元刪除，然後把下面幾行文字加到這群 LoadModule 指令的後面：

      LoadModule dav_svn_module modules/mod_dav_svn.so
      LoadModule authz_svn_module modules/mod_authz_svn.so
      　
   6. 重新啟動 Apache HTTP Server。

問題排除

如果 Apache HTTP Server 無法啟動，請依下列步驟檢查：

   1. 檢查 Subversion 的路徑是否有在系統的 %PATH% 環境變數裡面。
   2. 檢查你加入 httpd.conf 裡的項目是否正確，記住 mod_dav_svn.so 和 mod_authz_svn.so 必須在其他 mod_dav*.so 模組之後載入。

2.3 設定 Subversion 檔案庫的路徑

現在要設定 URL 路徑與檔案庫實體路徑的對應關係。對應的方式有兩種，分別是 SVNPath 與 SVNParentPath。
2.3.1 SVNPath

SVNPath 適合用來個別指定檔案庫的路徑，語法是：


    DAV svn
    SVNPath /absolute/path/to/repository


其中 "/svn/repos_name" 就是用戶端存取特定檔案庫的 URI（Uniform Resource Indentifier），SVNPath 後面指定的路徑則是檔案庫的絕對路徑，假設我們的檔案庫實際存放的路徑是 d:/svn/MyProject，並且希望用戶端使用 " http://myserver/svn/myprj" 的 URL 來存取檔案庫，那麼要加入 httpd.conf 的內容就是：


    DAV svn
    SVNPath d:/svn/MyProject


注意 Location 標籤後面的 /svn/myprj 的第一個斜線不可少！
2.3.2 SVNParentPath

如果你的檔案庫都集中放在某個目錄之下，例如：d:/svn，那你就可以使用 SVNParentPath 的方式指定檔案庫的根路徑，例如：


    DAV svn
    SVNParentPath d:/svn


這表示可以讓任何人都可以透過 http://myserver/svn/ 的方式，存取位於 d:/svn 這個目錄以下的所有檔案庫。也就是說，這個設定動作只需要一次，如果使用 SVNPath，你必須為各個檔案庫分別指定對應的路徑。

以上兩種設定方式都可以，方便起見，這裡我用 SVNParentPath 來統一指定所有檔案庫的父層 URL 路徑。

將  的設定加到 Apache HTTP Server 的 httpd.conf 檔尾就行了。

接著便可以開始建立檔案庫。
2.4 建立檔案庫

假設我們要把所有的檔案庫都放在 d:/svn 目錄下，現在要建立一個測試用的檔案庫，名稱叫做 在 repository，指令為：

md d:/svn
svnadmin create d:/svn/repository

命令執行完後，檢查看看 d:/svn/repository 目錄底下產生了哪些目錄和檔案。
警告

檔案庫絕對不可以在建立在任何遠端的儲存媒體上，例如：網路磁碟機。

這時候你已經建立了一個檔案庫，你可以先在本機用瀏覽器測試一下，網址輸入 http://svn/repository，看看能不能看到檔案庫的內容，正常的話應該像下圖一樣。

如果以上的測試可以通過，應該就行了。如果你還想要測試一下能不能從檔案庫取出整個工作複本，可以執行下列指令（非必要）：

c:
cd/temp
svn co http://localhost/svn/repository WholeRepos

上述指令會切換到一個暫時的目錄 c:/temp，然後從檔案庫取出整個工作複本。最後一行指令是要 svn.exe 執行 check out 動作（縮寫 co），如果正確的話，應該會顯示 "Checked out revision 0." 的訊息，此時 /svn/repository 這個檔案庫底下的所有檔案目錄都已經取出，並且複製一份到 c:/temp/WholeRepos 目錄下了。
問題排除

如果顯示的錯誤訊息是：

svn: PROPFIND request failed on '/svn/repository'
svn: PROPFIND of '/svn/repository': 405 Method Not Allowed ( http://localhost)

請檢查 Apache HTTP Server 的 httpd.conf 檔案裡面的  標籤x的位置是否跟你指定的 URL 樣式相同，注意一定要完全相同，以上面的例子而言，你的 httpd.conf 的最後面應該會有以下文字：


    DAV svn
    SVNPath 指向檔案庫的絕對路徑


如果顯示的錯誤訊息是：

svn: PROPFIND request failed on '/svn/repository'
svn:
Could not open the requested SVN filesystem

那表示在 /svn 對應的實體目錄（即 d:/svn）下找不到 reposiroty 這個目錄。

註：PROPFIND 是給 WebDAV 用的 HTTP method，用來從資源中取得屬性。

測試完畢就可以把 WholeRepos 這個目錄整個刪掉了。

到目前為止，可以確定檔案庫已經建立完成，接下來就可以匯入專案了。