Documentation

Getting Started

System Requirements

Before You Start

Svn2tfs Settings:

 

Subversion 6.x:

  • URL:
    • This is the URL to the repository on your Subversion server. The URL cab be in the form:
      • https://SvnServer/svn/repository – The most common way of accessing the subversion server.
      • http://SvnServer/svn/repository – Less common, but some servers are set up with a plain http:// setup
      • file://SvnServer/RepositoryShare – Alternate method of connecting to a repository. If the repository folder is shared or the user has access to the folder on the server (in this example, the share name is “RepositoryShare”), it is possible to connect this way as well.
  • Path:
    • This is the directory path to your project that you want to import.
    • If you are importing:
      • The entire Subversion repository - Leave this blank.
      • A certain trunk or tag of a project - Enter in the path, starting with a slash ‘/’ e.g. “/project/trunk”
  • Username:
    • This is the username of the account that you are going to use to connect to the subversion server.
    • The user should have at a minimum full read access to the portions of the repository that are being accessed
  • Password:
    • The password associated with the username.
  • From Revision:
    • Typically this is by default “1”
    • If you are importing:
      • The entire Subversion repository - Leave this as “1”
      • (Advanced) A certain trunk or tag or revision of a project - Enter in the revision here.
        • Typically this would be used if you have already imported the whole repository, and you need to update TFS with a more recent revision.
        • Or, if you want to do incremental load of the repository into TFS, you would use this in combination with the “To Revision:” field to import portions of the repository.
  • To Revision:
    • Typically this is by default “HEAD”
    • If you are importing:
      • The entire Subversion repository - Leave this as “HEAD”
      • (Advanced) A certain trunk or tag or revision of a project - Enter in the revision here.
        • Typically this would be used if you only want to import up to a certain revision.
        • Or, if you want to do incremental load of the repository into TFS, you would use this in combination with the “From Revision:” field to import portions of the repository.
When all Subversion fields have been filled out, click the Validate SVN button. Review the output. A successful connection looks like:
Testing SubVersion connection...
Connecting to SubVersion... Connected.
There are 21484 revisions.

An unsuccessful connection looks like:
Testing SubVersion connection...
Connecting to SubVersion... 
Failed: Unable to open an ra_local session to URL

In this instance, the URL to the server was incorrect.

User Mapping

  • User map file:
    • Click the Open... button. Browse for the location of the XML usermap file that you have created.
    • Here is an example of the map file:
<?xml version="1.0"?>
<ArrayOfUserMap xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <UserMap>
    <SvnUserName>svnUser1</SvnUserName>
    <TfsUserName>tfsUser1</TfsUserName>
  </UserMap>
  <UserMap>
    <SvnUserName>svnUser2</SvnUserName>
    <TfsUserName>tfsUser2</TfsUserName>
  </UserMap>
</ArrayOfUserMap>


After loading the Usermap file, you will get the following message in the output window:
User mapping file changed. You may check if all users are mapped pressing the SubVersion 'Check' button.

Click on the Validate SVN button. This will validate the usermap file against the SVN users in the repository. Note: If you have a large repository with a lot of revisions, this may take a long time to validate. This is normal. If you are missing any users in your usermap file, they will show up in the output like this:
Testing SubVersion connection...
Connecting to SubVersion... Connected.
There are 21484 revisions.
Loading user map file...
Searching involved users from r1 to r21484... (this might take a while)
User2 (User not mapped)
User3 (User not mapped)


Click Here: Creating the User Map file. And also shoand how to find all Subversion users.

Team Foundation 2010

After all fields have been filled in, click on the Validate TFS button. Review the output. A successful connection looks like:
Testing Team Foundation Server connection...
Connecting to Team Foundation Server... Connected as UserName.
Reading project collections list...
Found project collection: 'Project Collection'.
Reading team projects list...
Found project 'Project 01'.

Connected to team project successfully.

Import

After all the settings have been set, and validated without errors, click on the Import button to begin the import process. For large repositories and repositories with a many revisions, this process will take some time.
If you encounter any errors, please Click Here: Frequently Asked Questions

Last edited Mar 3, 2011 at 5:56 PM by kminchau, version 20

Comments

No comments yet.