1. TFS Database Import Service for Visual Studio Team Services
BRK3199
TFS Database Import Service for Visual Studio Team Services
Rogan Ferguson & Dan Hellem
Program Managers
© Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

2. Importing at a High Level
There will be a lot of demos during this presentation!

3. Shell Completely Migrated to VSTS
Microsoft 2016
6/20/2018 4:01 AM
Shell Completely Migrated to VSTS
“The transition to the cloud was absolutely painless, and within 24 hours we were online and back in action.”
– Shell Senior Software Developer
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

4. Demo Rogan Ferguson 6/20/2018 4:01 AM
© Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

5. TfsMigrator

6. Visual Studio Team Services
Phase 4: Validate
Making sure your collection is ready to import
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

7. Visual Studio Team Services
TfsMigrator Validate
Why is Validating Required?
How Does it Work?
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

8. Visual Studio Team Services
Validation Process
Run a Validation
Fix and Conform
Run Validation Again
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

9. Process Customization
Visual Studio Team Services
6/20/2018 4:01 AM
Process Customization
Hosted XML
Legecy XML
Import process through Web UI or REST API
Each project has it’s own process
No witadmin
Inherited
All customization is done through web UI
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

10. Process Customization
Visual Studio Team Services
6/20/2018 4:01 AM
Process Customization
How it works with data import
Loop through each and every project
If the project has been customized = Hosted XML
If the project has not been customized (OOB) = Inherited
* use PowerShell scripts to conform a project to be OOB
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

11. Checking the right logs
Visual Studio Team Services
6/20/2018 4:01 AM
Checking the right logs
TfsMigrator.log
Makes sure you are compatible with data import.
TryMatchOobProcesses.log
Identifies issues for projects you are trying to map to OOB process.
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

12. Visual Studio Team Services
Common Process Errors
Configure Features After Upgrade
“Required element PortfolioBacklog is missing from Process Configuration.”
“ProcessConfiguration doesn't specify required TypeField Effort.”
Resource:
Elements that are Not Supported
“User or group cannot be found.”
“Field rule attributes "for" or "not" aren't supported.”
“Custom link type My.LinkTypes.Foo is invalid because custom link types aren't supported.”
Over the Limits
“You've defined 514 items in global list VersionNumbers. A maximum of 512 is allowed.”
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

13. 6/20/2018 4:01 AM
Demo
Dan Hellem
© Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

14. Visual Studio Team Services
Phase 5: Get Ready
Preparing for import
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

15. Visual Studio Team Services
TfsMigrator Prepare
What does TfsMigrator Prepare do?
Why does it Validate the Collection Again?
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

16. Generated Files – Import Specification
Visual Studio Team Services
6/20/2018 4:01 AM
Generated Files – Import Specification
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

17. Generated Files – Identity Map
Visual Studio Team Services
6/20/2018 4:01 AM
Generated Files – Identity Map
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

18. Visual Studio Team Services
Identity Import
No Microsoft Account Support
Azure AD Connect Re quired to Map Identities
O365 Users are Good to Go!
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

19. Demo Rogan Ferguson 6/20/2018 4:01 AM
© Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

20. Visual Studio Team Services
Phase 6: Import
How to approach moving your data to the cloud
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

21. Visual Studio Team Services
Approaching Imports
Dry Run Imports
Production Run Imports
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

22. Getting Ready to Import
Visual Studio Team Services
6/20/2018 4:01 AM
Getting Ready to Import
A Few Things Need to be Completed
Take the collection offline and detach it
Decide on DACPAC vs. VM Import
Prepare database for import
Complete the Import Specification
Queue the Import
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

23. Importing Large Collections
Visual Studio Team Services
6/20/2018 4:01 AM
Importing Large Collections
Collections larger than 150GB can’t use DACPACs
They’ll need to use a SQL Azure VM instead
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

24. Visual Studio Team Services
Azure VM Approach
#3 Restore collection database in SQL
#5 Import
#2 Move to your IaaS VM
#1 Detach your collection       
#4 Configure SQL Login
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

25. Demo Rogan Ferguson 6/20/2018 4:01 AM
© Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

26. Visual Studio Team Services
Tips & Tricks
Where you Upload your Data Matters!
Always Delete Previous Import Attempts
Questions? Contact Us!
Send an to
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

27. VSTS Migration Guide Download: https://aka.ms/TFSImportData
Step by step instructions
Designed for consultants & customers
Updated frequently
Feedback:

28. Please evaluate this session
Tech Ready 15
6/20/2018
Please evaluate this session
From your
Please expand notes window at bottom of slide and read. Then Delete this text box.
PC or tablet: visit MyIgnite
Phone: download and use the Microsoft Ignite mobile app
Your input is important!
© 2012 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

29. 6/20/2018 4:01 AM
© Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.