OpsHub Visual Studio Online Migration Utility


This migration utility helps customers to migrate the most commonly requested data from an on-premises Team Foundation Server to their Visual Studio Online account. It is designed for basic migration scenarios to migrate history of version control changesets, work items etc.

(16) Review
Visual Studio
2013, 2012, 2010
Download (9,570)
E-mail Twitter del.icio.us Digg Facebook
Add to favorites
Reviews (16)
Q and A (48)
Sign in to write a review
Sort by:

by eXavier_777 | Tue 10:33 AM

I'm giving 1 star as this tool does not support migration of projects using Scrum v1.0 process template. However, I haven't tried other templates. We just don't use them.

by JohnLBevan | April 02 2015

Great tool. Doesn't do everything (e.g. no ability to auto create missing user accounts, or add lookup values to templates), but what it does do (migrating the bulk of TFS data) it does very well.

by Ryan Adler | February 19 2015

We have done some testing with the tool, and while it seems that it generally works, we have some showstopper issues.

1) For some reason, it is extremely slow - OpsHub is looking into the issue, but we currently estimate a 9-day migration time for 5 Team Projects with a decent amount of changesets and work items.
2) More of an issue, though, is that the dates of Work Item Closed Dates, etc. as well as the Changeset dates are not migrated. This means that we cannot run realistic reports after migration or effectively track code changes.

I realize that issue #2 is not really in the hands of DevOps, but it would be nice to see a fully supported migration path from Microsoft where all available data is migrated. Otherwise, at least in our case, we cannot get started with VSO. There will simply be too large of an overhead after migration to do this.

Sandeep Jain (OpsHub) February 20 2015
| Edit |

On #1, The migration speed is dependent on number of revisions, connectivity speed, the speed of end point and size of changesets and attachments (as they need to be transferred over the network to VSO).

On #2, The current VSO (and TFS) API doesn't allow us to set those attributes on a write. Hence the limitation.

by Adam Plocher | February 16 2015

Works well if you have a vanilla install of TFS and a brand new VSO instance with admin rights for both.

If you need any advanced customizations beyond that (e.g., being able to cloak incoming folders, re-base your import under a sub-folder, select only a subset of changesets to import, etc) I don't think you will be able to. It only includes the most basic settings: an instance of TFS to import from, an instance of VSO to export to.

It also has the tendency to fail easily. I had a very old TFS instance that had been upgraded from 2008 to 2010 and then again 2012. I'm not sure if it failed due to some corruption in TFS (it worked fine for us through VS), or if it was due to some historic branching issues. It also seems to need a lot of permissions.

Overall, it's the best product available, and you can't beat the price (free), but it can be problematic and require a little tweaking to get just right.

by ssloan_lacrossecounty | January 26 2015

Amazing Tool, has saved our team countless hours.

by K Dahl | January 19 2015

Not very flexible.

Couldn't get it to migrate any work items on two very simple repos (used by one or two person teams only). We were only able to do the vc history with the tool.

Sandeep Jain (OpsHub) January 20 2015
| Edit |

The utility is not designed to migrate from customized templates on TFS side. If you have customized templates on TFS side, the utility will give an error. If you are getting any other error please post it in Q&A section and we will help you in resolving it.

by christianarg | December 15 2014

Excellent tool. We had a few issues at first but the OpsHubs support was excellent and they helped us with everything. Recommended

by ENSOLCONS | December 12 2014

Although the first run of the utility was a bit time and memory excessive, the team managed to fix it and now we have migration completed without memory bloating.

by JohnBenes | November 18 2014

I used this tool to migrate from an old TFS server to Visual Studio Online and it worked great. I also found the OpsHub support to be outstanding. I recommend using this tool.

by codingoutloud | June 30 2014

Thank you - very nice tool. Considering the complexity of what you undertook and the amount of work it saved me (and many others), this was a 5 star effort.

by DKube | June 17 2014

This is a Java application, and I almost installed it. Luckily for me that I looked at the proxy installation... No Java on my machine!!

Sandeep Jain (OpsHub) June 18 2014
| Edit |

