SVN-Importer輕松實現CVS到SVN遷移
本節和大家學習一下用SVN-Importer把CVS遷移到SVN解決方案，通過在學習SVN過程中遇到的一個實例來介紹，希望通過本節的學習，大家能夠掌握用SVN-Importer把CVS遷移到SVN的方法。
最近有一個case，就是要將代碼庫從原先的cvs服務器，遷移到svn服務器。
原先使用過cvs2svn，但需要安裝Python的支持，感覺不那么方便。發現原來還有另一個強大的工具，就是SVNImporter。
SVN-Importer不但支持cvstosvn，而且還支持cvsrcs、pvcs、vss、cc、mks等轉移到svn服務器。此外，SVNImport是純java編寫的小軟件，只要你機子上有jdk，那就可以直接使用了。
SVN-Importer有兩種方案來遷移CVS的版本庫。
1.使用SVN-Importer內置的JavaCVS通過pserver協議來導出數據；
2.使用RCS直接從CVS版本庫文件系統中導出數據。
數據遷移過程分三步。和其它工具類似，都是讀數據、生成DUMP、導入DUMP。整個過程及參數配置都在文檔里寫得比較詳細。
SVN-Importer的安裝和運行很簡單。下載之后解壓到某個目錄即完成安裝。安裝目錄下有一個run.bat文件。運行run.bat的時候要帶2-3個參數。***個參數是操作模式；第二個參數是配置文件；第三個參數指定一個日期，表示僅遷移這個日期之后的數據。
SVN-Importer有3種操作模式：完整、增量和列表。完整模式用于將源VCS的版本庫數據全部導出；增量模式則用在***次的完整模式之后，導出新增加的數據；列表模式只將要導出的數據顯示出來，不實際導出。
至于配置文件，在安裝目錄下已經有一個config.properties作為示例。使用SVNImporter的時候只需要復制一份這個文件，再稍做修改即可。
配置文件中主要分四個部分：
***部分，常規配置，這里選擇源版本庫，設置臨時目錄，以及中間文件的位置等。重要的一些設置如下：
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=SVN-Importer，創建版本庫的用戶名
svnadmin.executable=svnadmin的路徑
svnadmin.repository_path=產生的SVN版本庫路徑
svnadmin.parent_dir=將數據導入版本庫里的哪們目錄。想設置為根目錄，將這個值設置為.（點號）即可；或者可以設置成工程名。trunk、branches和tags都會產生在這個目錄之下。
第三部分是對所選擇的源VCS進行配置，用于導出數據。因為工作中只是為了遷移CVS的數據，所以只用到了導出CVS的兩種配置。稍后說明。
第四部分是對日志文件的一些配置。
***次是直接使用的srcprovider=cvs，通過pserver來導出數據。想對于cvsrcs來說，這個速度要稍慢一些，但是它不需要安裝第三方的工具，只需要使用內置的JavaCVS就行，所以用來導出小項目還是比較好的。而且配置也比較簡單，主要就是CVSROOT中的一些配置。
cvs.class=org.polarion.svnimporter.cvsprovider.CvsProvider
cvs.username=訪問CVS版本庫的用戶名
cvs.password=上面用戶名登錄CVS版本庫時的密碼
cvs.hostname=主機地址
cvs.repository=CVSROOT目錄
cvs.modulename=要導出的工程（或目錄）
cvs.tempdir=存放臨時文件的目錄
用SVN-Importer把CVS遷移到SVN后來考慮到CVS里面的工程都比較大，而且可能需要直接從版本庫文件導出數據（不是通過客戶端去訪問CVS版本庫，而直接訪問版庫的文件），所以又嘗試了使用srcprovider=cvsrcs。這個情況下要用GNURCS來導出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.execvsroot\common\common.sln,v
結果報錯
rlog:cvsroot\common\RCS/common.sln,v:Nosuchfileordirectory
很奇怪，為什么rlog非要塞一個RCS/目錄進去呢？后來在論壇上查到，使用cvsrcs的時候，需要設置環境變量RCSINIT=-x,v/，雖然看不明白是啥意思，不過設置了這個環境變量之后SVN-Importer跑成功了。
為了搞明白這個設置，所以只好去下載了RCS的文檔來查看。在文檔里搜索-x,v/，發現原來是配置RCS處理的文件后綴。未設置的情況下會去RCS子目錄中查找文件。-x是設置后綴的參數,v是CVS版本庫文件的后綴，而/是分隔符，其后沒有東西表示為空。所以這個設置是兼顧,v文件和RCS/兩種情況。
***，由于CVS不能記錄目錄的更改歷史，***導入到SVN后，從HEAD里取出來的數據中有許多原來刪除掉的目錄和文件。感覺多冒出來的那些都應該是些空目錄才對，搞不明白為什么還有一些刪除掉的文件也冒出來了，還不太好找規律。所以，只好先對照從CVS里Checkout出來的***版，刪除掉多余的目錄和文件之后，再Checkin到SVN中，這才算完成遷移過程。本節關于用SVN-Importer把CVS遷移到SVN解決方案介紹完畢。
【編輯推薦】
