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.

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

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.

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.

TfsMigrator

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.

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.

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.

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.

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.

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.

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: https://www.visualstudio.com/docs/work/customize/configure-features-after-upgrade 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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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

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 https://myignite.microsoft.com/evaluations Phone: download and use the Microsoft Ignite mobile app https://aka.ms/ignite.mobileapp 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.

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.