最近想把公司原來用CVS管理的代碼遷移到SVN中去。主要是因為SVN是整個版本庫共享一個版本歷史，比較方便完整的Checkout某個工程。而且SVN還有一些CVS所不具有的良好特性，比如支持對目錄版本進行管理，支持重命名和移動等。
　　
　　上網查了下，大部分人用cvs2svn來將CVS版本庫遷移到SVN中。但是cvs2svn似乎要用Python來運行，我向來對這個日本人發(fā)明的腳本不感興趣，所以希望能找到其它方案。最后發(fā)現(xiàn)SVN Importer。SVN Importer不僅可以進行CVS版本庫到SVN版本庫的遷移，而且還可以遷移PVCS、VSS、ClearCase、MKS、StarTeam等VCS（Version Control System，版本管理系統(tǒng)）的版本庫到SVN。

　　大家去Subversion主頁的時候，通常都是直接去的www.subversion.org（subversion.tigris.org）。其實Subversion還有另一個主頁www.subversion.com。.COM站我去得少，卻沒想到一進去最明顯的那個位置就是SVN Importer。這個工具是用Java實現(xiàn)的，需要JRE來運行。而且，由于SVN Importer幾乎都是使用源VCS自帶的命令行工具來導出數據，所以需要安裝源VCS。另外，SVN Importer向SVN導入數據的時候，用的是Subversion的svnadmin，所以還需要安裝Subversion。

　　SVN Importer有兩種方案來遷移CVS的版本庫。

　　1. 使用SVN Importer內置的Java CVS通過pserver協(xié)議來導出數據；
　　2. 使用RCS直接從CVS版本庫文件系統(tǒng)中導出數據。

　　數據遷移過程分三步。和其它工具類似，都是讀數據、生成DUMP、導入DUMP。整個過程及參數配置都在文檔里寫得比較詳細。文檔目前只有英文的，不過目前Subversion中文站（www.subversion.org.cn）正在翻譯SVN Importer的文檔，相信中文文檔不久就會面世。順便打個廣告——請有興趣翻譯的朋友與subversion.org.cn站長聯(lián)系（http://www.subversion.org.cn/index.php?option=com_contact&Itemid=3），申請加入翻譯隊伍。

　　中文文檔出臺之前，總不能就不用SVN Importer吧，所以我就根據個人經驗簡單的介紹下吧。

　　SVN Importer的安裝和運行很簡單。下載之后解壓到某個目錄即完成安裝。安裝目錄下有一個run.bat文件。運行run.bat的時候要帶2-3個參數。第一個參數是操作模式；第二個參數是配置文件；第三個參數指定一個日期，表示僅遷移這個日期之后的數據。

　　SVN Importer有3種操作模式：完整、增量和列表。完整模式用于將源VCS的版本庫數據全部導出；增量模式則用在第一次的完整模式之后，導出新增加的數據；列表模式只將要導出的數據顯示出來，不實際導出。

　　至于配置文件，在安裝目錄下已經有一個config.properties作為示例。使用SVN Importer的時候只需要復制一份這個文件，再稍做修改即可。

　　配置文件中主要分四個部分：

　　第一部分，常規(guī)配置，這里選擇源版本庫，設置臨時目錄，以及中間文件的位置等。重要的一些設置如下：

　　srcprovider=源VCS，可以是cvs、cvsrcs、pvcs、vss、cc、mks等
　　import_dump_into_svn=yes或no，是否在生成DUMP文件之后立即導入SVN中（選否則不導入）
　　full.dump.file=完整模式時生成的DUMP文件路徑
　　incr.dump.file=增量模式時生成的DUMP文件路徑
　　incr.history.file=歷史文件路徑，這個文件在第一次完整模式時生成，以后使用增量模式時需要讀取其內容。

　　第二部分是SVN相關的設置，主要包括svnadmin的位置和版本庫中的一些設置。關鍵設置如下：

