Résoudre les problèmes de migration des migrations de fichiers du Gestionnaire de migration

Cet article explique comment résoudre les problèmes et les erreurs que vous pouvez rencontrer lors de l’utilisation du Gestionnaire de migration pour la migration de partage de fichiers.

• Composants requis et paramètres
• Messages d’erreur d’agent
• Problèmes d’URL du site de destination
• Messages d’erreur courants
• Échec de l’installation d’agent
• Agent déconnecté
• Tâche bloquée dans l’état de mise en file d’attente
• Impossible de télécharger un rapport de tâche
• Erreurs de migration dans les rapports de tâches
• Les rapports d’erreur de migration Google contiennent du code HTML
• Codes d’erreur
• Les administrateurs géographiques ne peuvent pas accéder aux fonctionnalités complètes du Gestionnaire de migration.
• Les administrateurs SharePoint hérités d’un groupe ne peuvent pas accéder à toutes les fonctionnalités du Gestionnaire de migration
• La collection de sites « XXXX » ne peut pas être créée ou mise à jour
• Tâche d’analyse bloquée dans un status « mis en file d’attente »

Vérifier les conditions requises et les paramètres

Vérifiez que vous remplissez les conditions préalables à l’installation de l’agent et passez en revue les points de terminaison requis. Les clients cloud du secteur public doivent confirmer que la configuration est correctement définie.

• Conditions préalables à l’installation de l’agent.
• Points de terminaison obligatoires.
• Paramètres du cloud pour le secteur public.
• Préprovisionner des comptes OneDrive Si vous effectuez une migration vers des comptes OneDrive, vérifiez que les comptes sont provisionnés avant de migrer. Pour ce faire, vous pouvez utiliser un script, comme décrit ici : Pré-configuration de OneDrive pour les utilisateurs de votre organisation.

Messages d’erreur d’agent

Problèmes d’URL du site de destination

Messages d’erreur fréquemment détectés

Échec de l’installation d’un agent

Question : L'agent de migration ne s'installe pas lorsqu'on utilise une ancienne version du fichier d'installation de l'agent pour installer l'agent.

Diagnostic/Enquête :

Un fichier clientsetup.exe obsolète peut provoquer ce problème.

Atténuation :

1. Accédez au Centre de migration dans le Centre d’administration SharePoint et connectez-vous avec un compte disposant d’autorisations d’administrateur pour votre organisation.
2. Sélectionnez Télécharger le fichier d’installation de l’agent.
3. Exécutez le fichier clientsetup.exe sur l’ordinateur ou la machine virtuelle sur lequel vous souhaitez installer l’agent. Suivez les instructions pour terminer l'installation de l'agent.

Émettre: L’agent de migration ne s’installe pas correctement ou le clientsetup.exe ne peut pas être ouvert.

Exemple :

Diagnostic/Enquête :

Si le clientsetup.exe ne peut pas être ouvert :

• Connectez-vous à Windows en tant qu’administrateur, ou fournissez le nom d’utilisateur et le mot de passe de l’administrateur à l’ouverture de l’application. Le compte d’administrateur doit déjà être ajouté au domaine.

Si des erreurs se sont produites lors du processus de l’installation :

• Le message d’erreur doit déjà inclure la raison de l’échec, ainsi que les mesures appropriées à prendre si possible.
• Si les erreurs ne suggèrent pas d’actions à résoudre, une défaillance réseau temporaire peut provoquer ce problème ou d’autres problèmes inconnus.

Atténuation :

Si le clientsetup.exe ne peut pas être ouvert :

1. Connectez-vous à Windows en tant qu’administrateur.
2. Rouvrez l’application clientsetup.exe, ou fournissez le nom d’utilisateur et le mot de passe d’administrateur à l’ouverture de l’application.

Si des erreurs se sont produites pendant le processus d’installation :

• Pour les erreurs liées à des actions spécifiques établies, effectuez l’action correspondante, puis rouvrez le clientsetup.exe.
• Pour les autres erreurs non spécifiques, assurez-vous que votre compte Administrateur est ajouté au domaine. Fermez la fenêtre de l’application, puis réessayez d’effectuer l’installation.

Déconnexion de l’agent

Problème : l’état de l’agent affiche « Déconnecté » et ne change jamais.

Diagnostic/Enquête :

