Étape 1 : configurer des agents Gestionnaires de migration

Lors de la migration de partages de fichiers avec le Gestionnaire de migration, vous devez d’abord configurer un ou plusieurs agents de migration. Pour ce faire, exécutez un fichier d’installation sur chaque ordinateur ou machine virtuelle que vous choisissez de configurer. Vous pouvez également regrouper des agents en affectant des migrations particulières à un ensemble spécifique d’agents ou en séparant les agents dans des groupes en fonction de l’emplacement géographique pour optimiser les performances.

Lorsque vous exécutez le fichier d'installation, vous êtes invité à fournir deux séries d'informations d'identification. Vous avez besoin d’informations d’identification globales ou d’administrateur SharePoint, en fonction de votre destination, et d’informations d’identification Windows avec accès en lecture à la source. Ces informations d’identification Windows doivent disposer d’un accès en lecture à tous les partages de fichiers que vous envisagez de migrer. Cette paire d’informations d’identification crée une relation de confiance avec le Gestionnaire de migration. Le Gestionnaire de migration le voit désormais comme un « agent » disponible vers lequel il peut distribuer automatiquement les tâches de migration.

Une fois qu’un agent est configuré, toute personne autorisée à accéder au Centre d’administration SharePoint peut créer des tâches. Les tâches sont automatiquement distribuées à l’un des agents configurés disponibles.

Importante

Veillez à télécharger la dernière version du fichier de configuration de l’agent. Les mots de passe ne sont pas stockés dans le programme d'installation.

Liste de vérification de planification

Catégorie	Aide
Déterminer le nombre d’agents dont vous avez besoin	Nombre d’agents à créer
Avoir les bonnes accréditations pour utiliser	Administrateur SharePoint ou OneDrive pour la destination de la migration et un compte local pour la source qui a accès à TOUS les partages de fichiers réseau que vous envisagez de migrer. Vérifiez que vous disposez d’informations d’identification SharePoint ou OneDrive Administration pour accéder à la « destination » de l’endroit où vous migrez votre contenu. Vérifiez que les informations d’identification locales que vous prévoyez d’utiliser pour configurer l’agent ont accès à tous les partages de fichiers réseau que vous envisagez de migrer.
Machines virtuelles ou ordinateurs à utiliser :	Déterminez le nombre de machines virtuelles ou d'ordinateurs que vous prévoyez d'utiliser pour votre projet de migration. Dressez la liste des ordinateurs ou des machine virtuelle avant de commencer.
Vérifier les conditions préalables	Assurez-vous que votre ordinateur répond aux exigences.
Vérifier les points de terminaison requis	Vérifiez que vous avez configuré les points de terminaison requis.
Locataire multigéographie	Si vous avez un locataire multigéographique, veillez à comprendre où l’agent sera installé.
Pré-configuration de comptes OneDrive	Si vous effectuez une migration vers des comptes OneDrive, assurez-vous que les comptes sont pré-configurés avant la migration. Le compte de migration doit avoir des droits d’administrateur de collection de sites sur chaque site OneDrive. Le pré-provisionnement peut être fait en utilisant un script comme décrit ici : Pré-provisionnement de OneDrive pour les utilisateurs de votre organisation.
Cloud gouvernemental	Si votre locataire réside dans un cloud du secteur public, vous devrez peut-être effectuer des étapes supplémentaires avant d’utiliser le Gestionnaire de migration.

Conseil

Créez un compte de service avec des droits d’administration pour que votre agent s’exécute sur le serveur ou la machine virtuelle. Ce compte doit disposer d’un accès en lecture aux sources que vous envisagez de migrer, ainsi que d’un accès administrateur SharePoint ou OneDrive à la destination spécifique de votre projet de migration. Connectez-vous à chaque machine virtuelle ou ordinateur avec ce compte avant d’exécuter le fichier d’installation pour vous assurer que l’agent s’installe en tant que service.

Remarque

L’authentification multifacteur tierce n’est pas prise en charge pour l’instant.

Considérations relatives aux agents et aux performances