　　trunk_path=/trunk，主分支所在目錄
　　branches_path=/branches，分支目錄
　　tags_path=/tags，標簽保存目錄
　　svnimporter_user_name=SvnImporter，創(chuàng)建版本庫的用戶名
　　svnadmin.executable=svnadmin的路徑
　　svnadmin.repository_path=產生的SVN版本庫路徑
　　svnadmin.parent_dir=將數據導入版本庫里的哪們目錄。想設置為根目錄，將這個值設置為.（點號）即可；或者可以設置成工程名。trunk、branches和tags都會產生在這個目錄之下。


　　第三部分是對所選擇的源VCS進行配置，用于導出數據。因為工作中只是為了遷移CVS的數據，所以只用到了導出CVS的兩種配置。稍后說明。

　　第四部分是對日志文件的一些配置。

　　第一次是直接使用的srcprovider=cvs，通過pserver來導出數據。想對于cvsrcs來說，這個速度要稍慢一些，但是它不需要安裝第三方的工具，只需要使用內置的Java CVS就行，所以用來導出小項目還是比較好的。而且配置也比較簡單，主要就是CVSROOT中的一些配置。

　　cvs.class=org.polarion.svnimporter.cvsprovider.CvsProvider
　　cvs.username=訪問CVS版本庫的用戶名
　　cvs.password=上面用戶名登錄CVS版本庫時的密碼
　　cvs.hostname=主機地址
　　cvs.repository=CVSROOT目錄
　　cvs.modulename=要導出的工程（或目錄）
　　cvs.tempdir=存放臨時文件的目錄

　　后來考慮到CVS里面的工程都比較大，而且可能需要直接從版本庫文件導出數據（不是通過客戶端去訪問CVS版本庫，而直接訪問版庫的文件），所以又嘗試了使用srcprovider=cvsrcs。這個情況下要用GNU RCS來導出CVS數據，所以需要安裝RCS（http://www.gnu.org/software/rcs/rcs.html）。

　　RCS目前最新是5.7版，分3個包下載，分別是rcs57pc1、rcs57pc2和rcs57pc3。這3個文件包分別是編譯好的二進制文件、文檔和源碼。其實只需要下載第一個包就行了，需要用到的也只是bin目錄下的rlog和co兩個命令而已。相關配置大概有：

　　cvsrcs.class=org.polarion.svnimporter.cvsprovider.CvsRcsProvider
　　cvsrcs.repository_path=CVS版庫文件目錄
　　cvsrcs.rlog_command=rlog命令的路徑
　　cvsrcs.co_command=co命令的路徑
　　cvsrcs.tempdir=保存臨時文件的目錄

　　配置好之后，一開始每次運行都失敗，看日志也不知所云。大概是說某個文件沒找到。于是決定手工運行rlog.exe來試試看。

　　rlog.exe cvsroot\common\common.sln,v

　　結果報錯

　　rlog: cvsroot\common\RCS/common.sln,v: No such file or directory

　　很奇怪，為什么rlog非要塞一個RCS/目錄進去呢？后來在論壇上查到，使用cvsrcs的時候，需要設置環(huán)境變量RCSINIT=-x,v/，雖然看不明白是啥意思，不過設置了這個環(huán)境變量之后SVN Importer跑成功了。

　　為了搞明白這個設置，所以只好去下載了RCS的文檔來查看。在文檔里搜索-x,v/，發(fā)現(xiàn)原來是配置RCS處理的文件后綴。未設置的情況下會去RCS子目錄中查找文件。-x是設置后綴的參數,v是CVS版本庫文件的后綴，而/是分隔符，其后沒有東西表示為空。所以這個設置是兼顧,v文件和RCS/兩種情況。

　　最后，由于CVS不能記錄目錄的更改歷史，最后導入到SVN后，從HEAD里取出來的數據中有許多原來刪除掉的目錄和文件。感覺多冒出來的那些都應該是些空目錄才對，搞不明白為什么還有一些刪除掉的文件也冒出來了，還不太好找規(guī)律。所以，只好先對照從CVS里Checkout出來的最新版，刪除掉多余的目錄和文件之后，再Checkin到SVN中，這才算完成遷移過程。