Résoudre les problèmes d’installation de l’application Afi¶
Cet article présente les problèmes que vous pouvez rencontrer avec Afi SaaS Backup pour Google Workspace et explique comment les résoudre.
Intégrer un locataire Google Workspace¶
L’installation de l’application Afi depuis Google Workspace Marketplace et l’intégration d’un locataire Google Workspace sont décrites dans le guide suivant. Une fois l’application Afi installée, la propagation des droits d’accès dans Google Workspace peut prendre jusqu’à 24 heures avant que l’application puisse accéder à votre locataire. Pendant ce délai, l’assistant d’intégration Afi affiche le message suivant : After application is installed it may take up to 24 hours before access is granted to the application. This page will be automatically refreshed to check the access.
Si l’assistant d’intégration ne progresse toujours pas après 24 heures, suivez les instructions ci-dessous afin de vérifier que l’application Afi est correctement installée et dispose de l’accès requis à votre locataire.
Vérifier que l’application Afi est installée dans Google Workspace Marketplace¶
Vous pouvez vérifier l’installation de l’application Afi sur sa page dans Google Workspace Marketplace. Si vous ne voyez pas le bouton Admin install et que le bouton Install est désactivé, votre compte Google actuel n’est pas super-administrateur Google Workspace. Vérifiez le compte utilisé et ses rôles dans Google Workspace.
Vérifier la portée de l’installation de l’application Afi¶
L’application Afi doit être installée pour tous les utilisateurs que vous souhaitez sauvegarder avec Afi et pour au moins un super-administrateur Google Workspace (dans le cadre d’une intégration, il doit s’agir de l’utilisateur qui effectue celle-ci). Sans accès à un super-administrateur, l’application Afi ne peut pas intégrer le locataire Google Workspace, et l’assistant d’intégration continue d’afficher la première étape et demande d’installer l’application.
En règle générale, nous vous recommandons d’installer l’application Afi pour l’ensemble du locataire Google Workspace, et non uniquement pour certaines unités organisationnelles ou certains groupes Google. Dans le cas contraire, si des utilisateurs ou des super-administrateurs Google Workspace sont déplacés vers des unités organisationnelles ou des groupes Google auxquels l’application Afi n’a pas accès, elle ne pourra plus sauvegarder ces utilisateurs ni effectuer les synchronisations périodiques des ressources avec Google Workspace.
Vous pouvez vérifier la portée de l’installation de l’application Afi et l’activer pour l’ensemble du locataire ou pour certaines unités organisationnelles ou certains groupes Google depuis la page Apps → Google Workspace Marketplace apps → Apps list → Afi G Suite Backup.
Réinstaller l’application Afi pour déclencher la propagation des droits d’accès¶
Si les étapes précédentes n’ont pas résolu le problème, vous pouvez désinstaller l’application Afi, puis la réinstaller. Cette opération déclenche la propagation des droits d’accès Google Workspace et peut résoudre le problème.
a. Pour désinstaller Afi, accédez à Apps → Google Workspace Marketplace apps -> Apps list, puis sélectionnez le nom de l’application.
b. Désinstallez l’application en cliquant sur l’icône de corbeille, puis réinstallez-la depuis Marketplace.
Information
La désinstallation de l’application Afi d’un locataire Google Workspace n’a aucune incidence sur les sauvegardes existantes du locataire correspondant dans Afi. Si l’application Afi est désinstallée, votre compte Afi reste accessible et vous pouvez toujours parcourir et exporter les sauvegardes existantes. Les prochaines sauvegardes échouent toutefois avec l’état Not authorized jusqu’à la réinstallation de l’application.
API Google Drive activée¶
En raison des spécificités de l’API Google, Afi emprunte l’identité d’un super-administrateur Google Workspace afin d’effectuer la découverte initiale des ressources lors de l’intégration d’un locataire Google Workspace. L’accès à Google Drive est nécessaire pour découvrir les Drive partagés. Vous pouvez vérifier que l’accès à l’API Google Drive est activé pour le locataire ou certains utilisateurs dans la section Apps → Google Workspace → Settings for Drive and Docs → Service status de la console d’administration Google.
Sauvegarde et restauration¶
L’application Afi doit avoir accès à tous les utilisateurs Google Workspace que vous souhaitez sauvegarder et vers lesquels vous souhaitez restaurer des données. Les tâches de sauvegarde ou de restauration des utilisateurs pour lesquels l’application Afi n’est pas installée échouent avec l’état Not authorized. Consultez la section ci-dessus pour savoir comment vérifier et accorder l’accès.
Information
Dans de rares cas, la synchronisation initiale avec Google Workspace peut prendre jusqu’à 24 heures. Tous les utilisateurs et tous les Drive ne deviennent visibles et accessibles à l’application qu’une fois cette opération terminée. Pendant ce délai, il est possible qu’un petit nombre de sauvegardes échouent avec l’état Not authorized, même si l’application Afi est installée pour les utilisateurs concernés.
Les autres problèmes de sauvegarde et de restauration, ainsi que les étapes permettant de les résoudre, sont décrits dans le guide suivant.
Sauvegardes suspendues ou de longue durée¶
Dans de rares cas, pendant la première sauvegarde d’un locataire Google Workspace, en particulier s’il est volumineux, certaines tâches de sauvegarde peuvent être temporairement suspendues et afficher l’état Paused. Il s’agit d’un comportement normal du service qui permet de gérer les pics d’erreurs transitoires ou liées aux limites de l’API Google et de traiter correctement la limitation du débit. Les sauvegardes suspendues sont automatiquement redémarrées quelques heures plus tard et reprennent à partir de l’état enregistré.
Afi surveille en continu les tâches suspendues ou de longue durée et résout de manière proactive tout problème qui les empêche d’aboutir.
Synchronisation des ressources avec Google Workspace¶
L’application Afi doit avoir accès à au moins un compte de super-administrateur Google Workspace actif pendant toute sa durée de vie afin d’effectuer les synchronisations de ressources avec Google Workspace. Elle n’est liée à aucun compte de super-administrateur précis et sélectionne un compte disponible auquel elle peut accéder. Pour effectuer une synchronisation, elle s’appuie toutefois sur la liste des comptes de super-administrateur enregistrée lors de la synchronisation précédente.
Par conséquent, si votre locataire ne comporte qu’un seul compte de super-administrateur Google Workspace et que vous souhaitez le remplacer, commencez par créer un nouveau compte de super-administrateur ou promouvoir un compte existant. Avant de supprimer l’ancien compte ou de rétrograder son rôle, déclenchez une synchronisation des ressources dans Afi en cliquant sur l’icône d’actualisation située dans l’angle supérieur droit de l’écran Service → Protection. Une fois la synchronisation terminée, vous pouvez supprimer l’ancien super-administrateur ou rétrograder son rôle. L’état de la tâche de synchronisation des ressources est disponible dans l’onglet Activity → Tasks.
Si les tâches périodiques de synchronisation des ressources (Discovery) échouent avec le code d’état Not authorized pour un locataire Google Workspace, vérifiez la portée de l’installation de l’application Afi ou contactez l’assistance Afi afin de remplacer le compte de super-administrateur Google Workspace supprimé utilisé pour les synchronisations par un nouveau compte.