L’un des facteurs permettant d’obtenir les meilleures performances dans votre migration est l’utilisation du plus petit nombre d’agents nécessaires pour effectuer la migration dans votre période de temps. L’utilisation de plus d’agents que nécessaire peut augmenter le taux de limitation lors du chargement des rapports.

Exemple : si votre migration peut être effectuée dans l’intervalle de temps souhaité à l’aide de 10 agents et à une vitesse acceptable, n’utilisez pas 20 agents. L’utilisation d’agents supplémentaires signifie un trafic plus élevé et un taux de requêtes d’API plus élevé.

Déterminer le nombre d’agents dont vous avez besoin

Pour calculer le nombre minimal d’agents à utiliser pour votre migration :

1. Exécutez une migration de test avec 20 à 30 tâches à l’aide d’un agent pour tester le débit par agent. Enregistrez l’heure.
2. Estimez le nombre de tâches pour l’ensemble de votre migration. Prenez le temps nécessaire au traitement d’un agent de test et calculez le nombre d’agents pour la migration. Tenez compte de la durée totale dont vous disposez pour terminer votre projet de migration.
3. Si vous avez déjà créé plus d’agents que nécessaire, vous pouvez les désactiver en sélectionnant l’agent dans le Gestionnaire de migration.

Créer un agent

