Migrer de TFS 2008 SP1 vers TFS 2012

Si vous avez encore votre serveur TFS en version 2008 SP1, il faudra migrer d'abord celui-ci vers TFS 2012 avant éventuellement de le migrer vers TFS 2013. Voici un résumé des principales étapes pour cette migration et celle de votre contenu SharePoint (WSS3.0).

1. Préparer les nouvelles machines avec : (Dans la plupart des cas, il n'est pas possible de migrer sur place)
1. Windows 2008 R2 SP1
2. SQL Server 2008 R2 SP2
3. SharePoint 2010 SP2
4. TFS 2012 Update 3 (une de mes migrations avec l'update 4 a échouée)
2. Préparer les outils et Team Build
1. migrer vers VS2012 autant que possible les solutions.
2. migrer vos taches et outils de Build vers vers le nouveau modèle objet client.
3. migrer une build .Net : à priori pas ou peu d'actions (sauf migration optionnelle de MsTest vers Test Runner et des personnalisations du 2.)
4. migrer une build Cpp en conservant une solution et projets VS2008  :
   Voici les points que j'ai rencontré, vous en aurez surement de supplémentaires,
   Sur la machine de Build :
   • Installer Windows SDK 6.1A
   • Installer la fonctionnalité du serveur .Net 3.5.1
   • Installer VS2008 avec Team Explorer puis le SP1
   • Ajouter au PATH : "C:\Program Files (x86)\Microsoft Visual Studio 9.0\VC\bin\amd64"
   Sur la définition de Build et les projets, il faut parfois s’assurer que l'"OutDir" personnalisée soit utilisée (et les fichiers bien envoyés dans le répertoire de dépôt)
   • Si l'OutDir est commun aux solutions et projets, modifier simplement la règle de l'activité "Create OutputDirectory Per Platform and Configuration" du process par défaut.
   • Sinon,  il faut supprimer la valeur passée en global à OutDir par Team Build dans l'activité  "Run MSBuild for Project". Puis, il faut passer un nouveau paramètre au travers des "MSBuild Arguments". Celui-ci permettant de distinguer la compilation avec VS de celle avec Team Build et d'ajuster en conséquence le répertoire de sortie "OutputPath"
   • Quelques solutions : http://stackoverflow.com/questions/2784335/how-can-i-get-tfs-2010-to-build-each-project-to-a-separate-directory
     http://blogs.msdn.com/b/jimlamb/archive/2010/04/13/customizableoutdir-in-tfs-2010.aspx
3. Sauvegarder, puis Restaurer les bases vers le nouveau serveur de base de données
• tfsXXX (toutes les bases de TFS)
• Wss_Content (la base de contenu SharePoint)
• ReportServer et ReportServertempdb (base des rapports).
  Cette restauration est à réaliser si vous avez des rapports personnalisés. Les nouveaux rapports sont créés automatiquement lors de la migration.
4. Migrer les bases TFS en choisissant l'option Mise à jour dans la boite de dialogue.
   Suivre les instructions pour migrer les bases TFS et le reporting. (Je préfères migrer SharePoint séparément)
   La migration est longue voire très longue suivant la taille de votre base de code et le nombre d'éléments de travail. L'idéal est de la tester une première fois avant de réaliser la migration définitive.
5. Configurer SharePoint 2010.
   Lancer une configuration standard en créant une nouvelle ferme de serveur et un nouveau site d’administration centrale. Puis lancer l'assistant d'installation pour configurer les applications et service, sauter la création d'un site de haut niveau.
6. Installer les extensions TFS pour SharePoint depuis la console d'administration de TFS.
   (Ou les installer directement depuis les sources TFS si SharePoint est sur un serveur séparé)
7. Ajouter la base de données de contenu. Pour cela, il faut utiliser la ligne de commande  (impossible de puis l'administration centrale)
   cd c:\Program Files\Common Files\microsoft shared\Web Server Extensions\14\BIN
   stsadm.exe -o addcontentdb -url http://SPSserveur/ -databasename WSS_Content -databaseserver DBServeur
8. Vérifier l’association du serveur SharePoint avec le serveur TFS depuis la console d’administration de TFS, activer l'association si nécessaire. Fixer les liens entre les projet d''équipe TFS et leur site SharePoint depuis la section Paramètres de Visual Studio Team Explorer 2012. 
9. Si vous migrez de domaine, changer les identités dans TFS et SharePoint.
   Mon billet disponible ici détaille les opérations.
10. Vous pouvez alors appliquer l'update 4 de TFS sur les serveurs.
    Ou bien choisir de migrer vers TFS 2013, la procédure sera plus simple et détaillée sur MSDN.
11. Pour bénéficier des nouvelles fonctionnalités du Web Access dans vos projets d'équipes existants, il vous faudra bien-sûr suivre la procédure de mise à niveau.

have a nice day.