近想把公司原来用软件测试的配置管理-CVS管理的代码迁移到SVN中去。主要是因为SVN是整个版本库共享一个版本历史,比较方便完整的Checkout某个工程。而且SVN还有一些CVS所不具有的良好特性,比如支持对目录版本进行管理,支持重命名和移动等。

  上网查了下,大部分人用cvs2svn来将CVS版本库迁移到SVN中。但是cvs2svn似乎要用Python来运行,我向来对这个日本人发明的脚本不感兴趣,所以希望能找到其它方案。后发现SVN Importer。SVN Importer不仅可以进行CVS版本库到SVN版本库的迁移,而且还可以迁移PVCS、VSS、ClearCase、MKS、StarTeam等VCS(Version Control System,版本管理系统)的版本库到SVN。

  大家去Subversion主页的时候,通常都是直接去的www.subversion.org(subversion.tigris.org)。其实Subversion还有另一个主页www.subversion.com。.COM站我去得少,却没想到一进去明显的那个位置是SVN Importer。这个工具是用Java实现的,需要JRE来运行。而且,由于SVN Importer几乎都是使用源VCS自带的命令行工具来导出数据,所以需要安装源VCS。另外,SVN Importer向SVN导入数据的时候,用的是Subversion的svnadmin,所以还需要安装Subversion。

  SVN Importer有两种方案来迁移CVS的版本库。

  1. 使用SVN Importer内置的Java CVS通过pserver协议来导出数据;

  2. 使用RCS直接从CVS版本库文件系统中导出数据。

  数据迁移过程分三步。和其它工具类似,都是读数据、生成DUMP、导入DUMP。整个过程及参数配置都在文档里写得比较详细。文档目前只有英文的,不过目前Subversion中文站(www.subversion.org.cn)正在翻译SVN Importer的文档,相信中文文档不久会面世。顺便打个广告??请有兴趣翻译的朋友与subversion.org.cn站长联系(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的时候只需要复制一份这个文件,再稍做修改即可。

  配置文件中主要分四个部分:

  第一部分,常规配置,这里选择源版本库,设置临时目录,以及中间文件的位置等。重要的一些设置如下:

  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,创建版本库的用户名

  svnadmin.executable=svnadmin的路径

  svnadmin.repository_path=产生的SVN版本库路径