• Vérifiez l’intégrité du réseau sur l’ordinateur sur lequel est installé l’agent.
• Si le mot de passe du compte d’administrateur de locataire connecté est modifié, ou si d’autres modifications critiques similaires sont appliquées au compte de Administration locataire qui vous oblige à vous reconnecter, tous les agents sont déconnectés. La réinstallation est requise sur tous ces éléments.
• Si la mise à niveau automatique de l’agent n’a pas pu être automatique, la version est probablement trop ancienne. Réinstallez l’agent.
• L’expiration du jeton peut également entraîner la déconnexion de l’agent.

Atténuation :

• Si vous rencontrez un problème de réseau, résolvez ce problème. L’agent devrait se reconnecter peu de temps après.
• Si des modifications critiques sont apportées au compte de Administration de locataire qui nécessitent une nouvelle connexion : Réinstallez l’agent sur tous les ordinateurs.
• Si aucune de ces options ne s’applique, commencez par réinstaller l’agent.

Tâche bloquée à l’état de « mise en file d’attente »

Problème : l’état d’une tâche reste « mise en file d’attente » et n'est jamais programmée pour être exécutée sur un agent.

Diagnostic/Enquête :

• Assurez-vous que des agents sont installés pour ce client. Ils doivent être répertoriées dans la liste des agents.
• Vérifiez l’état de chaque agent. Ils doivent être configurées sur « activé ».
• L’état « en cours d’utilisation » indique que l’agent traite déjà une autre tâche. L’agent ne peut pas être affecté à d’autres tâches sans terminer la tâche actuelle.
• Si un agent est répertorié comme « Désactivé », activez-le.
• S’ils semblent être « déconnectés » pendant un long moment, cochez la fonction agent déconnecté.

Atténuation :

• S’il existe des agents activés disponibles dans la liste, mais les tâches n’ont pas été planifiées pendant un long moment : créer une autre tâche qui est identique. Parfois, il résout le problème.

Impossible de télécharger un rapport de tâche

Problème : Le rapport de tâche ne peut pas être téléchargé à partir du lien dans le panneau détails de la tâche.

• Le lien de rapport de tâches de téléchargement est désactivé.
• Le lien Télécharger le rapport de tâche s’affiche actif, mais rien ne se produit après avoir cliqué dessus.

Diagnostic/Enquête :

• Le lien « Télécharger le rapport des tâches » est désactivé jusqu’à ce que la tâche soit terminée. Les rapports ne sont disponibles qu’une fois que le status de la tâche a un status « Terminé » ou « Échec ». Les tâches qui ont échoué en raison d’un délai d’attente ont également un lien de rapport de tâche désactivé.
• Si aucun rapport ne peut être téléchargé pour les tâches terminées et non expirées, il y a probablement des erreurs qui se sont produites pendant le processus de migration qui ont interrompu le chargement des rapports vers SharePoint. Toutefois, elles peuvent être trouvées localement tant qu’elles existent.

Atténuation :

Sur l’ordinateur qui a effectué la tâche, essayez de récupérer les rapports.

• Dans le dossier %AppData%\Microsoft\SPMigration\Logs\Migration\MigrationTool[tenant_site] ou < Your-Customized-Working-Folder >\Migration\MigrationTool[tenant_site], triez les sous-dossiers en fonction de leur heure de modification. Recherchez le sous-dossier dont l’heure de modification est la plus proche de l’heure de début de la tâche. Si les rapports de tâche existent, ils se trouvent dans le dossier « Rapport » de ce sous-dossier.

Ou

• Si la tâche a échoué, accédez au dossier %AppData%\Microsoft\SPMigration\Logs, puis triez les sous-dossiers en fonction de leur heure de modification. Recherchez le sous-dossier dont l’heure de modification est la plus proche de l’heure de début de la tâche. Le rapport d’erreurs se trouve dans ce sous-dossier.

Erreurs de migration dans les rapports de tâches

Problème : les tâches de migration échouent pour plusieurs raisons et sont détaillés dans les rapports des tâches.

Diagnostic/Enquête :

• Les raisons de l’échec doivent déjà être écrites de façon détaillée dans les rapports avec des solutions suggérées.
• Si vous ne pouvez pas télécharger les rapports de tâche, reportez-vous à Un rapport de tâche ne peut pas être téléchargé.

