Déplacer ou cloner Team Foundation Server (déplacement de matériel)

Vous pouvez déplacer ou cloner votre déploiement du logiciel Team Foundation Server (TFS). Vous déplacez TFS d'un ordinateur vers un autre en le restaurant sur un nouveau matériel (procédure également appelée déplacement basé sur la restauration). Par exemple, peut-être souhaitez-vous déplacer TFS vers un serveur doté d'une plus grande capacité ou d'une meilleure vitesse de traitement, ou peut-être avez-vous des problèmes de fiabilité du matériel sur lequel TFS est en cours de exécution. Le déplacement de TFS vers un nouveau serveur vous permet de modifier le matériel qui exécute TFS sans perdre vos historiques de projet.

Pour cloner votre déploiement de TFS, vous effectuez les mêmes étapes qu'un déplacement, ainsi que quelques étapes supplémentaires. Vous effectuez un déplacement quand vous envisagez de cesser d'utiliser le matériel et le déploiement de TFS d'origine. Vous effectuez un clonage quand vous envisagez de continuer à utiliser l'instance TFS d'origine une fois celle-ci déplacée.

Pour déplacer ou cloner TFS, effectuez les étapes suivantes :

1. Vérifier vos autorisations

2. Sauvegarder les bases de données et installer les logiciels

   1. Sauvegarder les bases de données et la clé de chiffrement

   2. Installer et configurer SQL Server sur le nouveau serveur de couche Données

   3. Installer et configurer les logiciels sur le nouveau serveur de couche Application

3. Restaurer les bases de données TFS sur le nouveau matériel

   1. Restaurer les bases de données TFS

   2. Rediriger les produits SharePoint vers le nouvel emplacement de la base de données de contenu

   3. (Option de clonage) Reconfigurer les ID de serveur et remapper les bases de données

4. Mettre à jour la configuration du nouveau serveur d'applications

   1. Configurer la nouvelle couche Application

   2. Mettre à jour les URL de Team Foundation Server

   3. Mettre à jour tous les comptes de service

   4. Mettre à jour les serveurs de build

   5. Configurer les applications Web SharePoint dans TFS

   6. Configurer la création de rapports et SQL Server Analysis Services

5. Vérifier les autorisations, notifier les utilisateurs et configurer les sauvegardes

   1. Vérifier les autorisations relatives aux utilisateurs, aux équipes, aux groupes et aux comptes de service

   2. Actualiser les caches sur les ordinateurs clients

   3. Notifier les utilisateurs

   4. Configurer les sauvegardes

1.Vérifier vos autorisations

