Résoudre les problèmes liés à Google Workspace Migrate

1. Pour trouver les journaux :
   • Sur une installation en plate-forme, accédez à C:\Program Files\Google Workspace Migrate\Google Workspace Migrate Platform\AppBridgeServiceHost.log.
   • Sur une installation en nœud, accédez à C:\Program Files\Google Workspace Migrate\Google Workspace Migrate Platform Node\AppBridgeServiceHost.log.

     Remarque: Si vous exécutez une version antérieure de Google Workspace Migrate, vous devrez peut-être utiliser G Suite dans le chemin au lieu de Google Workspace.

2. Ouvrez le journal et faites-le défiler jusqu'en bas.
3. Si vous voyez des problèmes pertinents, corrigez-les.

   Vous pouvez ignorer le message "Access denied: Symmetric encryption is required for this service request but not configured" (Accès refusé : chiffrement symétrique requis pour cette requête de service, mais non configuré).

4. Si vous ne parvenez pas à résoudre un problème, consultez Contacter l'assistance pour les problèmes liés à Google Workspace Migrate.

1. Connectez-vous à la plate-forme Google Workspace Migrate et cliquez sur Servers (Serveurs) en haut à droite.
2. Vérifiez que vos nœuds apparaissent dans la liste.
3. Vérifiez que les nœuds sont prêts (verts).

Si vous rencontrez une erreur lors de la tentative d'association d'un nœud à la plate-forme Google Workspace Migrate, vérifiez si le nœud est en cours d'exécution :

1. Dans un navigateur sur la machine qui exécute la plate-forme, saisissez l'adresse IP et le port du nœud (par exemple, http://192.0.2.1:5131).
2. Si la plate-forme parvient à joindre le nœud et que le service de nœud est en cours d'exécution, le message "Node is running" (Nœud en cours d'exécution) s'affiche.
3. Si vous recevez un message d'erreur, essayez les options suivantes :
   • S'il s'agit d'une erreur réseau, résolvez-la, puis réessayez.
   • Redémarrez le service de nœud.
   • Réinstallez l'application du nœud. Pour en savoir plus, suivez la procédure Installer les serveurs de nœuds.

Si ce message d'erreur s'affiche : 

1. Accédez au journal de l'hôte de service du serveur de nœud.

   Pour en savoir plus, consultez Vérifier les journaux de l'hôte de service.

2. Recherchez l'erreur suivante: The provided platform host address https://platformserver:443/Hub was unreachable (L'adresse indiquée pour l'hôte de la plate-forme n'était pas joignable).
3. Si l'erreur s'affiche, essayez les options suivantes :
   • Vérifiez la connexion réseau au serveur de la plate-forme. En cas de problème réseau, résolvez-le et redémarrez le service de nœud.
   • Si la plate-forme est configurée avec un certificat TLS, saisissez l'adresse IP et le port de la plate-forme (par exemple, https://192.0.2.1:5131) dans un navigateur sur l'ordinateur qui l'exécute. Vérifiez également que le certificat TLS est valide et qu'il n'a pas expiré.

Si le message invalid_grant (attribution non valide) apparaît dans le journal de l'hôte, vérifiez les points suivants :

• Vous devez avoir activé tous les champs d'application d'API pour votre compte cible. Pour en savoir plus, consultez Utiliser la console Google Cloud pour activer les API.
• Le compte de service doit être autorisé pour les champs d'application requis dans la console d'administration Google. Utilisez votre ID client OAuth 2.0 pour l'autorisation, et non l'ID client de votre compte de service. Pour en savoir plus, consultez Créer l'ID client Web OAuth.

Si votre migration s'exécute lentement ou pas du tout, l'erreur peut être liée aux quotas d'API de Google Workspace. Pour en savoir plus, consultez Utiliser des quotas.

Lorsque vous exécutez une analyse ou un pont, vous pouvez surveiller l'état des partitions.

1. Sur la plate-forme Google Workspace Migrate, cliquez sur Scans (Analyses) ou Bridges (Ponts).
2. Sur l'analyse ou le pont que vous souhaitez vérifier, cliquez sur Logs Partition log (Journaux > Journal de partition).
3. Sous State (État), vérifiez l'état des partitions :
   • Ready (Prêt) : la partition est prête à commencer.
   • Starting (En cours de démarrage) : la migration ou l'analyse est en préparation.
   • Crawling (Exploration) : la lecture des données du système source est en cours.
   • Processing (Traitement en cours) : l'écriture des données est en préparation dans le système cible.
   • Committing (Engagement) : l'écriture des données est en cours dans le système cible.
   • Cancelled (Annulé) : la partition a échoué. Passez à Résoudre les problèmes liés aux partitions annulées.
   • Completed (Terminé) : l'opération est terminée.
   • Skipped (Ignoré) : cet état s'affiche lors des nouvelles tentatives en cas d'échecs. La partition est ignorée, car elle ne présentait aucun échec. 