Yes. The application uses Java (and C#)among other things. Java is bundled in and the application (and Java) can be uninstalled after migration is completed.

by d1820 | May 16 2014

Tried running the installer numerous time, could not get the utility to work. nothing ever got created in C:\Program Files\OpsHub\

Hopefully there will be a Microsoft supported one in the near future to help migrate.

Sandeep Jain (OpsHub) May 20 2014
| Edit |

If you have any problem with the utility, please create a question on stackoverflow (www.stackoverflow.com) with tag opshub.
OpsHub support team monitors that tag and answers as appropriate.

by Anil Desai | May 16 2014

Worked very smoothly and completely migrated ~15 realtively simple projects and ~1,300 changesets. After configuring online security and mapping logins, the process couldn't have been much smoother. The only issue I've noticed so far is that check in timestamps for revisions will be set to the time of migration check-in; however, the comments have the original check-in user and original timestamp. Overall, this is an excellent utility - highly recommended for moving collections from TFS to Visual Studio Online!

by CastorTroy0606 | May 16 2014

Word. If you don't like it you have no idea what you are doing.

by El Bruno | May 14 2014

Amazing app! Thanks

by Ed Blankenship | May 12 2014

Sign in to start a discussion

  • Do you plan to support Scrum v1.0 process template?
    2 Posts | Last post 12:44 AM
    • I wanted to migrate project from TFS 2010 with default, not customized, Scrum v1.0 process template but the tool complains about "Template Customization or Template Mismatch error".
      In previous Q&As I noticed there was some plan to support Scrum v1.0 and was scheduled on February's release. As of September 2015 it is still not available. Can you please update us on its status?
    • This is supported but requires some admin operations upfront before running the utility.
      Please look at http://stackoverflow.com/questions/27926927/migrating-tfs-2010-to-visual-studio-online
  • ERROR Object reference not set to an instance of an object.
    2 Posts | Last post July 24, 2015
    • When the migration utility tries to pull up the list of available projects, I get the error below.  Things I have confirmed:
      1) Running the latest ( I think ) version of the utility - V1.3.000B000
      2) Migrating from TFS2010
      3) My VSO user IS in the "[DefaultCollection]\Project Collection Service Accounts" group
      4) I have created a project in VSO with the exact same name as the one I am migrating
      5) When managing endpoints, the "Team Project Collections" display for both servers, indicating that it does appear to be connecting/authenticating correctly
      6) Tried deleting VSO project to switch from Scrum ( desired type ) to Agile, since source project is "MSF for Agile Software Development - v4.2"
      Thank you in advance for your help.
      2015-07-22 23:14:36,677 [1] ERROR Object reference not set to an instance of an object.
      System.NullReferenceException: Object reference not set to an instance of an object.
         at TFSMigrationUI.ViewModel.ProjectSelectionViewModel.loadProjectWorker_RunWorkerCompleted(Object sender, RunWorkerCompletedEventArgs e) in e:\OVSMUBranch\TFSMigrationUI\ViewModel\ProjectSelectionViewModel.cs:line 324
         at System.ComponentModel.BackgroundWorker.OnRunWorkerCompleted(RunWorkerCompletedEventArgs e)
         at System.Windows.Threading.ExceptionWrapper.InternalRealCall(Delegate callback, Object args, Int32 numArgs)
         at System.Windows.Threading.ExceptionWrapper.TryCatchWhen(Object source, Delegate callback, Object args, Int32 numArgs, Delegate catchHandler)
    • Never mind - I was mistaken.
      We are running TFS2008, which is unsupported.
  • TFS31003 Due To Old IE 8
    2 Posts | Last post June 26, 2015
    • I was trying to configure a connection to a TFS Online site but kept getting the TFS31003 error when defining the target endpoint in the utility.  This was on a Windows 2008 R2 server that still had IE 8 installed. 
      Eventually tried upgrading IE on the server to IE 10 and that solved the problem.  The IE version is not listed in the utility requirements but IE 8 should be upgraded to make a TFS Online connection.
    • Paul. Thanks for the feedback. We will incorporate this limitation in the documentation.
  • Slow to get started
    2 Posts | Last post June 26, 2015
    • We've started a migrate today, about a dozen projects, OpsHub is sitting saying Migration: Fetching. 0/1041 Revisions passed. Sql is maxing out one core, OpsHub using all ram spare, about 6gb. TFS db is just over 1gb. Any idea of how long we are looking for this migration to take? From what I can see, it's not sending anything to vs.com yet, so not a network bottleneck?
    • How long has the utility been running? Can you please refer and share the logs at "C:\Program Files\OpsHub Visual Studio Online Migration Utility\logs". Logs would be recoding the process the utility is performing currently. Send olgs to ovsmu at opshub dot com
  • 32 bit version of VSO Migration Utiity
    2 Posts | Last post June 17, 2015
    • Hello Sandeep,
      If I have a 32 bit version of the OS, am I out of luck? The kind of scenario I have a work is, that I can't re-install the OS on the machine, and there is no other machine that is able to access my source TFS server. I welcome any suggestions/recommendations, if any.
    • Waqas, Currently only 64 bit version is available.
  • Project is using 'Git Version Control' in your Visual Studio Online.
    4 Posts | Last post April 28, 2015
    • Even though my VSO project is using 'Team Foundation Version Control', the tool is saying that is is using 'Git Version Control' when trying to migrate version control data. I could have sworn this worked a few weeks ago. 
      Error details: '[project-name]' is using 'Git Version Control' in your Visual Studio Online. Version Control migration for Git repository is not supported. So either choose only to migrate your work item data or create a new 'Team Foundation Version Control' based project with the same name in your Visual Studio Online and try again. 
    • This is usually encountered when the User through which the Migration Utility is connecting to VSO does not have enough permission to access that project (or is not a Team Member for that project). Microsoft TFS API does not directly provide the information regarding the Project's Source Control Type and this is done through a different detection algorithm that OpsHub implements. Wherein, not having access to the project through Source Control API too is regarded as the project having GIT Version Control.
      Could you please verify if the user has permissions as required in the per-requisite document for the utility?
    • Thanks, that's what it was. I tried to import with another user who was an admin but I forgot to update the 'Account owner' of the VSO account. Once I did that, everything started to work again.
    • Please provide URL of "per-requisite document for the utility". Thanks
  • OH-SCM-009: Error occurred while sync. No files checked in.
    3 Posts | Last post April 20, 2015
    • We have been working on migrating from TFS2010 to VSO for the last week.
      First we ran out of space on the SSD used; there where 27 GB in TFS_Temp?! as a workaround we have symlinked the directory to a 1 TB drive; seems to work.
      Saturday we had cleaned up some reference problems with 3 of our earliest workitems and started again.
      It went through the workitems in about 6 hours and started on the code.
      Around 2:30 the code migration ran into problems; 
      OH-SCM-009: Error occurred while sync. No files checked in.
      From what I can see it is changeset 1105… it was a big merge to Main; as we had moved to Silverlight 5 on the branch.
      But it is not clear to me what the problem is…?!
      FYI I have sent you a mail with logfiles attached and additional information.
    • I have the same issue ... What did you do ?
    • http://stackoverflow.com/questions/29746918/oh-scm-009-error-occurred-while-sync-no-files-checked-in
  • Migration from TFS On Premise to Visual Studio Online Hangs
    2 Posts | Last post April 07, 2015
    • Hi,
      My Dev Team is attempting to migrate a TFS 2013 Project to Visual Studio Online.We start the utility, go through set up steps, map users, and then start the migration, and it looks like it just hangs with no updates (visually atleast) once the migration begins. We let it run over night, yet no change. Is this by design, any help would be appreciated.
    • Also looking at the logs we get this common error, which points to a security context being lost or something in that manner, but we were able to setup the entire migration, so connection with the tfs server with the creds was successful: 
      Failed to login to Team Foundation Server : 'Server Url' with user : null. Server Error : ; nested exception is: 
      	java.net.ConnectException: Connection refused: connect. You may have given wrong credentials or credentials are not valid now.
      	at com.opshub.eai.tfs.adapter.TFSClient.<init>(TFSClient.java:92)
      	at com.opshub.eai.tfs.adapter.TFSAdapter.<init>(TFSAdapter.java:111)
      	at com.opshub.eai.tfs.adapter.TFSActionHandler.getOIMConnector(TFSActionHandler.java:82)
  • Template mismatch
    5 Posts | Last post April 03, 2015
    • Hi
      We've been struggling with template mismatch errors. We have tried to migrate unmodified existing Agile & CMMI projects, without success. 
      We tried creating a new Agile (2013.3) project on premise & VSO, created one work item and tried to migrate that, but still receive template mismatch errors (it seems for every work item type). 
      Trying to import a work item definition (Bug) from VSO to on premise, we get the error "The field Microsoft.VSTS.TCM.ReproSteps cannot be renamed from 'ReproSteps' to 'Repro Steps'."
      Any suggestions as to what we can do to move forward?
    • Can you send us screen shot of the errors in UI (may need multiple screenshots)
      Also from where you have downloaded template?
      Can you send us log located at <OpsHub Installation Directory>/logs
      Please email all the information to ovsmu@opshub.com
    • Sandeep - we had the same issues, but we did not download any template. We used the default Scrum/Agile templates that come with TFS, and also couldn't get any of our work items to work in the migration. It said there was a template mismatch error. The only other factor I can think of is that our local TFS was originally a 2010 install, and upgraded to 2013.
    • Are you using Scrum template (from TFS2010). If so, support for it was missed in the current version. A new version of the utility which will be out in early feb will have this support. 
      If you are not using scrum template, please send us screen shots of the errors along with template versions to ovsmu@opshub.com
    • Sandeep,
      I am also having issues with migrating a from Scrum template (from TFS2010). Your earlier reply mentions an early Feb upcoming release that should resolve this issue. Will this be available soon?
  • Moving Shelvesets
    2 Posts | Last post March 26, 2015
    • My team is starting to migrate our projects over, but it looks like our shelvesets are not transferring over. Are they not covered by this utility, or is there something special we need to do to move them?
    • Yes. The utility does not migrate shelve sets.
1 - 10 of 48 Items