Vous devez être administrateur sur les deux environnements matériels (l'ancien et le nouveau). En outre, vous devez être administrateur (ou disposer des autorisations équivalentes) pour TFS et tous les logiciels dont dépend votre déploiement : SQL Server, la création de rapports, les produits SharePoint (si votre déploiement utilise la création de rapports ou SharePoint) et les autres logiciels avec lesquels votre déploiement interagit, par exemple Project Server.

• Vérifiez que vous êtes membre des groupes suivants :

  • Serveurs : administrateurs (groupe Administrateurs local ou équivalent)

  • TFS : administrateurs Team Foundation et utilisateurs de la console Administration

  • SQL Server : sysadmin

  • Produits SharePoint : administrateurs de batterie (si votre déploiement TFS s'intègre avec les produits SharePoint)

Si vous n'êtes pas membre d'un ou de plusieurs de ces groupes, obtenez des autorisations maintenant.

2.Sauvegarder et installer

Tout d'abord, effectuez une sauvegarde de vos bases de données TFS, puis installez les logiciels sur le nouveau matériel.

2-a.Sauvegarder les bases de données et la clé de chiffrement SQL Server Reporting Services

1. Ouvrez la console Administration pour TFS et, sur la page Sauvegardes planifiées, acceptez une sauvegarde complète. La sauvegarde enregistrera tous les éléments que vous avez configurés pour la sauvegarde dans votre plan de sauvegarde, mais cette opération sera effectuée immédiatement, et pas en fonction du délai planifié dans le plan. Si votre déploiement utilise la création de rapports, vous pouvez sauvegarder la clé de chiffrement dans le cadre de cet ensemble de sauvegardes.

   

   (Si vous n'avez pas de sauvegardes configurées, vous devez créer un plan avant de pouvoir effectuer une sauvegarde complète.)

2. Une fois la sauvegarde terminée, vérifiez qu'elle est disponible sur le dispositif de stockage ou le partage réseau et que vous pouvez y accéder à partir du nouveau matériel.

2-b.Installer et configurer SQL Server sur le nouveau serveur de couche Données

• Installez SQL Server sur le nouveau serveur et assurez-vous qu'il fonctionne. Si votre déploiement précédent utilise la création de rapports, veillez à inclure les composants Reporting Services et Analysis Services. Vous devez installer la même version et la même édition que celles que vous avez utilisées précédemment, notamment le Service Pack et les niveaux des mises à jour cumulatives.

  

  Sinon, vous pouvez créer une instance de SQL Server sur un serveur sur lequel une version correspondante est déjà installée et restaurer les bases de données TFS pour cette instance, mais cela nécessitera plus de configuration post-restauration.

  Pour plus d'informations sur les options d'installation et de configuration de SQL Server, cliquez ici.

  Après l'installation de SQL Server, si votre déploiement inclut la création de rapports, ouvrez SQL Server Management Studio et détachez les bases de données ReportServer et ReportServerTempDB. Sinon, vous ne pourrez pas restaurer ces bases de données à l'aide de la sauvegarde que vous avez créée pour les bases de données TFS.

  

2-c.Installer et configurer les logiciels sur le nouveau serveur de couche Application

Pour configurer un ou plusieurs nouveaux serveurs pour TFS, vous devez d'abord installer et configurer les logiciels requis pour leur prise en charge. Ces logiciels incluent les composants suivants :

• un système d'exploitation pris en charge pour votre configuration de déploiement ;

• une version prise en charge des produits SharePoint (si votre déploiement est intégré à Produits SharePoint et que vous souhaitez le déplacer sur le même serveur que TFS).

Installez et configurez Windows, IIS (s'il n'est pas configuré par défaut) et SharePoint (si vous l'utilisez) dans le nouvel environnement, puis vérifiez que le serveur et ses logiciels sont opérationnels. 

Pour plus d'informations, voir la configuration système requise de Team Foundation Server et Transférer SharePoint vers un nouveau matériel pour TFS.

3.Restaurer les bases de données TFS sur le nouveau matériel

Pour restaurer les bases de données TFS à l'aide de l'outil de restauration, vous devez installer TFS sur le nouveau serveur de couche Données sans le configurer, puis utiliser la fonction de restauration dans le nœud Sauvegardes planifiées.

Si vous souhaitez restaurer manuellement les bases de données TFS à l'aide des outils de restauration de SQL Server, vous pouvez le faire, mais cette procédure est plus difficile. En outre, vous devrez démarrer manuellement les bases de données dans le nouveau déploiement. L'Assistant Restauration dans TFS effectue automatiquement cette opération pour vous dans le cadre de son processus de restauration, mais cette fonctionnalité ne fait pas partie des outils de restauration de SQL Server.

Si vous avez installé SharePoint Foundation 2013 à l'aide des étapes décrites dans Transférer SharePoint vers un nouveau matériel pour TFS et que vous prévoyez d'utiliser ce serveur comme serveur pour TFS, les bits d'installation et la console d'administration seront déjà présents sur le serveur et vous pouvez ignorer les deux premières étapes de la procédure suivante.

3-a.Restaurer les bases de données TFS

1. Exécutez le support d'installation TFS. Sur la page Installation de Team Foundation Server, cliquez sur Installer.

2. Lorsque l'installation est terminée, le Centre de configuration Team Foundation Server s'ouvre. Fermez-le.

   La console Administration s'ouvre automatiquement dans un état non configuré. Il s'agit du comportement attendu.

3. Pour démarrer l'Assistant Restauration, ouvrez la console Administration de TFS et ouvrez Sauvegardes planifiées.

   

4. Spécifiez le chemin d'accès au jeu de sauvegardes et choisissez le jeu que vous avez créé après avoir suspendu l'ancien déploiement.

   

5. Suivez la procédure de l'Assistant et restaurez les bases de données sur la nouvelle instance de SQL Server.

   

3-b.Rediriger les produits SharePoint vers le nouvel emplacement de la base de données de contenu

Si votre déploiement utilise les Produits SharePoint, vous avez déjà installé les mêmes version et édition des Produits SharePoint que celles que vous avez utilisées dans votre déploiement précédent en suivant les étapes décrites dans Transférer SharePoint vers un nouveau matériel pour TFS, comme indiqué ci-dessus. Maintenant, après avoir restauré la base de données de contenu de l'ancien déploiement (WSS_Content) vers le nouveau serveur dans le cadre du jeu de restauration, vous devez rediriger le serveur qui exécute les Produits SharePoint vers le nouvel emplacement de cette base de données. Cette base de données doit être opérationnelle avant la reconfiguration de Team Foundation Server avec les nouveaux emplacements de ses bases de données.

1. Ouvrez une invite de commandes en tant qu'administrateur sur le nouveau matériel qui exécute SharePoint Foundation.

2. Accédez au répertoire Lecteur:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\15\bin et exécutez stsadm.exe avec les paramètres suivants, où SharePointFoundationServerName est le nom du serveur où vous avez installé SharePoint Foundation 2013 et SQLServerName est le nom du serveur où vous avez restauré la base de données WSS_Content dans le cadre de la restauration des bases de données TFS :

   stsadm.exe –o addcontentdb –url http://SharePointFoundationServerName/sites -databasename WSS_Content -databaseserver SQLServerName
   

3. Lorsque cette commande s'est terminée avec succès, tapez la commande suivante, où Domain\UserName est le compte que vous avez utilisé pour installer et configurer SharePoint Foundation 2013 en vue d'une utilisation avec TFS :

   stsadm.exe -o addpermissionpolicy -url http://SharePointFoundationServerName -userlogin Domain\UserName -permissionlevel "full control"
   

3-c.(Option de clonage) Reconfigurer les ID de serveur et remapper les bases de données

Effectuez l'ensemble d'étapes suivant sur le nouveau serveur d'applications si vous envisagez de continuer à utiliser l'instance TFS d'origine. Ces étapes sont nécessaires pour éviter le risque d'endommagement de l'un ou des deux déploiements. Si les deux serveurs sont actifs, vous pouvez aboutir à un endommagement, en particulier s'ils pointent sur les mêmes ressources SharePoint ou de création de rapports.

1. Ouvrez une fenêtre d'invite de commandes en tant qu'administrateur, puis accédez au répertoire Lecteur:\%programfiles%\Microsoft Team Foundation Server 12.0\Tools. Ouvrez une fenêtre d'invite de commandes et entrez la commande suivante :

2. Exécutez la commande TFSConfig PrepareClone pour supprimer les informations sur les sauvegardes planifiées, SharePoint et les ressources de création de rapports.

   TFSConfig PrepareClone /SQLInstance:ServerName /DatabaseName:DatabaseName /notificationURL: ApplicationTierURL

3. Exécutez la commande TFSConfig ChangeServerID pour changer les GUID de serveur associés aux bases de données. Les GUID doivent être uniques dans le déploiement TFS.

   TFSConfig ChangeServerID /SQLInstance:ServerName] /DatabaseName:ConfigurationDatabaseName [/ProjectCollectionsOnly] [/ConfigDBOnly] [/usesqlalwayson]

4. Exécutez la commande TFSConfig RemapDBs pour rediriger le déploiement TFS cloné vers ses bases de données.

   TFSConfig RemapDBs /DatabaseName:ServerName;DatabaseName /SQLInstances:ServerName1,ServerName2 [/AnalysisInstance:ServerName] [/AnalysisDatabaseName:DatabaseName] [/preview] [/continue] [/usesqlalwayson]

4.Mettre à jour la configuration du nouveau serveur d'applications

Effectuez ces étapes sur le nouveau serveur d'applications.

4-a.Configurer le nouveau serveur d'applications

1. Dans la console Administration de TFS, choisissez Configurer les fonctionnalités pour lancer le centre de configuration.

2. Exécutez l'Assistant Couche Application uniquement puis, dans Bases de données, spécifiez la nouvelle instance de SQL Server où vous avez restauré les bases de données TFS. Sélectionnez la base de données Tfs_Configuration dans la liste.

   

3. Avant de fermer la dernière page de l'Assistant, recherchez le symbole « i ». Il désigne des informations utiles pour une référence ultérieure. La dernière page comprend également l'emplacement du journal de configuration.

   

4-b.Mettre à jour les URL TFS

1. Ouvrez le nœud Couche Application et examinez les URL de notification et Team Web Access. Notez qu'elles pointent toujours vers l'emplacement de l'ancien déploiement. Mettez-les à jour.

   

2. Après la mise à jour des URL avec le nom du nouveau serveur, examinez les informations pour vous assurer qu'elles sont correctes.

   

4-c.Mettre à jour tous les comptes de service

Vous devez mettre à jour le compte de service TFS (TFSService) et le compte de sources de données (TFSReports). Même si ces comptes n'ont pas changé, vous devez mettre à jour les informations pour contribuer à garantir que l'identité et le format des comptes sont appropriés pour le nouveau serveur.

1. Ouvrez une fenêtre d'invite de commandes en tant qu'administrateur, puis accédez au répertoire Lecteur:\%programfiles%\Microsoft Team Foundation Server 12.0\Tools.

2. À l'invite de commandes, tapez la commande suivante pour ajouter le compte de service pour Team Foundation, où NomBaseDeDonnées correspond au nom de la base de données de configuration (par défaut, TFS_Configuration) :

   **TfsConfig Accounts /add /AccountType:ApplicationTier /account:**NomCompte **/SQLInstance:**NomServeur **/DatabaseName:**NomBaseDeDonnées

3. À l'invite de commandes, tapez la commande suivante pour ajouter le compte de sources de données :

   **TfsConfig Accounts /add /AccountType:ReportingDataSource /account:**NomCompte **/SQLInstance:**NomServeur **/DatabaseName:**NomBaseDeDonnées

   Pour plus d'informations, consultez Accounts, commande.

4-d.Mettre à jour les serveurs de build

Vous devrez maintenant rediriger vos serveurs de build pour qu'ils pointent vers le déploiement TFS déplacé.

1. Sur chaque serveur de build, ouvrez la console Administration et arrêtez le service de build.

2. Dans les propriétés du service de build, mettez à jour les propriétés de communication.

   

4-d.Configurer les applications Web SharePoint

Si votre déploiement utilise les produits SharePoint et que vous avez déplacé SharePoint Foundation 2013 dans le cadre du déplacement de TFS, vous devrez peut-être rediriger TFS vers la nouvelle application web. Même si vous ne le faites pas, vous devez tout de même réparer la connexion pour garantir de bonnes performances.

Si vous n'utilisez pas les produits SharePoint dans le cadre de votre déploiement, ou si votre déploiement continuera à utiliser l'ancien serveur SharePoint, vous pouvez ignorer cette procédure.

• Ouvrez la console Administration et accédez aux applications Web SharePoint. Si l'application web fait toujours référence à l'ancien site, ou si votre nouveau déploiement utilise une autre application web que celle indiquée, choisissez Modifier et mettez à jour les paramètres.

  

  Si les informations sont correctes, ou après les avoir corrigées, sélectionnez Réparer la connexion. Cela permet de s'assurer que tout fonctionne correctement.

4-e.Configurer les services Reporting Services et Analysis Services

Si votre déploiement utilise un serveur de rapports, vous devez rediriger Team Foundation Server vers son emplacement, redémarrer l'entrepôt et regénérer manuellement la base de données pour Analysis Services. Si vous n'utilisez pas les rapports, ignorez cette procédure.

1. Accédez au nœud Rapports. Les valeurs du serveur de rapports répertoriées sont les anciennes, et non les nouvelles. Il faut donc les modifier.

   

2. Modifiez les valeurs des trois onglets pour qu'elles pointent vers le nouveau serveur. Veillez à fournir les informations appropriées pour le compte de sources de données dans le nouveau déploiement.

   

3. Sélectionnez Démarrer les travaux pour redémarrer la création de rapports.

4. Sélectionnez Démarrer la régénération pour régénérer l'entrepôt.

5.Vérifier les autorisations, notifier les utilisateurs et configurer les sauvegardes

Après avoir effectué un déplacement vers un nouveau matériel, vérifiez que tous les utilisateurs, groupes et comptes de service du déploiement sont configurés avec les autorisations appropriées pour un fonctionnement correct sur chaque serveur. Certaines autorisations, telles que les autorisations supplémentaires dans SQL Server ou sur l'ordinateur local, ne peuvent pas être migrées automatiquement. Par exemple, les administrateurs Team Foundation doivent être membres du groupe Administrateurs local sur le serveur de couche Application pour pouvoir ouvrir la console Administration ; par conséquent, vous devez les ajouter manuellement à ce groupe.

5-a.Vérifiez les autorisations relatives aux utilisateurs, aux groupes et aux comptes de service

• Connectez-vous au serveur et vérifiez que les utilisateurs, groupes et comptes de service sont configurés avec les autorisations nécessaires. Contrôlez manuellement l'appartenance aux groupes et équipes de projet et vérifiez que ces groupes et équipes disposent des autorisations prévues.

• Naviguez jusqu'à une collection de projets d'équipe et vérifiez que tous les projets dans cette collection apparaissent comme prévu, et que les utilisateurs de ces projets peuvent accéder correctement à leurs éléments de travail.

• Ouvrez Team Web Access et vérifiez que les sites d'équipe et les équipes apparaissent comme prévu.

Vous ne savez pas à quels groupes et à quelles autorisations vous attendre ? Pour plus d'informations, voir Ajouter des utilisateurs aux projets d'équipe, Définir les autorisations d'administrateur pour les collections de projets d'équipe, Définir les autorisations d'administrateur pour Team Foundation Server et Comptes de service et dépendances dans Team Foundation Server.

5-b.Actualiser le cache de données sur les ordinateurs clients

• Connectez-vous au serveur, puis utilisez le service web ClientService pour forcer les clients à mettre à jour le cache de suivi des éléments de travail et le cache de contrôle de version Team Foundation.

  https://ServerName:8080/tfs/WorkItemTracking/v3.0/ClientService.asmx
  

  Pour plus d'informations, consultez Actualiser les caches de données sur les ordinateurs clients.

  Si vous souhaitez actualiser le cache entier pour tous les utilisateurs lors de leur prochaine connexion, utilisez la commande witadmin rebuildcache.

  Notes

  Si vous avez restauré vos bases de données à un autre point dans le temps, vous devez également actualiser le cache de contrôle de version comme documenté dans Actualiser les caches de données sur les ordinateurs clients.

5-c.Notifier les utilisateurs

Maintenant que vous avez déplacé TFS, vous devez indiquer à vos utilisateurs comment se connecter au déploiement déplacé. Plus spécifiquement, vous devez leur fournir les informations suivantes :

• le nom du nouveau serveur et l'URL de Team Web Access, afin qu'ils puissent se reconnecter à leurs projets ;

• les nouveaux noms de bases de données pour l'enregistrement, si l'enregistrement fait partie de votre déploiement ;

• la nouvelle URL pour SharePoint, si SharePoint fait partie de votre déploiement ;

• s'ils sont membres d'un projet d'équipe qui utilise Git, les instructions de mise à jour de chaque clone disponible localement pour chaque référentiel de ce projet. Plus spécifiquement, ils devront exécuter la commande suivante pour chaque clone :

  git remote set-url <remote name> <new URL>
  

  Les utilisateurs peuvent connaître l'URL de chaque clone en recherchant le projet d'équipe sous l'onglet Explorateur.

  

  Pour en savoir plus sur Git, cliquez ici.

5-d.Configurer les sauvegardes sur la nouvelle instance TFS

Dans la console Administration, accédez au nœud Sauvegardes planifiées et reconfigurez les sauvegardes planifiées pour sauvegarder les bases de données TFS sur le nouveau serveur.

Pour plus d'informations, consultez Configurer une planification de sauvegarde.

Q et R

Q : Je souhaite modifier les domaines, et non les serveurs physiques.Est-ce possible ?

R : oui. Cela s'appelle un déplacement basé sur l'environnement, et vous trouverez les étapes ici. Vous ne devez pas essayer de combiner un déplacement basé sur l'environnement avec un déplacement basé sur le matériel. Procédez d'abord au déplacement du matériel, puis modifiez l'environnement.

Q : Quelles sont les étapes à suivre pour effectuer une intégration à Project Server après un déplacement matériel ?

R : Oui, après avoir procédé au déplacement matériel, vous devrez utiliser la commande /RegisterPWA de TFSAdmin ProjectServer avec les options /tfs, /force et /pwa pour réenregistrer TFS auprès de Project Server. Vous trouverez davantage d'informations sur l'intégration de TFS à Project Server ici.