Si une partition a pour état Cancelled dans le journal des partitions, vous pouvez résoudre le problème à l'aide des options ci-dessous.

Option 1 : Vérifier les codes d'erreur

Pour trouver les codes d'erreur, pointez sur une ligne du journal de partition et cliquez sur Plus Partition log (Journal de partition). Résolvez le problème à l'aide du code d'erreur associé à l'échec. Pour en savoir plus, consultez Interpréter les messages d'erreur de Google Workspace Migrate.

Option 2 : Vérifier les nœuds

Dans le journal des partitions, vérifiez si toutes les partitions d'un même nœud sont annulées. L'annulation de tous les nœuds indique généralement des problèmes de connexion (le service source est temporairement indisponible, par exemple). Suivez la procédure Erreur lors de l'association d'un nœud. Ensuite, relancez l'analyse ou exécutez une migration delta.

Option 3 : Vérifier le journal d'exécution de la partition

Si le problème affecte plusieurs nœuds, vous pouvez examiner le journal d'exécution de la partition. Pour afficher le journal d'exécution associé à une partition :

1. Ouvrez le journal des partitions.
2. Pointez sur une ligne du journal, puis cliquez sur Plus Execution log (Journal d'exécution).
3. Cliquez sur StateFailed (État > Échec).
4. Examinez les échecs afin d'isoler la cause du problème et de le résoudre.
5. Effectuez une nouvelle tentative d'analyse ou de migration.

En cas d'augmentation du nombre d'échecs similaires dans le résumé de la migration, la configuration de votre migration est probablement incorrecte.

Vérifiez que les éléments suivants sont correctement configurés :

1. Les API, en particulier le SDK Admin, doivent être correctement activées dans la console d'administration Google. Pour en savoir plus, consultez Utiliser la console Google Cloud pour activer les API.
2. Le compte utilisateur doit exister sur le compte source et dans Google Workspace Migrate. Vérifiez qu'il n'est pas bloqué, suspendu, ni renommé.
3. Tous les utilisateurs doivent avoir activé les services Google Workspace Migrate nécessaires (par exemple, Gmail ou Google Drive). Pour en savoir plus, consultez les Conditions requises pour Google Workspace.

Si cette erreur apparaît dans les journaux de l'hôte, vous devrez peut-être autoriser les applications tierces pour les fichiers Drive.

Pour résoudre ce problème, suivez la procédure décrite dans Autoriser les applications tierces à modifier des fichiers stockés dans Drive.

Vous pouvez souvent corriger de nombreuses erreurs en exécutant une migration delta. Une migration delta identifie les erreurs persistantes et nettoie les problèmes temporaires, comme la limitation du débit et les niveaux de quota, les problèmes de réseau, et les erreurs 401. Vous pouvez exécuter une migration delta plusieurs fois pour résoudre les problèmes. Pour en savoir plus, consultez Préparer la mise en service.

Si des fichiers ne peuvent pas être migrés et que cette erreur s'affiche :

1. Ouvrez le journal des transactions.
2. Dans le champ Code d'erreur, recherchez 1029 pour déterminer si la migration du dossier parent a échoué.
3. Si le dossier parent n'a pas été migré, vérifiez le code d'erreur et corrigez le problème.
4. Exécuter un pont delta

Si vous migrez des fichiers d'un Drive partagé vers un autre, assurez-vous d'utiliser un mappage d'identité qui mappe les sources aux utilisateurs cibles dans le pont.

1. Sur la plate-forme Google Workspace Migrate, cliquez sur Scans (Analyses) ou Bridges (Ponts).
2. Sur l'analyse ou le pont que vous souhaitez vérifier, cliquez sur Logs Transaction log (Journaux > Journal des transactions).
3. Pointez sur la transaction, puis cliquez sur Plus Transaction details (Détails de la transaction).
4. À l'aide du tableau suivant, identifiez les erreurs de transaction courantes et la procédure à suivre pour les résoudre.

Une transaction peut apparaître comme ignorée dans le journal des transactions pour les raisons suivantes :

• Vous exécutez une migration delta et l'objet n'a pas changé depuis la migration précédente.
• L'objet a été exclu par une condition de filtre dans le modèle de paramétrage.
• Vous migrez le contenu des e-mails vers un groupe, et une pièce jointe volumineuse est ignorée.
• Vous utilisez un modèle de paramétrage d'un Drive partagé, mais vous migrez le contenu vers Mon Drive.

Selon la source de la migration, les autres raisons pour lesquelles un élément peut être ignoré sont les suivantes :

• SharePoint : un dossier est ignoré, car il ne fait pas partie d'une bibliothèque de documents.
• Exchange : les brouillons d'e-mails sont ignorés lors d'une migration vers Google Groupes.
• Box : une révision de fichier est ignorée, car la révision est vide.
• Partages de fichiers : un élément est ignoré, car les nœuds ne disposent pas des autorisations nécessaires pour y accéder. 
• Gmail : les messages de chat (éléments sous le libellé Chat) sont ignorés.

Lorsque vous migrez des données entre des Drive partagés à l'aide du modèle de paramétrage Par défaut, GWM crée le nouveau Drive partagé dans le compte cible, mais il est possible qu'il ne migre pas les données du Drive partagé source. Voici pourquoi :

• Aucun mappage d'identité n'est disponible pour la source et la cible.
• L'option Allow unmapped users (Autoriser les utilisateurs non mappés) n'est pas cochée dans le modèle.

Vous pouvez résoudre ce problème de deux manières :

1. Créez un modèle personnalisé à partir du modèle de paramètres Default (Par défaut) et cochez Allow unmapped users (Autoriser les utilisateurs non mappés)
2. Ajoutez un mappage d'identité.

Il est possible que le rapport des transactions soit trop volumineux pour être téléchargé. Essayez les options suivantes pour résoudre le problème :

Option 1 : Ajouter des filtres avant la migration

Pour réduire la taille du rapport, filtrez le journal des transactions afin de rechercher des données spécifiques, comme l'état d'exécution ou le code d'erreur. Pour en savoir plus, consultez Monitor migration progress (Surveiller la progression de la migration).

Option 2 : Télécharger le journal avec des filtres

Vous pouvez utiliser la ligne de commande pour spécifier comment télécharger le journal des transactions :

• Pour réduire le nombre d'éléments dans le journal, utilisez l'option transactionState.
• Pour augmenter le temps nécessaire au téléchargement du journal, utilisez l'option queryTimeout.

Pour en savoir plus, consultez Télécharger les journaux à l'aide de la ligne de commande.

Si les migrations sont plus lentes que prévu, vérifiez que vous disposez de la configuration système requise suivante.

Niveaux de quota des API Google

Vos paramètres de quota peuvent générer des codes d'erreur, tels que "403 Accès interdit", "429 Trop de requêtes" ou "503 Service indisponible". Pour vérifier si les niveaux de quota affectent la vitesse de votre migration :

1. Vérifiez les quotas dans la console Google Cloud. Pour connaître la procédure à suivre, consultez Afficher les quotas dans la console Google Cloud.
2. Ajustez les quotas pour prendre en charge votre utilisation des ressources. Pour connaître la procédure à suivre, consultez Gérer vos quotas à l'aide de la console.

Paramètres de limitation côté client

Les paramètres de limitation gèrent la fréquence à laquelle les clients peuvent envoyer des requêtes aux services Google. Parfois, les paramètres génèrent des codes d'erreur, tels que "403 Accès interdit", "429 Trop de requêtes" ou "503 Service indisponible".

Ces codes d'erreur peuvent être dus à des taux de limitation trop élevés dans Google Workspace Migrate (GWM). Si la limitation côté client est élevée sans limitation côté serveur significative, vous pouvez ajuster les paramètres de marge intérieure dans GWM.

Avant de commencer

• Ces modifications ne doivent être effectuées que par des administrateurs expérimentés, car les mises à jour peuvent avoir des conséquences inattendues.
• Les étapes suivantes définissent la stratégie de limitation Google, mais vous devrez peut-être également utiliser d'autres sources de données, y compris googleThrottlingStrategy, exchangeThrottlingStrategy et sharepointThrottlingStrategy.

Pour remplacer les stratégies de limitation par défaut dans les versions 2.1.54.0 et ultérieures de GWM :

1. Sur le serveur de plate-forme, créez le répertoire C:\ProgramData\AppBridge\Overrides.
2. Ajoutez un fichier JSON nommé throttling_settings.json.
3. À l'aide du Bloc-notes, ajoutez le texte suivant au fichier JSON :

   {
"googleThrottlingStrategy": {
"throttlingModel": "ADAPTIVE_THROTTLING",
"adaptiveThrottlePadding": 32,
"adaptiveThrottleAcceptanceRatio": 1.1,
"adaptiveThrottleIntervalMs": 60000
}
}

4. Enregistrez le fichier json.
5. Dans la barre d'état système de Windows, cliquez sur .
6. Arrêtez le service GWM, puis redémarrez-le.

Restrictions de pare-feu

Pour réduire les interférences avec les opérations sur le disque et le réseau, désinstallez les logiciels antivirus, les outils d'analyse de sécurité et les autres logiciels non essentiels des serveurs Workspace.

Google Workspace Migrate utilise MySQL pour stocker les paramètres de configuration et les informations de journalisation. Si votre connexion MySQL est intermittente ou ne répond pas, accédez à Vérifier les journaux de l'hôte du service et suivez les étapes pour une installation en plate-forme.

Si des erreurs MySQL s'affichent pour AppBridgeServiceHost.log :

1. Consultez Résoudre les problèmes liés à MySQL.
2. Si vous avez encore besoin d'aide, consultez Contacter l'assistance pour les problèmes liés à Google Workspace Migrate.