Atténuation :

Recherchez l’erreur spécifique ici pour plus d’informations : Codes d’erreur.

Si vous recevez une erreur similaire à celle-ci : Échec de l’envoi du travail au serveur : Raison inconnue de l’échec lors de l’envoi d’un travail. 0x01610002, case activée les paramètres de toute application antivirus installée sur l’ordinateur de l’agent. Ajoutez nos deux applications de migration en tant qu’exceptions afin que le trafic de migration ne soit pas interrompu :

• microsoft.sharepoint.migration.clientservice.exe
• microsoft.sharepoint.migration.mthost.exe

Le rapport d’erreurs Google affiche le code HTML dans le rapport.

Problème : Les rapports d’erreurs générés pour une migration Google comportent parfois un code HTML incorporé dans le rapport.

Détails :

Les API Google retournent les erreurs HTML incluses dans les rapports générés. Ce problème peut se produire en cas d’erreur de chargement du serveur Google.

Atténuation :

Exécutez moins de transactions simultanées.

Statut :

Ce problème est connu. ETA non définie.

Administrateurs géographiques non pris en charge

Le Gestionnaire de migration ne prend actuellement pas en charge le rôle d’administrateur géographique pour des scénarios spécifiques. Pour les migrations de partage de fichiers, ces utilisateurs ne peuvent pas accéder à l’onglet Analyses . Pour les migrations cloud, ces utilisateurs ne peuvent pas accéder à l’onglet Analyses ou à l’onglet Migrations .

Solution de contournement Attribuez à l’utilisateur géographique un rôle d SharePoint ou d’administrateur global.

1. Dans le Centre d’administration, accédez à la page Utilisateurs>Utilisateurs actifs.
2. Dans la page Utilisateurs actifs, sélectionnez l’utilisateur dont vous souhaitez modifier le rôle d’administrateur. Dans le volet volant, sous Rôles, sélectionnez Gérer les rôles.
3. Sélectionnez le rôle d’administrateur que vous voulez attribuer à l’utilisateur. Si vous ne voyez pas le rôle que vous recherchez, sélectionnez Afficher tout en bas de la liste.

Les administrateurs SharePoint hérités de groupe ne peuvent pas accéder aux onglets Analyses et Migrations

Le Gestionnaire de migration ne prend pas entièrement en charge les rôles d’administrateur SharePoint créés à la suite de l’adhésion à un groupe Azure. Pour les migrations de partage de fichiers, ces utilisateurs ne peuvent pas accéder à l’onglet Analyses . Pour les migrations cloud, ces utilisateurs ne peuvent pas accéder à l’onglet Analyses ou à l’onglet Migrations .

Solution de contournement Attribuez à l’utilisateur un rôle d’administrateur SharePoint ou d’administrateur général.

1. Dans le Centre d’administration, accédez à la page Utilisateurs>Utilisateurs actifs.
2. Dans la page Utilisateurs actifs, sélectionnez l’utilisateur dont vous souhaitez modifier le rôle d’administrateur. Dans le volet volant, sous Rôles, sélectionnez Gérer les rôles.
3. Sélectionnez le rôle d’administrateur que vous voulez attribuer à l’utilisateur. Si vous ne voyez pas le rôle que vous recherchez, sélectionnez Afficher tout en bas de la liste.

La collection de sites « XXXX » ne peut pas être créée ou mise à jour

Le nom d’utilisateur principal (UPN) référencé n’est pas valide. Pour créer ou mettre à jour une collection de sites OneDrive, Microsoft Entra ID doit contenir l’UPN référencé. Vérifiez votre URL de destination et vérifiez que l’utilisateur existe dans Microsoft Entra ID.

Tâche d’analyse bloquée dans un status « mis en file d’attente »

Problème : l’status d’une analyse de partage de fichiers reste « En file d’attente » et n’est jamais planifiée sur un agent pour s’exécuter.

Diagnostic / Investigation

• Recherchez les tâches d’analyse dans la colonne Groupe d’agents. Seuls les agents du groupe d’agents par défaut peuvent être planifiés.

Atténuation

• S’il n’y a aucun agent dans le groupe d’agents par défaut , remplacez le groupe de l’agent existant par Défaut. Toutes les tâches d’analyse qui étaient bloquées doivent maintenant sortir de cet état.

Codes d’erreur