1. Connectez-vous à l’ordinateur ou à la machine virtuelle que vous choisissez pour configurer un agent avec des informations d’identification qui disposent d’un accès en lecture à tous les partages de fichiers que vous envisagez de migrer.
2. Dans le Centre d’administration SharePoint, sélectionnez Centre de migration. Vous devez vous connecter avec un compte disposant des autorisations d’administrateur SharePoint pour votre organization.
3. Sous « Pour les partages de fichiers », sélectionnez Prise en main.
4. Cliquez sur l’onglet Agents, puis sur Ajouter.
5. Sélectionnez Télécharger le fichier de configuration de l’agent. (Vous pouvez également télécharger la build Agent v2.0, actuellement en préversion publique. Pour plus d’informations et le lien de téléchargement, veuillez case activée la page « Nouveautés »
6. Ouvrez le fichier de configuration. Sur la page Bienvenue, sélectionnez Suivant.
7. Entrez le nom d’utilisateur et le mot de passe de l’administrateur SharePoint de l’environnement dans lequel vous migrez votre contenu. Sélectionnez Suivant.
8. Entrez le mot de passe du compte Windows qui fournit l’accès à tous les partages de fichiers qui contiennent le contenu que vous souhaitez migrer. Sélectionnez Installer.
9. Testez l'accès de l'agent (facultatif) ou sélectionnez Fermer. Une fois la configuration terminée, le nouvel agent sera ajouté aux agents disponibles qui peuvent se voir attribuer des tâches.

Remarque

Plusieurs agents : si vous avez un projet de migration volumineux et que vous devez configurer plusieurs agents, nous vous recommandons de télécharger le fichier d’installation de l’agent dans un emplacement partagé. De cette façon, vous pouvez facilement télécharger le fichier d’installation sur chaque ordinateur ou machine virtuelle. Plusieurs agents vous permettent de traiter par lot certaines tâches de migration vers des groupes particuliers en fonction de vos besoins. Par exemple, vous pouvez regrouper des agents par centre de données pour obtenir de meilleures performances en fonction de l’emplacement géographique.

Exemple : Vous migrez 10 000 utilisateurs à partir de partages locaux dans deux centres de données vers OneDrive. 2 000 utilisateurs ont des données stockées dans un centre de données californien, et 8 000 utilisateurs ont des données stockées dans un centre de données du Vermont. Vous avez installé deux agents dans le centre de données californien et six agents dans le centre de données du Vermont. En regroupant les agents géographiquement, vous pouvez traiter par lots les migrations où les données sources se trouvent en Californie vers le groupe d’agents californiens et pour les données du Vermont vers le groupe d’agents du Vermont. Le regroupement géographique offre des avantages en matière de performances. Sans regroupement géographique, tous les centres de données se trouveraient dans un groupe par défaut et vous n’auriez pas de contrôle sur les agents utilisés. Cela peut amener les agents californiens à migrer les données du Vermont et les agents du Vermont à migrer les données californiennes. Bien que cela migre techniquement les fichiers, les performances peuvent être affectées.

Dossier de travail

Un dossier de travail nommé %appdata%\Microsoft\SPMigration est créé pour chaque agent. C'est dans ce dossier que sont enregistrés les journaux, les rapports et tous les dossiers temporaires. Veillez à ce que votre dossier de travail ait un minimum de 150 Go d'espace libre. Cela peut nécessiter davantage en fonction de la taille des données que vous prévoyez de migrer.

Configuration d'un agent multigéographie

Si vous avez un locataire SharePoint multigéographique, l’agent est installé dans les emplacements géographiques définis dans le Centre d’administration SharePoint. Avant d’installer l’agent, assurez-vous que l’emplacement géographique souhaité est celui défini dans le centre d’administration. Pour modifier la géolocalisation d'un agent, supprimez et réinstallez l'agent.

En savoir plus : Fonctionnalités multigéographiques dans OneDrive et SharePoint Online

Pour installer un agent dans un autre emplacement géographique :

1. Téléchargez le fichier de configuration de l’agent.

2. Lancez le fichier de configuration et restez sur la page d’accueil.

3. Ouvrez ce fichier : %temp%\SPMigrationAgentSetup\SPMigrationAgentSetup\Microsoft.SharePoint.Migration.ClientShared.dll.config

4. Sous appSettings, ajoutez une entrée comme indiqué dans l’exemple suivant pour le pays/la région ou le centre de données souhaité. (Remarque : il s'agit d'un exemple pour le Canada.)

   <add key="GeoLocation" value="CAN" />
   

   Le code GEO du pays ou de la région est disponible ici Disponibilité multigéographique Microsoft 365.

Importante

Migration vers Teams : si vous effectuez une migration vers Teams, le site Teams de destination doit se trouver dans la même zone géographique que l’administrateur de votre locataire. S’ils sont différents, le canal Teams ne se charge pas lorsque vous sélectionnez la destination.

Installation d’un agent comme application

Si le système détecte que vous n’êtes pas joint à un domaine lors de l’installation de l’agent, vous pouvez installer l’agent en tant qu’application Windows. Vous pouvez toujours l’installer comme service, quitter et vous connecter à l’aide d’un compte de domaine joint.

Importante

Si vous installer l’agent comme application, il ne s’exécute pas si l’ordinateur est en veille, mettant en pause votre migration de manière efficace.

1. Sélectionnez Installer comme application.

   

2. Une fois l’agent installé, connectez-vous avec vos informations d'identification d’administrateur SharePoint.

3. Vérifiez si votre agent a accès aux partages de fichier que vous souhaitez migrer (facultatif).

   

4. L’écran des paramètres indique si et à quel locataire vous êtes connecté. Sélectionnez Dissocier un client si vous souhaitez vous connecter avec un autre client.

5. Microsoft 365 renouvelle automatiquement l’autorisation d’accéder à votre locataire tant que l’agent de migration est actif. Si l’agent est inactif depuis plus de sept jours, vous devrez peut-être vous reconnecter.

Affectation de tâche à l’agent

Le Gestionnaire de migration attribue automatiquement des tâches à un agent disponible. Vous ne pouvez pas affecter manuellement une tâche à un agent spécifique. Les agents peuvent avoir au maximum 10 tâches dans leur file d’attente. Toutefois, vous pouvez affecter des tâches à des groupes d’agents.

La suspension d’une tâche ne libère pas l’agent vers une autre tâche. Un agent reste indisponible pour l’acceptation d’une nouvelle tâche jusqu’à ce que la tâche soit reprise et terminée, ou si la tâche est supprimée.

Combien de temps la connexion reste-t-elle active ?

La connexion entre l’agent (en tant que service) et le Gestionnaire de migration reste active tant que l’ordinateur est en cours d’exécution et que les informations d’identification de l’administrateur SharePoint, utilisées pour se connecter à l’agent, sont valides.

Si l’agent est déconnecté, il conserve toujours le jeton pour le Gestionnaire de migration pendant sept jours. Passé ce délai, l’agent doit être réinstallé.