Search code examples
svnmigrationrepositoryexternals

How to migrate all URLs in svn:externals properties across a repository?


We are in the process of moving our SVN repositories from one machine to another one, and with it will come a new domain name for the new repo. The problem is, that within the repository, there are lots of svn:externals references to other projects within the repository. So for example, we have projectA, which has in the svn:externals properties:

external/libraryA svn://oldserver.net/repo/libraryA
external/libraryB svn://oldserver.net/repo/libraryB

...and so on. All of the URL's reference this particular domain name, so it can be easily parsed. Having already learned my lesson, I will migrate these URLs to be "svn://localhost/", but I need to find a way to go through the repository history and rewrite all of the old URLs, so that we can still check out older revisions of these projects without having broken links.

How would I go about doing this?


Solution

  • As you indicated that you still want to be able to check out older revisions, the only solution is really to "rewrite" the entire history (solution D mentioned earlier).

    To do this, you should:

    1) Dump the contents of the entire repository using svnadmin dump:

    $ svnadmin dump /path/to/repos > original-dumpfile
    * Dumped revision 0.
    * Dumped revision 1.
    * Dumped revision 2.
    * Dumped revision 3.
    

    2) Edit the dump file, to change the svn:externals URLs. This is the most difficult part: Assuming the repository contains binary data as well, opening the dump file in a plain text editor will most likely corrupt the dump file. I've had good experiences using a so-called "hex-editor", for instance the Freeware Hex Editor XVI32

    3) Create a new repository and load the modified dumpfile into it:

    $ svnadmin create newrepos
    $ svnadmin load newrepos < modified-dumpfile
    

    For more information, you might also be interested in this link:
    http://svnbook.red-bean.com/en/1.1/ch05s03.html

    NOTE: Subversion 1.5 actually added support for relative URLs in the svn:externals property, which can precisely prevent these sort of problems in the future:
    http://subversion.tigris.org/svn_1.5_releasenotes.html#externals